[BACK]Return to pa_sql_driver.h CVS log [TXT] [DIR] Up to [parser3project] / parser3 / src / sql

Diff for /parser3/src/sql/pa_sql_driver.h between versions 1.2 and 1.19

version 1.2, 2001/04/05 11:01:58 version 1.19, 2001/10/29 08:05:37
Line 2 Line 2
         Parser: sql driver interface.          Parser: sql driver interface.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
   
         Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)          Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
   
         $Id$          $Id$
Line 32 Line 31
 #include <sys/types.h>  #include <sys/types.h>
   
 /// service functions for SQL driver to use  /// service functions for SQL driver to use
 class Services_for_SQL_driver {  class SQL_Driver_services {
 public:  public:
         /// allocates some bytes on pool          /// allocates some bytes on pool
         virtual void *malloc(size_t size) =0;          virtual void *malloc(size_t size) =0;
         /// allocates some bytes clearing them with zeros          /// allocates some bytes clearing them with zeros
         virtual void *calloc(size_t size) =0;          virtual void *calloc(size_t size) =0;
         /// throw exception          /// prepare throw exception
         virtual void _throw(const char *comment) =0;          virtual void _throw(const char *comment) =0;
           /// throw C++ exception from prepared
           virtual void propagate_exception() =0;
   public:
           /// regretrully public, because can't make stack frames: "nowhere to return to"
           jmp_buf mark;
 };  };
   
 #define SQL_DRIVER_API_VERSION 0x0300  #define SQL_DRIVER_API_VERSION 0x0100
   #define SQL_DRIVER_CREATE create
   #define SQL_DRIVER_CREATE_NAME "create" /* could not figure out how to # it :( */
   
 /// SQL driver API  /// events, occuring when SQL_Driver::query()-ing
 class SQL_Driver {  class SQL_Driver_query_event_handlers {
 public:  public:
           virtual void add_column(void *ptr, size_t size) =0;
           virtual void before_rows() =0;
           virtual void add_row() =0;
           virtual void add_row_cell(void *ptr, size_t size) =0;
   };
   
         struct Cell {  /// SQL driver API
                 void *ptr;  class SQL_Driver {
                 size_t size;  
         };  
   
 public:  public:
   
         /// assignes services to driver. you can not use driver until this          SQL_Driver() {}
         void set_services(Services_for_SQL_driver *aservices) { fservices=aservices; }  
   
         SQL_Driver() :  
                 fservices(0) {  
         }  
         /// get api version          /// get api version
         virtual int api_version() =0;          virtual int api_version() =0;
         /// connect. @returns true+'connection' on success. 'error' on failure          /// initialize driver by loading sql dynamic link library
         virtual void connect(char *url, void **connection) =0;          virtual const char *initialize(const char *dlopen_file_spec) =0;
           /**     connect to sql database using 
                   @param used_only_to_connect_url 
                           format is driver specific
                           WARNING: must be used only to connect, for buffer doesn't live long enough
   
                   @returns true+'connection' on success. 'error' on failure
           */
           virtual void connect(char *used_only_in_connect_url_cstr, 
                   SQL_Driver_services& services, void **connection) =0;
         virtual void disconnect(void *connection) =0;          virtual void disconnect(void *connection) =0;
         virtual void commit(void *connection) =0;          virtual void commit(
         virtual void rollback(void *connection) =0;                  SQL_Driver_services& services, void *connection) =0;
         virtual void query(void *connection,          virtual void rollback(
                 const char *statement,                   SQL_Driver_services& services, void *connection) =0;
                 unsigned int *column_count, Cell **columns,          /// @returns true to indicate that connection still alive 
                 unsigned long *row_count, Cell ***rows) =0;          virtual bool ping(
         /// log error message                  SQL_Driver_services& services, void *connection) =0;
         //static void log(Pool& pool, const char *fmt, ...);          /// encodes the string in 'from' to an escaped SQL string
           virtual unsigned int quote(
 protected:                  SQL_Driver_services& services, void *connection,
                   char *to, const char *from, unsigned int length) =0;
         Services_for_SQL_driver *fservices;          virtual void query(
                   SQL_Driver_services& services, void *connection,
                   const char *statement, unsigned long offset, unsigned long limit,
                   SQL_Driver_query_event_handlers& handlers) =0;
 };  };
   
 typedef SQL_Driver *(*SQL_Driver_create_func)();  typedef SQL_Driver *(*SQL_Driver_create_func)();
Removed from v.1.2  
changed lines
  Added in v.1.19

E-mail: