1 ///////////////////////////////////////////////////////////////////////////////
3 // Purpose: Implementation of the wxDb class. The wxDb class represents a connection
4 // to an ODBC data source. The wxDb class allows operations on the data
5 // source such as opening and closing the data source.
7 // Modified by: George Tasker
9 // Mark Johnson, wxWindows@mj10777.de
11 // -Added support for SQL statement logging and database cataloging
13 // -Added QUERY_ONLY mode support to reduce default number of cursors
14 // -Added additional SQL logging code
15 // -Added DEBUG-ONLY tracking of wxTable objects to detect orphaned DB connections
16 // -Set ODBC option to only read committed writes to the DB so all
17 // databases operate the same in that respect
20 // Copyright: (c) 1996 Remstar International, Inc.
21 // Licence: wxWindows licence, plus:
22 // Notice: This class library and its intellectual design are free of charge for use,
23 // modification, enhancement, debugging under the following conditions:
24 // 1) These classes may only be used as part of the implementation of a
25 // wxWindows-based application
26 // 2) All enhancements and bug fixes are to be submitted back to the wxWindows
27 // user groups free of all charges for use with the wxWindows library.
28 // 3) These classes may not be distributed as part of any other class library,
29 // DLL, text (written or electronic), other than a complete distribution of
30 // the wxWindows GUI development toolkit.
31 ///////////////////////////////////////////////////////////////////////////////
38 #pragma implementation "db.h"
41 #include "wx/wxprec.h"
47 #ifdef DBDEBUG_CONSOLE
48 #include "wx/ioswrap.h"
52 #include "wx/string.h"
53 #include "wx/object.h"
57 #include "wx/msgdlg.h"
61 #include "wx/filefn.h"
62 #include "wx/wxchar.h"
74 WXDLLEXPORT_DATA(wxDbList
*) PtrBegDbList
= 0;
77 wxChar
const *SQL_LOG_FILENAME
= wxT("sqllog.txt");
78 wxChar
const *SQL_CATALOG_FILENAME
= wxT("catalog.txt");
81 extern wxList TablesInUse
;
84 // SQL Log defaults to be used by GetDbConnection
85 wxDbSqlLogState SQLLOGstate
= sqlLogOFF
;
87 static wxString SQLLOGfn
= SQL_LOG_FILENAME
;
89 // The wxDb::errorList is copied to this variable when the wxDb object
90 // is closed. This way, the error list is still available after the
91 // database object is closed. This is necessary if the database
92 // connection fails so the calling application can show the operator
93 // why the connection failed. Note: as each wxDb object is closed, it
94 // will overwrite the errors of the previously destroyed wxDb object in
95 // this variable. NOTE: This occurs during a CLOSE, not a FREEing of the
97 wxChar DBerrorList
[DB_MAX_ERROR_HISTORY
][DB_MAX_ERROR_MSG_LEN
];
100 // This type defines the return row-struct form
101 // SQLTablePrivileges, and is used by wxDB::TablePrivileges.
104 wxChar tableQual
[128+1];
105 wxChar tableOwner
[128+1];
106 wxChar tableName
[128+1];
107 wxChar grantor
[128+1];
108 wxChar grantee
[128+1];
109 wxChar privilege
[128+1];
110 wxChar grantable
[3+1];
111 } wxDbTablePrivilegeInfo
;
114 /********** wxDbConnectInf Constructor - form 1 **********/
115 wxDbConnectInf::wxDbConnectInf()
118 freeHenvOnDestroy
= FALSE
;
124 /********** wxDbConnectInf Constructor - form 2 **********/
125 wxDbConnectInf::wxDbConnectInf(HENV henv
, const wxString
&dsn
, const wxString
&userID
,
126 const wxString
&password
, const wxString
&defaultDir
,
127 const wxString
&fileType
, const wxString
&description
)
130 freeHenvOnDestroy
= FALSE
;
141 SetPassword(password
);
142 SetDescription(description
);
143 SetFileType(fileType
);
144 SetDefaultDir(defaultDir
);
145 } // wxDbConnectInf Constructor
148 wxDbConnectInf::~wxDbConnectInf()
150 if (freeHenvOnDestroy
)
154 } // wxDbConnectInf Destructor
158 /********** wxDbConnectInf::Initialize() **********/
159 bool wxDbConnectInf::Initialize()
161 freeHenvOnDestroy
= FALSE
;
163 if (freeHenvOnDestroy
&& Henv
)
175 } // wxDbConnectInf::Initialize()
178 /********** wxDbConnectInf::AllocHenv() **********/
179 bool wxDbConnectInf::AllocHenv()
181 // This is here to help trap if you are getting a new henv
182 // without releasing an existing henv
185 // Initialize the ODBC Environment for Database Operations
186 if (SQLAllocEnv(&Henv
) != SQL_SUCCESS
)
188 wxLogDebug(wxT("A problem occured while trying to get a connection to the data source"));
192 freeHenvOnDestroy
= TRUE
;
195 } // wxDbConnectInf::AllocHenv()
198 void wxDbConnectInf::FreeHenv()
206 freeHenvOnDestroy
= FALSE
;
208 } // wxDbConnectInf::FreeHenv()
211 void wxDbConnectInf::SetDsn(const wxString
&dsn
)
213 wxASSERT(dsn
.Length() < sizeof(Dsn
));
216 } // wxDbConnectInf::SetDsn()
219 void wxDbConnectInf::SetUserID(const wxString
&uid
)
221 wxASSERT(uid
.Length() < sizeof(Uid
));
223 } // wxDbConnectInf::SetUserID()
226 void wxDbConnectInf::SetPassword(const wxString
&password
)
228 wxASSERT(password
.Length() < sizeof(AuthStr
));
230 wxStrcpy(AuthStr
,password
);
231 } // wxDbConnectInf::SetPassword()
235 /********** wxDbColFor Constructor **********/
236 wxDbColFor::wxDbColFor()
239 } // wxDbColFor::wxDbColFor()
242 wxDbColFor::~wxDbColFor()
244 } // wxDbColFor::~wxDbColFor()
247 /********** wxDbColFor::Initialize() **********/
248 void wxDbColFor::Initialize()
258 i_Nation
= 0; // 0=EU, 1=UK, 2=International, 3=US
261 Format(1,DB_DATA_TYPE_VARCHAR
,0,0,0); // the Function that does the work
262 } // wxDbColFor::Initialize()
265 /********** wxDbColFor::Format() **********/
266 int wxDbColFor::Format(int Nation
, int dbDataType
, SWORD sqlDataType
,
267 short columnSize
, short decimalDigits
)
269 // ----------------------------------------------------------------------------------------
270 // -- 19991224 : mj10777 : Create
271 // There is still a lot of work to do here, but it is a start
272 // It handles all the basic data-types that I have run into up to now
273 // The main work will have be with Dates and float Formatting
274 // (US 1,000.00 ; EU 1.000,00)
275 // There are wxWindow plans for locale support and the new wxDateTime. If
276 // they define some constants (wxEUROPEAN) that can be gloably used,
277 // they should be used here.
278 // ----------------------------------------------------------------------------------------
279 // There should also be a function to scan in a string to fill the variable
280 // ----------------------------------------------------------------------------------------
282 i_Nation
= Nation
; // 0 = timestamp , 1=EU, 2=UK, 3=International, 4=US
283 i_dbDataType
= dbDataType
;
284 i_sqlDataType
= sqlDataType
;
285 s_Field
.Printf(wxT("%s%d"),s_Amount
[1].c_str(),i_Amount
[1]); // OK for VARCHAR, INTEGER and FLOAT
287 if (i_dbDataType
== 0) // Filter unsupported dbDataTypes
289 if ((i_sqlDataType
== SQL_VARCHAR
) || (i_sqlDataType
== SQL_LONGVARCHAR
))
290 i_dbDataType
= DB_DATA_TYPE_VARCHAR
;
291 if ((i_sqlDataType
== SQL_C_DATE
) || (i_sqlDataType
== SQL_C_TIMESTAMP
))
292 i_dbDataType
= DB_DATA_TYPE_DATE
;
293 if (i_sqlDataType
== SQL_C_BIT
)
294 i_dbDataType
= DB_DATA_TYPE_INTEGER
;
295 if (i_sqlDataType
== SQL_NUMERIC
)
296 i_dbDataType
= DB_DATA_TYPE_VARCHAR
;
297 if (i_sqlDataType
== SQL_REAL
)
298 i_dbDataType
= DB_DATA_TYPE_FLOAT
;
299 if (i_sqlDataType
== SQL_C_BINARY
)
300 i_dbDataType
= DB_DATA_TYPE_BLOB
;
303 if ((i_dbDataType
== DB_DATA_TYPE_INTEGER
) && (i_sqlDataType
== SQL_C_DOUBLE
))
305 i_dbDataType
= DB_DATA_TYPE_FLOAT
;
308 switch(i_dbDataType
) // TBD: Still a lot of proper formatting to do
310 case DB_DATA_TYPE_VARCHAR
:
313 case DB_DATA_TYPE_INTEGER
:
316 case DB_DATA_TYPE_FLOAT
:
317 if (decimalDigits
== 0)
320 tempStr
.Printf(wxT("%s%d.%d"),tempStr
.c_str(),columnSize
,decimalDigits
);
321 s_Field
.Printf(wxT("%sf"),tempStr
.c_str());
323 case DB_DATA_TYPE_DATE
:
324 if (i_Nation
== 0) // timestamp YYYY-MM-DD HH:MM:SS.SSS (tested for SYBASE)
326 s_Field
= wxT("%04d-%02d-%02d %02d:%02d:%02d.%03d");
328 if (i_Nation
== 1) // European DD.MM.YYYY HH:MM:SS.SSS
330 s_Field
= wxT("%02d.%02d.%04d %02d:%02d:%02d.%03d");
332 if (i_Nation
== 2) // UK DD/MM/YYYY HH:MM:SS.SSS
334 s_Field
= wxT("%02d/%02d/%04d %02d:%02d:%02d.%03d");
336 if (i_Nation
== 3) // International YYYY-MM-DD HH:MM:SS.SSS
338 s_Field
= wxT("%04d-%02d-%02d %02d:%02d:%02d.%03d");
340 if (i_Nation
== 4) // US MM/DD/YYYY HH:MM:SS.SSS
342 s_Field
= wxT("%02d/%02d/%04d %02d:%02d:%02d.%03d");
345 case DB_DATA_TYPE_BLOB
:
346 s_Field
.Printf(wxT("Unable to format(%d)-SQL(%d)"),dbDataType
,sqlDataType
); //
349 s_Field
.Printf(wxT("Unknown Format(%d)-SQL(%d)"),dbDataType
,sqlDataType
); //
353 } // wxDbColFor::Format()
357 /********** wxDbColInf Constructor **********/
358 wxDbColInf::wxDbColInf()
361 } // wxDbColInf::wxDbColInf()
364 /********** wxDbColInf Destructor ********/
365 wxDbColInf::~wxDbColInf()
370 } // wxDbColInf::~wxDbColInf()
373 bool wxDbColInf::Initialize()
395 } // wxDbColInf::Initialize()
398 /********** wxDbTableInf Constructor ********/
399 wxDbTableInf::wxDbTableInf()
402 } // wxDbTableInf::wxDbTableInf()
405 /********** wxDbTableInf Constructor ********/
406 wxDbTableInf::~wxDbTableInf()
411 } // wxDbTableInf::~wxDbTableInf()
414 bool wxDbTableInf::Initialize()
423 } // wxDbTableInf::Initialize()
426 /********** wxDbInf Constructor *************/
430 } // wxDbInf::wxDbInf()
433 /********** wxDbInf Destructor *************/
439 } // wxDbInf::~wxDbInf()
442 /********** wxDbInf::Initialize() *************/
443 bool wxDbInf::Initialize()
451 } // wxDbInf::Initialize()
454 /********** wxDb Constructor **********/
455 wxDb::wxDb(const HENV
&aHenv
, bool FwdOnlyCursors
)
457 // Copy the HENV into the db class
459 fwdOnlyCursors
= FwdOnlyCursors
;
465 /********** wxDb Destructor **********/
468 wxASSERT_MSG(!IsCached(),wxT("Cached connections must not be manually deleted, use\nwxDbFreeConnection() or wxDbCloseConnections()."));
478 /********** PRIVATE! wxDb::initialize PRIVATE! **********/
479 /********** wxDb::initialize() **********/
480 void wxDb::initialize()
482 * Private member function that sets all wxDb member variables to
483 * known values at creation of the wxDb
488 fpSqlLog
= 0; // Sql Log file pointer
489 sqlLogState
= sqlLogOFF
; // By default, logging is turned off
491 dbmsType
= dbmsUNIDENTIFIED
;
493 wxStrcpy(sqlState
,wxEmptyString
);
494 wxStrcpy(errorMsg
,wxEmptyString
);
495 nativeError
= cbErrorMsg
= 0;
496 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
497 wxStrcpy(errorList
[i
], wxEmptyString
);
499 // Init typeInf structures
500 typeInfVarchar
.TypeName
.Empty();
501 typeInfVarchar
.FsqlType
= 0;
502 typeInfVarchar
.Precision
= 0;
503 typeInfVarchar
.CaseSensitive
= 0;
504 typeInfVarchar
.MaximumScale
= 0;
506 typeInfInteger
.TypeName
.Empty();
507 typeInfInteger
.FsqlType
= 0;
508 typeInfInteger
.Precision
= 0;
509 typeInfInteger
.CaseSensitive
= 0;
510 typeInfInteger
.MaximumScale
= 0;
512 typeInfFloat
.TypeName
.Empty();
513 typeInfFloat
.FsqlType
= 0;
514 typeInfFloat
.Precision
= 0;
515 typeInfFloat
.CaseSensitive
= 0;
516 typeInfFloat
.MaximumScale
= 0;
518 typeInfDate
.TypeName
.Empty();
519 typeInfDate
.FsqlType
= 0;
520 typeInfDate
.Precision
= 0;
521 typeInfDate
.CaseSensitive
= 0;
522 typeInfDate
.MaximumScale
= 0;
524 typeInfBlob
.TypeName
.Empty();
525 typeInfBlob
.FsqlType
= 0;
526 typeInfBlob
.Precision
= 0;
527 typeInfBlob
.CaseSensitive
= 0;
528 typeInfBlob
.MaximumScale
= 0;
530 // Error reporting is turned OFF by default
533 // Allocate a data source connection handle
534 if (SQLAllocConnect(henv
, &hdbc
) != SQL_SUCCESS
)
537 // Initialize the db status flag
540 // Mark database as not open as of yet
543 } // wxDb::initialize()
546 /********** PRIVATE! wxDb::convertUserID PRIVATE! **********/
548 // NOTE: Return value from this function MUST be copied
549 // immediately, as the value is not good after
550 // this function has left scope.
552 const wxChar
*wxDb::convertUserID(const wxChar
*userID
, wxString
&UserID
)
556 if (!wxStrlen(userID
))
564 // dBase does not use user names, and some drivers fail if you try to pass one
565 if (Dbms() == dbmsDBASE
)
568 // Oracle user names may only be in uppercase, so force
569 // the name to uppercase
570 if (Dbms() == dbmsORACLE
)
571 UserID
= UserID
.Upper();
573 return UserID
.c_str();
574 } // wxDb::convertUserID()
577 /********** wxDb::Open() **********/
578 bool wxDb::Open(const wxString
&Dsn
, const wxString
&Uid
, const wxString
&AuthStr
)
580 wxASSERT(Dsn
.Length());
587 if (!FwdOnlyCursors())
589 // Specify that the ODBC cursor library be used, if needed. This must be
590 // specified before the connection is made.
591 retcode
= SQLSetConnectOption(hdbc
, SQL_ODBC_CURSORS
, SQL_CUR_USE_IF_NEEDED
);
593 #ifdef DBDEBUG_CONSOLE
594 if (retcode
== SQL_SUCCESS
)
595 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) successful") << endl
;
597 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) failed") << endl
;
601 // Connect to the data source
602 retcode
= SQLConnect(hdbc
, (UCHAR FAR
*) dsn
.c_str(), SQL_NTS
,
603 (UCHAR FAR
*) uid
.c_str(), SQL_NTS
,
604 (UCHAR FAR
*) authStr
.c_str(), SQL_NTS
);
607 if (retcode == SQL_SUCCESS_WITH_INFO)
608 DispAllErrors(henv, hdbc);
609 else if (retcode != SQL_SUCCESS)
610 return(DispAllErrors(henv, hdbc));
612 if (retcode == SQL_ERROR)
613 return(DispAllErrors(henv, hdbc));
615 if ((retcode
!= SQL_SUCCESS
) &&
616 (retcode
!= SQL_SUCCESS_WITH_INFO
))
617 return(DispAllErrors(henv
, hdbc
));
620 If using Intersolv branded ODBC drivers, this is the place where you would substitute
621 your branded driver license information
623 SQLSetConnectOption(hdbc, 1041, (UDWORD) wxEmptyString);
624 SQLSetConnectOption(hdbc, 1042, (UDWORD) wxEmptyString);
627 // Mark database as open
630 // Allocate a statement handle for the database connection
631 if (SQLAllocStmt(hdbc
, &hstmt
) != SQL_SUCCESS
)
632 return(DispAllErrors(henv
, hdbc
));
634 // Set Connection Options
635 if (!setConnectionOptions())
638 // Query the data source for inf. about itself
642 // Query the data source regarding data type information
645 // The way it was determined which SQL data types to use was by calling SQLGetInfo
646 // for all of the possible SQL data types to see which ones were supported. If
647 // a type is not supported, the SQLFetch() that's called from getDataTypeInfo()
648 // fails with SQL_NO_DATA_FOUND. This is ugly because I'm sure the three SQL data
649 // types I've selected below will not alway's be what we want. These are just
650 // what happened to work against an Oracle 7/Intersolv combination. The following is
651 // a complete list of the results I got back against the Oracle 7 database:
653 // SQL_BIGINT SQL_NO_DATA_FOUND
654 // SQL_BINARY SQL_NO_DATA_FOUND
655 // SQL_BIT SQL_NO_DATA_FOUND
656 // SQL_CHAR type name = 'CHAR', Precision = 255
657 // SQL_DATE SQL_NO_DATA_FOUND
658 // SQL_DECIMAL type name = 'NUMBER', Precision = 38
659 // SQL_DOUBLE type name = 'NUMBER', Precision = 15
660 // SQL_FLOAT SQL_NO_DATA_FOUND
661 // SQL_INTEGER SQL_NO_DATA_FOUND
662 // SQL_LONGVARBINARY type name = 'LONG RAW', Precision = 2 billion
663 // SQL_LONGVARCHAR type name = 'LONG', Precision = 2 billion
664 // SQL_NUMERIC SQL_NO_DATA_FOUND
665 // SQL_REAL SQL_NO_DATA_FOUND
666 // SQL_SMALLINT SQL_NO_DATA_FOUND
667 // SQL_TIME SQL_NO_DATA_FOUND
668 // SQL_TIMESTAMP type name = 'DATE', Precision = 19
669 // SQL_VARBINARY type name = 'RAW', Precision = 255
670 // SQL_VARCHAR type name = 'VARCHAR2', Precision = 2000
671 // =====================================================================
672 // Results from a Microsoft Access 7.0 db, using a driver from Microsoft
674 // SQL_VARCHAR type name = 'TEXT', Precision = 255
675 // SQL_TIMESTAMP type name = 'DATETIME'
676 // SQL_DECIMAL SQL_NO_DATA_FOUND
677 // SQL_NUMERIC type name = 'CURRENCY', Precision = 19
678 // SQL_FLOAT SQL_NO_DATA_FOUND
679 // SQL_REAL type name = 'SINGLE', Precision = 7
680 // SQL_DOUBLE type name = 'DOUBLE', Precision = 15
681 // SQL_INTEGER type name = 'LONG', Precision = 10
683 // VARCHAR = Variable length character string
684 if (!getDataTypeInfo(SQL_VARCHAR
, typeInfVarchar
))
685 if (!getDataTypeInfo(SQL_CHAR
, typeInfVarchar
))
688 typeInfVarchar
.FsqlType
= SQL_CHAR
;
690 typeInfVarchar
.FsqlType
= SQL_VARCHAR
;
693 if (!getDataTypeInfo(SQL_DOUBLE
,typeInfFloat
))
694 if (!getDataTypeInfo(SQL_REAL
,typeInfFloat
))
695 if (!getDataTypeInfo(SQL_FLOAT
,typeInfFloat
))
696 if (!getDataTypeInfo(SQL_DECIMAL
,typeInfFloat
))
697 if (!getDataTypeInfo(SQL_NUMERIC
,typeInfFloat
))
700 typeInfFloat
.FsqlType
= SQL_NUMERIC
;
702 typeInfFloat
.FsqlType
= SQL_DECIMAL
;
704 typeInfFloat
.FsqlType
= SQL_FLOAT
;
706 typeInfFloat
.FsqlType
= SQL_REAL
;
708 typeInfFloat
.FsqlType
= SQL_DOUBLE
;
711 if (!getDataTypeInfo(SQL_INTEGER
, typeInfInteger
))
713 // If SQL_INTEGER is not supported, use the floating point
714 // data type to store integers as well as floats
715 if (!getDataTypeInfo(typeInfFloat
.FsqlType
, typeInfInteger
))
718 typeInfInteger
.FsqlType
= typeInfFloat
.FsqlType
;
721 typeInfInteger
.FsqlType
= SQL_INTEGER
;
724 if (Dbms() != dbmsDBASE
)
726 if (!getDataTypeInfo(SQL_TIMESTAMP
,typeInfDate
))
729 typeInfDate
.FsqlType
= SQL_TIMESTAMP
;
733 if (!getDataTypeInfo(SQL_DATE
,typeInfDate
))
736 typeInfDate
.FsqlType
= SQL_DATE
;
739 if (!getDataTypeInfo(SQL_LONGVARBINARY
, typeInfBlob
))
741 if (!getDataTypeInfo(SQL_VARBINARY
,typeInfBlob
))
744 typeInfBlob
.FsqlType
= SQL_VARBINARY
;
747 typeInfBlob
.FsqlType
= SQL_LONGVARBINARY
;
749 //typeInfBlob.TypeName = "BLOB";
751 #ifdef DBDEBUG_CONSOLE
752 cout
<< wxT("VARCHAR DATA TYPE: ") << typeInfVarchar
.TypeName
<< endl
;
753 cout
<< wxT("INTEGER DATA TYPE: ") << typeInfInteger
.TypeName
<< endl
;
754 cout
<< wxT("FLOAT DATA TYPE: ") << typeInfFloat
.TypeName
<< endl
;
755 cout
<< wxT("DATE DATA TYPE: ") << typeInfDate
.TypeName
<< endl
;
756 cout
<< wxT("BLOB DATA TYPE: ") << typeInfBlob
.TypeName
<< endl
;
760 // Completed Successfully
766 bool wxDb::Open(wxDbConnectInf
*dbConnectInf
)
768 return Open(dbConnectInf
->GetDsn(), dbConnectInf
->GetUserID(),
769 dbConnectInf
->GetPassword());
773 bool wxDb::Open(wxDb
*copyDb
)
775 dsn
= copyDb
->GetDatasourceName();
776 uid
= copyDb
->GetUsername();
777 authStr
= copyDb
->GetPassword();
781 if (!FwdOnlyCursors())
783 // Specify that the ODBC cursor library be used, if needed. This must be
784 // specified before the connection is made.
785 retcode
= SQLSetConnectOption(hdbc
, SQL_ODBC_CURSORS
, SQL_CUR_USE_IF_NEEDED
);
787 #ifdef DBDEBUG_CONSOLE
788 if (retcode
== SQL_SUCCESS
)
789 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) successful") << endl
;
791 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) failed") << endl
;
795 // Connect to the data source
796 retcode
= SQLConnect(hdbc
, (UCHAR FAR
*) dsn
.c_str(), SQL_NTS
,
797 (UCHAR FAR
*) uid
.c_str(), SQL_NTS
,
798 (UCHAR FAR
*) authStr
.c_str(), SQL_NTS
);
800 if (retcode
== SQL_ERROR
)
801 return(DispAllErrors(henv
, hdbc
));
804 If using Intersolv branded ODBC drivers, this is the place where you would substitute
805 your branded driver license information
807 SQLSetConnectOption(hdbc, 1041, (UDWORD) wxEmptyString);
808 SQLSetConnectOption(hdbc, 1042, (UDWORD) wxEmptyString);
811 // Mark database as open
814 // Allocate a statement handle for the database connection
815 if (SQLAllocStmt(hdbc
, &hstmt
) != SQL_SUCCESS
)
816 return(DispAllErrors(henv
, hdbc
));
818 // Set Connection Options
819 if (!setConnectionOptions())
822 // Instead of Querying the data source for info about itself, it can just be copied
823 // from the wxDb instance that was passed in (copyDb).
824 wxStrcpy(dbInf
.serverName
,copyDb
->dbInf
.serverName
);
825 wxStrcpy(dbInf
.databaseName
,copyDb
->dbInf
.databaseName
);
826 wxStrcpy(dbInf
.dbmsName
,copyDb
->dbInf
.dbmsName
);
827 wxStrcpy(dbInf
.dbmsVer
,copyDb
->dbInf
.dbmsVer
);
828 dbInf
.maxConnections
= copyDb
->dbInf
.maxConnections
;
829 dbInf
.maxStmts
= copyDb
->dbInf
.maxStmts
;
830 wxStrcpy(dbInf
.driverName
,copyDb
->dbInf
.driverName
);
831 wxStrcpy(dbInf
.odbcVer
,copyDb
->dbInf
.odbcVer
);
832 wxStrcpy(dbInf
.drvMgrOdbcVer
,copyDb
->dbInf
.drvMgrOdbcVer
);
833 wxStrcpy(dbInf
.driverVer
,copyDb
->dbInf
.driverVer
);
834 dbInf
.apiConfLvl
= copyDb
->dbInf
.apiConfLvl
;
835 dbInf
.cliConfLvl
= copyDb
->dbInf
.cliConfLvl
;
836 dbInf
.sqlConfLvl
= copyDb
->dbInf
.sqlConfLvl
;
837 wxStrcpy(dbInf
.outerJoins
,copyDb
->dbInf
.outerJoins
);
838 wxStrcpy(dbInf
.procedureSupport
,copyDb
->dbInf
.procedureSupport
);
839 wxStrcpy(dbInf
.accessibleTables
,copyDb
->dbInf
.accessibleTables
);
840 dbInf
.cursorCommitBehavior
= copyDb
->dbInf
.cursorCommitBehavior
;
841 dbInf
.cursorRollbackBehavior
= copyDb
->dbInf
.cursorRollbackBehavior
;
842 dbInf
.supportNotNullClause
= copyDb
->dbInf
.supportNotNullClause
;
843 wxStrcpy(dbInf
.supportIEF
,copyDb
->dbInf
.supportIEF
);
844 dbInf
.txnIsolation
= copyDb
->dbInf
.txnIsolation
;
845 dbInf
.txnIsolationOptions
= copyDb
->dbInf
.txnIsolationOptions
;
846 dbInf
.fetchDirections
= copyDb
->dbInf
.fetchDirections
;
847 dbInf
.lockTypes
= copyDb
->dbInf
.lockTypes
;
848 dbInf
.posOperations
= copyDb
->dbInf
.posOperations
;
849 dbInf
.posStmts
= copyDb
->dbInf
.posStmts
;
850 dbInf
.scrollConcurrency
= copyDb
->dbInf
.scrollConcurrency
;
851 dbInf
.scrollOptions
= copyDb
->dbInf
.scrollOptions
;
852 dbInf
.staticSensitivity
= copyDb
->dbInf
.staticSensitivity
;
853 dbInf
.txnCapable
= copyDb
->dbInf
.txnCapable
;
854 dbInf
.loginTimeout
= copyDb
->dbInf
.loginTimeout
;
856 // VARCHAR = Variable length character string
857 typeInfVarchar
.FsqlType
= copyDb
->typeInfVarchar
.FsqlType
;
858 typeInfVarchar
.TypeName
= copyDb
->typeInfVarchar
.TypeName
;
859 typeInfVarchar
.Precision
= copyDb
->typeInfVarchar
.Precision
;
860 typeInfVarchar
.CaseSensitive
= copyDb
->typeInfVarchar
.CaseSensitive
;
861 typeInfVarchar
.MaximumScale
= copyDb
->typeInfVarchar
.MaximumScale
;
864 typeInfFloat
.FsqlType
= copyDb
->typeInfFloat
.FsqlType
;
865 typeInfFloat
.TypeName
= copyDb
->typeInfFloat
.TypeName
;
866 typeInfFloat
.Precision
= copyDb
->typeInfFloat
.Precision
;
867 typeInfFloat
.CaseSensitive
= copyDb
->typeInfFloat
.CaseSensitive
;
868 typeInfFloat
.MaximumScale
= copyDb
->typeInfFloat
.MaximumScale
;
871 typeInfInteger
.FsqlType
= copyDb
->typeInfInteger
.FsqlType
;
872 typeInfInteger
.TypeName
= copyDb
->typeInfInteger
.TypeName
;
873 typeInfInteger
.Precision
= copyDb
->typeInfInteger
.Precision
;
874 typeInfInteger
.CaseSensitive
= copyDb
->typeInfInteger
.CaseSensitive
;
875 typeInfInteger
.MaximumScale
= copyDb
->typeInfInteger
.MaximumScale
;
878 typeInfDate
.FsqlType
= copyDb
->typeInfDate
.FsqlType
;
879 typeInfDate
.TypeName
= copyDb
->typeInfDate
.TypeName
;
880 typeInfDate
.Precision
= copyDb
->typeInfDate
.Precision
;
881 typeInfDate
.CaseSensitive
= copyDb
->typeInfDate
.CaseSensitive
;
882 typeInfDate
.MaximumScale
= copyDb
->typeInfDate
.MaximumScale
;
885 typeInfBlob
.FsqlType
= copyDb
->typeInfBlob
.FsqlType
;
886 typeInfBlob
.TypeName
= copyDb
->typeInfBlob
.TypeName
;
887 typeInfBlob
.Precision
= copyDb
->typeInfBlob
.Precision
;
888 typeInfBlob
.CaseSensitive
= copyDb
->typeInfBlob
.CaseSensitive
;
889 typeInfBlob
.MaximumScale
= copyDb
->typeInfBlob
.MaximumScale
;
891 #ifdef DBDEBUG_CONSOLE
892 cout
<< wxT("VARCHAR DATA TYPE: ") << typeInfVarchar
.TypeName
<< endl
;
893 cout
<< wxT("INTEGER DATA TYPE: ") << typeInfInteger
.TypeName
<< endl
;
894 cout
<< wxT("FLOAT DATA TYPE: ") << typeInfFloat
.TypeName
<< endl
;
895 cout
<< wxT("DATE DATA TYPE: ") << typeInfDate
.TypeName
<< endl
;
896 cout
<< wxT("BLOB DATA TYPE: ") << typeInfBlob
.TypeName
<< endl
;
900 // Completed Successfully
905 /********** wxDb::setConnectionOptions() **********/
906 bool wxDb::setConnectionOptions(void)
908 * NOTE: The Intersolv/Oracle 7 driver was "Not Capable" of setting the login timeout.
913 // I need to get the DBMS name here, because some of the connection options
914 // are database specific and need to call the Dbms() function.
915 if (SQLGetInfo(hdbc
, SQL_DBMS_NAME
, (UCHAR
*) dbInf
.dbmsName
, 40, &cb
) != SQL_SUCCESS
)
916 return(DispAllErrors(henv
, hdbc
));
918 SQLSetConnectOption(hdbc
, SQL_AUTOCOMMIT
, SQL_AUTOCOMMIT_OFF
);
919 SQLSetConnectOption(hdbc
, SQL_OPT_TRACE
, SQL_OPT_TRACE_OFF
);
920 // SQLSetConnectOption(hdbc, SQL_TXN_ISOLATION, SQL_TXN_READ_COMMITTED); // No dirty reads
922 // By default, MS Sql Server closes cursors on commit and rollback. The following
923 // call to SQLSetConnectOption() is needed to force SQL Server to preserve cursors
924 // after a transaction. This is a driver specific option and is not part of the
925 // ODBC standard. Note: this behavior is specific to the ODBC interface to SQL Server.
926 // The database settings don't have any effect one way or the other.
927 if (Dbms() == dbmsMS_SQL_SERVER
)
929 const long SQL_PRESERVE_CURSORS
= 1204L;
930 const long SQL_PC_ON
= 1L;
931 SQLSetConnectOption(hdbc
, SQL_PRESERVE_CURSORS
, SQL_PC_ON
);
934 // Display the connection options to verify them
935 #ifdef DBDEBUG_CONSOLE
937 cout
<< wxT("****** CONNECTION OPTIONS ******") << endl
;
939 if (SQLGetConnectOption(hdbc
, SQL_AUTOCOMMIT
, &l
) != SQL_SUCCESS
)
940 return(DispAllErrors(henv
, hdbc
));
941 cout
<< wxT("AUTOCOMMIT: ") << (l
== SQL_AUTOCOMMIT_OFF
? "OFF" : "ON") << endl
;
943 if (SQLGetConnectOption(hdbc
, SQL_ODBC_CURSORS
, &l
) != SQL_SUCCESS
)
944 return(DispAllErrors(henv
, hdbc
));
945 cout
<< wxT("ODBC CURSORS: ");
948 case(SQL_CUR_USE_IF_NEEDED
):
949 cout
<< wxT("SQL_CUR_USE_IF_NEEDED");
951 case(SQL_CUR_USE_ODBC
):
952 cout
<< wxT("SQL_CUR_USE_ODBC");
954 case(SQL_CUR_USE_DRIVER
):
955 cout
<< wxT("SQL_CUR_USE_DRIVER");
960 if (SQLGetConnectOption(hdbc
, SQL_OPT_TRACE
, &l
) != SQL_SUCCESS
)
961 return(DispAllErrors(henv
, hdbc
));
962 cout
<< wxT("TRACING: ") << (l
== SQL_OPT_TRACE_OFF
? wxT("OFF") : wxT("ON")) << endl
;
967 // Completed Successfully
970 } // wxDb::setConnectionOptions()
973 /********** wxDb::getDbInfo() **********/
974 bool wxDb::getDbInfo(void)
979 if (SQLGetInfo(hdbc
, SQL_SERVER_NAME
, (UCHAR
*) dbInf
.serverName
, 80, &cb
) != SQL_SUCCESS
)
980 return(DispAllErrors(henv
, hdbc
));
982 if (SQLGetInfo(hdbc
, SQL_DATABASE_NAME
, (UCHAR
*) dbInf
.databaseName
, 128, &cb
) != SQL_SUCCESS
)
983 return(DispAllErrors(henv
, hdbc
));
985 if (SQLGetInfo(hdbc
, SQL_DBMS_NAME
, (UCHAR
*) dbInf
.dbmsName
, 40, &cb
) != SQL_SUCCESS
)
986 return(DispAllErrors(henv
, hdbc
));
989 // After upgrading to MSVC6, the original 20 char buffer below was insufficient,
990 // causing database connectivity to fail in some cases.
991 retcode
= SQLGetInfo(hdbc
, SQL_DBMS_VER
, (UCHAR
*) dbInf
.dbmsVer
, 64, &cb
);
993 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
994 return(DispAllErrors(henv
, hdbc
));
996 if (SQLGetInfo(hdbc
, SQL_ACTIVE_CONNECTIONS
, (UCHAR
*) &dbInf
.maxConnections
, sizeof(dbInf
.maxConnections
), &cb
) != SQL_SUCCESS
)
997 return(DispAllErrors(henv
, hdbc
));
999 if (SQLGetInfo(hdbc
, SQL_ACTIVE_STATEMENTS
, (UCHAR
*) &dbInf
.maxStmts
, sizeof(dbInf
.maxStmts
), &cb
) != SQL_SUCCESS
)
1000 return(DispAllErrors(henv
, hdbc
));
1002 if (SQLGetInfo(hdbc
, SQL_DRIVER_NAME
, (UCHAR
*) dbInf
.driverName
, 40, &cb
) != SQL_SUCCESS
)
1003 return(DispAllErrors(henv
, hdbc
));
1005 if (SQLGetInfo(hdbc
, SQL_DRIVER_ODBC_VER
, (UCHAR
*) dbInf
.odbcVer
, 60, &cb
) == SQL_ERROR
)
1006 return(DispAllErrors(henv
, hdbc
));
1008 retcode
= SQLGetInfo(hdbc
, SQL_ODBC_VER
, (UCHAR
*) dbInf
.drvMgrOdbcVer
, 60, &cb
);
1009 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
1010 return(DispAllErrors(henv
, hdbc
));
1012 if (SQLGetInfo(hdbc
, SQL_DRIVER_VER
, (UCHAR
*) dbInf
.driverVer
, 60, &cb
) == SQL_ERROR
)
1013 return(DispAllErrors(henv
, hdbc
));
1015 if (SQLGetInfo(hdbc
, SQL_ODBC_API_CONFORMANCE
, (UCHAR
*) &dbInf
.apiConfLvl
, sizeof(dbInf
.apiConfLvl
), &cb
) != SQL_SUCCESS
)
1016 return(DispAllErrors(henv
, hdbc
));
1018 if (SQLGetInfo(hdbc
, SQL_ODBC_SAG_CLI_CONFORMANCE
, (UCHAR
*) &dbInf
.cliConfLvl
, sizeof(dbInf
.cliConfLvl
), &cb
) != SQL_SUCCESS
)
1019 // return(DispAllErrors(henv, hdbc));
1021 // Not all drivers support this call - Nick Gorham(unixODBC)
1022 dbInf
.cliConfLvl
= 0;
1025 if (SQLGetInfo(hdbc
, SQL_ODBC_SQL_CONFORMANCE
, (UCHAR
*) &dbInf
.sqlConfLvl
, sizeof(dbInf
.sqlConfLvl
), &cb
) != SQL_SUCCESS
)
1026 return(DispAllErrors(henv
, hdbc
));
1028 if (SQLGetInfo(hdbc
, SQL_OUTER_JOINS
, (UCHAR
*) dbInf
.outerJoins
, 2, &cb
) != SQL_SUCCESS
)
1029 return(DispAllErrors(henv
, hdbc
));
1031 if (SQLGetInfo(hdbc
, SQL_PROCEDURES
, (UCHAR
*) dbInf
.procedureSupport
, 2, &cb
) != SQL_SUCCESS
)
1032 return(DispAllErrors(henv
, hdbc
));
1034 if (SQLGetInfo(hdbc
, SQL_ACCESSIBLE_TABLES
, (UCHAR
*) dbInf
.accessibleTables
, 2, &cb
) != SQL_SUCCESS
)
1035 return(DispAllErrors(henv
, hdbc
));
1037 if (SQLGetInfo(hdbc
, SQL_CURSOR_COMMIT_BEHAVIOR
, (UCHAR
*) &dbInf
.cursorCommitBehavior
, sizeof(dbInf
.cursorCommitBehavior
), &cb
) != SQL_SUCCESS
)
1038 return(DispAllErrors(henv
, hdbc
));
1040 if (SQLGetInfo(hdbc
, SQL_CURSOR_ROLLBACK_BEHAVIOR
, (UCHAR
*) &dbInf
.cursorRollbackBehavior
, sizeof(dbInf
.cursorRollbackBehavior
), &cb
) != SQL_SUCCESS
)
1041 return(DispAllErrors(henv
, hdbc
));
1043 if (SQLGetInfo(hdbc
, SQL_NON_NULLABLE_COLUMNS
, (UCHAR
*) &dbInf
.supportNotNullClause
, sizeof(dbInf
.supportNotNullClause
), &cb
) != SQL_SUCCESS
)
1044 return(DispAllErrors(henv
, hdbc
));
1046 if (SQLGetInfo(hdbc
, SQL_ODBC_SQL_OPT_IEF
, (UCHAR
*) dbInf
.supportIEF
, 2, &cb
) != SQL_SUCCESS
)
1047 return(DispAllErrors(henv
, hdbc
));
1049 if (SQLGetInfo(hdbc
, SQL_DEFAULT_TXN_ISOLATION
, (UCHAR
*) &dbInf
.txnIsolation
, sizeof(dbInf
.txnIsolation
), &cb
) != SQL_SUCCESS
)
1050 return(DispAllErrors(henv
, hdbc
));
1052 if (SQLGetInfo(hdbc
, SQL_TXN_ISOLATION_OPTION
, (UCHAR
*) &dbInf
.txnIsolationOptions
, sizeof(dbInf
.txnIsolationOptions
), &cb
) != SQL_SUCCESS
)
1053 return(DispAllErrors(henv
, hdbc
));
1055 if (SQLGetInfo(hdbc
, SQL_FETCH_DIRECTION
, (UCHAR
*) &dbInf
.fetchDirections
, sizeof(dbInf
.fetchDirections
), &cb
) != SQL_SUCCESS
)
1056 return(DispAllErrors(henv
, hdbc
));
1058 if (SQLGetInfo(hdbc
, SQL_LOCK_TYPES
, (UCHAR
*) &dbInf
.lockTypes
, sizeof(dbInf
.lockTypes
), &cb
) != SQL_SUCCESS
)
1059 return(DispAllErrors(henv
, hdbc
));
1061 if (SQLGetInfo(hdbc
, SQL_POS_OPERATIONS
, (UCHAR
*) &dbInf
.posOperations
, sizeof(dbInf
.posOperations
), &cb
) != SQL_SUCCESS
)
1062 return(DispAllErrors(henv
, hdbc
));
1064 if (SQLGetInfo(hdbc
, SQL_POSITIONED_STATEMENTS
, (UCHAR
*) &dbInf
.posStmts
, sizeof(dbInf
.posStmts
), &cb
) != SQL_SUCCESS
)
1065 return(DispAllErrors(henv
, hdbc
));
1067 if (SQLGetInfo(hdbc
, SQL_SCROLL_CONCURRENCY
, (UCHAR
*) &dbInf
.scrollConcurrency
, sizeof(dbInf
.scrollConcurrency
), &cb
) != SQL_SUCCESS
)
1068 return(DispAllErrors(henv
, hdbc
));
1070 if (SQLGetInfo(hdbc
, SQL_SCROLL_OPTIONS
, (UCHAR
*) &dbInf
.scrollOptions
, sizeof(dbInf
.scrollOptions
), &cb
) != SQL_SUCCESS
)
1071 return(DispAllErrors(henv
, hdbc
));
1073 if (SQLGetInfo(hdbc
, SQL_STATIC_SENSITIVITY
, (UCHAR
*) &dbInf
.staticSensitivity
, sizeof(dbInf
.staticSensitivity
), &cb
) != SQL_SUCCESS
)
1074 return(DispAllErrors(henv
, hdbc
));
1076 if (SQLGetInfo(hdbc
, SQL_TXN_CAPABLE
, (UCHAR
*) &dbInf
.txnCapable
, sizeof(dbInf
.txnCapable
), &cb
) != SQL_SUCCESS
)
1077 return(DispAllErrors(henv
, hdbc
));
1079 if (SQLGetInfo(hdbc
, SQL_LOGIN_TIMEOUT
, (UCHAR
*) &dbInf
.loginTimeout
, sizeof(dbInf
.loginTimeout
), &cb
) != SQL_SUCCESS
)
1080 return(DispAllErrors(henv
, hdbc
));
1082 #ifdef DBDEBUG_CONSOLE
1083 cout
<< wxT("***** DATA SOURCE INFORMATION *****") << endl
;
1084 cout
<< wxT(wxT("SERVER Name: ") << dbInf
.serverName
<< endl
;
1085 cout
<< wxT("DBMS Name: ") << dbInf
.dbmsName
<< wxT("; DBMS Version: ") << dbInf
.dbmsVer
<< endl
;
1086 cout
<< wxT("ODBC Version: ") << dbInf
.odbcVer
<< wxT("; Driver Version: ") << dbInf
.driverVer
<< endl
;
1088 cout
<< wxT("API Conf. Level: ");
1089 switch(dbInf
.apiConfLvl
)
1091 case SQL_OAC_NONE
: cout
<< wxT("None"); break;
1092 case SQL_OAC_LEVEL1
: cout
<< wxT("Level 1"); break;
1093 case SQL_OAC_LEVEL2
: cout
<< wxT("Level 2"); break;
1097 cout
<< wxT("SAG CLI Conf. Level: ");
1098 switch(dbInf
.cliConfLvl
)
1100 case SQL_OSCC_NOT_COMPLIANT
: cout
<< wxT("Not Compliant"); break;
1101 case SQL_OSCC_COMPLIANT
: cout
<< wxT("Compliant"); break;
1105 cout
<< wxT("SQL Conf. Level: ");
1106 switch(dbInf
.sqlConfLvl
)
1108 case SQL_OSC_MINIMUM
: cout
<< wxT("Minimum Grammar"); break;
1109 case SQL_OSC_CORE
: cout
<< wxT("Core Grammar"); break;
1110 case SQL_OSC_EXTENDED
: cout
<< wxT("Extended Grammar"); break;
1114 cout
<< wxT("Max. Connections: ") << dbInf
.maxConnections
<< endl
;
1115 cout
<< wxT("Outer Joins: ") << dbInf
.outerJoins
<< endl
;
1116 cout
<< wxT("Support for Procedures: ") << dbInf
.procedureSupport
<< endl
;
1117 cout
<< wxT("All tables accessible : ") << dbInf
.accessibleTables
<< endl
;
1118 cout
<< wxT("Cursor COMMIT Behavior: ");
1119 switch(dbInf
.cursorCommitBehavior
)
1121 case SQL_CB_DELETE
: cout
<< wxT("Delete cursors"); break;
1122 case SQL_CB_CLOSE
: cout
<< wxT("Close cursors"); break;
1123 case SQL_CB_PRESERVE
: cout
<< wxT("Preserve cursors"); break;
1127 cout
<< wxT("Cursor ROLLBACK Behavior: ");
1128 switch(dbInf
.cursorRollbackBehavior
)
1130 case SQL_CB_DELETE
: cout
<< wxT("Delete cursors"); break;
1131 case SQL_CB_CLOSE
: cout
<< wxT("Close cursors"); break;
1132 case SQL_CB_PRESERVE
: cout
<< wxT("Preserve cursors"); break;
1136 cout
<< wxT("Support NOT NULL clause: ");
1137 switch(dbInf
.supportNotNullClause
)
1139 case SQL_NNC_NULL
: cout
<< wxT("No"); break;
1140 case SQL_NNC_NON_NULL
: cout
<< wxT("Yes"); break;
1144 cout
<< wxT("Support IEF (Ref. Integrity): ") << dbInf
.supportIEF
<< endl
;
1145 cout
<< wxT("Login Timeout: ") << dbInf
.loginTimeout
<< endl
;
1147 cout
<< endl
<< endl
<< wxT("more ...") << endl
;
1150 cout
<< wxT("Default Transaction Isolation: ";
1151 switch(dbInf
.txnIsolation
)
1153 case SQL_TXN_READ_UNCOMMITTED
: cout
<< wxT("Read Uncommitted"); break;
1154 case SQL_TXN_READ_COMMITTED
: cout
<< wxT("Read Committed"); break;
1155 case SQL_TXN_REPEATABLE_READ
: cout
<< wxT("Repeatable Read"); break;
1156 case SQL_TXN_SERIALIZABLE
: cout
<< wxT("Serializable"); break;
1158 case SQL_TXN_VERSIONING
: cout
<< wxT("Versioning"); break;
1163 cout
<< wxT("Transaction Isolation Options: ");
1164 if (dbInf
.txnIsolationOptions
& SQL_TXN_READ_UNCOMMITTED
)
1165 cout
<< wxT("Read Uncommitted, ");
1166 if (dbInf
.txnIsolationOptions
& SQL_TXN_READ_COMMITTED
)
1167 cout
<< wxT("Read Committed, ");
1168 if (dbInf
.txnIsolationOptions
& SQL_TXN_REPEATABLE_READ
)
1169 cout
<< wxT("Repeatable Read, ");
1170 if (dbInf
.txnIsolationOptions
& SQL_TXN_SERIALIZABLE
)
1171 cout
<< wxT("Serializable, ");
1173 if (dbInf
.txnIsolationOptions
& SQL_TXN_VERSIONING
)
1174 cout
<< wxT("Versioning");
1178 cout
<< wxT("Fetch Directions Supported:") << endl
<< wxT(" ");
1179 if (dbInf
.fetchDirections
& SQL_FD_FETCH_NEXT
)
1180 cout
<< wxT("Next, ");
1181 if (dbInf
.fetchDirections
& SQL_FD_FETCH_PRIOR
)
1182 cout
<< wxT("Prev, ");
1183 if (dbInf
.fetchDirections
& SQL_FD_FETCH_FIRST
)
1184 cout
<< wxT("First, ");
1185 if (dbInf
.fetchDirections
& SQL_FD_FETCH_LAST
)
1186 cout
<< wxT("Last, ");
1187 if (dbInf
.fetchDirections
& SQL_FD_FETCH_ABSOLUTE
)
1188 cout
<< wxT("Absolute, ");
1189 if (dbInf
.fetchDirections
& SQL_FD_FETCH_RELATIVE
)
1190 cout
<< wxT("Relative, ");
1192 if (dbInf
.fetchDirections
& SQL_FD_FETCH_RESUME
)
1193 cout
<< wxT("Resume, ");
1195 if (dbInf
.fetchDirections
& SQL_FD_FETCH_BOOKMARK
)
1196 cout
<< wxT("Bookmark");
1199 cout
<< wxT("Lock Types Supported (SQLSetPos): ");
1200 if (dbInf
.lockTypes
& SQL_LCK_NO_CHANGE
)
1201 cout
<< wxT("No Change, ");
1202 if (dbInf
.lockTypes
& SQL_LCK_EXCLUSIVE
)
1203 cout
<< wxT("Exclusive, ");
1204 if (dbInf
.lockTypes
& SQL_LCK_UNLOCK
)
1205 cout
<< wxT("UnLock");
1208 cout
<< wxT("Position Operations Supported (SQLSetPos): ");
1209 if (dbInf
.posOperations
& SQL_POS_POSITION
)
1210 cout
<< wxT("Position, ");
1211 if (dbInf
.posOperations
& SQL_POS_REFRESH
)
1212 cout
<< wxT("Refresh, ");
1213 if (dbInf
.posOperations
& SQL_POS_UPDATE
)
1214 cout
<< wxT("Upd, "));
1215 if (dbInf
.posOperations
& SQL_POS_DELETE
)
1216 cout
<< wxT("Del, ");
1217 if (dbInf
.posOperations
& SQL_POS_ADD
)
1221 cout
<< wxT("Positioned Statements Supported: ");
1222 if (dbInf
.posStmts
& SQL_PS_POSITIONED_DELETE
)
1223 cout
<< wxT("Pos delete, ");
1224 if (dbInf
.posStmts
& SQL_PS_POSITIONED_UPDATE
)
1225 cout
<< wxT("Pos update, ");
1226 if (dbInf
.posStmts
& SQL_PS_SELECT_FOR_UPDATE
)
1227 cout
<< wxT("Select for update");
1230 cout
<< wxT("Scroll Concurrency: ");
1231 if (dbInf
.scrollConcurrency
& SQL_SCCO_READ_ONLY
)
1232 cout
<< wxT("Read Only, ");
1233 if (dbInf
.scrollConcurrency
& SQL_SCCO_LOCK
)
1234 cout
<< wxT("Lock, ");
1235 if (dbInf
.scrollConcurrency
& SQL_SCCO_OPT_ROWVER
)
1236 cout
<< wxT("Opt. Rowver, ");
1237 if (dbInf
.scrollConcurrency
& SQL_SCCO_OPT_VALUES
)
1238 cout
<< wxT("Opt. Values");
1241 cout
<< wxT("Scroll Options: ");
1242 if (dbInf
.scrollOptions
& SQL_SO_FORWARD_ONLY
)
1243 cout
<< wxT("Fwd Only, ");
1244 if (dbInf
.scrollOptions
& SQL_SO_STATIC
)
1245 cout
<< wxT("Static, ");
1246 if (dbInf
.scrollOptions
& SQL_SO_KEYSET_DRIVEN
)
1247 cout
<< wxT("Keyset Driven, ");
1248 if (dbInf
.scrollOptions
& SQL_SO_DYNAMIC
)
1249 cout
<< wxT("Dynamic, ");
1250 if (dbInf
.scrollOptions
& SQL_SO_MIXED
)
1251 cout
<< wxT("Mixed");
1254 cout
<< wxT("Static Sensitivity: ");
1255 if (dbInf
.staticSensitivity
& SQL_SS_ADDITIONS
)
1256 cout
<< wxT("Additions, ");
1257 if (dbInf
.staticSensitivity
& SQL_SS_DELETIONS
)
1258 cout
<< wxT("Deletions, ");
1259 if (dbInf
.staticSensitivity
& SQL_SS_UPDATES
)
1260 cout
<< wxT("Updates");
1263 cout
<< wxT("Transaction Capable?: ");
1264 switch(dbInf
.txnCapable
)
1266 case SQL_TC_NONE
: cout
<< wxT("No"); break;
1267 case SQL_TC_DML
: cout
<< wxT("DML Only"); break;
1268 case SQL_TC_DDL_COMMIT
: cout
<< wxT("DDL Commit"); break;
1269 case SQL_TC_DDL_IGNORE
: cout
<< wxT("DDL Ignore"); break;
1270 case SQL_TC_ALL
: cout
<< wxT("DDL & DML"); break;
1277 // Completed Successfully
1280 } // wxDb::getDbInfo()
1283 /********** wxDb::getDataTypeInfo() **********/
1284 bool wxDb::getDataTypeInfo(SWORD fSqlType
, wxDbSqlTypeInfo
&structSQLTypeInfo
)
1287 * fSqlType will be something like SQL_VARCHAR. This parameter determines
1288 * the data type inf. is gathered for.
1290 * wxDbSqlTypeInfo is a structure that is filled in with data type information,
1295 // Get information about the data type specified
1296 if (SQLGetTypeInfo(hstmt
, fSqlType
) != SQL_SUCCESS
)
1297 return(DispAllErrors(henv
, hdbc
, hstmt
));
1299 if ((retcode
= SQLFetch(hstmt
)) != SQL_SUCCESS
)
1301 #ifdef DBDEBUG_CONSOLE
1302 if (retcode
== SQL_NO_DATA_FOUND
)
1303 cout
<< wxT("SQL_NO_DATA_FOUND fetching inf. about data type.") << endl
;
1305 DispAllErrors(henv
, hdbc
, hstmt
);
1306 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1310 wxChar typeName
[DB_TYPE_NAME_LEN
+1];
1311 // Obtain columns from the record
1312 if (SQLGetData(hstmt
, 1, SQL_C_CHAR
, (UCHAR
*) typeName
, DB_TYPE_NAME_LEN
, &cbRet
) != SQL_SUCCESS
)
1313 return(DispAllErrors(henv
, hdbc
, hstmt
));
1315 structSQLTypeInfo
.TypeName
= typeName
;
1317 // BJO 20000503: no more needed with new GetColumns...
1320 if (Dbms() == dbmsMY_SQL
)
1322 if (structSQLTypeInfo
.TypeName
== wxT("middleint"))
1323 structSQLTypeInfo
.TypeName
= wxT("mediumint");
1324 else if (structSQLTypeInfo
.TypeName
== wxT("middleint unsigned"))
1325 structSQLTypeInfo
.TypeName
= wxT("mediumint unsigned");
1326 else if (structSQLTypeInfo
.TypeName
== wxT("integer"))
1327 structSQLTypeInfo
.TypeName
= wxT("int");
1328 else if (structSQLTypeInfo
.TypeName
== wxT("integer unsigned"))
1329 structSQLTypeInfo
.TypeName
= wxT("int unsigned");
1330 else if (structSQLTypeInfo
.TypeName
== wxT("middleint"))
1331 structSQLTypeInfo
.TypeName
= wxT("mediumint");
1332 else if (structSQLTypeInfo
.TypeName
== wxT("varchar"))
1333 structSQLTypeInfo
.TypeName
= wxT("char");
1336 // BJO 20000427 : OpenLink driver
1337 if (!wxStrncmp(dbInf
.driverName
, wxT("oplodbc"), 7) ||
1338 !wxStrncmp(dbInf
.driverName
, wxT("OLOD"), 4))
1340 if (structSQLTypeInfo
.TypeName
== wxT("double precision"))
1341 structSQLTypeInfo
.TypeName
= wxT("real");
1345 if (SQLGetData(hstmt
, 3, SQL_C_LONG
, (UCHAR
*) &structSQLTypeInfo
.Precision
, 0, &cbRet
) != SQL_SUCCESS
)
1346 return(DispAllErrors(henv
, hdbc
, hstmt
));
1347 if (SQLGetData(hstmt
, 8, SQL_C_SHORT
, (UCHAR
*) &structSQLTypeInfo
.CaseSensitive
, 0, &cbRet
) != SQL_SUCCESS
)
1348 return(DispAllErrors(henv
, hdbc
, hstmt
));
1349 // if (SQLGetData(hstmt, 14, SQL_C_SHORT, (UCHAR*) &structSQLTypeInfo.MinimumScale, 0, &cbRet) != SQL_SUCCESS)
1350 // return(DispAllErrors(henv, hdbc, hstmt));
1352 if (SQLGetData(hstmt
, 15, SQL_C_SHORT
,(UCHAR
*) &structSQLTypeInfo
.MaximumScale
, 0, &cbRet
) != SQL_SUCCESS
)
1353 return(DispAllErrors(henv
, hdbc
, hstmt
));
1355 if (structSQLTypeInfo
.MaximumScale
< 0)
1356 structSQLTypeInfo
.MaximumScale
= 0;
1358 // Close the statement handle which closes open cursors
1359 if (SQLFreeStmt(hstmt
, SQL_CLOSE
) != SQL_SUCCESS
)
1360 return(DispAllErrors(henv
, hdbc
, hstmt
));
1362 // Completed Successfully
1365 } // wxDb::getDataTypeInfo()
1368 /********** wxDb::Close() **********/
1369 void wxDb::Close(void)
1371 // Close the Sql Log file
1378 // Free statement handle
1381 if (SQLFreeStmt(hstmt
, SQL_DROP
) != SQL_SUCCESS
)
1382 DispAllErrors(henv
, hdbc
);
1385 // Disconnect from the datasource
1386 if (SQLDisconnect(hdbc
) != SQL_SUCCESS
)
1387 DispAllErrors(henv
, hdbc
);
1389 // Free the connection to the datasource
1390 if (SQLFreeConnect(hdbc
) != SQL_SUCCESS
)
1391 DispAllErrors(henv
, hdbc
);
1393 // There should be zero Ctable objects still connected to this db object
1394 wxASSERT(nTables
== 0);
1399 pNode
= TablesInUse
.First();
1403 tiu
= (wxTablesInUse
*)pNode
->Data();
1404 if (tiu
->pDb
== this)
1406 s
.Printf(wxT("(%-20s) tableID:[%6lu] pDb:[%p]"), tiu
->tableName
,tiu
->tableID
,tiu
->pDb
);
1407 s2
.Printf(wxT("Orphaned found using pDb:[%p]"),this);
1408 wxLogDebug (s
.c_str(),s2
.c_str());
1410 pNode
= pNode
->Next();
1414 // Copy the error messages to a global variable
1416 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
1417 wxStrcpy(DBerrorList
[i
], errorList
[i
]);
1419 dbmsType
= dbmsUNIDENTIFIED
;
1425 /********** wxDb::CommitTrans() **********/
1426 bool wxDb::CommitTrans(void)
1430 // Commit the transaction
1431 if (SQLTransact(henv
, hdbc
, SQL_COMMIT
) != SQL_SUCCESS
)
1432 return(DispAllErrors(henv
, hdbc
));
1435 // Completed successfully
1438 } // wxDb::CommitTrans()
1441 /********** wxDb::RollbackTrans() **********/
1442 bool wxDb::RollbackTrans(void)
1444 // Rollback the transaction
1445 if (SQLTransact(henv
, hdbc
, SQL_ROLLBACK
) != SQL_SUCCESS
)
1446 return(DispAllErrors(henv
, hdbc
));
1448 // Completed successfully
1451 } // wxDb::RollbackTrans()
1454 /********** wxDb::DispAllErrors() **********/
1455 bool wxDb::DispAllErrors(HENV aHenv
, HDBC aHdbc
, HSTMT aHstmt
)
1457 * This function is called internally whenever an error condition prevents the user's
1458 * request from being executed. This function will query the datasource as to the
1459 * actual error(s) that just occured on the previous request of the datasource.
1461 * The function will retrieve each error condition from the datasource and
1462 * Printf the codes/text values into a string which it then logs via logError().
1463 * If in DBDEBUG_CONSOLE mode, the constructed string will be displayed in the console
1464 * window and program execution will be paused until the user presses a key.
1466 * This function always returns a FALSE, so that functions which call this function
1467 * can have a line like "return (DispAllErrors(henv, hdbc));" to indicate the failure
1468 * of the users request, so that the calling code can then process the error msg log
1471 wxString odbcErrMsg
;
1473 while (SQLError(aHenv
, aHdbc
, aHstmt
, (UCHAR FAR
*) sqlState
, &nativeError
, (UCHAR FAR
*) errorMsg
, SQL_MAX_MESSAGE_LENGTH
- 1, &cbErrorMsg
) == SQL_SUCCESS
)
1475 odbcErrMsg
.Printf(wxT("SQL State = %s\nNative Error Code = %li\nError Message = %s\n"), sqlState
, nativeError
, errorMsg
);
1476 logError(odbcErrMsg
, sqlState
);
1479 #ifdef DBDEBUG_CONSOLE
1480 // When run in console mode, use standard out to display errors.
1481 cout
<< odbcErrMsg
.c_str() << endl
;
1482 cout
<< wxT("Press any key to continue...") << endl
;
1487 wxLogDebug(odbcErrMsg
,wxT("ODBC DEBUG MESSAGE from DispAllErrors()"));
1492 return(FALSE
); // This function always returns FALSE.
1494 } // wxDb::DispAllErrors()
1497 /********** wxDb::GetNextError() **********/
1498 bool wxDb::GetNextError(HENV aHenv
, HDBC aHdbc
, HSTMT aHstmt
)
1500 if (SQLError(aHenv
, aHdbc
, aHstmt
, (UCHAR FAR
*) sqlState
, &nativeError
, (UCHAR FAR
*) errorMsg
, SQL_MAX_MESSAGE_LENGTH
- 1, &cbErrorMsg
) == SQL_SUCCESS
)
1505 } // wxDb::GetNextError()
1508 /********** wxDb::DispNextError() **********/
1509 void wxDb::DispNextError(void)
1511 wxString odbcErrMsg
;
1513 odbcErrMsg
.Printf(wxT("SQL State = %s\nNative Error Code = %li\nError Message = %s\n"), sqlState
, nativeError
, errorMsg
);
1514 logError(odbcErrMsg
, sqlState
);
1519 #ifdef DBDEBUG_CONSOLE
1520 // When run in console mode, use standard out to display errors.
1521 cout
<< odbcErrMsg
.c_str() << endl
;
1522 cout
<< wxT("Press any key to continue...") << endl
;
1527 wxLogDebug(odbcErrMsg
,wxT("ODBC DEBUG MESSAGE"));
1528 #endif // __WXDEBUG__
1530 } // wxDb::DispNextError()
1533 /********** wxDb::logError() **********/
1534 void wxDb::logError(const wxString
&errMsg
, const wxString
&SQLState
)
1536 wxASSERT(errMsg
.Length());
1538 static int pLast
= -1;
1541 if (++pLast
== DB_MAX_ERROR_HISTORY
)
1544 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
1545 wxStrcpy(errorList
[i
], errorList
[i
+1]);
1549 wxStrcpy(errorList
[pLast
], errMsg
);
1551 if (SQLState
.Length())
1552 if ((dbStatus
= TranslateSqlState(SQLState
)) != DB_ERR_FUNCTION_SEQUENCE_ERROR
)
1553 DB_STATUS
= dbStatus
;
1555 // Add the errmsg to the sql log
1556 WriteSqlLog(errMsg
);
1558 } // wxDb::logError()
1561 /**********wxDb::TranslateSqlState() **********/
1562 int wxDb::TranslateSqlState(const wxString
&SQLState
)
1564 if (!wxStrcmp(SQLState
, wxT("01000")))
1565 return(DB_ERR_GENERAL_WARNING
);
1566 if (!wxStrcmp(SQLState
, wxT("01002")))
1567 return(DB_ERR_DISCONNECT_ERROR
);
1568 if (!wxStrcmp(SQLState
, wxT("01004")))
1569 return(DB_ERR_DATA_TRUNCATED
);
1570 if (!wxStrcmp(SQLState
, wxT("01006")))
1571 return(DB_ERR_PRIV_NOT_REVOKED
);
1572 if (!wxStrcmp(SQLState
, wxT("01S00")))
1573 return(DB_ERR_INVALID_CONN_STR_ATTR
);
1574 if (!wxStrcmp(SQLState
, wxT("01S01")))
1575 return(DB_ERR_ERROR_IN_ROW
);
1576 if (!wxStrcmp(SQLState
, wxT("01S02")))
1577 return(DB_ERR_OPTION_VALUE_CHANGED
);
1578 if (!wxStrcmp(SQLState
, wxT("01S03")))
1579 return(DB_ERR_NO_ROWS_UPD_OR_DEL
);
1580 if (!wxStrcmp(SQLState
, wxT("01S04")))
1581 return(DB_ERR_MULTI_ROWS_UPD_OR_DEL
);
1582 if (!wxStrcmp(SQLState
, wxT("07001")))
1583 return(DB_ERR_WRONG_NO_OF_PARAMS
);
1584 if (!wxStrcmp(SQLState
, wxT("07006")))
1585 return(DB_ERR_DATA_TYPE_ATTR_VIOL
);
1586 if (!wxStrcmp(SQLState
, wxT("08001")))
1587 return(DB_ERR_UNABLE_TO_CONNECT
);
1588 if (!wxStrcmp(SQLState
, wxT("08002")))
1589 return(DB_ERR_CONNECTION_IN_USE
);
1590 if (!wxStrcmp(SQLState
, wxT("08003")))
1591 return(DB_ERR_CONNECTION_NOT_OPEN
);
1592 if (!wxStrcmp(SQLState
, wxT("08004")))
1593 return(DB_ERR_REJECTED_CONNECTION
);
1594 if (!wxStrcmp(SQLState
, wxT("08007")))
1595 return(DB_ERR_CONN_FAIL_IN_TRANS
);
1596 if (!wxStrcmp(SQLState
, wxT("08S01")))
1597 return(DB_ERR_COMM_LINK_FAILURE
);
1598 if (!wxStrcmp(SQLState
, wxT("21S01")))
1599 return(DB_ERR_INSERT_VALUE_LIST_MISMATCH
);
1600 if (!wxStrcmp(SQLState
, wxT("21S02")))
1601 return(DB_ERR_DERIVED_TABLE_MISMATCH
);
1602 if (!wxStrcmp(SQLState
, wxT("22001")))
1603 return(DB_ERR_STRING_RIGHT_TRUNC
);
1604 if (!wxStrcmp(SQLState
, wxT("22003")))
1605 return(DB_ERR_NUMERIC_VALUE_OUT_OF_RNG
);
1606 if (!wxStrcmp(SQLState
, wxT("22005")))
1607 return(DB_ERR_ERROR_IN_ASSIGNMENT
);
1608 if (!wxStrcmp(SQLState
, wxT("22008")))
1609 return(DB_ERR_DATETIME_FLD_OVERFLOW
);
1610 if (!wxStrcmp(SQLState
, wxT("22012")))
1611 return(DB_ERR_DIVIDE_BY_ZERO
);
1612 if (!wxStrcmp(SQLState
, wxT("22026")))
1613 return(DB_ERR_STR_DATA_LENGTH_MISMATCH
);
1614 if (!wxStrcmp(SQLState
, wxT("23000")))
1615 return(DB_ERR_INTEGRITY_CONSTRAINT_VIOL
);
1616 if (!wxStrcmp(SQLState
, wxT("24000")))
1617 return(DB_ERR_INVALID_CURSOR_STATE
);
1618 if (!wxStrcmp(SQLState
, wxT("25000")))
1619 return(DB_ERR_INVALID_TRANS_STATE
);
1620 if (!wxStrcmp(SQLState
, wxT("28000")))
1621 return(DB_ERR_INVALID_AUTH_SPEC
);
1622 if (!wxStrcmp(SQLState
, wxT("34000")))
1623 return(DB_ERR_INVALID_CURSOR_NAME
);
1624 if (!wxStrcmp(SQLState
, wxT("37000")))
1625 return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL
);
1626 if (!wxStrcmp(SQLState
, wxT("3C000")))
1627 return(DB_ERR_DUPLICATE_CURSOR_NAME
);
1628 if (!wxStrcmp(SQLState
, wxT("40001")))
1629 return(DB_ERR_SERIALIZATION_FAILURE
);
1630 if (!wxStrcmp(SQLState
, wxT("42000")))
1631 return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL2
);
1632 if (!wxStrcmp(SQLState
, wxT("70100")))
1633 return(DB_ERR_OPERATION_ABORTED
);
1634 if (!wxStrcmp(SQLState
, wxT("IM001")))
1635 return(DB_ERR_UNSUPPORTED_FUNCTION
);
1636 if (!wxStrcmp(SQLState
, wxT("IM002")))
1637 return(DB_ERR_NO_DATA_SOURCE
);
1638 if (!wxStrcmp(SQLState
, wxT("IM003")))
1639 return(DB_ERR_DRIVER_LOAD_ERROR
);
1640 if (!wxStrcmp(SQLState
, wxT("IM004")))
1641 return(DB_ERR_SQLALLOCENV_FAILED
);
1642 if (!wxStrcmp(SQLState
, wxT("IM005")))
1643 return(DB_ERR_SQLALLOCCONNECT_FAILED
);
1644 if (!wxStrcmp(SQLState
, wxT("IM006")))
1645 return(DB_ERR_SQLSETCONNECTOPTION_FAILED
);
1646 if (!wxStrcmp(SQLState
, wxT("IM007")))
1647 return(DB_ERR_NO_DATA_SOURCE_DLG_PROHIB
);
1648 if (!wxStrcmp(SQLState
, wxT("IM008")))
1649 return(DB_ERR_DIALOG_FAILED
);
1650 if (!wxStrcmp(SQLState
, wxT("IM009")))
1651 return(DB_ERR_UNABLE_TO_LOAD_TRANSLATION_DLL
);
1652 if (!wxStrcmp(SQLState
, wxT("IM010")))
1653 return(DB_ERR_DATA_SOURCE_NAME_TOO_LONG
);
1654 if (!wxStrcmp(SQLState
, wxT("IM011")))
1655 return(DB_ERR_DRIVER_NAME_TOO_LONG
);
1656 if (!wxStrcmp(SQLState
, wxT("IM012")))
1657 return(DB_ERR_DRIVER_KEYWORD_SYNTAX_ERROR
);
1658 if (!wxStrcmp(SQLState
, wxT("IM013")))
1659 return(DB_ERR_TRACE_FILE_ERROR
);
1660 if (!wxStrcmp(SQLState
, wxT("S0001")))
1661 return(DB_ERR_TABLE_OR_VIEW_ALREADY_EXISTS
);
1662 if (!wxStrcmp(SQLState
, wxT("S0002")))
1663 return(DB_ERR_TABLE_NOT_FOUND
);
1664 if (!wxStrcmp(SQLState
, wxT("S0011")))
1665 return(DB_ERR_INDEX_ALREADY_EXISTS
);
1666 if (!wxStrcmp(SQLState
, wxT("S0012")))
1667 return(DB_ERR_INDEX_NOT_FOUND
);
1668 if (!wxStrcmp(SQLState
, wxT("S0021")))
1669 return(DB_ERR_COLUMN_ALREADY_EXISTS
);
1670 if (!wxStrcmp(SQLState
, wxT("S0022")))
1671 return(DB_ERR_COLUMN_NOT_FOUND
);
1672 if (!wxStrcmp(SQLState
, wxT("S0023")))
1673 return(DB_ERR_NO_DEFAULT_FOR_COLUMN
);
1674 if (!wxStrcmp(SQLState
, wxT("S1000")))
1675 return(DB_ERR_GENERAL_ERROR
);
1676 if (!wxStrcmp(SQLState
, wxT("S1001")))
1677 return(DB_ERR_MEMORY_ALLOCATION_FAILURE
);
1678 if (!wxStrcmp(SQLState
, wxT("S1002")))
1679 return(DB_ERR_INVALID_COLUMN_NUMBER
);
1680 if (!wxStrcmp(SQLState
, wxT("S1003")))
1681 return(DB_ERR_PROGRAM_TYPE_OUT_OF_RANGE
);
1682 if (!wxStrcmp(SQLState
, wxT("S1004")))
1683 return(DB_ERR_SQL_DATA_TYPE_OUT_OF_RANGE
);
1684 if (!wxStrcmp(SQLState
, wxT("S1008")))
1685 return(DB_ERR_OPERATION_CANCELLED
);
1686 if (!wxStrcmp(SQLState
, wxT("S1009")))
1687 return(DB_ERR_INVALID_ARGUMENT_VALUE
);
1688 if (!wxStrcmp(SQLState
, wxT("S1010")))
1689 return(DB_ERR_FUNCTION_SEQUENCE_ERROR
);
1690 if (!wxStrcmp(SQLState
, wxT("S1011")))
1691 return(DB_ERR_OPERATION_INVALID_AT_THIS_TIME
);
1692 if (!wxStrcmp(SQLState
, wxT("S1012")))
1693 return(DB_ERR_INVALID_TRANS_OPERATION_CODE
);
1694 if (!wxStrcmp(SQLState
, wxT("S1015")))
1695 return(DB_ERR_NO_CURSOR_NAME_AVAIL
);
1696 if (!wxStrcmp(SQLState
, wxT("S1090")))
1697 return(DB_ERR_INVALID_STR_OR_BUF_LEN
);
1698 if (!wxStrcmp(SQLState
, wxT("S1091")))
1699 return(DB_ERR_DESCRIPTOR_TYPE_OUT_OF_RANGE
);
1700 if (!wxStrcmp(SQLState
, wxT("S1092")))
1701 return(DB_ERR_OPTION_TYPE_OUT_OF_RANGE
);
1702 if (!wxStrcmp(SQLState
, wxT("S1093")))
1703 return(DB_ERR_INVALID_PARAM_NO
);
1704 if (!wxStrcmp(SQLState
, wxT("S1094")))
1705 return(DB_ERR_INVALID_SCALE_VALUE
);
1706 if (!wxStrcmp(SQLState
, wxT("S1095")))
1707 return(DB_ERR_FUNCTION_TYPE_OUT_OF_RANGE
);
1708 if (!wxStrcmp(SQLState
, wxT("S1096")))
1709 return(DB_ERR_INF_TYPE_OUT_OF_RANGE
);
1710 if (!wxStrcmp(SQLState
, wxT("S1097")))
1711 return(DB_ERR_COLUMN_TYPE_OUT_OF_RANGE
);
1712 if (!wxStrcmp(SQLState
, wxT("S1098")))
1713 return(DB_ERR_SCOPE_TYPE_OUT_OF_RANGE
);
1714 if (!wxStrcmp(SQLState
, wxT("S1099")))
1715 return(DB_ERR_NULLABLE_TYPE_OUT_OF_RANGE
);
1716 if (!wxStrcmp(SQLState
, wxT("S1100")))
1717 return(DB_ERR_UNIQUENESS_OPTION_TYPE_OUT_OF_RANGE
);
1718 if (!wxStrcmp(SQLState
, wxT("S1101")))
1719 return(DB_ERR_ACCURACY_OPTION_TYPE_OUT_OF_RANGE
);
1720 if (!wxStrcmp(SQLState
, wxT("S1103")))
1721 return(DB_ERR_DIRECTION_OPTION_OUT_OF_RANGE
);
1722 if (!wxStrcmp(SQLState
, wxT("S1104")))
1723 return(DB_ERR_INVALID_PRECISION_VALUE
);
1724 if (!wxStrcmp(SQLState
, wxT("S1105")))
1725 return(DB_ERR_INVALID_PARAM_TYPE
);
1726 if (!wxStrcmp(SQLState
, wxT("S1106")))
1727 return(DB_ERR_FETCH_TYPE_OUT_OF_RANGE
);
1728 if (!wxStrcmp(SQLState
, wxT("S1107")))
1729 return(DB_ERR_ROW_VALUE_OUT_OF_RANGE
);
1730 if (!wxStrcmp(SQLState
, wxT("S1108")))
1731 return(DB_ERR_CONCURRENCY_OPTION_OUT_OF_RANGE
);
1732 if (!wxStrcmp(SQLState
, wxT("S1109")))
1733 return(DB_ERR_INVALID_CURSOR_POSITION
);
1734 if (!wxStrcmp(SQLState
, wxT("S1110")))
1735 return(DB_ERR_INVALID_DRIVER_COMPLETION
);
1736 if (!wxStrcmp(SQLState
, wxT("S1111")))
1737 return(DB_ERR_INVALID_BOOKMARK_VALUE
);
1738 if (!wxStrcmp(SQLState
, wxT("S1C00")))
1739 return(DB_ERR_DRIVER_NOT_CAPABLE
);
1740 if (!wxStrcmp(SQLState
, wxT("S1T00")))
1741 return(DB_ERR_TIMEOUT_EXPIRED
);
1746 } // wxDb::TranslateSqlState()
1749 /********** wxDb::Grant() **********/
1750 bool wxDb::Grant(int privileges
, const wxString
&tableName
, const wxString
&userList
)
1754 // Build the grant statement
1755 sqlStmt
= wxT("GRANT ");
1756 if (privileges
== DB_GRANT_ALL
)
1757 sqlStmt
+= wxT("ALL");
1761 if (privileges
& DB_GRANT_SELECT
)
1763 sqlStmt
+= wxT("SELECT");
1766 if (privileges
& DB_GRANT_INSERT
)
1769 sqlStmt
+= wxT(", ");
1770 sqlStmt
+= wxT("INSERT");
1772 if (privileges
& DB_GRANT_UPDATE
)
1775 sqlStmt
+= wxT(", ");
1776 sqlStmt
+= wxT("UPDATE");
1778 if (privileges
& DB_GRANT_DELETE
)
1781 sqlStmt
+= wxT(", ");
1782 sqlStmt
+= wxT("DELETE");
1786 sqlStmt
+= wxT(" ON ");
1787 sqlStmt
+= tableName
;
1788 sqlStmt
+= wxT(" TO ");
1789 sqlStmt
+= userList
;
1791 #ifdef DBDEBUG_CONSOLE
1792 cout
<< endl
<< sqlStmt
.c_str() << endl
;
1795 WriteSqlLog(sqlStmt
);
1797 return(ExecSql(sqlStmt
));
1802 /********** wxDb::CreateView() **********/
1803 bool wxDb::CreateView(const wxString
&viewName
, const wxString
&colList
,
1804 const wxString
&pSqlStmt
, bool attemptDrop
)
1808 // Drop the view first
1809 if (attemptDrop
&& !DropView(viewName
))
1812 // Build the create view statement
1813 sqlStmt
= wxT("CREATE VIEW ");
1814 sqlStmt
+= viewName
;
1816 if (colList
.Length())
1818 sqlStmt
+= wxT(" (");
1820 sqlStmt
+= wxT(")");
1823 sqlStmt
+= wxT(" AS ");
1824 sqlStmt
+= pSqlStmt
;
1826 WriteSqlLog(sqlStmt
);
1828 #ifdef DBDEBUG_CONSOLE
1829 cout
<< sqlStmt
.c_str() << endl
;
1832 return(ExecSql(sqlStmt
));
1834 } // wxDb::CreateView()
1837 /********** wxDb::DropView() **********/
1838 bool wxDb::DropView(const wxString
&viewName
)
1841 * NOTE: This function returns TRUE if the View does not exist, but
1842 * only for identified databases. Code will need to be added
1843 * below for any other databases when those databases are defined
1844 * to handle this situation consistently
1848 sqlStmt
.Printf(wxT("DROP VIEW %s"), viewName
.c_str());
1850 WriteSqlLog(sqlStmt
);
1852 #ifdef DBDEBUG_CONSOLE
1853 cout
<< endl
<< sqlStmt
.c_str() << endl
;
1856 if (SQLExecDirect(hstmt
, (UCHAR FAR
*) sqlStmt
.c_str(), SQL_NTS
) != SQL_SUCCESS
)
1858 // Check for "Base table not found" error and ignore
1859 GetNextError(henv
, hdbc
, hstmt
);
1860 if (wxStrcmp(sqlState
,wxT("S0002"))) // "Base table not found"
1862 // Check for product specific error codes
1863 if (!((Dbms() == dbmsSYBASE_ASA
&& !wxStrcmp(sqlState
,wxT("42000"))))) // 5.x (and lower?)
1866 DispAllErrors(henv
, hdbc
, hstmt
);
1873 // Commit the transaction
1879 } // wxDb::DropView()
1882 /********** wxDb::ExecSql() **********/
1883 bool wxDb::ExecSql(const wxString
&pSqlStmt
)
1887 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1889 retcode
= SQLExecDirect(hstmt
, (UCHAR FAR
*) pSqlStmt
.c_str(), SQL_NTS
);
1890 if (retcode
== SQL_SUCCESS
||
1891 (Dbms() == dbmsDB2
&& (retcode
== SQL_SUCCESS_WITH_INFO
|| retcode
== SQL_NO_DATA_FOUND
)))
1897 DispAllErrors(henv
, hdbc
, hstmt
);
1901 } // wxDb::ExecSql()
1904 /********** wxDb::GetNext() **********/
1905 bool wxDb::GetNext(void)
1907 if (SQLFetch(hstmt
) == SQL_SUCCESS
)
1911 DispAllErrors(henv
, hdbc
, hstmt
);
1915 } // wxDb::GetNext()
1918 /********** wxDb::GetData() **********/
1919 bool wxDb::GetData(UWORD colNo
, SWORD cType
, PTR pData
, SDWORD maxLen
, SDWORD FAR
*cbReturned
)
1922 wxASSERT(cbReturned
);
1924 if (SQLGetData(hstmt
, colNo
, cType
, pData
, maxLen
, cbReturned
) == SQL_SUCCESS
)
1928 DispAllErrors(henv
, hdbc
, hstmt
);
1932 } // wxDb::GetData()
1935 /********** wxDb::GetKeyFields() **********/
1936 int wxDb::GetKeyFields(const wxString
&tableName
, wxDbColInf
* colInf
, UWORD noCols
)
1938 wxChar szPkTable
[DB_MAX_TABLE_NAME_LEN
+1]; /* Primary key table name */
1939 wxChar szFkTable
[DB_MAX_TABLE_NAME_LEN
+1]; /* Foreign key table name */
1941 // SQLSMALLINT iKeySeq;
1942 wxChar szPkCol
[DB_MAX_COLUMN_NAME_LEN
+1]; /* Primary key column */
1943 wxChar szFkCol
[DB_MAX_COLUMN_NAME_LEN
+1]; /* Foreign key column */
1949 * -----------------------------------------------------------------------
1950 * -- 19991224 : mj10777 : Create ------
1951 * -- : Three things are done and stored here : ------
1952 * -- : 1) which Column(s) is/are Primary Key(s) ------
1953 * -- : 2) which tables use this Key as a Foreign Key ------
1954 * -- : 3) which columns are Foreign Key and the name ------
1955 * -- : of the Table where the Key is the Primary Key -----
1956 * -- : Called from GetColumns(const wxString &tableName, ------
1957 * -- int *numCols,const wxChar *userID ) ------
1958 * -----------------------------------------------------------------------
1961 /*---------------------------------------------------------------------*/
1962 /* Get the names of the columns in the primary key. */
1963 /*---------------------------------------------------------------------*/
1964 retcode
= SQLPrimaryKeys(hstmt
,
1965 NULL
, 0, /* Catalog name */
1966 NULL
, 0, /* Schema name */
1967 (UCHAR FAR
*) tableName
.c_str(), SQL_NTS
); /* Table name */
1969 /*---------------------------------------------------------------------*/
1970 /* Fetch and display the result set. This will be a list of the */
1971 /* columns in the primary key of the tableName table. */
1972 /*---------------------------------------------------------------------*/
1973 while ((retcode
== SQL_SUCCESS
) || (retcode
== SQL_SUCCESS_WITH_INFO
))
1975 retcode
= SQLFetch(hstmt
);
1976 if (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
1978 GetData( 4, SQL_C_CHAR
, szPkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
1979 GetData( 5, SQL_C_SSHORT
, &iKeySeq
, 0, &cb
);
1981 for (i
=0;i
<noCols
;i
++) // Find the Column name
1982 if (!wxStrcmp(colInf
[i
].colName
,szPkCol
)) // We have found the Column
1983 colInf
[i
].PkCol
= iKeySeq
; // Which Primary Key is this (first, second usw.) ?
1986 SQLFreeStmt(hstmt
, SQL_CLOSE
); /* Close the cursor (the hstmt is still allocated). */
1988 /*---------------------------------------------------------------------*/
1989 /* Get all the foreign keys that refer to tableName primary key. */
1990 /*---------------------------------------------------------------------*/
1991 retcode
= SQLForeignKeys(hstmt
,
1992 NULL
, 0, /* Primary catalog */
1993 NULL
, 0, /* Primary schema */
1994 (UCHAR FAR
*)tableName
.c_str(), SQL_NTS
,/* Primary table */
1995 NULL
, 0, /* Foreign catalog */
1996 NULL
, 0, /* Foreign schema */
1997 NULL
, 0); /* Foreign table */
1999 /*---------------------------------------------------------------------*/
2000 /* Fetch and display the result set. This will be all of the foreign */
2001 /* keys in other tables that refer to the tableName primary key. */
2002 /*---------------------------------------------------------------------*/
2005 while ((retcode
== SQL_SUCCESS
) || (retcode
== SQL_SUCCESS_WITH_INFO
))
2007 retcode
= SQLFetch(hstmt
);
2008 if (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
2010 GetData( 3, SQL_C_CHAR
, szPkTable
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2011 GetData( 4, SQL_C_CHAR
, szPkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2012 GetData( 5, SQL_C_SSHORT
, &iKeySeq
, 0, &cb
);
2013 GetData( 7, SQL_C_CHAR
, szFkTable
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2014 GetData( 8, SQL_C_CHAR
, szFkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2015 tempStr
.Printf(wxT("%s[%s] "),tempStr
.c_str(),szFkTable
); // [ ] in case there is a blank in the Table name
2019 tempStr
.Trim(); // Get rid of any unneeded blanks
2020 if (!tempStr
.IsEmpty())
2022 for (i
=0; i
<noCols
; i
++)
2023 { // Find the Column name
2024 if (!wxStrcmp(colInf
[i
].colName
, szPkCol
)) // We have found the Column, store the Information
2025 wxStrcpy(colInf
[i
].PkTableName
, tempStr
.c_str()); // Name of the Tables where this Primary Key is used as a Foreign Key
2029 SQLFreeStmt(hstmt
, SQL_CLOSE
); /* Close the cursor (the hstmt is still allocated). */
2031 /*---------------------------------------------------------------------*/
2032 /* Get all the foreign keys in the tablename table. */
2033 /*---------------------------------------------------------------------*/
2034 retcode
= SQLForeignKeys(hstmt
,
2035 NULL
, 0, /* Primary catalog */
2036 NULL
, 0, /* Primary schema */
2037 NULL
, 0, /* Primary table */
2038 NULL
, 0, /* Foreign catalog */
2039 NULL
, 0, /* Foreign schema */
2040 (UCHAR
*)tableName
.c_str(), SQL_NTS
);/* Foreign table */
2042 /*---------------------------------------------------------------------*/
2043 /* Fetch and display the result set. This will be all of the */
2044 /* primary keys in other tables that are referred to by foreign */
2045 /* keys in the tableName table. */
2046 /*---------------------------------------------------------------------*/
2048 while ((retcode
== SQL_SUCCESS
) || (retcode
== SQL_SUCCESS_WITH_INFO
))
2050 retcode
= SQLFetch(hstmt
);
2051 if (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
2053 GetData( 3, SQL_C_CHAR
, szPkTable
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2054 GetData( 5, SQL_C_SSHORT
, &iKeySeq
, 0, &cb
);
2055 GetData( 8, SQL_C_CHAR
, szFkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2057 for (i
=0; i
<noCols
; i
++) // Find the Column name
2059 if (!wxStrcmp(colInf
[i
].colName
,szFkCol
)) // We have found the (Foreign Key) Column
2061 colInf
[i
].FkCol
= iKeySeq
; // Which Foreign Key is this (first, second usw.) ?
2062 wxStrcpy(colInf
[i
].FkTableName
,szPkTable
); // Name of the Table where this Foriegn is the Primary Key
2067 SQLFreeStmt(hstmt
, SQL_CLOSE
); /* Close the cursor (the hstmt is still allocated). */
2071 } // wxDb::GetKeyFields()
2075 /********** wxDb::GetColumns() **********/
2076 wxDbColInf
*wxDb::GetColumns(wxChar
*tableName
[], const wxChar
*userID
)
2078 * 1) The last array element of the tableName[] argument must be zero (null).
2079 * This is how the end of the array is detected.
2080 * 2) This function returns an array of wxDbColInf structures. If no columns
2081 * were found, or an error occured, this pointer will be zero (null). THE
2082 * CALLING FUNCTION IS RESPONSIBLE FOR DELETING THE MEMORY RETURNED WHEN IT
2083 * IS FINISHED WITH IT. i.e.
2085 * wxDbColInf *colInf = pDb->GetColumns(tableList, userID);
2088 * // Use the column inf
2090 * // Destroy the memory
2094 * userID is evaluated in the following manner:
2095 * userID == NULL ... UserID is ignored
2096 * userID == "" ... UserID set equal to 'this->uid'
2097 * userID != "" ... UserID set equal to 'userID'
2099 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2100 * by this function. This function should use its own wxDb instance
2101 * to avoid undesired unbinding of columns.
2106 wxDbColInf
*colInf
= 0;
2114 convertUserID(userID
,UserID
);
2116 // Pass 1 - Determine how many columns there are.
2117 // Pass 2 - Allocate the wxDbColInf array and fill in
2118 // the array with the column information.
2120 for (pass
= 1; pass
<= 2; pass
++)
2124 if (noCols
== 0) // Probably a bogus table name(s)
2126 // Allocate n wxDbColInf objects to hold the column information
2127 colInf
= new wxDbColInf
[noCols
+1];
2130 // Mark the end of the array
2131 wxStrcpy(colInf
[noCols
].tableName
,wxEmptyString
);
2132 wxStrcpy(colInf
[noCols
].colName
,wxEmptyString
);
2133 colInf
[noCols
].sqlDataType
= 0;
2135 // Loop through each table name
2137 for (tbl
= 0; tableName
[tbl
]; tbl
++)
2139 TableName
= tableName
[tbl
];
2140 // Oracle and Interbase table names are uppercase only, so force
2141 // the name to uppercase just in case programmer forgot to do this
2142 if ((Dbms() == dbmsORACLE
) ||
2143 (Dbms() == dbmsINTERBASE
))
2144 TableName
= TableName
.Upper();
2146 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2148 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2149 // use the call below that leaves out the user name
2150 if (!UserID
.IsEmpty() &&
2151 Dbms() != dbmsMY_SQL
&&
2152 Dbms() != dbmsACCESS
&&
2153 Dbms() != dbmsMS_SQL_SERVER
)
2155 retcode
= SQLColumns(hstmt
,
2156 NULL
, 0, // All qualifiers
2157 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2158 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2159 NULL
, 0); // All columns
2163 retcode
= SQLColumns(hstmt
,
2164 NULL
, 0, // All qualifiers
2166 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2167 NULL
, 0); // All columns
2169 if (retcode
!= SQL_SUCCESS
)
2170 { // Error occured, abort
2171 DispAllErrors(henv
, hdbc
, hstmt
);
2174 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2178 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2180 if (pass
== 1) // First pass, just add up the number of columns
2182 else // Pass 2; Fill in the array of structures
2184 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
2186 // NOTE: Only the ODBC 1.x fields are retrieved
2187 GetData( 1, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].catalog
, 128+1, &cb
);
2188 GetData( 2, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].schema
, 128+1, &cb
);
2189 GetData( 3, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2190 GetData( 4, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2191 GetData( 5, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].sqlDataType
, 0, &cb
);
2192 GetData( 6, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].typeName
, 128+1, &cb
);
2193 GetData( 7, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].columnSize
, 0, &cb
);
2194 GetData( 8, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].bufferLength
, 0, &cb
);
2195 GetData( 9, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].decimalDigits
,0, &cb
);
2196 GetData(10, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].numPrecRadix
, 0, &cb
);
2197 GetData(11, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].nullable
, 0, &cb
);
2198 GetData(12, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].remarks
, 254+1, &cb
);
2200 // Determine the wxDb data type that is used to represent the native data type of this data source
2201 colInf
[colNo
].dbDataType
= 0;
2202 if (!wxStricmp(typeInfVarchar
.TypeName
,colInf
[colNo
].typeName
))
2205 // IODBC does not return a correct columnSize, so we set
2206 // columnSize = bufferLength if no column size was returned
2207 // IODBC returns the columnSize in bufferLength.. (bug)
2208 if (colInf
[colNo
].columnSize
< 1)
2210 colInf
[colNo
].columnSize
= colInf
[colNo
].bufferLength
;
2213 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_VARCHAR
;
2215 else if (!wxStricmp(typeInfInteger
.TypeName
, colInf
[colNo
].typeName
))
2216 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_INTEGER
;
2217 else if (!wxStricmp(typeInfFloat
.TypeName
, colInf
[colNo
].typeName
))
2218 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_FLOAT
;
2219 else if (!wxStricmp(typeInfDate
.TypeName
, colInf
[colNo
].typeName
))
2220 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_DATE
;
2221 else if (!wxStricmp(typeInfBlob
.TypeName
, colInf
[colNo
].typeName
))
2222 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_BLOB
;
2227 if (retcode
!= SQL_NO_DATA_FOUND
)
2228 { // Error occured, abort
2229 DispAllErrors(henv
, hdbc
, hstmt
);
2232 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2238 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2241 } // wxDb::GetColumns()
2244 /********** wxDb::GetColumns() **********/
2246 wxDbColInf
*wxDb::GetColumns(const wxString
&tableName
, UWORD
*numCols
, const wxChar
*userID
)
2248 // Same as the above GetColumns() function except this one gets columns
2249 // only for a single table, and if 'numCols' is not NULL, the number of
2250 // columns stored in the returned wxDbColInf is set in '*numCols'
2252 // userID is evaluated in the following manner:
2253 // userID == NULL ... UserID is ignored
2254 // userID == "" ... UserID set equal to 'this->uid'
2255 // userID != "" ... UserID set equal to 'userID'
2257 // NOTE: ALL column bindings associated with this wxDb instance are unbound
2258 // by this function. This function should use its own wxDb instance
2259 // to avoid undesired unbinding of columns.
2264 wxDbColInf
*colInf
= 0;
2272 convertUserID(userID
,UserID
);
2274 // Pass 1 - Determine how many columns there are.
2275 // Pass 2 - Allocate the wxDbColInf array and fill in
2276 // the array with the column information.
2278 for (pass
= 1; pass
<= 2; pass
++)
2282 if (noCols
== 0) // Probably a bogus table name(s)
2284 // Allocate n wxDbColInf objects to hold the column information
2285 colInf
= new wxDbColInf
[noCols
+1];
2288 // Mark the end of the array
2289 wxStrcpy(colInf
[noCols
].tableName
, wxEmptyString
);
2290 wxStrcpy(colInf
[noCols
].colName
, wxEmptyString
);
2291 colInf
[noCols
].sqlDataType
= 0;
2294 TableName
= tableName
;
2295 // Oracle and Interbase table names are uppercase only, so force
2296 // the name to uppercase just in case programmer forgot to do this
2297 if ((Dbms() == dbmsORACLE
) ||
2298 (Dbms() == dbmsINTERBASE
))
2299 TableName
= TableName
.Upper();
2301 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2303 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2304 // use the call below that leaves out the user name
2305 if (!UserID
.IsEmpty() &&
2306 Dbms() != dbmsMY_SQL
&&
2307 Dbms() != dbmsACCESS
&&
2308 Dbms() != dbmsMS_SQL_SERVER
)
2310 retcode
= SQLColumns(hstmt
,
2311 NULL
, 0, // All qualifiers
2312 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2313 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2314 NULL
, 0); // All columns
2318 retcode
= SQLColumns(hstmt
,
2319 NULL
, 0, // All qualifiers
2321 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2322 NULL
, 0); // All columns
2324 if (retcode
!= SQL_SUCCESS
)
2325 { // Error occured, abort
2326 DispAllErrors(henv
, hdbc
, hstmt
);
2329 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2335 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2337 if (pass
== 1) // First pass, just add up the number of columns
2339 else // Pass 2; Fill in the array of structures
2341 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
2343 // NOTE: Only the ODBC 1.x fields are retrieved
2344 GetData( 1, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].catalog
, 128+1, &cb
);
2345 GetData( 2, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].schema
, 128+1, &cb
);
2346 GetData( 3, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2347 GetData( 4, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2348 GetData( 5, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].sqlDataType
, 0, &cb
);
2349 GetData( 6, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].typeName
, 128+1, &cb
);
2350 GetData( 7, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].columnSize
, 0, &cb
);
2351 // BJO 991214 : SQL_C_SSHORT instead of SQL_C_SLONG, otherwise fails on Sparc (probably all 64 bit architectures)
2352 GetData( 8, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].bufferLength
, 0, &cb
);
2353 GetData( 9, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].decimalDigits
,0, &cb
);
2354 GetData(10, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].numPrecRadix
, 0, &cb
);
2355 GetData(11, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].nullable
, 0, &cb
);
2356 GetData(12, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].remarks
, 254+1, &cb
);
2357 // Start Values for Primary/Foriegn Key (=No)
2358 colInf
[colNo
].PkCol
= 0; // Primary key column 0=No; 1= First Key, 2 = Second Key etc.
2359 colInf
[colNo
].PkTableName
[0] = 0; // Tablenames where Primary Key is used as a Foreign Key
2360 colInf
[colNo
].FkCol
= 0; // Foreign key column 0=No; 1= First Key, 2 = Second Key etc.
2361 colInf
[colNo
].FkTableName
[0] = 0; // Foreign key table name
2363 // BJO 20000428 : Virtuoso returns type names with upper cases!
2364 if (Dbms() == dbmsVIRTUOSO
)
2366 wxString s
= colInf
[colNo
].typeName
;
2368 wxStrcmp(colInf
[colNo
].typeName
, s
.c_str());
2371 // Determine the wxDb data type that is used to represent the native data type of this data source
2372 colInf
[colNo
].dbDataType
= 0;
2373 if (!wxStricmp(typeInfVarchar
.TypeName
, colInf
[colNo
].typeName
))
2376 // IODBC does not return a correct columnSize, so we set
2377 // columnSize = bufferLength if no column size was returned
2378 // IODBC returns the columnSize in bufferLength.. (bug)
2379 if (colInf
[colNo
].columnSize
< 1)
2381 colInf
[colNo
].columnSize
= colInf
[colNo
].bufferLength
;
2385 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_VARCHAR
;
2387 else if (!wxStricmp(typeInfInteger
.TypeName
, colInf
[colNo
].typeName
))
2388 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_INTEGER
;
2389 else if (!wxStricmp(typeInfFloat
.TypeName
, colInf
[colNo
].typeName
))
2390 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_FLOAT
;
2391 else if (!wxStricmp(typeInfDate
.TypeName
, colInf
[colNo
].typeName
))
2392 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_DATE
;
2393 else if (!wxStricmp(typeInfBlob
.TypeName
, colInf
[colNo
].typeName
))
2394 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_BLOB
;
2400 if (retcode
!= SQL_NO_DATA_FOUND
)
2401 { // Error occured, abort
2402 DispAllErrors(henv
, hdbc
, hstmt
);
2405 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2412 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2414 // Store Primary and Foriegn Keys
2415 GetKeyFields(tableName
,colInf
,noCols
);
2421 } // wxDb::GetColumns()
2424 #else // New GetColumns
2429 These are tentative new GetColumns members which should be more database
2430 independant and which always returns the columns in the order they were
2433 - The first one (wxDbColInf *wxDb::GetColumns(wxChar *tableName[], const
2434 wxChar* userID)) calls the second implementation for each separate table
2435 before merging the results. This makes the code easier to maintain as
2436 only one member (the second) makes the real work
2437 - wxDbColInf *wxDb::GetColumns(const wxString &tableName, int *numCols, const
2438 wxChar *userID) is a little bit improved
2439 - It doesn't anymore rely on the type-name to find out which database-type
2441 - It ends by sorting the columns, so that they are returned in the same
2442 order they were created
2452 wxDbColInf
*wxDb::GetColumns(wxChar
*tableName
[], const wxChar
*userID
)
2455 // The last array element of the tableName[] argument must be zero (null).
2456 // This is how the end of the array is detected.
2460 // How many tables ?
2462 for (tbl
= 0 ; tableName
[tbl
]; tbl
++);
2464 // Create a table to maintain the columns for each separate table
2465 _TableColumns
*TableColumns
= new _TableColumns
[tbl
];
2468 for (i
= 0 ; i
< tbl
; i
++)
2471 TableColumns
[i
].colInf
= GetColumns(tableName
[i
], &TableColumns
[i
].noCols
, userID
);
2472 if (TableColumns
[i
].colInf
== NULL
)
2474 noCols
+= TableColumns
[i
].noCols
;
2477 // Now merge all the separate table infos
2478 wxDbColInf
*colInf
= new wxDbColInf
[noCols
+1];
2480 // Mark the end of the array
2481 wxStrcpy(colInf
[noCols
].tableName
, wxEmptyString
);
2482 wxStrcpy(colInf
[noCols
].colName
, wxEmptyString
);
2483 colInf
[noCols
].sqlDataType
= 0;
2488 for (i
= 0 ; i
< tbl
; i
++)
2490 for (j
= 0 ; j
< TableColumns
[i
].noCols
; j
++)
2492 colInf
[offset
++] = TableColumns
[i
].colInf
[j
];
2496 delete [] TableColumns
;
2499 } // wxDb::GetColumns() -- NEW
2502 wxDbColInf
*wxDb::GetColumns(const wxString
&tableName
, int *numCols
, const wxChar
*userID
)
2504 // Same as the above GetColumns() function except this one gets columns
2505 // only for a single table, and if 'numCols' is not NULL, the number of
2506 // columns stored in the returned wxDbColInf is set in '*numCols'
2508 // userID is evaluated in the following manner:
2509 // userID == NULL ... UserID is ignored
2510 // userID == "" ... UserID set equal to 'this->uid'
2511 // userID != "" ... UserID set equal to 'userID'
2513 // NOTE: ALL column bindings associated with this wxDb instance are unbound
2514 // by this function. This function should use its own wxDb instance
2515 // to avoid undesired unbinding of columns.
2519 wxDbColInf
*colInf
= 0;
2527 convertUserID(userID
,UserID
);
2529 // Pass 1 - Determine how many columns there are.
2530 // Pass 2 - Allocate the wxDbColInf array and fill in
2531 // the array with the column information.
2533 for (pass
= 1; pass
<= 2; pass
++)
2537 if (noCols
== 0) // Probably a bogus table name(s)
2539 // Allocate n wxDbColInf objects to hold the column information
2540 colInf
= new wxDbColInf
[noCols
+1];
2543 // Mark the end of the array
2544 wxStrcpy(colInf
[noCols
].tableName
, wxEmptyString
);
2545 wxStrcpy(colInf
[noCols
].colName
, wxEmptyString
);
2546 colInf
[noCols
].sqlDataType
= 0;
2549 TableName
= tableName
;
2550 // Oracle and Interbase table names are uppercase only, so force
2551 // the name to uppercase just in case programmer forgot to do this
2552 if ((Dbms() == dbmsORACLE
) ||
2553 (Dbms() == dbmsINTERBASE
))
2554 TableName
= TableName
.Upper();
2556 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2558 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2559 // use the call below that leaves out the user name
2560 if (!UserID
.IsEmpty() &&
2561 Dbms() != dbmsMY_SQL
&&
2562 Dbms() != dbmsACCESS
&&
2563 Dbms() != dbmsMS_SQL_SERVER
)
2565 retcode
= SQLColumns(hstmt
,
2566 NULL
, 0, // All qualifiers
2567 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2568 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2569 NULL
, 0); // All columns
2573 retcode
= SQLColumns(hstmt
,
2574 NULL
, 0, // All qualifiers
2576 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2577 NULL
, 0); // All columns
2579 if (retcode
!= SQL_SUCCESS
)
2580 { // Error occured, abort
2581 DispAllErrors(henv
, hdbc
, hstmt
);
2584 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2590 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2592 if (pass
== 1) // First pass, just add up the number of columns
2594 else // Pass 2; Fill in the array of structures
2596 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
2598 // NOTE: Only the ODBC 1.x fields are retrieved
2599 GetData( 1, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].catalog
, 128+1, &cb
);
2600 GetData( 2, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].schema
, 128+1, &cb
);
2601 GetData( 3, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2602 GetData( 4, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2603 GetData( 5, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].sqlDataType
, 0, &cb
);
2604 GetData( 6, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].typeName
, 128+1, &cb
);
2605 GetData( 7, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].columnSize
, 0, &cb
);
2606 GetData( 8, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].bufferLength
, 0, &cb
);
2607 GetData( 9, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].decimalDigits
,0, &cb
);
2608 GetData(10, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].numPrecRadix
, 0, &cb
);
2609 GetData(11, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].nullable
, 0, &cb
);
2610 GetData(12, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].remarks
, 254+1, &cb
);
2611 // Start Values for Primary/Foriegn Key (=No)
2612 colInf
[colNo
].PkCol
= 0; // Primary key column 0=No; 1= First Key, 2 = Second Key etc.
2613 colInf
[colNo
].PkTableName
[0] = 0; // Tablenames where Primary Key is used as a Foreign Key
2614 colInf
[colNo
].FkCol
= 0; // Foreign key column 0=No; 1= First Key, 2 = Second Key etc.
2615 colInf
[colNo
].FkTableName
[0] = 0; // Foreign key table name
2618 // IODBC does not return a correct columnSize, so we set
2619 // columnSize = bufferLength if no column size was returned
2620 // IODBC returns the columnSize in bufferLength.. (bug)
2621 if (colInf
[colNo
].columnSize
< 1)
2623 colInf
[colNo
].columnSize
= colInf
[colNo
].bufferLength
;
2627 // Determine the wxDb data type that is used to represent the native data type of this data source
2628 colInf
[colNo
].dbDataType
= 0;
2629 // Get the intern datatype
2630 switch (colInf
[colNo
].sqlDataType
)
2634 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_VARCHAR
;
2640 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_INTEGER
;
2647 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_FLOAT
;
2650 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_DATE
;
2653 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_BLOB
;
2658 errMsg
.Printf(wxT("SQL Data type %d currently not supported by wxWindows"), colInf
[colNo
].sqlDataType
);
2659 wxLogDebug(errMsg
,wxT("ODBC DEBUG MESSAGE"));
2666 if (retcode
!= SQL_NO_DATA_FOUND
)
2667 { // Error occured, abort
2668 DispAllErrors(henv
, hdbc
, hstmt
);
2671 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2678 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2680 // Store Primary and Foreign Keys
2681 GetKeyFields(tableName
,colInf
,noCols
);
2683 ///////////////////////////////////////////////////////////////////////////
2684 // Now sort the the columns in order to make them appear in the right order
2685 ///////////////////////////////////////////////////////////////////////////
2687 // Build a generic SELECT statement which returns 0 rows
2690 Stmt
.Printf(wxT("select * from %s where 0=1"), tableName
);
2693 if (SQLExecDirect(hstmt
, (UCHAR FAR
*) Stmt
.c_str(), SQL_NTS
) != SQL_SUCCESS
)
2695 DispAllErrors(henv
, hdbc
, hstmt
);
2699 // Get the number of result columns
2700 if (SQLNumResultCols (hstmt
, &noCols
) != SQL_SUCCESS
)
2702 DispAllErrors(henv
, hdbc
, hstmt
);
2706 if (noCols
== 0) // Probably a bogus table name
2715 for (colNum
= 0; colNum
< noCols
; colNum
++)
2717 if (SQLColAttributes(hstmt
,colNum
+1, SQL_COLUMN_NAME
,
2719 &Sword
, &Sdword
) != SQL_SUCCESS
)
2721 DispAllErrors(henv
, hdbc
, hstmt
);
2725 wxString Name1
= name
;
2726 Name1
= Name1
.Upper();
2728 // Where is this name in the array ?
2729 for (i
= colNum
; i
< noCols
; i
++)
2731 wxString Name2
= colInf
[i
].colName
;
2732 Name2
= Name2
.Upper();
2735 if (colNum
!= i
) // swap to sort
2737 wxDbColInf tmpColInf
= colInf
[colNum
];
2738 colInf
[colNum
] = colInf
[i
];
2739 colInf
[i
] = tmpColInf
;
2745 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2747 ///////////////////////////////////////////////////////////////////////////
2749 ///////////////////////////////////////////////////////////////////////////
2755 } // wxDb::GetColumns()
2758 #endif // #else OLD_GETCOLUMNS
2761 /********** wxDb::GetColumnCount() **********/
2762 int wxDb::GetColumnCount(const wxString
&tableName
, const wxChar
*userID
)
2764 * Returns a count of how many columns are in a table.
2765 * If an error occurs in computing the number of columns
2766 * this function will return a -1 for the count
2768 * userID is evaluated in the following manner:
2769 * userID == NULL ... UserID is ignored
2770 * userID == "" ... UserID set equal to 'this->uid'
2771 * userID != "" ... UserID set equal to 'userID'
2773 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2774 * by this function. This function should use its own wxDb instance
2775 * to avoid undesired unbinding of columns.
2785 convertUserID(userID
,UserID
);
2787 TableName
= tableName
;
2788 // Oracle and Interbase table names are uppercase only, so force
2789 // the name to uppercase just in case programmer forgot to do this
2790 if ((Dbms() == dbmsORACLE
) ||
2791 (Dbms() == dbmsINTERBASE
))
2792 TableName
= TableName
.Upper();
2794 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2796 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2797 // use the call below that leaves out the user name
2798 if (!UserID
.IsEmpty() &&
2799 Dbms() != dbmsMY_SQL
&&
2800 Dbms() != dbmsACCESS
&&
2801 Dbms() != dbmsMS_SQL_SERVER
)
2803 retcode
= SQLColumns(hstmt
,
2804 NULL
, 0, // All qualifiers
2805 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2806 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2807 NULL
, 0); // All columns
2811 retcode
= SQLColumns(hstmt
,
2812 NULL
, 0, // All qualifiers
2814 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2815 NULL
, 0); // All columns
2817 if (retcode
!= SQL_SUCCESS
)
2818 { // Error occured, abort
2819 DispAllErrors(henv
, hdbc
, hstmt
);
2820 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2824 // Count the columns
2825 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2828 if (retcode
!= SQL_NO_DATA_FOUND
)
2829 { // Error occured, abort
2830 DispAllErrors(henv
, hdbc
, hstmt
);
2831 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2835 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2838 } // wxDb::GetColumnCount()
2841 /********** wxDb::GetCatalog() *******/
2842 wxDbInf
*wxDb::GetCatalog(const wxChar
*userID
)
2844 * ---------------------------------------------------------------------
2845 * -- 19991203 : mj10777 : Create ------
2846 * -- : Creates a wxDbInf with Tables / Cols Array ------
2847 * -- : uses SQLTables and fills pTableInf; ------
2848 * -- : pColInf is set to NULL and numCols to 0; ------
2849 * -- : returns pDbInf (wxDbInf) ------
2850 * -- - if unsuccesfull (pDbInf == NULL) ------
2851 * -- : pColInf can be filled with GetColumns(..); ------
2852 * -- : numCols can be filled with GetColumnCount(..); ------
2853 * ---------------------------------------------------------------------
2855 * userID is evaluated in the following manner:
2856 * userID == NULL ... UserID is ignored
2857 * userID == "" ... UserID set equal to 'this->uid'
2858 * userID != "" ... UserID set equal to 'userID'
2860 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2861 * by this function. This function should use its own wxDb instance
2862 * to avoid undesired unbinding of columns.
2865 wxDbInf
*pDbInf
= NULL
; // Array of catalog entries
2866 int noTab
= 0; // Counter while filling table entries
2870 wxString tblNameSave
;
2873 convertUserID(userID
,UserID
);
2875 //-------------------------------------------------------------
2876 pDbInf
= new wxDbInf
; // Create the Database Array
2877 //-------------------------------------------------------------
2878 // Table Information
2879 // Pass 1 - Determine how many Tables there are.
2880 // Pass 2 - Create the Table array and fill it
2881 // - Create the Cols array = NULL
2882 //-------------------------------------------------------------
2884 for (pass
= 1; pass
<= 2; pass
++)
2886 SQLFreeStmt(hstmt
, SQL_CLOSE
); // Close if Open
2887 tblNameSave
.Empty();
2889 if (!UserID
.IsEmpty() &&
2890 Dbms() != dbmsMY_SQL
&&
2891 Dbms() != dbmsACCESS
&&
2892 Dbms() != dbmsMS_SQL_SERVER
)
2894 retcode
= SQLTables(hstmt
,
2895 NULL
, 0, // All qualifiers
2896 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // User specified
2897 NULL
, 0, // All tables
2898 NULL
, 0); // All columns
2902 retcode
= SQLTables(hstmt
,
2903 NULL
, 0, // All qualifiers
2904 NULL
, 0, // User specified
2905 NULL
, 0, // All tables
2906 NULL
, 0); // All columns
2909 if (retcode
!= SQL_SUCCESS
)
2911 DispAllErrors(henv
, hdbc
, hstmt
);
2913 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2917 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
) // Table Information
2919 if (pass
== 1) // First pass, just count the Tables
2921 if (pDbInf
->numTables
== 0)
2923 GetData( 1, SQL_C_CHAR
, (UCHAR
*) pDbInf
->catalog
, 128+1, &cb
);
2924 GetData( 2, SQL_C_CHAR
, (UCHAR
*) pDbInf
->schema
, 128+1, &cb
);
2926 pDbInf
->numTables
++; // Counter for Tables
2928 if (pass
== 2) // Create and fill the Table entries
2930 if (pDbInf
->pTableInf
== NULL
) // Has the Table Array been created
2931 { // no, then create the Array
2932 pDbInf
->pTableInf
= new wxDbTableInf
[pDbInf
->numTables
];
2934 } // if (pDbInf->pTableInf == NULL) // Has the Table Array been created
2936 GetData( 3, SQL_C_CHAR
, (UCHAR
*) (pDbInf
->pTableInf
+noTab
)->tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2937 GetData( 4, SQL_C_CHAR
, (UCHAR
*) (pDbInf
->pTableInf
+noTab
)->tableType
, 30+1, &cb
);
2938 GetData( 5, SQL_C_CHAR
, (UCHAR
*) (pDbInf
->pTableInf
+noTab
)->tableRemarks
, 254+1, &cb
);
2944 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2946 // Query how many columns are in each table
2947 for (noTab
=0;noTab
<pDbInf
->numTables
;noTab
++)
2949 (pDbInf
->pTableInf
+noTab
)->numCols
= GetColumnCount((pDbInf
->pTableInf
+noTab
)->tableName
,UserID
);
2954 } // wxDb::GetCatalog()
2957 /********** wxDb::Catalog() **********/
2958 bool wxDb::Catalog(const wxChar
*userID
, const wxString
&fileName
)
2960 * Creates the text file specified in 'filename' which will contain
2961 * a minimal data dictionary of all tables accessible by the user specified
2964 * userID is evaluated in the following manner:
2965 * userID == NULL ... UserID is ignored
2966 * userID == "" ... UserID set equal to 'this->uid'
2967 * userID != "" ... UserID set equal to 'userID'
2969 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2970 * by this function. This function should use its own wxDb instance
2971 * to avoid undesired unbinding of columns.
2974 wxASSERT(fileName
.Length());
2978 wxChar tblName
[DB_MAX_TABLE_NAME_LEN
+1];
2979 wxString tblNameSave
;
2980 wxChar colName
[DB_MAX_COLUMN_NAME_LEN
+1];
2982 wxChar typeName
[30+1];
2983 SWORD precision
, length
;
2985 FILE *fp
= fopen(fileName
.c_str(),wxT("wt"));
2989 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2992 convertUserID(userID
,UserID
);
2994 if (!UserID
.IsEmpty() &&
2995 Dbms() != dbmsMY_SQL
&&
2996 Dbms() != dbmsACCESS
&&
2997 Dbms() != dbmsINTERBASE
&&
2998 Dbms() != dbmsMS_SQL_SERVER
)
3000 retcode
= SQLColumns(hstmt
,
3001 NULL
, 0, // All qualifiers
3002 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // User specified
3003 NULL
, 0, // All tables
3004 NULL
, 0); // All columns
3008 retcode
= SQLColumns(hstmt
,
3009 NULL
, 0, // All qualifiers
3010 NULL
, 0, // User specified
3011 NULL
, 0, // All tables
3012 NULL
, 0); // All columns
3014 if (retcode
!= SQL_SUCCESS
)
3016 DispAllErrors(henv
, hdbc
, hstmt
);
3022 tblNameSave
.Empty();
3025 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
3027 if (wxStrcmp(tblName
, tblNameSave
.c_str()))
3030 fputs(wxT("\n"), fp
);
3031 fputs(wxT("================================ "), fp
);
3032 fputs(wxT("================================ "), fp
);
3033 fputs(wxT("===================== "), fp
);
3034 fputs(wxT("========= "), fp
);
3035 fputs(wxT("=========\n"), fp
);
3036 outStr
.Printf(wxT("%-32s %-32s %-21s %9s %9s\n"),
3037 wxT("TABLE NAME"), wxT("COLUMN NAME"), wxT("DATA TYPE"), wxT("PRECISION"), wxT("LENGTH"));
3038 fputs(outStr
.c_str(), fp
);
3039 fputs(wxT("================================ "), fp
);
3040 fputs(wxT("================================ "), fp
);
3041 fputs(wxT("===================== "), fp
);
3042 fputs(wxT("========= "), fp
);
3043 fputs(wxT("=========\n"), fp
);
3044 tblNameSave
= tblName
;
3047 GetData(3,SQL_C_CHAR
, (UCHAR
*)tblName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
3048 GetData(4,SQL_C_CHAR
, (UCHAR
*)colName
, DB_MAX_COLUMN_NAME_LEN
+1,&cb
);
3049 GetData(5,SQL_C_SSHORT
,(UCHAR
*)&sqlDataType
,0, &cb
);
3050 GetData(6,SQL_C_CHAR
, (UCHAR
*)typeName
, sizeof(typeName
), &cb
);
3051 GetData(7,SQL_C_SSHORT
,(UCHAR
*)&precision
, 0, &cb
);
3052 GetData(8,SQL_C_SSHORT
,(UCHAR
*)&length
, 0, &cb
);
3054 outStr
.Printf(wxT("%-32s %-32s (%04d)%-15s %9d %9d\n"),
3055 tblName
, colName
, sqlDataType
, typeName
, precision
, length
);
3056 if (fputs(outStr
.c_str(), fp
) == EOF
)
3058 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3065 if (retcode
!= SQL_NO_DATA_FOUND
)
3066 DispAllErrors(henv
, hdbc
, hstmt
);
3068 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3071 return(retcode
== SQL_NO_DATA_FOUND
);
3073 } // wxDb::Catalog()
3076 bool wxDb::TableExists(const wxString
&tableName
, const wxChar
*userID
, const wxString
&tablePath
)
3078 * Table name can refer to a table, view, alias or synonym. Returns TRUE
3079 * if the object exists in the database. This function does not indicate
3080 * whether or not the user has privleges to query or perform other functions
3083 * userID is evaluated in the following manner:
3084 * userID == NULL ... UserID is ignored
3085 * userID == "" ... UserID set equal to 'this->uid'
3086 * userID != "" ... UserID set equal to 'userID'
3089 wxASSERT(tableName
.Length());
3093 if (Dbms() == dbmsDBASE
)
3096 if (tablePath
.Length())
3097 dbName
.Printf(wxT("%s/%s.dbf"), tablePath
.c_str(), tableName
.c_str());
3099 dbName
.Printf(wxT("%s.dbf"), tableName
.c_str());
3102 exists
= wxFileExists(dbName
);
3107 convertUserID(userID
,UserID
);
3109 TableName
= tableName
;
3110 // Oracle and Interbase table names are uppercase only, so force
3111 // the name to uppercase just in case programmer forgot to do this
3112 if ((Dbms() == dbmsORACLE
) ||
3113 (Dbms() == dbmsINTERBASE
))
3114 TableName
= TableName
.Upper();
3116 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3119 // Some databases cannot accept a user name when looking up table names,
3120 // so we use the call below that leaves out the user name
3121 if (!UserID
.IsEmpty() &&
3122 Dbms() != dbmsMY_SQL
&&
3123 Dbms() != dbmsACCESS
&&
3124 Dbms() != dbmsMS_SQL_SERVER
&&
3125 Dbms() != dbmsDB2
&&
3126 Dbms() != dbmsINTERBASE
&&
3127 Dbms() != dbmsPERVASIVE_SQL
)
3129 retcode
= SQLTables(hstmt
,
3130 NULL
, 0, // All qualifiers
3131 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Only tables owned by this user
3132 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
,
3133 NULL
, 0); // All table types
3137 retcode
= SQLTables(hstmt
,
3138 NULL
, 0, // All qualifiers
3139 NULL
, 0, // All owners
3140 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
,
3141 NULL
, 0); // All table types
3143 if (retcode
!= SQL_SUCCESS
)
3144 return(DispAllErrors(henv
, hdbc
, hstmt
));
3146 retcode
= SQLFetch(hstmt
);
3147 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
3149 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3150 return(DispAllErrors(henv
, hdbc
, hstmt
));
3153 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3157 } // wxDb::TableExists()
3160 /********** wxDb::TablePrivileges() **********/
3161 bool wxDb::TablePrivileges(const wxString
&tableName
, const wxString
&priv
, const wxChar
*userID
,
3162 const wxChar
*schema
, const wxString
&tablePath
)
3164 wxASSERT(tableName
.Length());
3166 wxDbTablePrivilegeInfo result
;
3170 // We probably need to be able to dynamically set this based on
3171 // the driver type, and state.
3172 wxChar curRole
[]=wxT("public");
3176 wxString UserID
,Schema
;
3177 convertUserID(userID
,UserID
);
3178 convertUserID(schema
,Schema
);
3180 TableName
= tableName
;
3181 // Oracle and Interbase table names are uppercase only, so force
3182 // the name to uppercase just in case programmer forgot to do this
3183 if ((Dbms() == dbmsORACLE
) ||
3184 (Dbms() == dbmsINTERBASE
))
3185 TableName
= TableName
.Upper();
3187 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3189 // Some databases cannot accept a user name when looking up table names,
3190 // so we use the call below that leaves out the user name
3191 if (!Schema
.IsEmpty() &&
3192 Dbms() != dbmsMY_SQL
&&
3193 Dbms() != dbmsACCESS
&&
3194 Dbms() != dbmsMS_SQL_SERVER
)
3196 retcode
= SQLTablePrivileges(hstmt
,
3198 (UCHAR FAR
*)Schema
.c_str(), SQL_NTS
, // Schema
3199 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
);
3203 retcode
= SQLTablePrivileges(hstmt
,
3206 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
);
3209 #ifdef DBDEBUG_CONSOLE
3210 fprintf(stderr
,wxT("SQLTablePrivileges() returned %i \n"),retcode
);
3213 if ((retcode
!= SQL_SUCCESS
) && (retcode
!= SQL_SUCCESS_WITH_INFO
))
3214 return(DispAllErrors(henv
, hdbc
, hstmt
));
3216 bool failed
= FALSE
;
3217 retcode
= SQLFetch(hstmt
);
3218 while (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
3220 if (SQLGetData(hstmt
, 1, SQL_C_CHAR
, (UCHAR
*) result
.tableQual
, sizeof(result
.tableQual
), &cbRetVal
) != SQL_SUCCESS
)
3223 if (!failed
&& SQLGetData(hstmt
, 2, SQL_C_CHAR
, (UCHAR
*) result
.tableOwner
, sizeof(result
.tableOwner
), &cbRetVal
) != SQL_SUCCESS
)
3226 if (!failed
&& SQLGetData(hstmt
, 3, SQL_C_CHAR
, (UCHAR
*) result
.tableName
, sizeof(result
.tableName
), &cbRetVal
) != SQL_SUCCESS
)
3229 if (!failed
&& SQLGetData(hstmt
, 4, SQL_C_CHAR
, (UCHAR
*) result
.grantor
, sizeof(result
.grantor
), &cbRetVal
) != SQL_SUCCESS
)
3232 if (!failed
&& SQLGetData(hstmt
, 5, SQL_C_CHAR
, (UCHAR
*) result
.grantee
, sizeof(result
.grantee
), &cbRetVal
) != SQL_SUCCESS
)
3235 if (!failed
&& SQLGetData(hstmt
, 6, SQL_C_CHAR
, (UCHAR
*) result
.privilege
, sizeof(result
.privilege
), &cbRetVal
) != SQL_SUCCESS
)
3238 if (!failed
&& SQLGetData(hstmt
, 7, SQL_C_CHAR
, (UCHAR
*) result
.grantable
, sizeof(result
.grantable
), &cbRetVal
) != SQL_SUCCESS
)
3243 return(DispAllErrors(henv
, hdbc
, hstmt
));
3245 #ifdef DBDEBUG_CONSOLE
3246 fprintf(stderr
,wxT("Scanning %s privilege on table %s.%s granted by %s to %s\n"),
3247 result
.privilege
,result
.tableOwner
,result
.tableName
,
3248 result
.grantor
, result
.grantee
);
3251 if (UserID
.IsSameAs(result
.tableOwner
,FALSE
))
3253 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3257 if (UserID
.IsSameAs(result
.grantee
,FALSE
) &&
3258 !wxStrcmp(result
.privilege
,priv
))
3260 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3264 if (!wxStrcmp(result
.grantee
,curRole
) &&
3265 !wxStrcmp(result
.privilege
,priv
))
3267 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3271 retcode
= SQLFetch(hstmt
);
3274 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3277 } // wxDb::TablePrivileges
3280 /********** wxDb::SetSqlLogging() **********/
3281 bool wxDb::SetSqlLogging(wxDbSqlLogState state
, const wxString
&filename
, bool append
)
3283 wxASSERT(state
== sqlLogON
|| state
== sqlLogOFF
);
3284 wxASSERT(state
== sqlLogOFF
|| filename
.Length());
3286 if (state
== sqlLogON
)
3290 fpSqlLog
= fopen(filename
, (append
? wxT("at") : wxT("wt")));
3291 if (fpSqlLog
== NULL
)
3299 if (fclose(fpSqlLog
))
3305 sqlLogState
= state
;
3308 } // wxDb::SetSqlLogging()
3311 /********** wxDb::WriteSqlLog() **********/
3312 bool wxDb::WriteSqlLog(const wxString
&logMsg
)
3314 wxASSERT(logMsg
.Length());
3316 if (fpSqlLog
== 0 || sqlLogState
== sqlLogOFF
)
3319 if (fputs(wxT("\n"), fpSqlLog
) == EOF
)
3321 if (fputs(logMsg
, fpSqlLog
) == EOF
)
3323 if (fputs(wxT("\n"), fpSqlLog
) == EOF
)
3328 } // wxDb::WriteSqlLog()
3331 /********** wxDb::Dbms() **********/
3332 wxDBMS
wxDb::Dbms(void)
3334 * Be aware that not all database engines use the exact same syntax, and not
3335 * every ODBC compliant database is compliant to the same level of compliancy.
3336 * Some manufacturers support the minimum Level 1 compliancy, and others up
3337 * through Level 3. Others support subsets of features for levels above 1.
3339 * If you find an inconsistency between the wxDb class and a specific database
3340 * engine, and an identifier to this section, and special handle the database in
3341 * the area where behavior is non-conforming with the other databases.
3344 * NOTES ABOUT ISSUES SPECIFIC TO EACH DATABASE ENGINE
3345 * ---------------------------------------------------
3348 * - Currently the only database supported by the class to support VIEWS
3351 * - Does not support the SQL_TIMESTAMP structure
3352 * - Supports only one cursor and one connect (apparently? with Microsoft driver only?)
3353 * - Does not automatically create the primary index if the 'keyField' param of SetColDef
3354 * is TRUE. The user must create ALL indexes from their program.
3355 * - Table names can only be 8 characters long
3356 * - Column names can only be 10 characters long
3359 * - To lock a record during QUERY functions, the reserved word 'HOLDLOCK' must be added
3360 * after every table name involved in the query/join if that tables matching record(s)
3362 * - Ignores the keywords 'FOR UPDATE'. Use the HOLDLOCK functionality described above
3364 * SYBASE (Enterprise)
3365 * - If a column is part of the Primary Key, the column cannot be NULL
3366 * - Maximum row size is somewhere in the neighborhood of 1920 bytes
3369 * - If a column is part of the Primary Key, the column cannot be NULL
3370 * - Cannot support selecting for update [::CanSelectForUpdate()]. Always returns FALSE
3371 * - Columns that are part of primary or secondary keys must be defined as being NOT NULL
3372 * when they are created. Some code is added in ::CreateIndex to try to adjust the
3373 * column definition if it is not defined correctly, but it is experimental
3374 * - Does not support sub-queries in SQL statements
3377 * - Does not support the keywords 'ASC' or 'DESC' as of release v6.5.0
3378 * - Does not support sub-queries in SQL statements
3381 * - Primary keys must be declared as NOT NULL
3382 * - Table and index names must not be longer than 13 characters in length (technically
3383 * table names can be up to 18 characters, but the primary index is created using the
3384 * base table name plus "_PIDX", so the limit if the table has a primary index is 13.
3389 * - Columns that are part of primary keys must be defined as being NOT NULL
3390 * when they are created. Some code is added in ::CreateIndex to try to adjust the
3391 * column definition if it is not defined correctly, but it is experimental
3394 // Should only need to do this once for each new database connection
3395 // so return the value we already determined it to be to save time
3396 // and lots of string comparisons
3397 if (dbmsType
!= dbmsUNIDENTIFIED
)
3400 wxChar baseName
[25+1];
3401 wxStrncpy(baseName
,dbInf
.dbmsName
,25);
3404 // RGG 20001025 : add support for Interbase
3405 // GT : Integrated to base classes on 20001121
3406 if (!wxStricmp(dbInf
.dbmsName
,wxT("Interbase")))
3407 return((wxDBMS
)(dbmsType
= dbmsINTERBASE
));
3409 // BJO 20000428 : add support for Virtuoso
3410 if (!wxStricmp(dbInf
.dbmsName
,wxT("OpenLink Virtuoso VDBMS")))
3411 return((wxDBMS
)(dbmsType
= dbmsVIRTUOSO
));
3413 if (!wxStricmp(dbInf
.dbmsName
,wxT("Adaptive Server Anywhere")))
3414 return((wxDBMS
)(dbmsType
= dbmsSYBASE_ASA
));
3416 // BJO 20000427 : The "SQL Server" string is also returned by SQLServer when
3417 // connected through an OpenLink driver.
3418 // Is it also returned by Sybase Adapatitve server?
3419 // OpenLink driver name is OLOD3032.DLL for msw and oplodbc.so for unix
3420 if (!wxStricmp(dbInf
.dbmsName
,wxT("SQL Server")))
3422 if (!wxStrncmp(dbInf
.driverName
, wxT("oplodbc"), 7) ||
3423 !wxStrncmp(dbInf
.driverName
, wxT("OLOD"), 4))
3424 return ((wxDBMS
)(dbmsMS_SQL_SERVER
));
3426 return ((wxDBMS
)(dbmsType
= dbmsSYBASE_ASE
));
3429 if (!wxStricmp(dbInf
.dbmsName
,wxT("Microsoft SQL Server")))
3430 return((wxDBMS
)(dbmsType
= dbmsMS_SQL_SERVER
));
3431 if (!wxStricmp(dbInf
.dbmsName
,wxT("MySQL")))
3432 return((wxDBMS
)(dbmsType
= dbmsMY_SQL
));
3433 if (!wxStricmp(dbInf
.dbmsName
,wxT("PostgreSQL"))) // v6.5.0
3434 return((wxDBMS
)(dbmsType
= dbmsPOSTGRES
));
3437 if (!wxStricmp(dbInf
.dbmsName
,wxT("Pervasive")))
3438 return((wxDBMS
)(dbmsType
= dbmsPERVASIVE_SQL
));
3441 if (!wxStricmp(baseName
,wxT("Informix")))
3442 return((wxDBMS
)(dbmsType
= dbmsINFORMIX
));
3445 if (!wxStricmp(baseName
,wxT("Oracle")))
3446 return((wxDBMS
)(dbmsType
= dbmsORACLE
));
3447 if (!wxStricmp(dbInf
.dbmsName
,wxT("ACCESS")))
3448 return((wxDBMS
)(dbmsType
= dbmsACCESS
));
3449 if (!wxStricmp(dbInf
.dbmsName
,wxT("MySQL")))
3450 return((wxDBMS
)(dbmsType
= dbmsMY_SQL
));
3451 if (!wxStricmp(baseName
,wxT("Sybase")))
3452 return((wxDBMS
)(dbmsType
= dbmsSYBASE_ASE
));
3455 if (!wxStricmp(baseName
,wxT("DBASE")))
3456 return((wxDBMS
)(dbmsType
= dbmsDBASE
));
3459 if (!wxStricmp(baseName
,wxT("DB2")))
3460 return((wxDBMS
)(dbmsType
= dbmsDBASE
));
3462 return((wxDBMS
)(dbmsType
= dbmsUNIDENTIFIED
));
3467 bool wxDb::ModifyColumn(const wxString
&tableName
, const wxString
&columnName
,
3468 int dataType
, ULONG columnLength
,
3469 const wxString
&optionalParam
)
3471 wxASSERT(tableName
.Length());
3472 wxASSERT(columnName
.Length());
3473 wxASSERT((dataType
== DB_DATA_TYPE_VARCHAR
&& columnLength
> 0) ||
3474 dataType
!= DB_DATA_TYPE_VARCHAR
);
3476 // Must specify a columnLength if modifying a VARCHAR type column
3477 if (dataType
== DB_DATA_TYPE_VARCHAR
&& !columnLength
)
3480 wxString dataTypeName
;
3482 wxString alterSlashModify
;
3486 case DB_DATA_TYPE_VARCHAR
:
3487 dataTypeName
= typeInfVarchar
.TypeName
;
3489 case DB_DATA_TYPE_INTEGER
:
3490 dataTypeName
= typeInfInteger
.TypeName
;
3492 case DB_DATA_TYPE_FLOAT
:
3493 dataTypeName
= typeInfFloat
.TypeName
;
3495 case DB_DATA_TYPE_DATE
:
3496 dataTypeName
= typeInfDate
.TypeName
;
3498 case DB_DATA_TYPE_BLOB
:
3499 dataTypeName
= typeInfBlob
.TypeName
;
3505 // Set the modify or alter syntax depending on the type of database connected to
3509 alterSlashModify
= "MODIFY";
3511 case dbmsMS_SQL_SERVER
:
3512 alterSlashModify
= "ALTER COLUMN";
3514 case dbmsUNIDENTIFIED
:
3516 case dbmsSYBASE_ASA
:
3517 case dbmsSYBASE_ASE
:
3523 alterSlashModify
= "MODIFY";
3527 // create the SQL statement
3528 sqlStmt
.Printf(wxT("ALTER TABLE %s %s %s %s"), tableName
.c_str(), alterSlashModify
.c_str(),
3529 columnName
.c_str(), dataTypeName
.c_str());
3531 // For varchars only, append the size of the column
3532 if (dataType
== DB_DATA_TYPE_VARCHAR
)
3535 s
.Printf(wxT("(%d)"), columnLength
);
3539 // for passing things like "NOT NULL"
3540 if (optionalParam
.Length())
3542 sqlStmt
+= wxT(" ");
3543 sqlStmt
+= optionalParam
;
3546 return ExecSql(sqlStmt
);
3548 } // wxDb::ModifyColumn()
3551 /********** wxDbGetConnection() **********/
3552 wxDb WXDLLEXPORT
*wxDbGetConnection(wxDbConnectInf
*pDbConfig
, bool FwdOnlyCursors
)
3556 // Used to keep a pointer to a DB connection that matches the requested
3557 // DSN and FwdOnlyCursors settings, even if it is not FREE, so that the
3558 // data types can be copied from it (using the wxDb::Open(wxDb *) function)
3559 // rather than having to re-query the datasource to get all the values
3560 // using the wxDb::Open(Dsn,Uid,AuthStr) function
3561 wxDb
*matchingDbConnection
= NULL
;
3563 // Scan the linked list searching for an available database connection
3564 // that's already been opened but is currently not in use.
3565 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3567 // The database connection must be for the same datasource
3568 // name and must currently not be in use.
3570 (pList
->PtrDb
->FwdOnlyCursors() == FwdOnlyCursors
) &&
3571 (!wxStrcmp(pDbConfig
->GetDsn(), pList
->Dsn
))) // Found a free connection
3573 pList
->Free
= FALSE
;
3574 return(pList
->PtrDb
);
3577 if (!wxStrcmp(pDbConfig
->GetDsn(), pList
->Dsn
) &&
3578 !wxStrcmp(pDbConfig
->GetUserID(), pList
->Uid
) &&
3579 !wxStrcmp(pDbConfig
->GetPassword(), pList
->AuthStr
))
3580 matchingDbConnection
= pList
->PtrDb
;
3583 // No available connections. A new connection must be made and
3584 // appended to the end of the linked list.
3587 // Find the end of the list
3588 for (pList
= PtrBegDbList
; pList
->PtrNext
; pList
= pList
->PtrNext
);
3589 // Append a new list item
3590 pList
->PtrNext
= new wxDbList
;
3591 pList
->PtrNext
->PtrPrev
= pList
;
3592 pList
= pList
->PtrNext
;
3596 // Create the first node on the list
3597 pList
= PtrBegDbList
= new wxDbList
;
3601 // Initialize new node in the linked list
3603 pList
->Free
= FALSE
;
3604 pList
->Dsn
= pDbConfig
->GetDsn();
3605 pList
->Uid
= pDbConfig
->GetUserID();
3606 pList
->AuthStr
= pDbConfig
->GetPassword();
3608 pList
->PtrDb
= new wxDb(pDbConfig
->GetHenv(), FwdOnlyCursors
);
3610 bool opened
= FALSE
;
3612 if (!matchingDbConnection
)
3613 opened
= pList
->PtrDb
->Open(pDbConfig
->GetDsn(), pDbConfig
->GetUserID(), pDbConfig
->GetPassword());
3615 opened
= pList
->PtrDb
->Open(matchingDbConnection
);
3617 // Connect to the datasource
3620 pList
->PtrDb
->setCached(TRUE
); // Prevent a user from deleting a cached connection
3621 pList
->PtrDb
->SetSqlLogging(SQLLOGstate
,SQLLOGfn
,TRUE
);
3622 return(pList
->PtrDb
);
3624 else // Unable to connect, destroy list item
3627 pList
->PtrPrev
->PtrNext
= 0;
3629 PtrBegDbList
= 0; // Empty list again
3630 pList
->PtrDb
->CommitTrans(); // Commit any open transactions on wxDb object
3631 pList
->PtrDb
->Close(); // Close the wxDb object
3632 delete pList
->PtrDb
; // Deletes the wxDb object
3633 delete pList
; // Deletes the linked list object
3637 } // wxDbGetConnection()
3640 /********** wxDbFreeConnection() **********/
3641 bool WXDLLEXPORT
wxDbFreeConnection(wxDb
*pDb
)
3645 // Scan the linked list searching for the database connection
3646 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3648 if (pList
->PtrDb
== pDb
) // Found it, now free it!!!
3649 return (pList
->Free
= TRUE
);
3652 // Never found the database object, return failure
3655 } // wxDbFreeConnection()
3658 /********** wxDbCloseConnections() **********/
3659 void WXDLLEXPORT
wxDbCloseConnections(void)
3661 wxDbList
*pList
, *pNext
;
3663 // Traverse the linked list closing database connections and freeing memory as I go.
3664 for (pList
= PtrBegDbList
; pList
; pList
= pNext
)
3666 pNext
= pList
->PtrNext
; // Save the pointer to next
3667 pList
->PtrDb
->CommitTrans(); // Commit any open transactions on wxDb object
3668 pList
->PtrDb
->Close(); // Close the wxDb object
3669 pList
->PtrDb
->setCached(FALSE
); // Allows deletion of the wxDb instance
3670 delete pList
->PtrDb
; // Deletes the wxDb object
3671 delete pList
; // Deletes the linked list object
3674 // Mark the list as empty
3677 } // wxDbCloseConnections()
3680 /********** wxDbConnectionsInUse() **********/
3681 int WXDLLEXPORT
wxDbConnectionsInUse(void)
3686 // Scan the linked list counting db connections that are currently in use
3687 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3689 if (pList
->Free
== FALSE
)
3695 } // wxDbConnectionsInUse()
3699 /********** wxDbLogExtendedErrorMsg() **********/
3700 // DEBUG ONLY function
3701 const wxChar WXDLLEXPORT
*wxDbLogExtendedErrorMsg(const wxChar
*userText
, wxDb
*pDb
,
3702 char *ErrFile
, int ErrLine
)
3704 static wxString msg
;
3709 if (ErrFile
|| ErrLine
)
3711 msg
+= wxT("File: ");
3713 msg
+= wxT(" Line: ");
3714 tStr
.Printf(wxT("%d"),ErrLine
);
3715 msg
+= tStr
.c_str();
3719 msg
.Append (wxT("\nODBC errors:\n"));
3722 // Display errors for this connection
3724 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
3726 if (pDb
->errorList
[i
])
3728 msg
.Append(pDb
->errorList
[i
]);
3729 if (wxStrcmp(pDb
->errorList
[i
],wxT("")) != 0)
3730 msg
.Append(wxT("\n"));
3731 // Clear the errmsg buffer so the next error will not
3732 // end up showing the previous error that have occurred
3733 wxStrcpy(pDb
->errorList
[i
],wxT(""));
3738 wxLogDebug(msg
.c_str());
3741 } // wxDbLogExtendedErrorMsg()
3744 /********** wxDbSqlLog() **********/
3745 bool wxDbSqlLog(wxDbSqlLogState state
, const wxChar
*filename
)
3747 bool append
= FALSE
;
3750 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3752 if (!pList
->PtrDb
->SetSqlLogging(state
,filename
,append
))
3757 SQLLOGstate
= state
;
3758 SQLLOGfn
= filename
;
3766 /********** wxDbCreateDataSource() **********/
3767 int wxDbCreateDataSource(const wxString
&driverName
, const wxString
&dsn
, const wxString
&description
,
3768 bool sysDSN
, const wxString
&defDir
, wxWindow
*parent
)
3770 * !!!! ONLY FUNCTIONAL UNDER MSW with VC6 !!!!
3771 * Very rudimentary creation of an ODBC data source.
3773 * ODBC driver must be ODBC 3.0 compliant to use this function
3778 //!!!! ONLY FUNCTIONAL UNDER MSW with VC6 !!!!
3784 dsnLocation
= ODBC_ADD_SYS_DSN
;
3786 dsnLocation
= ODBC_ADD_DSN
;
3788 // NOTE: The decimal 2 is an invalid character in all keyword pairs
3789 // so that is why I used it, as wxString does not deal well with
3790 // embedded nulls in strings
3791 setupStr
.Printf(wxT("DSN=%s%cDescription=%s%cDefaultDir=%s%c"),dsn
,2,description
,2,defDir
,2);
3793 // Replace the separator from above with the '\0' seperator needed
3794 // by the SQLConfigDataSource() function
3798 k
= setupStr
.Find((wxChar
)2,TRUE
);
3799 if (k
!= wxNOT_FOUND
)
3800 setupStr
[(UINT
)k
] = wxT('\0');
3802 while (k
!= wxNOT_FOUND
);
3804 result
= SQLConfigDataSource((HWND
)parent
->GetHWND(), dsnLocation
,
3805 driverName
, setupStr
.c_str());
3807 if ((result
!= SQL_SUCCESS
) && (result
!= SQL_SUCCESS_WITH_INFO
))
3809 // check for errors caused by ConfigDSN based functions
3812 wxChar errMsg
[SQL_MAX_MESSAGE_LENGTH
];
3813 errMsg
[0] = wxT('\0');
3815 // This function is only supported in ODBC drivers v3.0 compliant and above
3816 SQLInstallerError(1,&retcode
,errMsg
,SQL_MAX_MESSAGE_LENGTH
-1,&cb
);
3819 #ifdef DBDEBUG_CONSOLE
3820 // When run in console mode, use standard out to display errors.
3821 cout
<< errMsg
<< endl
;
3822 cout
<< wxT("Press any key to continue...") << endl
;
3824 #endif // DBDEBUG_CONSOLE
3827 wxLogDebug(errMsg
,wxT("ODBC DEBUG MESSAGE"));
3828 #endif // __WXDEBUG__
3834 // Using iODBC/unixODBC or some other compiler which does not support the APIs
3835 // necessary to use this function, so this function is not supported
3837 wxLogDebug(wxT("wxDbCreateDataSource() not available except under VC++/MSW"),wxT("ODBC DEBUG MESSAGE"));
3840 #endif // __VISUALC__
3844 } // wxDbCreateDataSource()
3848 /********** wxDbGetDataSource() **********/
3849 bool wxDbGetDataSource(HENV henv
, wxChar
*Dsn
, SWORD DsnMax
, wxChar
*DsDesc
,
3850 SWORD DsDescMax
, UWORD direction
)
3852 * Dsn and DsDesc will contain the data source name and data source
3853 * description upon return
3858 if (SQLDataSources(henv
, direction
, (UCHAR FAR
*) Dsn
, DsnMax
, &cb1
,
3859 (UCHAR FAR
*) DsDesc
, DsDescMax
, &cb2
) == SQL_SUCCESS
)
3864 } // wxDbGetDataSource()
3867 // Change this to 0 to remove use of all deprecated functions
3868 #if wxODBC_BACKWARD_COMPATABILITY
3869 /********************************************************************
3870 ********************************************************************
3872 * The following functions are all DEPRECATED and are included for
3873 * backward compatability reasons only
3875 ********************************************************************
3876 ********************************************************************/
3877 bool SqlLog(sqlLog state
, const wxChar
*filename
)
3879 return wxDbSqlLog((enum wxDbSqlLogState
)state
, filename
);
3881 /***** DEPRECATED: use wxGetDataSource() *****/
3882 bool GetDataSource(HENV henv
, char *Dsn
, SWORD DsnMax
, char *DsDesc
, SWORD DsDescMax
,
3885 return wxDbGetDataSource(henv
, Dsn
, DsnMax
, DsDesc
, DsDescMax
, direction
);
3887 /***** DEPRECATED: use wxDbGetConnection() *****/
3888 wxDb WXDLLEXPORT
*GetDbConnection(DbStuff
*pDbStuff
, bool FwdOnlyCursors
)
3890 return wxDbGetConnection((wxDbConnectInf
*)pDbStuff
, FwdOnlyCursors
);
3892 /***** DEPRECATED: use wxDbFreeConnection() *****/
3893 bool WXDLLEXPORT
FreeDbConnection(wxDb
*pDb
)
3895 return wxDbFreeConnection(pDb
);
3897 /***** DEPRECATED: use wxDbCloseConnections() *****/
3898 void WXDLLEXPORT
CloseDbConnections(void)
3900 wxDbCloseConnections();
3902 /***** DEPRECATED: use wxDbConnectionsInUse() *****/
3903 int WXDLLEXPORT
NumberDbConnectionsInUse(void)
3905 return wxDbConnectionsInUse();