|
|
| version 1.3, 2001/04/05 11:50:10 | version 1.9, 2001/05/17 08:42:22 |
|---|---|
| Line 32 | Line 32 |
| #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; |
| Line 42 public: | Line 42 public: |
| virtual void _throw(const char *comment) =0; | virtual void _throw(const char *comment) =0; |
| }; | }; |
| #define SQL_DRIVER_API_VERSION 0x0300 | #define SQL_DRIVER_API_VERSION 0x0301 |
| /// SQL driver API | /// SQL driver API |
| class SQL_Driver { | class SQL_Driver { |
| public: | public: |
| /// row cell & column title storage | |
| struct Cell { | struct Cell { |
| void *ptr; | void *ptr; |
| size_t size; | size_t size; |
| Line 56 public: | Line 57 public: |
| public: | public: |
| /// assignes services to driver. you can not use driver until this | /// assignes services to driver. you can not use driver until this |
| void set_services(Services_for_SQL_driver *aservices) { fservices=aservices; } | void set_services(SQL_Driver_services *aservices) { services=aservices; } |
| SQL_Driver() : | SQL_Driver() : |
| fservices(0) { | services(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_to_connect_url, void **connection) =0; | |
| virtual void disconnect(void *connection) =0; | virtual void disconnect(void *connection) =0; |
| virtual void commit(void *connection) =0; | virtual void commit(void *connection) =0; |
| virtual void rollback(void *connection) =0; | virtual void rollback(void *connection) =0; |
| /// @returns true to indicate that connection still alive | /// @returns true to indicate that connection still alive |
| virtual bool ping(void *connection) =0; | virtual bool ping(void *connection) =0; |
| /// encodes the string in 'from' to an escaped SQL string | |
| virtual unsigned int quote(void *connection, | |
| char *to, const char *from, unsigned int length) =0; | |
| virtual void query(void *connection, | virtual void query(void *connection, |
| const char *statement, unsigned long offset, unsigned long limit, | const char *statement, unsigned long offset, unsigned long limit, |
| unsigned int *column_count, Cell **columns, | unsigned int *column_count, Cell **columns, |
| Line 79 public: | Line 91 public: |
| protected: | protected: |
| Services_for_SQL_driver *fservices; | SQL_Driver_services *services; |
| }; | }; |
| typedef SQL_Driver *(*SQL_Driver_create_func)(); | typedef SQL_Driver *(*SQL_Driver_create_func)(); |