--- parser3/src/sql/pa_sql_driver.h 2003/07/24 11:31:24 1.35 +++ parser3/src/sql/pa_sql_driver.h 2004/05/25 07:05:52 1.40 @@ -1,7 +1,7 @@ /** @file Parser: sql driver interface. - Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com) + Copyright (c) 2001-2004 ArtLebedev Group (http://www.artlebedev.com) Author: Alexandr Petrosian (http://paf.design.ru) @@ -26,13 +26,13 @@ #ifndef PA_SQL_DRIVER_H #define PA_SQL_DRIVER_H -static const char* IDENT_SQL_DRIVER_H="$Date: 2003/07/24 11:31:24 $"; +static const char * const IDENT_SQL_DRIVER_H="$Date: 2004/05/25 07:05:52 $"; #include #include #include -#define SQL_DRIVER_API_VERSION 0x0007 +#define SQL_DRIVER_API_VERSION 0x0008 #define SQL_DRIVER_CREATE create /* used in driver implementation */ #define SQL_DRIVER_CREATE_NAME "create" /* could not figure out how to # it :( */ @@ -75,6 +75,16 @@ public: virtual void *malloc_atomic(size_t size) =0; /// reallocates bytes virtual void *realloc(void *ptr, size_t size) =0; + /// $request:charset + virtual const char* request_charset() =0; + /// transcoder. + /// WARNING: can store pointers to charset names to speedup name-to-instance resolving + /// so do NOT pass pointers to local vars and change those vars after that + virtual void transcode(const char* src, size_t src_length, + const char*& dst, size_t& dst_length, + const char* charset_from_name, + const char* charset_to_name + ) =0; /// prepare throw exception virtual void _throw(const SQL_Error& e) =0; /// throw C++ exception from prepared @@ -118,28 +128,22 @@ public: /// initialize driver by loading sql dynamic link library virtual const char* initialize(char *dlopen_file_spec) =0; /** connect to sql database using - @param used_only_to_connect_url + @param url_cstr 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, + virtual void connect(char *url_cstr, SQL_Driver_services& services, void **connection) =0; virtual void disconnect(void *connection) =0; - virtual void commit( - SQL_Driver_services& services, void *connection) =0; - virtual void rollback( - SQL_Driver_services& services, void *connection) =0; + virtual void commit(void *connection) =0; + virtual void rollback(void *connection) =0; /// @returns true to indicate that connection still alive - virtual bool ping( - SQL_Driver_services& services, void *connection) =0; + virtual bool ping(void *connection) =0; /// encodes the string in 'from' to an escaped SQL string - virtual const char* quote( - SQL_Driver_services& services, void *connection, + virtual const char* quote(void *connection, const char* str, unsigned int length) =0; - virtual void query( - SQL_Driver_services& services, void *connection, + virtual void query(void *connection, const char* statement, unsigned long offset, unsigned long limit, SQL_Driver_query_event_handlers& handlers) =0; };