|
|
| version 1.8, 2001/04/26 14:55:31 | version 1.20, 2001/11/05 11:46:29 |
|---|---|
| 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://paf.design.ru) | |
| Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf) | |
| $Id$ | $Id$ |
| Line 38 public: | Line 37 public: |
| 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 0x0301 | #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; | |
| }; | |
| /// row cell & column title storage | /// SQL driver API |
| struct Cell { | class SQL_Driver { |
| void *ptr; | |
| size_t size; | |
| }; | |
| public: | public: |
| /// assignes services to driver. you can not use driver until this | SQL_Driver() {} |
| void set_services(SQL_Driver_services *aservices) { services=aservices; } | |
| SQL_Driver() : | |
| services(0) { | |
| } | |
| /// get api version | /// get api version |
| virtual int api_version() =0; | virtual int api_version() =0; |
| /// initialize driver by loading sql dynamic link library | /// initialize driver by loading sql dynamic link library |
| virtual const char *initialize(const char *dlopen_file_spec) =0; | virtual const char *initialize(const char *dlopen_file_spec) =0; |
| /// connect. @returns true+'connection' on success. 'error' on failure | /** connect to sql database using |
| virtual void connect(char *url, void **connection) =0; | @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 rollback( | |
| SQL_Driver_services& services, 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( |
| SQL_Driver_services& services, void *connection) =0; | |
| /// encodes the string in 'from' to an escaped SQL string | /// encodes the string in 'from' to an escaped SQL string |
| virtual unsigned int quote(void *connection, | virtual unsigned int quote( |
| SQL_Driver_services& services, void *connection, | |
| char *to, const char *from, unsigned int length) =0; | char *to, const char *from, unsigned int length) =0; |
| virtual void query(void *connection, | virtual void query( |
| SQL_Driver_services& services, 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, | SQL_Driver_query_event_handlers& handlers) =0; |
| unsigned long *row_count, Cell ***rows) =0; | |
| /// log error message | |
| //static void log(Pool& pool, const char *fmt, ...); | |
| protected: | |
| SQL_Driver_services *services; | |
| }; | }; |
| typedef SQL_Driver *(*SQL_Driver_create_func)(); | typedef SQL_Driver *(*SQL_Driver_create_func)(); |