38 #define DBI_CAP_NONE 0
39 #define DBI_CAP_TIME_ZONE_SUPPORT (1 << 0)
40 #define DBI_CAP_CHARSET_SUPPORT (1 << 1)
41 #define DBI_CAP_TRANSACTION_MANAGEMENT (1 << 2)
42 #define DBI_CAP_STORED_PROCEDURES (1 << 3)
43 #define DBI_CAP_LOB_SUPPORT (1 << 4)
44 #define DBI_CAP_BIND_BY_VALUE (1 << 5)
45 #define DBI_CAP_BIND_BY_PLACEHOLDER (1 << 6)
46 #define DBI_CAP_HAS_EXECRAW (1 << 7)
47 #define DBI_CAP_HAS_STATEMENT (1 << 8)
48 #define DBI_CAP_HAS_SELECT_ROW (1 << 9)
49 #define DBI_CAP_HAS_NUMBER_SUPPORT (1 << 10)
50 #define DBI_CAP_HAS_OPTION_SUPPORT (1 << 11)
51 #define DBI_CAP_SERVER_TIME_ZONE (1 << 12)
52 #define DBI_CAP_AUTORECONNECT (1 << 13)
53 #define DBI_CAP_EVENTS (1 << 14)
54 #define DBI_CAP_HAS_DESCRIBE (1 << 15)
55 #define DBI_CAP_HAS_ARRAY_BIND (1 << 16)
56 #define DBI_CAP_HAS_RESULTSET_OUTPUT (1 << 17)
58 #define BN_PLACEHOLDER 0
61 #define DBI_DEFAULT_STR_LEN 512
64 #define QDBI_METHOD_OPEN 1
65 #define QDBI_METHOD_CLOSE 2
66 #define QDBI_METHOD_SELECT 3
67 #define QDBI_METHOD_SELECT_ROWS 4
68 #define QDBI_METHOD_EXEC 5
69 #define QDBI_METHOD_COMMIT 6
70 #define QDBI_METHOD_ROLLBACK 7
71 #define QDBI_METHOD_BEGIN_TRANSACTION 8
72 #define QDBI_METHOD_ABORT_TRANSACTION_START 9
73 #define QDBI_METHOD_GET_SERVER_VERSION 10
74 #define QDBI_METHOD_GET_CLIENT_VERSION 11
75 #define QDBI_METHOD_EXECRAW 12
76 #define QDBI_METHOD_STMT_PREPARE 13
77 #define QDBI_METHOD_STMT_PREPARE_RAW 14
78 #define QDBI_METHOD_STMT_BIND 15
79 #define QDBI_METHOD_STMT_BIND_PLACEHOLDERS 16
80 #define QDBI_METHOD_STMT_BIND_VALUES 17
81 #define QDBI_METHOD_STMT_EXEC 18
82 #define QDBI_METHOD_STMT_FETCH_ROW 19
83 #define QDBI_METHOD_STMT_FETCH_ROWS 20
84 #define QDBI_METHOD_STMT_FETCH_COLUMNS 21
85 #define QDBI_METHOD_STMT_NEXT 22
86 #define QDBI_METHOD_STMT_CLOSE 23
87 #define QDBI_METHOD_STMT_AFFECTED_ROWS 24
88 #define QDBI_METHOD_STMT_GET_OUTPUT 25
89 #define QDBI_METHOD_STMT_GET_OUTPUT_ROWS 26
90 #define QDBI_METHOD_STMT_DEFINE 27
91 #define QDBI_METHOD_SELECT_ROW 28
92 #define QDBI_METHOD_OPT_SET 29
93 #define QDBI_METHOD_OPT_GET 30
94 #define QDBI_METHOD_STMT_DESCRIBE 31
95 #define QDBI_METHOD_DESCRIBE 32
96 #define QDBI_METHOD_STMT_FREE 33
97 #define QDBI_METHOD_STMT_EXEC_DESCRIBE 34
99 #define QDBI_VALID_CODES 34
108 #define QDBI_EVENT_WARNING 1
293 #define DBI_OPT_NUMBER_OPT "optimal-numbers"
294 #define DBI_OPT_NUMBER_STRING "string-numbers"
295 #define DBI_OPT_NUMBER_NUMERIC "numeric-numbers"
296 #define DBI_OPT_TIMEZONE "timezone"
302 friend struct qore_dbi_mlist_private;
305 struct qore_dbi_mlist_private* priv;
309 DLLLOCAL qore_dbi_method_list& operator=(
const qore_dbi_method_list&);
312 DLLEXPORT qore_dbi_method_list();
313 DLLEXPORT ~qore_dbi_method_list();
339 DLLEXPORT
void add(
int code, q_dbi_stmt_fetch_row_t method);
341 DLLEXPORT
void add(
int code, q_dbi_stmt_fetch_columns_t method);
343 DLLEXPORT
void add(
int code, q_dbi_stmt_fetch_rows_t method);
345 DLLEXPORT
void add(
int code, q_dbi_stmt_next_t method);
348 DLLEXPORT
void add(
int code, q_dbi_option_set_t method);
350 DLLEXPORT
void add(
int code, q_dbi_option_get_t method);
353 DLLEXPORT
void registerOption(
const char* name,
const char* desc,
const QoreTypeInfo* type = 0);
363 friend struct qore_dbi_private;
367 struct qore_dbi_private* priv;
372 DLLLOCAL DBIDriver& operator=(
const DBIDriver&);
379 DLLEXPORT
const char*
getName()
const;
393 DLLLOCAL DBIDriver(
struct qore_dbi_private* p);
394 DLLLOCAL ~DBIDriver();
397 struct qore_dbi_dlist_private;
407 struct qore_dbi_dlist_private *priv;
409 DLLLOCAL
DBIDriver* find_intern(
const char* name)
const;
444 DLLLOCAL ~DBIDriverList();
463 #endif // _QORE_DBI_H
int(* q_dbi_open_t)(Datasource *ds, ExceptionSink *xsink)
signature for the DBI "open" method - must be defined in each DBI driver
Definition: DBI.h:128
AbstractQoreNode *(* q_dbi_get_client_version_t)(const Datasource *ds, ExceptionSink *xsink)
signature for the "get_client_version" method
Definition: DBI.h:235
This is the hash or associative list container type in Qore, dynamically allocated only...
Definition: QoreHashNode.h:50
The base class for all value and parse types in Qore expression trees.
Definition: AbstractQoreNode.h:54
QoreHashNode *(* q_dbi_select_row_t)(Datasource *ds, const QoreString *str, const QoreListNode *args, ExceptionSink *xsink)
signature for the DBI "selectRow" method - must be defined in each DBI driver
Definition: DBI.h:166
contains constants, classes, and subnamespaces in QoreProgram objects
Definition: QoreNamespace.h:63
this class provides the internal link to the database driver for Qore's DBI layer ...
Definition: DBI.h:362
DLLEXPORT bool hasStatementAPI() const
returns true if the driver supports the statement API
int(* q_dbi_abort_transaction_start_t)(Datasource *ds, ExceptionSink *xsink)
signature for the rollback method to be executed when the first statement in an explicit transaction ...
Definition: DBI.h:219
DLLEXPORT QoreHashNode * getOptionHash() const
returns the valid options for this driver with descriptions
Qore's string type supported by the QoreEncoding class.
Definition: QoreString.h:82
int(* q_dbi_rollback_t)(Datasource *ds, ExceptionSink *xsink)
signature for the DBI "rollback" method - must be defined in each DBI driver
Definition: DBI.h:201
AbstractQoreNode *(* q_dbi_execraw_t)(Datasource *ds, const QoreString *str, ExceptionSink *xsink)
signature for the DBI "execRawSQL" method - must be defined in each DBI driver
Definition: DBI.h:185
int(* q_dbi_stmt_bind_t)(SQLStatement *stmt, const QoreListNode &l, ExceptionSink *xsink)
bind input values and optionally describe output parameters
Definition: DBI.h:251
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreListNode.h:52
DLLEXPORT DBIDriverList DBI
list of DBI drivers currently reigsted by the Qore library
int(* q_dbi_close_t)(Datasource *ds)
signature for the DBI "close" method - must be defined in each DBI driver
Definition: DBI.h:135
the base class for accessing databases in Qore through a Qore DBI driver
Definition: Datasource.h:55
AbstractQoreNode *(* q_dbi_get_server_version_t)(Datasource *ds, ExceptionSink *xsink)
signature for the "get_server_version" method
Definition: DBI.h:227
DLLEXPORT const char * getName() const
this is the only public exported function available in this class
this is the data structure Qore DBI drivers will use to pass the supported DBI methods ...
Definition: DBI.h:301
This is the public class for DBI drivers supporting Qore's new prepared statement API...
Definition: SQLStatement.h:38
int(* q_dbi_commit_t)(Datasource *ds, ExceptionSink *xsink)
signature for the DBI "commit" method - must be defined in each DBI driver
Definition: DBI.h:193
container for holding Qore-language exception information and also for registering a "thread_exit" ca...
Definition: ExceptionSink.h:47
AbstractQoreNode *(* q_dbi_select_t)(Datasource *ds, const QoreString *str, const QoreListNode *args, ExceptionSink *xsink)
signature for the DBI "select" method - must be defined in each DBI driver
Definition: DBI.h:145
DLLEXPORT DBIDriver * registerDriver(const char *name, const qore_dbi_method_list &methods, int caps)
registers a new DBI driver
int(* q_dbi_begin_transaction_t)(Datasource *ds, ExceptionSink *xsink)
signature for the DBI "begin_transaction" method, should only be defined for drivers needing this to ...
Definition: DBI.h:209
int(* q_dbi_stmt_exec_t)(SQLStatement *stmt, ExceptionSink *xsink)
execute statement
Definition: DBI.h:256
this class is used to register and find DBI drivers loaded in qore
Definition: DBI.h:404
int(* q_dbi_stmt_prepare_raw_t)(SQLStatement *stmt, const QoreString &str, ExceptionSink *xsink)
prepare statement with no bind parsing
Definition: DBI.h:246
int(* q_dbi_stmt_affected_rows_t)(SQLStatement *stmt, ExceptionSink *xsink)
get number of affected rows
Definition: DBI.h:261
DLLEXPORT QoreHashNode * parseDatasource(const char *ds, ExceptionSink *xsink)
parses a datasource string and returns a hash of the component parts
DLLEXPORT void DBI_concat_numeric(QoreString *str, const AbstractQoreNode *v)
concatenates a numeric value to the QoreString from the QoreNode
DLLEXPORT DBIDriver * find(const char *name) const
finds a driver, will try to load the driver using the ModuleManager if no such driver is already pres...
int(* q_dbi_stmt_prepare_t)(SQLStatement *stmt, const QoreString &str, const QoreListNode *args, ExceptionSink *xsink)
prepare statement and process placeholder specifications and bind parameters
Definition: DBI.h:241
DLLEXPORT int DBI_concat_string(QoreString *str, const AbstractQoreNode *v, ExceptionSink *xsink)
concatenates a string value to the QoreString from the AbstractQoreNode