开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 数值算法/人工智能 > 生物技术 > 查看源码
interfaces.hpp
资源名称：ncbi_cxx_win--Jul_08_2004.zip　[点击查看]
上传用户：yhdzpy8989
上传日期：2007-06-13
资源大小：13604k
文件大小：19k
源码类别：

生物技术

开发平台：

C/C++

interfaces.hpp：源码内容
  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: interfaces.hpp,v $
  4.  * PRODUCTION Revision 1000.0  2003/10/29 20:19:22  gouriano
  5.  * PRODUCTION PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.16
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  10. #ifndef DBAPI_DRIVER_CTLIB___INTERFACES__HPP
  11. #define DBAPI_DRIVER_CTLIB___INTERFACES__HPP
  13. /* $Id: interfaces.hpp,v 1000.0 2003/10/29 20:19:22 gouriano Exp $
  14.  * ===========================================================================
  15.  *
  16.  *                            PUBLIC DOMAIN NOTICE
  17.  *               National Center for Biotechnology Information
  18.  *
  19.  *  This software/database is a "United States Government Work" under the
  20.  *  terms of the United States Copyright Act.  It was written as part of
  21.  *  the author's official duties as a United States Government employee and
  22.  *  thus cannot be copyrighted.  This software/database is freely available
  23.  *  to the public for use. The National Library of Medicine and the U.S.
  24.  *  Government have not placed any restriction on its use or reproduction.
  25.  *
  26.  *  Although all reasonable efforts have been taken to ensure the accuracy
  27.  *  and reliability of the software and data, the NLM and the U.S.
  28.  *  Government do not and cannot warrant the performance or results that
  29.  *  may be obtained by using this software or data. The NLM and the U.S.
  30.  *  Government disclaim all warranties, express or implied, including
  31.  *  warranties of performance, merchantability or fitness for any particular
  32.  *  purpose.
  33.  *
  34.  *  Please cite the author in any work or product based on this material.
  35.  *
  36.  * ===========================================================================
  37.  *
  38.  * Author:  Vladimir Soussov
  39.  *
  40.  * File Description:  Driver for CTLib server
  41.  *
  42.  */
  44. #include <dbapi/driver/public.hpp>
  45. #include <dbapi/driver/util/parameters.hpp>
  47. #include <ctpublic.h>
  48. #include <bkpublic.h>
  51. BEGIN_NCBI_SCOPE
  53. class CTLibContext;
  54. class CTL_Connection;
  55. class CTL_LangCmd;
  56. class CTL_RPCCmd;
  57. class CTL_CursorCmd;
  58. class CTL_BCPInCmd;
  59. class CTL_SendDataCmd;
  60. class CTL_RowResult;
  61. class CTL_ParamResult;
  62. class CTL_ComputeResult;
  63. class CTL_StatusResult;
  64. class CTL_CursorResult;
  68. /////////////////////////////////////////////////////////////////////////////
  69. //
  70. //  CTLibContext::
  71. //
  73. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTLibContext : public I_DriverContext
  74. {
  75.     friend class CDB_Connection;
  77. public:
  78.     CTLibContext(bool reuse_context = true, CS_INT version = CS_VERSION_110);
  80.     //
  81.     // GENERIC functionality (see in <dbapi/driver/interfaces.hpp>)
  82.     //
  84.     virtual bool SetLoginTimeout (unsigned int nof_secs = 0);
  85.     virtual bool SetTimeout      (unsigned int nof_secs = 0);
  86.     virtual bool SetMaxTextImageSize(size_t nof_bytes);
  88.     virtual CDB_Connection* Connect(const string&   srv_name,
  89.                                     const string&   user_name,
  90.                                     const string&   passwd,
  91.                                     TConnectionMode mode,
  92.                                     bool            reusable  = false,
  93.                                     const string&   pool_name = kEmptyStr);
  95.     virtual ~CTLibContext();
  98.     //
  99.     // CTLIB specific functionality
  100.     //
  102.     // the following methods are optional (driver will use the default values
  103.     // if not called), the values will affect the new connections only
  105.     virtual void CTLIB_SetApplicationName(const string& a_name);
  106.     virtual void CTLIB_SetHostName(const string& host_name);
  107.     virtual void CTLIB_SetPacketSize(CS_INT packet_size);
  108.     virtual void CTLIB_SetLoginRetryCount(CS_INT n);
  109.     virtual void CTLIB_SetLoginLoopDelay(CS_INT nof_sec);
  111.     virtual bool IsAbleTo(ECapability cpb) const;
  113.     virtual CS_CONTEXT* CTLIB_GetContext() const;
  115.     static bool CTLIB_cserr_handler(CS_CONTEXT* context, CS_CLIENTMSG* msg);
  116.     static bool CTLIB_cterr_handler(CS_CONTEXT* context, CS_CONNECTION* con,
  117.                                     CS_CLIENTMSG* msg);
  118.     static bool CTLIB_srverr_handler(CS_CONTEXT* context, CS_CONNECTION* con,
  119.                                      CS_SERVERMSG* msg);
  121. private:
  122.     CS_CONTEXT* m_Context;
  123.     string      m_AppName;
  124.     string      m_HostName;
  125.     CS_INT      m_PacketSize;
  126.     CS_INT      m_LoginRetryCount;
  127.     CS_INT      m_LoginLoopDelay;
  129.     CS_CONNECTION* x_ConnectToServer(const string&   srv_name,
  130.                                      const string&   usr_name,
  131.                                      const string&   passwd,
  132.                                      TConnectionMode mode);
  133. };
  137. /////////////////////////////////////////////////////////////////////////////
  138. //
  139. //  CTL_Connection::
  140. //
  142. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_Connection : public I_Connection
  143. {
  144.     friend class CTLibContext;
  145.     friend class CDB_Connection;
  146.     friend class CTL_LangCmd;
  147.     friend class CTL_RPCCmd;
  148.     friend class CTL_CursorCmd;
  149.     friend class CTL_BCPInCmd;
  150.     friend class CTL_SendDataCmd;
  152. protected:
  153.     CTL_Connection(CTLibContext* cntx, CS_CONNECTION* con,
  154.                    bool reusable, const string& pool_name);
  156.     virtual bool IsAlive();
  158.     virtual CDB_LangCmd*     LangCmd     (const string&   lang_query,
  159.                                           unsigned int    nof_params = 0);
  160.     virtual CDB_RPCCmd*      RPC         (const string&   rpc_name,
  161.                                           unsigned int    nof_args);
  162.     virtual CDB_BCPInCmd*    BCPIn       (const string&   table_name,
  163.                                           unsigned int    nof_columns);
  164.     virtual CDB_CursorCmd*   Cursor      (const string&   cursor_name,
  165.                                           const string&   query,
  166.                                           unsigned int    nof_params,
  167.                                           unsigned int    batch_size = 1);
  168.     virtual CDB_SendDataCmd* SendDataCmd (I_ITDescriptor& desc,
  169.                                           size_t          data_size,
  170.                                           bool            log_it = true);
  172.     virtual bool SendData(I_ITDescriptor& desc, CDB_Image& img,
  173.                           bool log_it = true);
  174.     virtual bool SendData(I_ITDescriptor& desc, CDB_Text&  txt,
  175.                           bool log_it = true);
  176.     virtual bool Refresh();
  177.     virtual const string& ServerName() const;
  178.     virtual const string& UserName()   const;
  179.     virtual const string& Password()   const;
  180.     virtual I_DriverContext::TConnectionMode ConnectMode() const;
  181.     virtual bool IsReusable() const;
  182.     virtual const string& PoolName() const;
  183.     virtual I_DriverContext* Context() const;
  184.     virtual void PushMsgHandler(CDB_UserHandler* h);
  185.     virtual void PopMsgHandler (CDB_UserHandler* h);
  186.     virtual CDB_ResultProcessor* SetResultProcessor(CDB_ResultProcessor* rp);
  187.     virtual void Release();
  189.     virtual ~CTL_Connection();
  191.     void DropCmd(CDB_BaseEnt& cmd);
  193. private:
  194.     bool x_SendData(I_ITDescriptor& desc, CDB_Stream& img, bool log_it = true);
  195.     I_ITDescriptor* x_GetNativeITDescriptor(const CDB_ITDescriptor& descr_in);
  197.     CS_CONNECTION*  m_Link;
  198.     CTLibContext*   m_Context;
  199.     CPointerPot     m_CMDs;
  200.     CDBHandlerStack m_MsgHandlers;
  201.     string          m_Server;
  202.     string          m_User;
  203.     string          m_Passwd;
  204.     string          m_Pool;
  205.     bool            m_Reusable;
  206.     bool            m_BCPable;
  207.     bool            m_SecureLogin;
  208.     CDB_ResultProcessor* m_ResProc;
  209. };
  213. /////////////////////////////////////////////////////////////////////////////
  214. //
  215. //  CTL_LangCmd::
  216. //
  218. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_LangCmd : public I_LangCmd
  219. {
  220.     friend class CTL_Connection;
  221. protected:
  222.     CTL_LangCmd(CTL_Connection* conn, CS_COMMAND* cmd,
  223.                 const string& lang_query, unsigned int nof_params);
  225.     virtual bool More(const string& query_text);
  226.     virtual bool BindParam(const string& param_name, CDB_Object* param_ptr);
  227.     virtual bool SetParam(const string& param_name, CDB_Object* param_ptr);
  228.     virtual bool Send();
  229.     virtual bool WasSent() const;
  230.     virtual bool Cancel();
  231.     virtual bool WasCanceled() const;
  232.     virtual CDB_Result* Result();
  233.     virtual bool HasMoreResults() const;
  234.     virtual bool HasFailed() const;
  235.     virtual int  RowCount() const;
  236.     virtual void DumpResults();
  237.     virtual void Release();
  239.     virtual ~CTL_LangCmd();
  241. private:
  242.     bool x_AssignParams();
  244.     CTL_Connection* m_Connect;
  245.     CS_COMMAND*     m_Cmd;
  246.     string          m_Query;
  247.     CDB_Params      m_Params;
  248.     bool            m_WasSent;
  249.     bool            m_HasFailed;
  250.     I_Result*       m_Res;
  251.     int             m_RowCount;
  252. };
  256. /////////////////////////////////////////////////////////////////////////////
  257. //
  258. //  CTL_RPCCmd::
  259. //
  261. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_RPCCmd : public I_RPCCmd
  262. {
  263.     friend class CTL_Connection;
  264. protected:
  265.     CTL_RPCCmd(CTL_Connection* con, CS_COMMAND* cmd,
  266.                const string& proc_name, unsigned int nof_params);
  268.     virtual bool BindParam(const string& param_name, CDB_Object* param_ptr,
  269.                            bool out_param = false);
  270.     virtual bool SetParam(const string& param_name, CDB_Object* param_ptr,
  271.                           bool out_param = false);
  272.     virtual bool Send();
  273.     virtual bool WasSent() const;
  274.     virtual bool Cancel();
  275.     virtual bool WasCanceled() const;
  276.     virtual CDB_Result* Result();
  277.     virtual bool HasMoreResults() const;
  278.     virtual bool HasFailed() const;
  279.     virtual int  RowCount() const;
  280.     virtual void DumpResults();
  281.     virtual void SetRecompile(bool recompile = true);
  282.     virtual void Release();
  284.     virtual ~CTL_RPCCmd();
  286. private:
  287.     bool x_AssignParams();
  289.     CTL_Connection* m_Connect;
  290.     CS_COMMAND*     m_Cmd;
  291.     string          m_Query;
  292.     CDB_Params      m_Params;
  293.     bool            m_WasSent;
  294.     bool            m_HasFailed;
  295.     bool            m_Recompile;
  296.     I_Result*       m_Res;
  297.     int             m_RowCount;
  298. };
  302. /////////////////////////////////////////////////////////////////////////////
  303. //
  304. //  CTL_CursorCmd::
  305. //
  307. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_CursorCmd : public I_CursorCmd
  308. {
  309.     friend class CTL_Connection;
  310. protected:
  311.     CTL_CursorCmd(CTL_Connection* conn, CS_COMMAND* cmd,
  312.                   const string& cursor_name, const string& query,
  313.                   unsigned int nof_params, unsigned int fetch_size);
  315.     virtual bool BindParam(const string& param_name, CDB_Object* param_ptr);
  316.     virtual CDB_Result* Open();
  317.     virtual bool Update(const string& table_name, const string& upd_query);
  318.     virtual bool UpdateTextImage(unsigned int item_num, CDB_Stream& data, 
  319.  bool log_it = true);
  320.     virtual CDB_SendDataCmd* SendDataCmd(unsigned int item_num, size_t size, 
  321.  bool log_it = true);
  322.     virtual bool Delete(const string& table_name);
  323.     virtual int  RowCount() const;
  324.     virtual bool Close();
  325.     virtual void Release();
  327.     virtual ~CTL_CursorCmd();
  329. private:
  330.     bool x_AssignParams(bool just_declare = false);
  331.     I_ITDescriptor*   x_GetITDescriptor(unsigned int item_num);
  332.     CTL_Connection*   m_Connect;
  333.     CS_COMMAND*       m_Cmd;
  334.     string            m_Name;
  335.     string            m_Query;
  336.     CDB_Params        m_Params;
  337.     unsigned int      m_FetchSize;
  338.     bool              m_IsOpen;
  339.     bool              m_HasFailed;
  340.     bool              m_Used;
  341.     CTL_CursorResult* m_Res;
  342.     int               m_RowCount;
  343. };
  347. /////////////////////////////////////////////////////////////////////////////
  348. //
  349. //  CTL_BCPInCmd::
  350. //
  352. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_BCPInCmd : public I_BCPInCmd
  353. {
  354.     friend class CTL_Connection;
  355. protected:
  356.     CTL_BCPInCmd(CTL_Connection* con, CS_BLKDESC* cmd,
  357.                  const string& table_name, unsigned int nof_columns);
  359.     virtual bool Bind(unsigned int column_num, CDB_Object* param_ptr);
  360.     virtual bool SendRow();
  361.     virtual bool CompleteBatch();
  362.     virtual bool Cancel();
  363.     virtual bool CompleteBCP();
  364.     virtual void Release();
  366.     virtual ~CTL_BCPInCmd();
  368. private:
  369.     bool x_AssignParams();
  371.     CTL_Connection* m_Connect;
  372.     CS_BLKDESC*     m_Cmd;
  373.     string          m_Query;
  374.     CDB_Params      m_Params;
  375.     bool            m_WasSent;
  376.     bool            m_HasFailed;
  378.     struct SBcpBind {
  379.         CS_INT      datalen;
  380.         CS_SMALLINT indicator;
  381.         char        buffer[sizeof(CS_NUMERIC)];
  382.     };
  383.     SBcpBind*       m_Bind;
  384. };
  388. /////////////////////////////////////////////////////////////////////////////
  389. //
  390. //  CTL_SendDataCmd::
  391. //
  393. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_SendDataCmd : public I_SendDataCmd
  394. {
  395.     friend class CTL_Connection;
  396. protected:
  397.     CTL_SendDataCmd(CTL_Connection* con, CS_COMMAND* cmd, size_t nof_bytes);
  399.     virtual size_t SendChunk(const void* chunk_ptr, size_t nof_bytes);
  400.     virtual void   Release();
  402.     virtual ~CTL_SendDataCmd();
  404. private:
  405.     CTL_Connection* m_Connect;
  406.     CS_COMMAND*     m_Cmd;
  407.     size_t          m_Bytes2go;
  408. };
  412. /////////////////////////////////////////////////////////////////////////////
  413. //
  414. //  CTL_RowResult::
  415. //
  417. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_RowResult : public I_Result
  418. {
  419.     friend class CTL_LangCmd;
  420.     friend class CTL_RPCCmd;
  421.     friend class CTL_CursorCmd;
  422.     friend class CTL_Connection;
  423.     friend class CTL_SendDataCmd;
  424. protected:
  425.     CTL_RowResult(CS_COMMAND* cmd);
  427.     virtual EDB_ResType     ResultType() const;
  428.     virtual unsigned int    NofItems() const;
  429.     virtual const char*     ItemName    (unsigned int item_num) const;
  430.     virtual size_t          ItemMaxSize (unsigned int item_num) const;
  431.     virtual EDB_Type        ItemDataType(unsigned int item_num) const;
  432.     virtual bool            Fetch();
  433.     virtual int             CurrentItemNo() const;
  434.     virtual CDB_Object*     GetItem(CDB_Object* item_buf = 0);
  435.     virtual size_t          ReadItem(void* buffer, size_t buffer_size,
  436.                                      bool* is_null = 0);
  437.     virtual I_ITDescriptor* GetImageOrTextDescriptor();
  438.     virtual bool            SkipItem();
  440.     CS_RETCODE my_ct_get_data(CS_COMMAND* cmd, CS_INT item, 
  441.   CS_VOID* buffer, 
  442.   CS_INT buflen, CS_INT *outlen);
  443.     CDB_Object* s_GetItem(CS_COMMAND* cmd, CS_INT item_no, CS_DATAFMT& fmt,
  444.   CDB_Object* item_buf);
  445.     virtual ~CTL_RowResult();
  447.     // data
  448.     CS_COMMAND*  m_Cmd;
  449.     int          m_CurrItem;
  450.     bool         m_EOR;
  451.     unsigned int m_NofCols;
  452.     unsigned int m_CmdNum;
  453.     CS_DATAFMT*  m_ColFmt;
  454.     int          m_BindedCols;
  455.     CS_VOID**    m_BindItem;
  456.     CS_INT*      m_Copied;
  457.     CS_SMALLINT* m_Indicator;
  458.     unsigned char m_BindBuff[2048];
  459. };
  463. /////////////////////////////////////////////////////////////////////////////
  464. //
  465. //  CTL_ParamResult::
  466. //  CTL_ComputeResult::
  467. //  CTL_StatusResult::
  468. //  CTL_CursorResult::
  469. //
  471. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_ParamResult : public CTL_RowResult
  472. {
  473.     friend class CTL_LangCmd;
  474.     friend class CTL_RPCCmd;
  475.     friend class CTL_Connection;
  476.     friend class CTL_SendDataCmd;
  477.     friend class CTL_CursorCmd;
  478. protected:
  479.     CTL_ParamResult(CS_COMMAND* pCmd) : CTL_RowResult(pCmd) {}
  480.     virtual EDB_ResType ResultType() const;
  481. };
  484. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_ComputeResult : public CTL_RowResult
  485. {
  486.     friend class CTL_LangCmd;
  487.     friend class CTL_RPCCmd;
  488.     friend class CTL_Connection;
  489.     friend class CTL_SendDataCmd;
  490.     friend class CTL_CursorCmd;
  491. protected:
  492.     CTL_ComputeResult(CS_COMMAND* pCmd) : CTL_RowResult(pCmd) {}
  493.     virtual EDB_ResType ResultType() const;
  494. };
  497. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_StatusResult :  public CTL_RowResult
  498. {
  499.     friend class CTL_LangCmd;
  500.     friend class CTL_RPCCmd;
  501.     friend class CTL_Connection;
  502.     friend class CTL_SendDataCmd;
  503.     friend class CTL_CursorCmd;
  504. protected:
  505.     CTL_StatusResult(CS_COMMAND* pCmd) : CTL_RowResult(pCmd) {}
  506.     virtual EDB_ResType ResultType() const;
  507. };
  510. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_CursorResult :  public CTL_RowResult
  511. {
  512.     friend class CTL_CursorCmd;
  513. protected:
  514.     CTL_CursorResult(CS_COMMAND* pCmd) : CTL_RowResult(pCmd) {}
  515.     virtual EDB_ResType ResultType() const;
  516.     virtual bool        SkipItem();
  517.     virtual ~CTL_CursorResult();
  518. };
  522. /////////////////////////////////////////////////////////////////////////////
  523. //
  524. //  CTL_ITDescriptor::
  525. //
  527. #define CTL_ITDESCRIPTOR_TYPE_MAGNUM 0xc00
  529. class NCBI_DBAPIDRIVER_CTLIB_EXPORT CTL_ITDescriptor : public I_ITDescriptor
  530. {
  531.     friend class CTL_RowResult;
  532.     friend class CTL_Connection;
  533.     friend class CTL_CursorCmd;
  535. public:
  536.     virtual int DescriptorType() const;
  537.     virtual ~CTL_ITDescriptor();
  539. protected:
  540.     CTL_ITDescriptor();
  542.     CS_IODESC m_Desc;
  543. };
  547. /////////////////////////////////////////////////////////////////////////////
  548. //
  549. //  Miscellaneous
  550. //
  552. extern void g_CTLIB_GetRowCount
  553. (CS_COMMAND* cmd,
  554.  int*        cnt
  555. );
  558. extern bool g_CTLIB_AssignCmdParam
  559. (CS_COMMAND*   cmd,
  560.  CDB_Object&   param,
  561.  const string& param_name,
  562.  CS_DATAFMT&   param_fmt,
  563.  CS_SMALLINT   indicator,
  564.  bool          declare_only = false
  565.  );
  568. END_NCBI_SCOPE
  571. #endif  /* DBAPI_DRIVER_CTLIB___INTERFACES__HPP */
  575. /*
  576.  * ===========================================================================
  577.  * $Log: interfaces.hpp,v $
  578.  * Revision 1000.0  2003/10/29 20:19:22  gouriano
  579.  * PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.16
  580.  *
  581.  * Revision 1.16  2003/07/17 20:41:48  soussov
  582.  * connections pool improvements
  583.  *
  584.  * Revision 1.15  2003/06/05 15:55:26  soussov
  585.  * adds DumpResults method for LangCmd and RPC, SetResultProcessor method for Connection interface
  586.  *
  587.  * Revision 1.14  2003/04/21 20:17:06  soussov
  588.  * Buffering fetched result to avoid ct_get_data performance issue
  589.  *
  590.  * Revision 1.13  2003/04/01 20:26:24  vakatov
  591.  * Temporarily rollback to R1.11 -- until more backward-incompatible
  592.  * changes (in CException) are ready to commit (to avoid breaking the
  593.  * compatibility twice).
  594.  *
  595.  * Revision 1.11  2003/02/13 16:06:36  ivanov
  596.  * Added export specifier NCBI_DBAPIDRIVER_CTLIB_EXPORT for class definitions
  597.  *
  598.  * Revision 1.10  2002/03/28 00:37:01  vakatov
  599.  * CTL_CursorCmd::  use CTL_CursorResult rather than I_Result (fix access)
  600.  *
  601.  * Revision 1.9  2002/03/26 15:26:02  soussov
  602.  * new image/text operations added
  603.  *
  604.  * Revision 1.8  2001/11/06 17:58:56  lavr
  605.  * Get rid of inline methods - all moved into source files
  606.  *
  607.  * Revision 1.7  2001/10/22 15:14:50  lavr
  608.  * Beautifications...
  609.  *
  610.  * Revision 1.6  2001/09/27 23:01:06  vakatov
  611.  * CTL_***Result::  virtual methods' implementation moved away from the header
  612.  *
  613.  * Revision 1.5  2001/09/27 20:08:30  vakatov
  614.  * Added "DB_" (or "I_") prefix where it was missing
  615.  *
  616.  * Revision 1.4  2001/09/27 15:41:28  soussov
  617.  * CTL_Connection::Release() added
  618.  *
  619.  * Revision 1.3  2001/09/26 23:23:28  vakatov
  620.  * Moved the err.message handlers' stack functionality (generic storage
  621.  * and methods) to the "abstract interface" level.
  622.  *
  623.  * Revision 1.2  2001/09/24 20:52:19  vakatov
  624.  * Fixed args like "string& s = 0" to "string& s = kEmptyStr"
  625.  *
  626.  * Revision 1.1  2001/09/21 23:39:53  vakatov
  627.  * -----  Initial (draft) revision.  -----
  628.  * This is a major revamp (by Denis Vakatov, with help from Vladimir Soussov)
  629.  * of the DBAPI "driver" libs originally written by Vladimir Soussov.
  630.  * The revamp involved massive code shuffling and grooming, numerous local
  631.  * API redesigns, adding comments and incorporating DBAPI to the C++ Toolkit.
  632.  *
  633.  * ===========================================================================
  634.  */