--- parser3/src/sql/pa_sql_driver.h 2001/04/05 08:09:25 1.1 +++ parser3/src/sql/pa_sql_driver.h 2001/04/17 19:00:46 1.6 @@ -5,7 +5,7 @@ Author: Alexander Petrosyan (http://design.ru/paf) - $Id: pa_sql_driver.h,v 1.1 2001/04/05 08:09:25 paf Exp $ + $Id: pa_sql_driver.h,v 1.6 2001/04/17 19:00:46 paf Exp $ driver dynamic library must look like this: @@ -29,7 +29,7 @@ #ifndef PA_SQL_DRIVER_H #define PA_SQL_DRIVER_H -#include "pa_pool.h" +#include /// service functions for SQL driver to use class Services_for_SQL_driver { @@ -42,31 +42,49 @@ public: virtual void _throw(const char *comment) =0; }; -#define SQL_DRIVER_API_VERSION 0x0300 +#define SQL_DRIVER_API_VERSION 0x0301 /// SQL driver API class SQL_Driver { public: + struct Cell { + void *ptr; + size_t size; + }; + +public: + /// assignes services to driver. you can not use driver until this - void set_services(Services_for_SQL_driver *aservices) { fservices=aservices; } + void set_services(Services_for_SQL_driver *aservices) { services=aservices; } SQL_Driver() : - fservices(0) { + services(0) { } /// get api version virtual int api_version() =0; + /// initialize driver by loading sql dynamic link library + virtual const char *initialize(const char *dlopen_file_spec) =0; /// connect. @returns true+'connection' on success. 'error' on failure virtual void connect(char *url, void **connection) =0; virtual void disconnect(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(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, + const char *statement, unsigned long offset, unsigned long limit, + unsigned int *column_count, Cell **columns, + unsigned long *row_count, Cell ***rows) =0; /// log error message //static void log(Pool& pool, const char *fmt, ...); protected: - Services_for_SQL_driver *fservices; + Services_for_SQL_driver *services; }; typedef SQL_Driver *(*SQL_Driver_create_func)();