Files
wxWidgets/src/common/db.cpp
Robert Roebling e115e77131 Applied a few patches,
Put some life into iODBC again,


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@3906 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
1999-10-09 13:32:40 +00:00

1883 lines
55 KiB
C++

///////////////////////////////////////////////////////////////////////////////
// Name: db.cpp
// Purpose: Implementation of the wxDB class. The wxDB class represents a connection
// to an ODBC data source. The wxDB class allows operations on the data
// source such as opening and closing the data source.
// Author: Doug Card
// Modified by:
// Mods: Dec, 1998:
// -Added support for SQL statement logging and database cataloging
// Mods: April, 1999
// -Added QUERY_ONLY mode support to reduce default number of cursors
// -Added additional SQL logging code
// -Added DEBUG-ONLY tracking of wxTable objects to detect orphaned DB connections
// -Set ODBC option to only read committed writes to the DB so all
// databases operate the same in that respect
// Created: 9.96
// RCS-ID: $Id$
// Copyright: (c) 1996 Remstar International, Inc.
// Licence: wxWindows licence, plus:
// Notice: This class library and its intellectual design are free of charge for use,
// modification, enhancement, debugging under the following conditions:
// 1) These classes may only be used as part of the implementation of a
// wxWindows-based application
// 2) All enhancements and bug fixes are to be submitted back to the wxWindows
// user groups free of all charges for use with the wxWindows library.
// 3) These classes may not be distributed as part of any other class library,
// DLL, text (written or electronic), other than a complete distribution of
// the wxWindows GUI development toolkit.
///////////////////////////////////////////////////////////////////////////////
/*
// SYNOPSIS START
// SYNOPSIS STOP
*/
// Use this line for wxWindows v1.x
//#include "wx_ver.h"
// Use this line for wxWindows v2.x
#include "wx/version.h"
#include "wx/wxprec.h"
#if wxMAJOR_VERSION == 2
#ifdef __GNUG__
#pragma implementation "db.h"
#endif
#endif
#ifdef DBDEBUG_CONSOLE
#include <iostream.h>
#endif
#ifdef __BORLANDC__
#pragma hdrstop
#endif //__BORLANDC__
#if wxMAJOR_VERSION == 2
#ifndef WX_PRECOMP
#include "wx/string.h"
#endif //WX_PRECOMP
#endif
#if wxMAJOR_VERSION == 1
# if defined(wx_msw) || defined(wx_x)
# ifdef WX_PRECOMP
# include "wx_prec.h"
# else
# include "wx.h"
# endif
# endif
# define wxUSE_ODBC 1
#endif
#if wxUSE_ODBC
#include <stdio.h>
#include <string.h>
#include <assert.h>
#include <stdlib.h>
#include <ctype.h>
#if wxMAJOR_VERSION == 1
#include "db.h"
#elif wxMAJOR_VERSION == 2
#include "wx/db.h"
#endif
DbList* WXDLLEXPORT PtrBegDbList = 0;
#if __WXDEBUG__ > 0
#if wxMAJOR_VERSION == 2
#include "wx/object.h"
#include "wx/list.h"
#include "wx/utils.h"
#include "wx/msgdlg.h"
#endif
extern wxList TablesInUse;
#endif
// SQL Log defaults to be used by GetDbConnection
enum sqlLog SQLLOGstate = sqlLogOFF;
char SQLLOGfn[DB_PATH_MAX+1] = "sqllog.txt";
// The wxDB::errorList is copied to this variable when the wxDB object
// is closed. This way, the error list is still available after the
// database object is closed. This is necessary if the database
// connection fails so the calling application can show the operator
// why the connection failed. Note: as each wxDB object is closed, it
// will overwrite the errors of the previously destroyed wxDB object in
// this variable.
char DBerrorList[DB_MAX_ERROR_HISTORY][DB_MAX_ERROR_MSG_LEN];
/********** wxDB Constructor **********/
wxDB::wxDB(HENV &aHenv)
{
int i;
fpSqlLog = 0; // Sql Log file pointer
sqlLogState = sqlLogOFF; // By default, logging is turned off
nTables = 0;
strcpy(sqlState,"");
strcpy(errorMsg,"");
nativeError = cbErrorMsg = 0;
for (i = 0; i < DB_MAX_ERROR_HISTORY; i++)
strcpy(errorList[i], "");
// Init typeInf structures
strcpy(typeInfVarchar.TypeName,"");
typeInfVarchar.FsqlType = 0;
typeInfVarchar.Precision = 0;
typeInfVarchar.CaseSensitive = 0;
typeInfVarchar.MaximumScale = 0;
strcpy(typeInfInteger.TypeName,"");
typeInfInteger.FsqlType = 0;
typeInfInteger.Precision = 0;
typeInfInteger.CaseSensitive = 0;
typeInfInteger.MaximumScale = 0;
strcpy(typeInfFloat.TypeName,"");
typeInfFloat.FsqlType = 0;
typeInfFloat.Precision = 0;
typeInfFloat.CaseSensitive = 0;
typeInfFloat.MaximumScale = 0;
strcpy(typeInfDate.TypeName,"");
typeInfDate.FsqlType = 0;
typeInfDate.Precision = 0;
typeInfDate.CaseSensitive = 0;
typeInfDate.MaximumScale = 0;
// Error reporting is turned OFF by default
silent = TRUE;
// Copy the HENV into the db class
henv = aHenv;
// Allocate a data source connection handle
if (SQLAllocConnect(henv, &hdbc) != SQL_SUCCESS)
DispAllErrors(henv);
// Initialize the db status flag
DB_STATUS = 0;
// Mark database as not open as of yet
dbIsOpen = FALSE;
} // wxDB::wxDB()
/********** wxDB::Open() **********/
bool wxDB::Open(char *Dsn, char *Uid, char *AuthStr)
{
assert(Dsn && strlen(Dsn));
dsn = Dsn;
uid = Uid;
authStr = AuthStr;
RETCODE retcode;
#ifndef FWD_ONLY_CURSORS
// Specify that the ODBC cursor library be used, if needed. This must be
// specified before the connection is made.
retcode = SQLSetConnectOption(hdbc, SQL_ODBC_CURSORS, SQL_CUR_USE_IF_NEEDED);
#ifdef DBDEBUG_CONSOLE
if (retcode == SQL_SUCCESS)
cout << "SQLSetConnectOption(CURSOR_LIB) successful" << endl;
else
cout << "SQLSetConnectOption(CURSOR_LIB) failed" << endl;
#endif
#endif
// Connect to the data source
retcode = SQLConnect(hdbc, (UCHAR FAR *) Dsn, SQL_NTS,
(UCHAR FAR *) Uid, SQL_NTS,
(UCHAR FAR *) AuthStr,SQL_NTS);
if (retcode == SQL_SUCCESS_WITH_INFO)
DispAllErrors(henv, hdbc);
else if (retcode != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
/*
If using Intersolv branded ODBC drivers, this is the place where you would substitute
your branded driver license information
SQLSetConnectOption(hdbc, 1041, (UDWORD) "");
SQLSetConnectOption(hdbc, 1042, (UDWORD) "");
*/
// Mark database as open
dbIsOpen = TRUE;
// Allocate a statement handle for the database connection
if (SQLAllocStmt(hdbc, &hstmt) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
// Set Connection Options
if (! setConnectionOptions())
return(FALSE);
// Query the data source for inf. about itself
if (! getDbInfo())
return(FALSE);
// Query the data source regarding data type information
//
// The way I determined which SQL data types to use was by calling SQLGetInfo
// for all of the possible SQL data types to see which ones were supported. If
// a type is not supported, the SQLFetch() that's called from getDataTypeInfo()
// fails with SQL_NO_DATA_FOUND. This is ugly because I'm sure the three SQL data
// types I've selected below will not alway's be what we want. These are just
// what happened to work against an Oracle 7/Intersolv combination. The following is
// a complete list of the results I got back against the Oracle 7 database:
//
// SQL_BIGINT SQL_NO_DATA_FOUND
// SQL_BINARY SQL_NO_DATA_FOUND
// SQL_BIT SQL_NO_DATA_FOUND
// SQL_CHAR type name = 'CHAR', Precision = 255
// SQL_DATE SQL_NO_DATA_FOUND
// SQL_DECIMAL type name = 'NUMBER', Precision = 38
// SQL_DOUBLE type name = 'NUMBER', Precision = 15
// SQL_FLOAT SQL_NO_DATA_FOUND
// SQL_INTEGER SQL_NO_DATA_FOUND
// SQL_LONGVARBINARY type name = 'LONG RAW', Precision = 2 billion
// SQL_LONGVARCHAR type name = 'LONG', Precision = 2 billion
// SQL_NUMERIC SQL_NO_DATA_FOUND
// SQL_REAL SQL_NO_DATA_FOUND
// SQL_SMALLINT SQL_NO_DATA_FOUND
// SQL_TIME SQL_NO_DATA_FOUND
// SQL_TIMESTAMP type name = 'DATE', Precision = 19
// SQL_VARBINARY type name = 'RAW', Precision = 255
// SQL_VARCHAR type name = 'VARCHAR2', Precision = 2000
// =====================================================================
// Results from a Microsoft Access 7.0 db, using a driver from Microsoft
//
// SQL_VARCHAR type name = 'TEXT', Precision = 255
// SQL_TIMESTAMP type name = 'DATETIME'
// SQL_DECIMAL SQL_NO_DATA_FOUND
// SQL_NUMERIC type name = 'CURRENCY', Precision = 19
// SQL_FLOAT SQL_NO_DATA_FOUND
// SQL_REAL type name = 'SINGLE', Precision = 7
// SQL_DOUBLE type name = 'DOUBLE', Precision = 15
// SQL_INTEGER type name = 'LONG', Precision = 10
// VARCHAR = Variable length character string
if (! getDataTypeInfo(SQL_VARCHAR, typeInfVarchar))
if (! getDataTypeInfo(SQL_CHAR, typeInfVarchar))
return(FALSE);
else
typeInfVarchar.FsqlType = SQL_CHAR;
else
typeInfVarchar.FsqlType = SQL_VARCHAR;
// Float
if (! getDataTypeInfo(SQL_DOUBLE, typeInfFloat))
if (! getDataTypeInfo(SQL_REAL, typeInfFloat))
if (! getDataTypeInfo(SQL_FLOAT, typeInfFloat))
if (! getDataTypeInfo(SQL_DECIMAL, typeInfFloat))
if (! getDataTypeInfo(SQL_NUMERIC, typeInfFloat))
return(FALSE);
else
typeInfFloat.FsqlType = SQL_NUMERIC;
else
typeInfFloat.FsqlType = SQL_DECIMAL;
else
typeInfFloat.FsqlType = SQL_FLOAT;
else
typeInfFloat.FsqlType = SQL_REAL;
else
typeInfFloat.FsqlType = SQL_DOUBLE;
// Integer
if (! getDataTypeInfo(SQL_INTEGER, typeInfInteger))
// If SQL_INTEGER is not supported, use the floating point
// data type to store integers as well as floats
if (! getDataTypeInfo(typeInfFloat.FsqlType, typeInfInteger))
return(FALSE);
else
typeInfInteger.FsqlType = typeInfFloat.FsqlType;
else
typeInfInteger.FsqlType = SQL_INTEGER;
// Date/Time
if (Dbms() != dbmsDBASE)
{
if (! getDataTypeInfo(SQL_TIMESTAMP, typeInfDate))
return(FALSE);
else
typeInfDate.FsqlType = SQL_TIMESTAMP;
}
else
{
if (! getDataTypeInfo(SQL_DATE, typeInfDate))
return(FALSE);
else
typeInfDate.FsqlType = SQL_DATE;
}
#ifdef DBDEBUG_CONSOLE
cout << "VARCHAR DATA TYPE: " << typeInfVarchar.TypeName << endl;
cout << "INTEGER DATA TYPE: " << typeInfInteger.TypeName << endl;
cout << "FLOAT DATA TYPE: " << typeInfFloat.TypeName << endl;
cout << "DATE DATA TYPE: " << typeInfDate.TypeName << endl;
cout << endl;
#endif
// Completed Successfully
return(TRUE);
} // wxDB::Open()
// The Intersolv/Oracle 7 driver was "Not Capable" of setting the login timeout.
/********** wxDB::setConnectionOptions() **********/
bool wxDB::setConnectionOptions(void)
{
SQLSetConnectOption(hdbc, SQL_AUTOCOMMIT, SQL_AUTOCOMMIT_OFF);
SQLSetConnectOption(hdbc, SQL_OPT_TRACE, SQL_OPT_TRACE_OFF);
// Display the connection options to verify them
#ifdef DBDEBUG_CONSOLE
long l;
cout << ">>>>> CONNECTION OPTIONS <<<<<<" << endl;
if (SQLGetConnectOption(hdbc, SQL_AUTOCOMMIT, &l) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
cout << "AUTOCOMMIT: " << (l == SQL_AUTOCOMMIT_OFF ? "OFF" : "ON") << endl;
if (SQLGetConnectOption(hdbc, SQL_ODBC_CURSORS, &l) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
cout << "ODBC CURSORS: ";
switch(l)
{
case(SQL_CUR_USE_IF_NEEDED):
cout << "SQL_CUR_USE_IF_NEEDED";
break;
case(SQL_CUR_USE_ODBC):
cout << "SQL_CUR_USE_ODBC";
break;
case(SQL_CUR_USE_DRIVER):
cout << "SQL_CUR_USE_DRIVER";
break;
}
cout << endl;
if (SQLGetConnectOption(hdbc, SQL_OPT_TRACE, &l) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
cout << "TRACING: " << (l == SQL_OPT_TRACE_OFF ? "OFF" : "ON") << endl;
cout << endl;
#endif
// Completed Successfully
return(TRUE);
} // wxDB::setConnectionOptions()
/********** wxDB::getDbInfo() **********/
bool wxDB::getDbInfo(void)
{
SWORD cb;
RETCODE retcode;
if (SQLGetInfo(hdbc, SQL_SERVER_NAME, (UCHAR*) dbInf.serverName, 80, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_DATABASE_NAME, (UCHAR*) dbInf.databaseName, 128, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_DBMS_NAME, (UCHAR*) dbInf.dbmsName, 40, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
// 16-Mar-1999
// After upgrading to MSVC6, the original 20 char buffer below was insufficient,
// causing database connectivity to fail in some cases.
retcode = SQLGetInfo(hdbc, SQL_DBMS_VER, (UCHAR*) dbInf.dbmsVer, 64, &cb);
if (retcode != SQL_SUCCESS && retcode != SQL_SUCCESS_WITH_INFO )
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_ACTIVE_CONNECTIONS, (UCHAR*) &dbInf.maxConnections, sizeof(dbInf.maxConnections), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_ACTIVE_STATEMENTS, (UCHAR*) &dbInf.maxStmts, sizeof(dbInf.maxStmts), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_DRIVER_NAME, (UCHAR*) dbInf.driverName, 40, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_DRIVER_ODBC_VER, (UCHAR*) dbInf.odbcVer, 60, &cb) == SQL_ERROR)
return(DispAllErrors(henv, hdbc));
retcode = SQLGetInfo(hdbc, SQL_ODBC_VER, (UCHAR*) dbInf.drvMgrOdbcVer, 60, &cb);
if (retcode != SQL_SUCCESS && retcode != SQL_SUCCESS_WITH_INFO)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_DRIVER_VER, (UCHAR*) dbInf.driverVer, 60, &cb) == SQL_ERROR)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_ODBC_API_CONFORMANCE, (UCHAR*) &dbInf.apiConfLvl, sizeof(dbInf.apiConfLvl), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_ODBC_SAG_CLI_CONFORMANCE, (UCHAR*) &dbInf.cliConfLvl, sizeof(dbInf.cliConfLvl), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_ODBC_SQL_CONFORMANCE, (UCHAR*) &dbInf.sqlConfLvl, sizeof(dbInf.sqlConfLvl), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_OUTER_JOINS, (UCHAR*) dbInf.outerJoins, 2, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_PROCEDURES, (UCHAR*) dbInf.procedureSupport, 2, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_CURSOR_COMMIT_BEHAVIOR, (UCHAR*) &dbInf.cursorCommitBehavior, sizeof(dbInf.cursorCommitBehavior), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_CURSOR_ROLLBACK_BEHAVIOR, (UCHAR*) &dbInf.cursorRollbackBehavior, sizeof(dbInf.cursorRollbackBehavior), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_NON_NULLABLE_COLUMNS, (UCHAR*) &dbInf.supportNotNullClause, sizeof(dbInf.supportNotNullClause), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_ODBC_SQL_OPT_IEF, (UCHAR*) dbInf.supportIEF, 2, &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_DEFAULT_TXN_ISOLATION, (UCHAR*) &dbInf.txnIsolation, sizeof(dbInf.txnIsolation), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_TXN_ISOLATION_OPTION, (UCHAR*) &dbInf.txnIsolationOptions, sizeof(dbInf.txnIsolationOptions), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_FETCH_DIRECTION, (UCHAR*) &dbInf.fetchDirections, sizeof(dbInf.fetchDirections), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_LOCK_TYPES, (UCHAR*) &dbInf.lockTypes, sizeof(dbInf.lockTypes), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_POS_OPERATIONS, (UCHAR*) &dbInf.posOperations, sizeof(dbInf.posOperations), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_POSITIONED_STATEMENTS, (UCHAR*) &dbInf.posStmts, sizeof(dbInf.posStmts), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_SCROLL_CONCURRENCY, (UCHAR*) &dbInf.scrollConcurrency, sizeof(dbInf.scrollConcurrency), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_SCROLL_OPTIONS, (UCHAR*) &dbInf.scrollOptions, sizeof(dbInf.scrollOptions), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_STATIC_SENSITIVITY, (UCHAR*) &dbInf.staticSensitivity, sizeof(dbInf.staticSensitivity), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_TXN_CAPABLE, (UCHAR*) &dbInf.txnCapable, sizeof(dbInf.txnCapable), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
if (SQLGetInfo(hdbc, SQL_LOGIN_TIMEOUT, (UCHAR*) &dbInf.loginTimeout, sizeof(dbInf.loginTimeout), &cb) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
#ifdef DBDEBUG_CONSOLE
cout << ">>>>> DATA SOURCE INFORMATION <<<<<" << endl;
cout << "SERVER Name: " << dbInf.serverName << endl;
cout << "DBMS Name: " << dbInf.dbmsName << "; DBMS Version: " << dbInf.dbmsVer << endl;
cout << "ODBC Version: " << dbInf.odbcVer << "; Driver Version: " << dbInf.driverVer << endl;
cout << "API Conf. Level: ";
switch(dbInf.apiConfLvl)
{
case SQL_OAC_NONE: cout << "None"; break;
case SQL_OAC_LEVEL1: cout << "Level 1"; break;
case SQL_OAC_LEVEL2: cout << "Level 2"; break;
}
cout << endl;
cout << "SAG CLI Conf. Level: ";
switch(dbInf.cliConfLvl)
{
case SQL_OSCC_NOT_COMPLIANT: cout << "Not Compliant"; break;
case SQL_OSCC_COMPLIANT: cout << "Compliant"; break;
}
cout << endl;
cout << "SQL Conf. Level: ";
switch(dbInf.sqlConfLvl)
{
case SQL_OSC_MINIMUM: cout << "Minimum Grammer"; break;
case SQL_OSC_CORE: cout << "Core Grammer"; break;
case SQL_OSC_EXTENDED: cout << "Extended Grammer"; break;
}
cout << endl;
cout << "Max. Connections: " << dbInf.maxConnections << endl;
cout << "Outer Joins: " << dbInf.outerJoins << endl;
cout << "Support for Procedures: " << dbInf.procedureSupport << endl;
cout << "Cursor COMMIT Behavior: ";
switch(dbInf.cursorCommitBehavior)
{
case SQL_CB_DELETE: cout << "Delete cursors"; break;
case SQL_CB_CLOSE: cout << "Close cursors"; break;
case SQL_CB_PRESERVE: cout << "Preserve cursors"; break;
}
cout << endl;
cout << "Cursor ROLLBACK Behavior: ";
switch(dbInf.cursorRollbackBehavior)
{
case SQL_CB_DELETE: cout << "Delete cursors"; break;
case SQL_CB_CLOSE: cout << "Close cursors"; break;
case SQL_CB_PRESERVE: cout << "Preserve cursors"; break;
}
cout << endl;
cout << "Support NOT NULL clause: ";
switch(dbInf.supportNotNullClause)
{
case SQL_NNC_NULL: cout << "No"; break;
case SQL_NNC_NON_NULL: cout << "Yes"; break;
}
cout << endl;
cout << "Support IEF (Ref. Integrity): " << dbInf.supportIEF << endl;
cout << "Login Timeout: " << dbInf.loginTimeout << endl;
cout << endl << endl << "more ..." << endl;
getchar();
cout << "Default Transaction Isolation: ";
switch(dbInf.txnIsolation)
{
case SQL_TXN_READ_UNCOMMITTED: cout << "Read Uncommitted"; break;
case SQL_TXN_READ_COMMITTED: cout << "Read Committed"; break;
case SQL_TXN_REPEATABLE_READ: cout << "Repeatable Read"; break;
case SQL_TXN_SERIALIZABLE: cout << "Serializable"; break;
#ifdef ODBC_V20
case SQL_TXN_VERSIONING: cout << "Versioning"; break;
#endif
}
cout << endl;
cout << "Transaction Isolation Options: ";
if (dbInf.txnIsolationOptions & SQL_TXN_READ_UNCOMMITTED)
cout << "Read Uncommitted, ";
if (dbInf.txnIsolationOptions & SQL_TXN_READ_COMMITTED)
cout << "Read Committed, ";
if (dbInf.txnIsolationOptions & SQL_TXN_REPEATABLE_READ)
cout << "Repeatable Read, ";
if (dbInf.txnIsolationOptions & SQL_TXN_SERIALIZABLE)
cout << "Serializable, ";
#ifdef ODBC_V20
if (dbInf.txnIsolationOptions & SQL_TXN_VERSIONING)
cout << "Versioning";
#endif
cout << endl;
cout << "Fetch Directions Supported:" << endl << " ";
if (dbInf.fetchDirections & SQL_FD_FETCH_NEXT)
cout << "Next, ";
if (dbInf.fetchDirections & SQL_FD_FETCH_PRIOR)
cout << "Prev, ";
if (dbInf.fetchDirections & SQL_FD_FETCH_FIRST)
cout << "First, ";
if (dbInf.fetchDirections & SQL_FD_FETCH_LAST)
cout << "Last, ";
if (dbInf.fetchDirections & SQL_FD_FETCH_ABSOLUTE)
cout << "Absolute, ";
if (dbInf.fetchDirections & SQL_FD_FETCH_RELATIVE)
cout << "Relative, ";
#ifdef ODBC_V20
if (dbInf.fetchDirections & SQL_FD_FETCH_RESUME)
cout << "Resume, ";
#endif
if (dbInf.fetchDirections & SQL_FD_FETCH_BOOKMARK)
cout << "Bookmark";
cout << endl;
cout << "Lock Types Supported (SQLSetPos): ";
if (dbInf.lockTypes & SQL_LCK_NO_CHANGE)
cout << "No Change, ";
if (dbInf.lockTypes & SQL_LCK_EXCLUSIVE)
cout << "Exclusive, ";
if (dbInf.lockTypes & SQL_LCK_UNLOCK)
cout << "UnLock";
cout << endl;
cout << "Position Operations Supported (SQLSetPos): ";
if (dbInf.posOperations & SQL_POS_POSITION)
cout << "Position, ";
if (dbInf.posOperations & SQL_POS_REFRESH)
cout << "Refresh, ";
if (dbInf.posOperations & SQL_POS_UPDATE)
cout << "Upd, ";
if (dbInf.posOperations & SQL_POS_DELETE)
cout << "Del, ";
if (dbInf.posOperations & SQL_POS_ADD)
cout << "Add";
cout << endl;
cout << "Positioned Statements Supported: ";
if (dbInf.posStmts & SQL_PS_POSITIONED_DELETE)
cout << "Pos delete, ";
if (dbInf.posStmts & SQL_PS_POSITIONED_UPDATE)
cout << "Pos update, ";
if (dbInf.posStmts & SQL_PS_SELECT_FOR_UPDATE)
cout << "Select for update";
cout << endl;
cout << "Scroll Concurrency: ";
if (dbInf.scrollConcurrency & SQL_SCCO_READ_ONLY)
cout << "Read Only, ";
if (dbInf.scrollConcurrency & SQL_SCCO_LOCK)
cout << "Lock, ";
if (dbInf.scrollConcurrency & SQL_SCCO_OPT_ROWVER)
cout << "Opt. Rowver, ";
if (dbInf.scrollConcurrency & SQL_SCCO_OPT_VALUES)
cout << "Opt. Values";
cout << endl;
cout << "Scroll Options: ";
if (dbInf.scrollOptions & SQL_SO_FORWARD_ONLY)
cout << "Fwd Only, ";
if (dbInf.scrollOptions & SQL_SO_STATIC)
cout << "Static, ";
if (dbInf.scrollOptions & SQL_SO_KEYSET_DRIVEN)
cout << "Keyset Driven, ";
if (dbInf.scrollOptions & SQL_SO_DYNAMIC)
cout << "Dynamic, ";
if (dbInf.scrollOptions & SQL_SO_MIXED)
cout << "Mixed";
cout << endl;
cout << "Static Sensitivity: ";
if (dbInf.staticSensitivity & SQL_SS_ADDITIONS)
cout << "Additions, ";
if (dbInf.staticSensitivity & SQL_SS_DELETIONS)
cout << "Deletions, ";
if (dbInf.staticSensitivity & SQL_SS_UPDATES)
cout << "Updates";
cout << endl;
cout << "Transaction Capable?: ";
switch(dbInf.txnCapable)
{
case SQL_TC_NONE: cout << "No"; break;
case SQL_TC_DML: cout << "DML Only"; break;
case SQL_TC_DDL_COMMIT: cout << "DDL Commit"; break;
case SQL_TC_DDL_IGNORE: cout << "DDL Ignore"; break;
case SQL_TC_ALL: cout << "DDL & DML"; break;
}
cout << endl;
cout << endl;
#endif
// Completed Successfully
return(TRUE);
} // wxDB::getDbInfo()
/********** wxDB::getDataTypeInfo() **********/
bool wxDB::getDataTypeInfo(SWORD fSqlType, SqlTypeInfo &structSQLTypeInfo)
{
// fSqlType will be something like SQL_VARCHAR. This parameter determines
// the data type inf. is gathered for.
//
// SqlTypeInfo is a structure that is filled in with data type information,
RETCODE retcode;
SDWORD cbRet;
// Get information about the data type specified
if (SQLGetTypeInfo(hstmt, fSqlType) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
// Fetch the record
if ((retcode = SQLFetch(hstmt)) != SQL_SUCCESS)
{
#ifdef DBDEBUG_CONSOLE
if (retcode == SQL_NO_DATA_FOUND)
cout << "SQL_NO_DATA_FOUND fetching inf. about data type." << endl;
#endif
DispAllErrors(henv, hdbc, hstmt);
SQLFreeStmt(hstmt, SQL_CLOSE);
return(FALSE);
}
// Obtain columns from the record
if (SQLGetData(hstmt, 1, SQL_C_CHAR, (UCHAR*) structSQLTypeInfo.TypeName, DB_TYPE_NAME_LEN, &cbRet) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
if (SQLGetData(hstmt, 3, SQL_C_LONG, (UCHAR*) &structSQLTypeInfo.Precision, 0, &cbRet) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
if (SQLGetData(hstmt, 8, SQL_C_SHORT, (UCHAR*) &structSQLTypeInfo.CaseSensitive, 0, &cbRet) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
// if (SQLGetData(hstmt, 14, SQL_C_SHORT, (UCHAR*) &structSQLTypeInfo.MinimumScale, 0, &cbRet) != SQL_SUCCESS)
// return(DispAllErrors(henv, hdbc, hstmt));
//#ifdef __UNIX__ // BJO : IODBC knows about 5, not 15...
// if (SQLGetData(hstmt, 5, SQL_C_SHORT,(UCHAR*) &structSQLTypeInfo.MaximumScale, 0, &cbRet) != SQL_SUCCESS)
// return(DispAllErrors(henv, hdbc, hstmt));
//#else
if (SQLGetData(hstmt, 15, SQL_C_SHORT,(UCHAR*) &structSQLTypeInfo.MaximumScale, 0, &cbRet) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
//#endif
if (structSQLTypeInfo.MaximumScale < 0)
structSQLTypeInfo.MaximumScale = 0;
// Close the statement handle which closes open cursors
if (SQLFreeStmt(hstmt, SQL_CLOSE) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
// Completed Successfully
return(TRUE);
} // wxDB::getDataTypeInfo()
/********** wxDB::Close() **********/
void wxDB::Close(void)
{
// Close the Sql Log file
if (fpSqlLog)
{
fclose(fpSqlLog);
fpSqlLog = 0;
}
// Free statement handle
if (dbIsOpen)
{
if (SQLFreeStmt(hstmt, SQL_DROP) != SQL_SUCCESS)
DispAllErrors(henv, hdbc);
}
// Disconnect from the datasource
if (SQLDisconnect(hdbc) != SQL_SUCCESS)
DispAllErrors(henv, hdbc);
// Free the connection to the datasource
if (SQLFreeConnect(hdbc) != SQL_SUCCESS)
DispAllErrors(henv, hdbc);
// There should be zero Ctable objects still connected to this db object
assert(nTables == 0);
#if __WXDEBUG__ > 0
CstructTablesInUse *tiu;
wxNode *pNode;
pNode = TablesInUse.First();
char s[80];
char s2[80];
while (pNode)
{
tiu = (CstructTablesInUse *)pNode->Data();
if (tiu->pDb == this)
{
sprintf(s, "(%-20s) tableID:[%6lu] pDb:[%lu]", tiu->tableName,tiu->tableID,tiu->pDb);
sprintf(s2,"Orphaned found using pDb:[%lu]",this);
wxMessageBox (s,s2);
}
pNode = pNode->Next();
}
#endif
// Copy the error messages to a global variable
for (int i = 0; i < DB_MAX_ERROR_HISTORY; i++)
strcpy(DBerrorList[i],errorList[i]);
} // wxDB::Close()
/********** wxDB::CommitTrans() **********/
bool wxDB::CommitTrans(void)
{
if (this)
{
// Commit the transaction
if (SQLTransact(henv, hdbc, SQL_COMMIT) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
}
// Completed successfully
return(TRUE);
} // wxDB::CommitTrans()
/********** wxDB::RollbackTrans() **********/
bool wxDB::RollbackTrans(void)
{
// Rollback the transaction
if (SQLTransact(henv, hdbc, SQL_ROLLBACK) != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc));
// Completed successfully
return(TRUE);
} // wxDB::RollbackTrans()
/********** wxDB::DispAllErrors() **********/
bool wxDB::DispAllErrors(HENV aHenv, HDBC aHdbc, HSTMT aHstmt)
{
char odbcErrMsg[DB_MAX_ERROR_MSG_LEN];
while (SQLError(aHenv, aHdbc, aHstmt, (UCHAR FAR *) sqlState, &nativeError, (UCHAR FAR *) errorMsg, SQL_MAX_MESSAGE_LENGTH - 1, &cbErrorMsg) == SQL_SUCCESS)
{
sprintf(odbcErrMsg, "SQL State = %s\nNative Error Code = %li\nError Message = %s\n", sqlState, nativeError, errorMsg);
logError(odbcErrMsg, sqlState);
if (!silent)
{
#ifdef DBDEBUG_CONSOLE
// When run in console mode, use standard out to display errors.
cout << odbcErrMsg << endl;
cout << "Press any key to continue..." << endl;
getchar();
#endif
}
#ifdef __WXDEBUG__
wxMessageBox(odbcErrMsg);
#endif
}
return(FALSE); // This function always returns false.
} // wxDB::DispAllErrors()
/********** wxDB::GetNextError() **********/
bool wxDB::GetNextError(HENV aHenv, HDBC aHdbc, HSTMT aHstmt)
{
if (SQLError(aHenv, aHdbc, aHstmt, (UCHAR FAR *) sqlState, &nativeError, (UCHAR FAR *) errorMsg, SQL_MAX_MESSAGE_LENGTH - 1, &cbErrorMsg) == SQL_SUCCESS)
return(TRUE);
else
return(FALSE);
} // wxDB::GetNextError()
/********** wxDB::DispNextError() **********/
void wxDB::DispNextError(void)
{
char odbcErrMsg[DB_MAX_ERROR_MSG_LEN];
sprintf(odbcErrMsg, "SQL State = %s\nNative Error Code = %li\nError Message = %s\n", sqlState, nativeError, errorMsg);
logError(odbcErrMsg, sqlState);
if (silent)
return;
#ifdef DBDEBUG_CONSOLE
// When run in console mode, use standard out to display errors.
cout << odbcErrMsg << endl;
cout << "Press any key to continue..." << endl;
getchar();
#endif
} // wxDB::DispNextError()
/********** wxDB::logError() **********/
void wxDB::logError(char *errMsg, char *SQLState)
{
assert(errMsg && strlen(errMsg));
static int pLast = -1;
int dbStatus;
if (++pLast == DB_MAX_ERROR_HISTORY)
{
int i;
for (i = 0; i < DB_MAX_ERROR_HISTORY; i++)
strcpy(errorList[i], errorList[i+1]);
pLast--;
}
strcpy(errorList[pLast], errMsg);
if (SQLState && strlen(SQLState))
if ((dbStatus = TranslateSqlState(SQLState)) != DB_ERR_FUNCTION_SEQUENCE_ERROR)
DB_STATUS = dbStatus;
// Add the errmsg to the sql log
WriteSqlLog(errMsg);
} // wxDB::logError()
/**********wxDB::TranslateSqlState() **********/
int wxDB::TranslateSqlState(char *SQLState)
{
if (!strcmp(SQLState, "01000"))
return(DB_ERR_GENERAL_WARNING);
if (!strcmp(SQLState, "01002"))
return(DB_ERR_DISCONNECT_ERROR);
if (!strcmp(SQLState, "01004"))
return(DB_ERR_DATA_TRUNCATED);
if (!strcmp(SQLState, "01006"))
return(DB_ERR_PRIV_NOT_REVOKED);
if (!strcmp(SQLState, "01S00"))
return(DB_ERR_INVALID_CONN_STR_ATTR);
if (!strcmp(SQLState, "01S01"))
return(DB_ERR_ERROR_IN_ROW);
if (!strcmp(SQLState, "01S02"))
return(DB_ERR_OPTION_VALUE_CHANGED);
if (!strcmp(SQLState, "01S03"))
return(DB_ERR_NO_ROWS_UPD_OR_DEL);
if (!strcmp(SQLState, "01S04"))
return(DB_ERR_MULTI_ROWS_UPD_OR_DEL);
if (!strcmp(SQLState, "07001"))
return(DB_ERR_WRONG_NO_OF_PARAMS);
if (!strcmp(SQLState, "07006"))
return(DB_ERR_DATA_TYPE_ATTR_VIOL);
if (!strcmp(SQLState, "08001"))
return(DB_ERR_UNABLE_TO_CONNECT);
if (!strcmp(SQLState, "08002"))
return(DB_ERR_CONNECTION_IN_USE);
if (!strcmp(SQLState, "08003"))
return(DB_ERR_CONNECTION_NOT_OPEN);
if (!strcmp(SQLState, "08004"))
return(DB_ERR_REJECTED_CONNECTION);
if (!strcmp(SQLState, "08007"))
return(DB_ERR_CONN_FAIL_IN_TRANS);
if (!strcmp(SQLState, "08S01"))
return(DB_ERR_COMM_LINK_FAILURE);
if (!strcmp(SQLState, "21S01"))
return(DB_ERR_INSERT_VALUE_LIST_MISMATCH);
if (!strcmp(SQLState, "21S02"))
return(DB_ERR_DERIVED_TABLE_MISMATCH);
if (!strcmp(SQLState, "22001"))
return(DB_ERR_STRING_RIGHT_TRUNC);
if (!strcmp(SQLState, "22003"))
return(DB_ERR_NUMERIC_VALUE_OUT_OF_RNG);
if (!strcmp(SQLState, "22005"))
return(DB_ERR_ERROR_IN_ASSIGNMENT);
if (!strcmp(SQLState, "22008"))
return(DB_ERR_DATETIME_FLD_OVERFLOW);
if (!strcmp(SQLState, "22012"))
return(DB_ERR_DIVIDE_BY_ZERO);
if (!strcmp(SQLState, "22026"))
return(DB_ERR_STR_DATA_LENGTH_MISMATCH);
if (!strcmp(SQLState, "23000"))
return(DB_ERR_INTEGRITY_CONSTRAINT_VIOL);
if (!strcmp(SQLState, "24000"))
return(DB_ERR_INVALID_CURSOR_STATE);
if (!strcmp(SQLState, "25000"))
return(DB_ERR_INVALID_TRANS_STATE);
if (!strcmp(SQLState, "28000"))
return(DB_ERR_INVALID_AUTH_SPEC);
if (!strcmp(SQLState, "34000"))
return(DB_ERR_INVALID_CURSOR_NAME);
if (!strcmp(SQLState, "37000"))
return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL);
if (!strcmp(SQLState, "3C000"))
return(DB_ERR_DUPLICATE_CURSOR_NAME);
if (!strcmp(SQLState, "40001"))
return(DB_ERR_SERIALIZATION_FAILURE);
if (!strcmp(SQLState, "42000"))
return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL2);
if (!strcmp(SQLState, "70100"))
return(DB_ERR_OPERATION_ABORTED);
if (!strcmp(SQLState, "IM001"))
return(DB_ERR_UNSUPPORTED_FUNCTION);
if (!strcmp(SQLState, "IM002"))
return(DB_ERR_NO_DATA_SOURCE);
if (!strcmp(SQLState, "IM003"))
return(DB_ERR_DRIVER_LOAD_ERROR);
if (!strcmp(SQLState, "IM004"))
return(DB_ERR_SQLALLOCENV_FAILED);
if (!strcmp(SQLState, "IM005"))
return(DB_ERR_SQLALLOCCONNECT_FAILED);
if (!strcmp(SQLState, "IM006"))
return(DB_ERR_SQLSETCONNECTOPTION_FAILED);
if (!strcmp(SQLState, "IM007"))
return(DB_ERR_NO_DATA_SOURCE_DLG_PROHIB);
if (!strcmp(SQLState, "IM008"))
return(DB_ERR_DIALOG_FAILED);
if (!strcmp(SQLState, "IM009"))
return(DB_ERR_UNABLE_TO_LOAD_TRANSLATION_DLL);
if (!strcmp(SQLState, "IM010"))
return(DB_ERR_DATA_SOURCE_NAME_TOO_LONG);
if (!strcmp(SQLState, "IM011"))
return(DB_ERR_DRIVER_NAME_TOO_LONG);
if (!strcmp(SQLState, "IM012"))
return(DB_ERR_DRIVER_KEYWORD_SYNTAX_ERROR);
if (!strcmp(SQLState, "IM013"))
return(DB_ERR_TRACE_FILE_ERROR);
if (!strcmp(SQLState, "S0001"))
return(DB_ERR_TABLE_OR_VIEW_ALREADY_EXISTS);
if (!strcmp(SQLState, "S0002"))
return(DB_ERR_TABLE_NOT_FOUND);
if (!strcmp(SQLState, "S0011"))
return(DB_ERR_INDEX_ALREADY_EXISTS);
if (!strcmp(SQLState, "S0012"))
return(DB_ERR_INDEX_NOT_FOUND);
if (!strcmp(SQLState, "S0021"))
return(DB_ERR_COLUMN_ALREADY_EXISTS);
if (!strcmp(SQLState, "S0022"))
return(DB_ERR_COLUMN_NOT_FOUND);
if (!strcmp(SQLState, "S0023"))
return(DB_ERR_NO_DEFAULT_FOR_COLUMN);
if (!strcmp(SQLState, "S1000"))
return(DB_ERR_GENERAL_ERROR);
if (!strcmp(SQLState, "S1001"))
return(DB_ERR_MEMORY_ALLOCATION_FAILURE);
if (!strcmp(SQLState, "S1002"))
return(DB_ERR_INVALID_COLUMN_NUMBER);
if (!strcmp(SQLState, "S1003"))
return(DB_ERR_PROGRAM_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1004"))
return(DB_ERR_SQL_DATA_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1008"))
return(DB_ERR_OPERATION_CANCELLED);
if (!strcmp(SQLState, "S1009"))
return(DB_ERR_INVALID_ARGUMENT_VALUE);
if (!strcmp(SQLState, "S1010"))
return(DB_ERR_FUNCTION_SEQUENCE_ERROR);
if (!strcmp(SQLState, "S1011"))
return(DB_ERR_OPERATION_INVALID_AT_THIS_TIME);
if (!strcmp(SQLState, "S1012"))
return(DB_ERR_INVALID_TRANS_OPERATION_CODE);
if (!strcmp(SQLState, "S1015"))
return(DB_ERR_NO_CURSOR_NAME_AVAIL);
if (!strcmp(SQLState, "S1090"))
return(DB_ERR_INVALID_STR_OR_BUF_LEN);
if (!strcmp(SQLState, "S1091"))
return(DB_ERR_DESCRIPTOR_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1092"))
return(DB_ERR_OPTION_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1093"))
return(DB_ERR_INVALID_PARAM_NO);
if (!strcmp(SQLState, "S1094"))
return(DB_ERR_INVALID_SCALE_VALUE);
if (!strcmp(SQLState, "S1095"))
return(DB_ERR_FUNCTION_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1096"))
return(DB_ERR_INF_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1097"))
return(DB_ERR_COLUMN_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1098"))
return(DB_ERR_SCOPE_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1099"))
return(DB_ERR_NULLABLE_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1100"))
return(DB_ERR_UNIQUENESS_OPTION_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1101"))
return(DB_ERR_ACCURACY_OPTION_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1103"))
return(DB_ERR_DIRECTION_OPTION_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1104"))
return(DB_ERR_INVALID_PRECISION_VALUE);
if (!strcmp(SQLState, "S1105"))
return(DB_ERR_INVALID_PARAM_TYPE);
if (!strcmp(SQLState, "S1106"))
return(DB_ERR_FETCH_TYPE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1107"))
return(DB_ERR_ROW_VALUE_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1108"))
return(DB_ERR_CONCURRENCY_OPTION_OUT_OF_RANGE);
if (!strcmp(SQLState, "S1109"))
return(DB_ERR_INVALID_CURSOR_POSITION);
if (!strcmp(SQLState, "S1110"))
return(DB_ERR_INVALID_DRIVER_COMPLETION);
if (!strcmp(SQLState, "S1111"))
return(DB_ERR_INVALID_BOOKMARK_VALUE);
if (!strcmp(SQLState, "S1C00"))
return(DB_ERR_DRIVER_NOT_CAPABLE);
if (!strcmp(SQLState, "S1T00"))
return(DB_ERR_TIMEOUT_EXPIRED);
// No match
return(0);
} // wxDB::TranslateSqlState()
/********** wxDB::Grant() **********/
bool wxDB::Grant(int privileges, char *tableName, char *userList)
{
char sqlStmt[DB_MAX_STATEMENT_LEN];
// Build the grant statement
strcpy(sqlStmt, "GRANT ");
if (privileges == DB_GRANT_ALL)
strcat(sqlStmt, "ALL");
else
{
int c = 0;
if (privileges & DB_GRANT_SELECT)
{
strcat(sqlStmt, "SELECT");
c++;
}
if (privileges & DB_GRANT_INSERT)
{
if (c++)
strcat(sqlStmt, ", ");
strcat(sqlStmt, "INSERT");
}
if (privileges & DB_GRANT_UPDATE)
{
if (c++)
strcat(sqlStmt, ", ");
strcat(sqlStmt, "UPDATE");
}
if (privileges & DB_GRANT_DELETE)
{
if (c++)
strcat(sqlStmt, ", ");
strcat(sqlStmt, "DELETE");
}
}
strcat(sqlStmt, " ON ");
strcat(sqlStmt, tableName);
strcat(sqlStmt, " TO ");
strcat(sqlStmt, userList);
#ifdef DBDEBUG_CONSOLE
cout << endl << sqlStmt << endl;
#endif
WriteSqlLog(sqlStmt);
return(ExecSql(sqlStmt));
} // wxDB::Grant()
/********** wxDB::CreateView() **********/
bool wxDB::CreateView(char *viewName, char *colList, char *pSqlStmt, bool attemptDrop)
{
char sqlStmt[DB_MAX_STATEMENT_LEN];
// Drop the view first
if (attemptDrop && !DropView(viewName))
return FALSE;
// Build the create view statement
strcpy(sqlStmt, "CREATE VIEW ");
strcat(sqlStmt, viewName);
if (strlen(colList))
{
strcat(sqlStmt, " (");
strcat(sqlStmt, colList);
strcat(sqlStmt, ")");
}
strcat(sqlStmt, " AS ");
strcat(sqlStmt, pSqlStmt);
WriteSqlLog(sqlStmt);
#ifdef DBDEBUG_CONSOLE
cout << sqlStmt << endl;
#endif
return(ExecSql(sqlStmt));
} // wxDB::CreateView()
/********** wxDB::DropView() **********/
bool wxDB::DropView(char *viewName)
{
// NOTE: This function returns TRUE if the View does not exist, but
// only for identified databases. Code will need to be added
// below for any other databases when those databases are defined
// to handle this situation consistently
char sqlStmt[DB_MAX_STATEMENT_LEN];
sprintf(sqlStmt, "DROP VIEW %s", viewName);
WriteSqlLog(sqlStmt);
#ifdef DBDEBUG_CONSOLE
cout << endl << sqlStmt << endl;
#endif
if (SQLExecDirect(hstmt, (UCHAR FAR *) sqlStmt, SQL_NTS) != SQL_SUCCESS)
{
// Check for "Base table not found" error and ignore
GetNextError(henv, hdbc, hstmt);
if (strcmp(sqlState,"S0002")) // "Base table not found"
{
// Check for product specific error codes
if (!((Dbms() == dbmsSYBASE_ASA && !strcmp(sqlState,"42000")))) // 5.x (and lower?)
{
DispNextError();
DispAllErrors(henv, hdbc, hstmt);
RollbackTrans();
return(FALSE);
}
}
}
// Commit the transaction
if (! CommitTrans())
return(FALSE);
return TRUE;
} // wxDB::DropView()
/********** wxDB::ExecSql() **********/
bool wxDB::ExecSql(char *pSqlStmt)
{
SQLFreeStmt(hstmt, SQL_CLOSE);
if (SQLExecDirect(hstmt, (UCHAR FAR *) pSqlStmt, SQL_NTS) == SQL_SUCCESS)
return(TRUE);
else
{
DispAllErrors(henv, hdbc, hstmt);
return(FALSE);
}
} // wxDB::ExecSql()
/********** wxDB::GetNext() **********/
bool wxDB::GetNext(void)
{
if (SQLFetch(hstmt) == SQL_SUCCESS)
return(TRUE);
else
{
DispAllErrors(henv, hdbc, hstmt);
return(FALSE);
}
} // wxDB::GetNext()
/********** wxDB::GetData() **********/
bool wxDB::GetData(UWORD colNo, SWORD cType, PTR pData, SDWORD maxLen, SDWORD FAR *cbReturned)
{
assert(pData);
assert(cbReturned);
if (SQLGetData(hstmt, colNo, cType, pData, maxLen, cbReturned) == SQL_SUCCESS)
return(TRUE);
else
{
DispAllErrors(henv, hdbc, hstmt);
return(FALSE);
}
} // wxDB::GetData()
/********** wxDB::GetColumns() **********/
/*
* 1) The last array element of the tableName[] argument must be zero (null).
* This is how the end of the array is detected.
* 2) This function returns an array of CcolInf structures. If no columns
* were found, or an error occured, this pointer will be zero (null). THE
* CALLING FUNCTION IS RESPONSIBLE FOR DELETING THE MEMORY RETURNED WHEN IT
* IS FINISHED WITH IT. i.e.
*
* CcolInf *colInf = pDb->GetColumns(tableList, userID);
* if (colInf)
* {
* // Use the column inf
* .......
* // Destroy the memory
* delete [] colInf;
* }
*/
CcolInf *wxDB::GetColumns(char *tableName[], char *userID)
{
UINT noCols = 0;
UINT colNo = 0;
CcolInf *colInf = 0;
RETCODE retcode;
SDWORD cb;
char tblName[DB_MAX_TABLE_NAME_LEN+1];
char colName[DB_MAX_COLUMN_NAME_LEN+1];
SWORD sqlDataType;
char userIdUC[80+1];
char tableNameUC[DB_MAX_TABLE_NAME_LEN+1];
if (!userID || !strlen(userID))
userID = uid;
// dBase does not use user names, and some drivers fail if you try to pass one
if (Dbms() == dbmsDBASE)
userID = "";
// Oracle user names may only be in uppercase, so force
// the name to uppercase
if (Dbms() == dbmsORACLE)
{
int i = 0;
for (char *p = userID; *p; p++)
userIdUC[i++] = toupper(*p);
userIdUC[i] = 0;
userID = userIdUC;
}
// Pass 1 - Determine how many columns there are.
// Pass 2 - Allocate the CcolInf array and fill in
// the array with the column information.
int pass;
for (pass = 1; pass <= 2; pass++)
{
if (pass == 2)
{
if (noCols == 0) // Probably a bogus table name(s)
break;
// Allocate n CcolInf objects to hold the column information
colInf = new CcolInf[noCols+1];
if (!colInf)
break;
// Mark the end of the array
strcpy(colInf[noCols].tableName, "");
strcpy(colInf[noCols].colName, "");
colInf[noCols].sqlDataType = 0;
}
// Loop through each table name
int tbl;
for (tbl = 0; tableName[tbl]; tbl++)
{
// Oracle table names are uppercase only, so force
// the name to uppercase just in case programmer forgot to do this
if (Dbms() == dbmsORACLE)
{
int i = 0;
for (char *p = tableName[tbl]; *p; p++)
tableNameUC[i++] = toupper(*p);
tableNameUC[i] = 0;
}
else
sprintf(tableNameUC,tableName[tbl]);
SQLFreeStmt(hstmt, SQL_CLOSE);
// MySQL and Access cannot accept a user name when looking up column names, so we
// use the call below that leaves out the user name
if (strcmp(userID,"") &&
Dbms() != dbmsMY_SQL &&
Dbms() != dbmsACCESS)
{
retcode = SQLColumns(hstmt,
NULL, 0, // All qualifiers
(UCHAR *) userID, SQL_NTS, // Owner
(UCHAR *) tableNameUC, SQL_NTS,
NULL, 0); // All columns
}
else
{
retcode = SQLColumns(hstmt,
NULL, 0, // All qualifiers
NULL, 0, // Owner
(UCHAR *) tableNameUC, SQL_NTS,
NULL, 0); // All columns
}
if (retcode != SQL_SUCCESS)
{ // Error occured, abort
DispAllErrors(henv, hdbc, hstmt);
if (colInf)
delete [] colInf;
SQLFreeStmt(hstmt, SQL_UNBIND);
SQLFreeStmt(hstmt, SQL_CLOSE);
return(0);
}
SQLBindCol(hstmt, 3, SQL_C_CHAR, (UCHAR*) tblName, DB_MAX_TABLE_NAME_LEN+1, &cb);
SQLBindCol(hstmt, 4, SQL_C_CHAR, (UCHAR*) colName, DB_MAX_COLUMN_NAME_LEN+1, &cb);
SQLBindCol(hstmt, 5, SQL_C_SSHORT, (UCHAR*) &sqlDataType, 0, &cb);
while ((retcode = SQLFetch(hstmt)) == SQL_SUCCESS)
{
if (pass == 1) // First pass, just add up the number of columns
noCols++;
else // Pass 2; Fill in the array of structures
{
if (colNo < noCols) // Some extra error checking to prevent memory overwrites
{
strcpy(colInf[colNo].tableName, tblName);
strcpy(colInf[colNo].colName, colName);
colInf[colNo].sqlDataType = sqlDataType;
colNo++;
}
}
}
if (retcode != SQL_NO_DATA_FOUND)
{ // Error occured, abort
DispAllErrors(henv, hdbc, hstmt);
if (colInf)
delete [] colInf;
SQLFreeStmt(hstmt, SQL_UNBIND);
SQLFreeStmt(hstmt, SQL_CLOSE);
return(0);
}
}
}
SQLFreeStmt(hstmt, SQL_UNBIND);
SQLFreeStmt(hstmt, SQL_CLOSE);
return colInf;
} // wxDB::GetColumns()
/********** wxDB::Catalog() **********/
bool wxDB::Catalog(char *userID, char *fileName)
{
assert(fileName && strlen(fileName));
RETCODE retcode;
SDWORD cb;
char tblName[DB_MAX_TABLE_NAME_LEN+1];
char tblNameSave[DB_MAX_TABLE_NAME_LEN+1];
char colName[DB_MAX_COLUMN_NAME_LEN+1];
SWORD sqlDataType;
char typeName[30+1];
SWORD precision, length;
FILE *fp = fopen(fileName,"wt");
if (fp == NULL)
return(FALSE);
SQLFreeStmt(hstmt, SQL_CLOSE);
if (!userID || !strlen(userID))
userID = uid;
char userIdUC[80+1];
// Oracle user names may only be in uppercase, so force
// the name to uppercase
if (Dbms() == dbmsORACLE)
{
int i = 0;
for (char *p = userID; *p; p++)
userIdUC[i++] = toupper(*p);
userIdUC[i] = 0;
userID = userIdUC;
}
if (strcmp(userID,""))
{
retcode = SQLColumns(hstmt,
NULL, 0, // All qualifiers
(UCHAR *) userID, SQL_NTS, // User specified
NULL, 0, // All tables
NULL, 0); // All columns
}
else
{
retcode = SQLColumns(hstmt,
NULL, 0, // All qualifiers
NULL, 0, // User specified
NULL, 0, // All tables
NULL, 0); // All columns
}
if (retcode != SQL_SUCCESS)
{
DispAllErrors(henv, hdbc, hstmt);
fclose(fp);
return(FALSE);
}
SQLBindCol(hstmt, 3, SQL_C_CHAR, (UCHAR*) tblName, DB_MAX_TABLE_NAME_LEN+1, &cb);
SQLBindCol(hstmt, 4, SQL_C_CHAR, (UCHAR*) colName, DB_MAX_COLUMN_NAME_LEN+1, &cb);
SQLBindCol(hstmt, 5, SQL_C_SSHORT, (UCHAR*) &sqlDataType, 0, &cb);
SQLBindCol(hstmt, 6, SQL_C_CHAR, (UCHAR*) typeName, sizeof(typeName), &cb);
SQLBindCol(hstmt, 7, SQL_C_SSHORT, (UCHAR*) &precision, 0, &cb);
SQLBindCol(hstmt, 8, SQL_C_SSHORT, (UCHAR*) &length, 0, &cb);
char outStr[256];
strcpy(tblNameSave,"");
int cnt = 0;
while ((retcode = SQLFetch(hstmt)) == SQL_SUCCESS)
{
if (strcmp(tblName,tblNameSave))
{
if (cnt)
fputs("\n", fp);
fputs("================================ ", fp);
fputs("================================ ", fp);
fputs("===================== ", fp);
fputs("========= ", fp);
fputs("=========\n", fp);
sprintf(outStr, "%-32s %-32s %-21s %9s %9s\n",
"TABLE NAME", "COLUMN NAME", "DATA TYPE", "PRECISION", "LENGTH");
fputs(outStr, fp);
fputs("================================ ", fp);
fputs("================================ ", fp);
fputs("===================== ", fp);
fputs("========= ", fp);
fputs("=========\n", fp);
strcpy(tblNameSave,tblName);
}
sprintf(outStr, "%-32s %-32s (%04d)%-15s %9d %9d\n",
tblName, colName, sqlDataType, typeName, precision, length);
if (fputs(outStr, fp) == EOF)
{
SQLFreeStmt(hstmt, SQL_UNBIND);
SQLFreeStmt(hstmt, SQL_CLOSE);
fclose(fp);
return(FALSE);
}
cnt++;
}
if (retcode != SQL_NO_DATA_FOUND)
DispAllErrors(henv, hdbc, hstmt);
SQLFreeStmt(hstmt, SQL_UNBIND);
SQLFreeStmt(hstmt, SQL_CLOSE);
fclose(fp);
return(retcode == SQL_NO_DATA_FOUND);
} // wxDB::Catalog()
// Table name can refer to a table, view, alias or synonym. Returns true
// if the object exists in the database. This function does not indicate
// whether or not the user has privleges to query or perform other functions
// on the table.
bool wxDB::TableExists(char *tableName, char *userID, char *tablePath)
{
assert(tableName && strlen(tableName));
if (Dbms() == dbmsDBASE)
{
wxString dbName;
if (tablePath && strlen(tablePath))
dbName.sprintf("%s/%s.dbf",tablePath,tableName);
else
dbName.sprintf("%s.dbf",tableName);
bool glt;
glt = wxFileExists(dbName.GetData());
return glt;
}
if (!userID || !strlen(userID))
userID = uid;
char userIdUC[80+1];
// Oracle user names may only be in uppercase, so force
// the name to uppercase
if (Dbms() == dbmsORACLE)
{
int i = 0;
for (char *p = userID; *p; p++)
userIdUC[i++] = toupper(*p);
userIdUC[i] = 0;
userID = userIdUC;
}
char tableNameUC[DB_MAX_TABLE_NAME_LEN+1];
// Oracle table names are uppercase only, so force
// the name to uppercase just in case programmer forgot to do this
if (Dbms() == dbmsORACLE)
{
int i = 0;
for (char *p = tableName; *p; p++)
tableNameUC[i++] = toupper(*p);
tableNameUC[i] = 0;
}
else
sprintf(tableNameUC,tableName);
SQLFreeStmt(hstmt, SQL_CLOSE);
RETCODE retcode;
// MySQL and Access cannot accept a user name when looking up table names, so we
// use the call below that leaves out the user name
if (strcmp(userID,"") &&
Dbms() != dbmsMY_SQL &&
Dbms() != dbmsACCESS)
{
retcode = SQLTables(hstmt,
NULL, 0, // All qualifiers
(UCHAR *) userID, SQL_NTS, // All owners
(UCHAR FAR *)tableNameUC, SQL_NTS,
NULL, 0); // All table types
}
else
{
retcode = SQLTables(hstmt,
NULL, 0, // All qualifiers
NULL, 0, // All owners
(UCHAR FAR *)tableNameUC, SQL_NTS,
NULL, 0); // All table types
}
if (retcode != SQL_SUCCESS)
return(DispAllErrors(henv, hdbc, hstmt));
retcode = SQLFetch(hstmt);
if (retcode != SQL_SUCCESS && retcode != SQL_SUCCESS_WITH_INFO)
{
SQLFreeStmt(hstmt, SQL_CLOSE);
return(DispAllErrors(henv, hdbc, hstmt));
}
SQLFreeStmt(hstmt, SQL_CLOSE);
return(TRUE);
} // wxDB::TableExists()
/********** wxDB::SqlLog() **********/
bool wxDB::SqlLog(enum sqlLog state, char *filename, bool append)
{
assert(state == sqlLogON || state == sqlLogOFF);
assert(state == sqlLogOFF || filename);
if (state == sqlLogON)
{
if (fpSqlLog == 0)
{
fpSqlLog = fopen(filename, (append ? "at" : "wt"));
if (fpSqlLog == NULL)
return(FALSE);
}
}
else // sqlLogOFF
{
if (fpSqlLog)
{
if (fclose(fpSqlLog))
return(FALSE);
fpSqlLog = 0;
}
}
sqlLogState = state;
return(TRUE);
} // wxDB::SqlLog()
/********** wxDB::WriteSqlLog() **********/
bool wxDB::WriteSqlLog(char *logMsg)
{
assert(logMsg);
if (fpSqlLog == 0 || sqlLogState == sqlLogOFF)
return(FALSE);
if (fputs("\n", fpSqlLog) == EOF) return(FALSE);
if (fputs(logMsg, fpSqlLog) == EOF) return(FALSE);
if (fputs("\n", fpSqlLog) == EOF) return(FALSE);
return(TRUE);
} // wxDB::WriteSqlLog()
/********** wxDB::Dbms() **********/
/*
* Be aware that not all database engines use the exact same syntax, and not
* every ODBC compliant database is compliant to the same level of compliancy.
* Some manufacturers support the minimum Level 1 compliancy, and others up
* through Level 3. Others support subsets of features for levels above 1.
*
* If you find an inconsistency between the wxDB class and a specific database
* engine, and an identifier to this section, and special handle the database in
* the area where behavior is non-conforming with the other databases.
*
*
* NOTES ABOUT ISSUES SPECIFIC TO EACH DATABASE ENGINE
* ---------------------------------------------------
*
* ORACLE
* - Currently the only database supported by the class to support VIEWS
*
* DBASE
* - Does not support the SQL_TIMESTAMP structure
* - Supports only one cursor and one connect (apparently? with Microsoft driver only?)
* - Does not automatically create the primary index if the 'keyField' param of SetColDef
* is TRUE. The user must create ALL indexes from their program.
* - Table names can only be 8 characters long
* - Column names can only be 10 characters long
*
* SYBASE (all)
* - To lock a record during QUERY functions, the reserved word 'HOLDLOCK' must be added
* after every table name involved in the query/join if that tables matching record(s)
* are to be locked
* - Ignores the keywords 'FOR UPDATE'. Use the HOLDLOCK functionality described above
*
* SYBASE (Enterprise)
* - If a column is part of the Primary Key, the column cannot be NULL
*
* MY_SQL
* - If a column is part of the Primary Key, the column cannot be NULL
* - Cannot support selecting for update [::CanSelectForUpdate()]. Always returns FALSE
*
* POSTGRES
* - Does not support the keywords 'ASC' or 'DESC' as of release v6.5.0
*
*
*/
DBMS wxDB::Dbms(void)
{
if (!strnicmp(dbInf.dbmsName,"Oracle",6))
return(dbmsORACLE);
if (!stricmp(dbInf.dbmsName,"Adaptive Server Anywhere"))
return(dbmsSYBASE_ASA);
if (!stricmp(dbInf.dbmsName,"SQL Server")) // Sybase Adaptive Server Enterprise
return(dbmsSYBASE_ASE);
if (!stricmp(dbInf.dbmsName,"Microsoft SQL Server"))
return(dbmsMS_SQL_SERVER);
if (!stricmp(dbInf.dbmsName,"MySQL"))
return(dbmsMY_SQL);
if (!stricmp(dbInf.dbmsName,"PostgresSQL")) // v6.5.0
return(dbmsPOSTGRES);
if (!stricmp(dbInf.dbmsName,"ACCESS"))
return(dbmsACCESS);
if (!strnicmp(dbInf.dbmsName,"DBASE",5))
return(dbmsDBASE);
return(dbmsUNIDENTIFIED);
} // wxDB::Dbms()
/********** GetDbConnection() **********/
wxDB* WXDLLEXPORT GetDbConnection(DbStuff *pDbStuff)
{
DbList *pList;
// Scan the linked list searching for an available database connection
// that's already been opened but is currently not in use.
for (pList = PtrBegDbList; pList; pList = pList->PtrNext)
{
// The database connection must be for the same datasource
// name and must currently not be in use.
if (pList->Free && (! strcmp(pDbStuff->Dsn, pList->Dsn))) // Found a free connection
{
pList->Free = FALSE;
return(pList->PtrDb);
}
}
// No available connections. A new connection must be made and
// appended to the end of the linked list.
if (PtrBegDbList)
{
// Find the end of the list
for (pList = PtrBegDbList; pList->PtrNext; pList = pList->PtrNext);
// Append a new list item
pList->PtrNext = new DbList;
pList->PtrNext->PtrPrev = pList;
pList = pList->PtrNext;
}
else // Empty list
{
// Create the first node on the list
pList = PtrBegDbList = new DbList;
pList->PtrPrev = 0;
}
// Initialize new node in the linked list
pList->PtrNext = 0;
pList->Free = FALSE;
strcpy(pList->Dsn, pDbStuff->Dsn);
pList->PtrDb = new wxDB(pDbStuff->Henv);
// Connect to the datasource
if (pList->PtrDb->Open(pDbStuff->Dsn, pDbStuff->Uid, pDbStuff->AuthStr))
{
pList->PtrDb->SqlLog(SQLLOGstate,SQLLOGfn,TRUE);
return(pList->PtrDb);
}
else // Unable to connect, destroy list item
{
if (pList->PtrPrev)
pList->PtrPrev->PtrNext = 0;
else
PtrBegDbList = 0; // Empty list again
pList->PtrDb->CommitTrans(); // Commit any open transactions on wxDB object
pList->PtrDb->Close(); // Close the wxDB object
delete pList->PtrDb; // Deletes the wxDB object
delete pList; // Deletes the linked list object
return(0);
}
} // GetDbConnection()
/********** FreeDbConnection() **********/
bool WXDLLEXPORT FreeDbConnection(wxDB *pDb)
{
DbList *pList;
// Scan the linked list searching for the database connection
for (pList = PtrBegDbList; pList; pList = pList->PtrNext)
{
if (pList->PtrDb == pDb) // Found it!!!
return(pList->Free = TRUE);
}
// Never found the database object, return failure
return(FALSE);
} // FreeDbConnection()
/********** CloseDbConnections() **********/
void WXDLLEXPORT CloseDbConnections(void)
{
DbList *pList, *pNext;
// Traverse the linked list closing database connections and freeing memory as I go.
for (pList = PtrBegDbList; pList; pList = pNext)
{
pNext = pList->PtrNext; // Save the pointer to next
pList->PtrDb->CommitTrans(); // Commit any open transactions on wxDB object
pList->PtrDb->Close(); // Close the wxDB object
delete pList->PtrDb; // Deletes the wxDB object
delete pList; // Deletes the linked list object
}
// Mark the list as empty
PtrBegDbList = 0;
} // CloseDbConnections()
/********** NumberDbConnectionsInUse() **********/
int WXDLLEXPORT NumberDbConnectionsInUse(void)
{
DbList *pList;
int cnt = 0;
// Scan the linked list counting db connections that are currently in use
for (pList = PtrBegDbList; pList; pList = pList->PtrNext)
{
if (pList->Free == FALSE)
cnt++;
}
return(cnt);
} // NumberDbConnectionsInUse()
/********** SqlLog() **********/
bool SqlLog(enum sqlLog state, char *filename)
{
bool append = FALSE;
DbList *pList;
for (pList = PtrBegDbList; pList; pList = pList->PtrNext)
{
if (!pList->PtrDb->SqlLog(state,filename,append))
return(FALSE);
append = TRUE;
}
SQLLOGstate = state;
strcpy(SQLLOGfn,filename);
return(TRUE);
} // SqlLog()
/********** GetDataSource() **********/
bool GetDataSource(HENV henv, char *Dsn, SWORD DsnMax, char *DsDesc, SWORD DsDescMax,
UWORD direction)
{
SWORD cb;
if (SQLDataSources(henv, direction, (UCHAR FAR *) Dsn, DsnMax, &cb,
(UCHAR FAR *) DsDesc, DsDescMax, &cb) == SQL_SUCCESS)
return(TRUE);
else
return(FALSE);
} // GetDataSource()
#endif
// wxUSE_ODBC