|
|
| version 1.34.2.1, 2003/01/27 17:17:07 | version 1.34.2.4.2.1, 2003/03/20 08:11:15 |
|---|---|
| Line 1 | Line 1 |
| /** @file | /** @file |
| Parser: sql driver interface. | Parser: sql driver interface. |
| Copyright (c) 2001, 2003 ArtLebedev Group (http://www.artlebedev.com) | Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com) |
| Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) | Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) |
| driver dynamic library must look like this: | driver dynamic library must look like this: |
| @code | @code |
| class X_SQL_Driver : public SQL_Driver { | class X_SQL_Driver: public SQL_Driver { |
| public: | public: |
| X_SQL_Driver() : SQL_driver() {} | X_SQL_Driver() : SQL_driver() {} |
| Line 37 static const char* IDENT_SQL_DRIVER_H="$ | Line 37 static const char* IDENT_SQL_DRIVER_H="$ |
| /// fields are freed elsewhere | /// fields are freed elsewhere |
| class SQL_Error { | class SQL_Error { |
| bool fdefined; | bool fdefined; |
| const char *ftype; | const char* ftype; |
| const char *fcomment; | const char* fcomment; |
| public: | public: |
| SQL_Error(): | SQL_Error(): |
| fdefined(false) {} | fdefined(false) {} |
| SQL_Error( | SQL_Error( |
| const char *atype, | const char* atype, |
| const char *acomment): | const char* acomment): |
| fdefined(true), | fdefined(true), |
| ftype(atype), | ftype(atype), |
| fcomment(acomment) {} | fcomment(acomment) {} |
| SQL_Error(const char *acomment): | SQL_Error(const char* acomment): |
| fdefined(true), | fdefined(true), |
| ftype(0), | ftype(0), |
| fcomment(acomment) {} | fcomment(acomment) {} |
| Line 60 public: | Line 60 public: |
| } | } |
| bool defined() const { return fdefined; } | bool defined() const { return fdefined; } |
| const char *type() const { return ftype; } | const char* type() const { return ftype; } |
| const char *comment() const { return fcomment; } | const char* comment() const { return fcomment; } |
| }; | }; |
| /// service functions for SQL driver to use | /// service functions for SQL driver to use |
| Line 78 public: | Line 78 public: |
| /// throw C++ exception from prepared | /// throw C++ exception from prepared |
| virtual void propagate_exception() =0; | virtual void propagate_exception() =0; |
| /// helper func | /// helper func |
| void _throw(const char *comment) { _throw(SQL_Error("sql.connect", comment)); } | void _throw(const char* comment) { _throw(SQL_Error("sql.connect", comment)); } |
| public: | public: |
| /// regretrully public, because can't make stack frames: "nowhere to return to" | /// regretrully public, because can't make stack frames: "nowhere to return to" |
| jmp_buf mark; | jmp_buf mark; |
| Line 101 public: | Line 101 public: |
| class SQL_Driver { | class SQL_Driver { |
| public: | public: |
| /** allocated using our allocator, | |
| @todo never freed | |
| */ | |
| static void *operator new(size_t size) { | |
| void *result=::malloc(size); | |
| if(!result) | |
| abort(); | |
| return result; | |
| } | |
| /// 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(char *dlopen_file_spec) =0; | virtual const char* initialize(char *dlopen_file_spec) =0; |
| /** connect to sql database using | /** connect to sql database using |
| @param used_only_to_connect_url | @param used_only_to_connect_url |
| format is driver specific | format is driver specific |
| Line 122 public: | Line 132 public: |
| /// @returns true to indicate that connection still alive | /// @returns true to indicate that connection still alive |
| virtual bool ping( | virtual bool ping( |
| SQL_Driver_services& services, void *connection) =0; | SQL_Driver_services& services, void *connection) =0; |
| struct Quote_result { | |
| char *s; | |
| size_t size; | |
| }; | |
| /// encodes the string in 'from' to an escaped SQL string | /// encodes the string in 'from' to an escaped SQL string |
| virtual unsigned int quote( | virtual Quote_result quote( |
| SQL_Driver_services& services, void *connection, | SQL_Driver_services& services, void *connection, |
| char *to, const char *from, unsigned int length) =0; | const char* from, unsigned int length) =0; |
| virtual void query( | virtual void query( |
| SQL_Driver_services& services, void *connection, | SQL_Driver_services& services, void *connection, |
| const char *statement, unsigned long offset, unsigned long limit, | const char* statement, unsigned long offset, unsigned long limit, |
| SQL_Driver_query_event_handlers& handlers) =0; | SQL_Driver_query_event_handlers& handlers) =0; |
| }; | }; |