--- parser3/src/sql/pa_sql_driver.h	2004/03/05 10:01:50	1.39
+++ parser3/src/sql/pa_sql_driver.h	2012/03/16 09:24:15	1.46
@@ -1,7 +1,7 @@
 /** @file
 	Parser: sql driver interface.
 
-	Copyright (c) 2001-2004 ArtLebedev Group (http://www.artlebedev.com)
+	Copyright (c) 2001-2012 Art. Lebedev Studio (http://www.artlebedev.com)
 	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
 
 
@@ -26,16 +26,26 @@
 #ifndef PA_SQL_DRIVER_H
 #define PA_SQL_DRIVER_H
 
-static const char * const IDENT_SQL_DRIVER_H="$Date: 2004/03/05 10:01:50 $";
+#define IDENT_PA_SQL_DRIVER_H "$Id: pa_sql_driver.h,v 1.46 2012/03/16 09:24:15 moko Exp $"
 
 #include <sys/types.h>
 #include <setjmp.h>
 #include <stdlib.h>
+#include <limits.h>
 
-#define SQL_DRIVER_API_VERSION 0x0008
+/*
+    1..8 not logged
+	9 introducing placeholders
+	10 limit fixed (default: SQL_NO_LIMIT [ULONG_MAX]), path to document_root added
+*/
+#define SQL_DRIVER_API_VERSION 10
+//#define SQL_DRIVER_API_VERSION 9
 #define SQL_DRIVER_CREATE create /* used in driver implementation */
 #define SQL_DRIVER_CREATE_NAME "create" /* could not figure out how to # it :( */
 
+#define SQL_NO_LIMIT ULONG_MAX
+//#define SQL_NO_LIMIT 0
+
 /// fields are freed elsewhere
 class SQL_Error {
 	bool fdefined;
@@ -77,6 +87,8 @@ public:
 	virtual void *realloc(void *ptr, size_t size) =0;
 	/// $request:charset
 	virtual const char* request_charset() =0;
+	/// $request:document-root
+	virtual const char* request_document_root() =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
@@ -113,6 +125,15 @@ public:
 class SQL_Driver {
 public:
 
+	/// @todo can be optimized to contain type information, 
+	/// to pass IN and OUT int/double NOT in string format
+	struct Placeholder {
+		const char* name;
+		const char* value;
+		bool is_null;
+		bool were_updated;
+	};
+
 	/** allocated using our allocator,
 		@todo never freed
 	*/
@@ -128,13 +149,12 @@ 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(void *connection) =0;
@@ -145,7 +165,9 @@ public:
 	virtual const char* quote(void *connection,
 		const char* str, unsigned int length) =0;
 	virtual void query(void *connection,
-		const char* statement, unsigned long offset, unsigned long limit,
+		const char* statement, 
+		size_t placeholders_count, Placeholder* placeholders,
+		unsigned long offset, unsigned long limit,
 		SQL_Driver_query_event_handlers& handlers) =0;
 };