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"
58 #include "wx/filefn.h"
59 #include "wx/wxchar.h"
71 WXDLLEXPORT_DATA(wxDbList
*) PtrBegDbList
= 0;
74 wxChar
const *SQL_LOG_FILENAME
= wxT("sqllog.txt");
75 wxChar
const *SQL_CATALOG_FILENAME
= wxT("catalog.txt");
78 extern wxList TablesInUse
;
81 // SQL Log defaults to be used by GetDbConnection
82 wxDbSqlLogState SQLLOGstate
= sqlLogOFF
;
84 static wxString SQLLOGfn
= SQL_LOG_FILENAME
;
86 // The wxDb::errorList is copied to this variable when the wxDb object
87 // is closed. This way, the error list is still available after the
88 // database object is closed. This is necessary if the database
89 // connection fails so the calling application can show the operator
90 // why the connection failed. Note: as each wxDb object is closed, it
91 // will overwrite the errors of the previously destroyed wxDb object in
92 // this variable. NOTE: This occurs during a CLOSE, not a FREEing of the
94 wxChar DBerrorList
[DB_MAX_ERROR_HISTORY
][DB_MAX_ERROR_MSG_LEN
];
97 // This type defines the return row-struct form
98 // SQLTablePrivileges, and is used by wxDB::TablePrivileges.
101 wxChar tableQual
[128+1];
102 wxChar tableOwner
[128+1];
103 wxChar tableName
[128+1];
104 wxChar grantor
[128+1];
105 wxChar grantee
[128+1];
106 wxChar privilege
[128+1];
107 wxChar grantable
[3+1];
108 } wxDbTablePrivilegeInfo
;
111 /********** wxDbConnectInf Constructor - form 1 **********/
112 wxDbConnectInf::wxDbConnectInf()
115 freeHenvOnDestroy
= FALSE
;
121 /********** wxDbConnectInf Constructor - form 2 **********/
122 wxDbConnectInf::wxDbConnectInf(HENV henv
, const wxString
&dsn
, const wxString
&userID
,
123 const wxString
&password
, const wxString
&defaultDir
,
124 const wxString
&fileType
, const wxString
&description
)
127 freeHenvOnDestroy
= FALSE
;
138 SetPassword(password
);
139 SetDescription(description
);
140 SetFileType(fileType
);
141 SetDefaultDir(defaultDir
);
142 } // wxDbConnectInf Constructor
145 wxDbConnectInf::~wxDbConnectInf()
147 if (freeHenvOnDestroy
)
151 } // wxDbConnectInf Destructor
155 /********** wxDbConnectInf::Initialize() **********/
156 bool wxDbConnectInf::Initialize()
158 freeHenvOnDestroy
= FALSE
;
160 if (freeHenvOnDestroy
&& Henv
)
172 } // wxDbConnectInf::Initialize()
175 /********** wxDbConnectInf::AllocHenv() **********/
176 bool wxDbConnectInf::AllocHenv()
178 // This is here to help trap if you are getting a new henv
179 // without releasing an existing henv
182 // Initialize the ODBC Environment for Database Operations
183 if (SQLAllocEnv(&Henv
) != SQL_SUCCESS
)
185 wxLogDebug(wxT("A problem occured while trying to get a connection to the data source"));
189 freeHenvOnDestroy
= TRUE
;
192 } // wxDbConnectInf::AllocHenv()
195 void wxDbConnectInf::FreeHenv()
203 freeHenvOnDestroy
= FALSE
;
205 } // wxDbConnectInf::FreeHenv()
208 void wxDbConnectInf::SetDsn(const wxString
&dsn
)
210 wxASSERT(dsn
.Length() < sizeof(Dsn
));
213 } // wxDbConnectInf::SetDsn()
216 void wxDbConnectInf::SetUserID(const wxString
&uid
)
218 wxASSERT(uid
.Length() < sizeof(Uid
));
220 } // wxDbConnectInf::SetUserID()
223 void wxDbConnectInf::SetPassword(const wxString
&password
)
225 wxASSERT(password
.Length() < sizeof(AuthStr
));
227 wxStrcpy(AuthStr
,password
);
228 } // wxDbConnectInf::SetPassword()
232 /********** wxDbColFor Constructor **********/
233 wxDbColFor::wxDbColFor()
236 } // wxDbColFor::wxDbColFor()
239 wxDbColFor::~wxDbColFor()
241 } // wxDbColFor::~wxDbColFor()
244 /********** wxDbColFor::Initialize() **********/
245 void wxDbColFor::Initialize()
255 i_Nation
= 0; // 0=EU, 1=UK, 2=International, 3=US
258 Format(1,DB_DATA_TYPE_VARCHAR
,0,0,0); // the Function that does the work
259 } // wxDbColFor::Initialize()
262 /********** wxDbColFor::Format() **********/
263 int wxDbColFor::Format(int Nation
, int dbDataType
, SWORD sqlDataType
,
264 short columnSize
, short decimalDigits
)
266 // ----------------------------------------------------------------------------------------
267 // -- 19991224 : mj10777 : Create
268 // There is still a lot of work to do here, but it is a start
269 // It handles all the basic data-types that I have run into up to now
270 // The main work will have be with Dates and float Formatting
271 // (US 1,000.00 ; EU 1.000,00)
272 // There are wxWindow plans for locale support and the new wxDateTime. If
273 // they define some constants (wxEUROPEAN) that can be gloably used,
274 // they should be used here.
275 // ----------------------------------------------------------------------------------------
276 // There should also be a function to scan in a string to fill the variable
277 // ----------------------------------------------------------------------------------------
279 i_Nation
= Nation
; // 0 = timestamp , 1=EU, 2=UK, 3=International, 4=US
280 i_dbDataType
= dbDataType
;
281 i_sqlDataType
= sqlDataType
;
282 s_Field
.Printf(wxT("%s%d"),s_Amount
[1].c_str(),i_Amount
[1]); // OK for VARCHAR, INTEGER and FLOAT
284 if (i_dbDataType
== 0) // Filter unsupported dbDataTypes
286 if ((i_sqlDataType
== SQL_VARCHAR
) || (i_sqlDataType
== SQL_LONGVARCHAR
))
287 i_dbDataType
= DB_DATA_TYPE_VARCHAR
;
288 if ((i_sqlDataType
== SQL_C_DATE
) || (i_sqlDataType
== SQL_C_TIMESTAMP
))
289 i_dbDataType
= DB_DATA_TYPE_DATE
;
290 if (i_sqlDataType
== SQL_C_BIT
)
291 i_dbDataType
= DB_DATA_TYPE_INTEGER
;
292 if (i_sqlDataType
== SQL_NUMERIC
)
293 i_dbDataType
= DB_DATA_TYPE_VARCHAR
;
294 if (i_sqlDataType
== SQL_REAL
)
295 i_dbDataType
= DB_DATA_TYPE_FLOAT
;
296 if (i_sqlDataType
== SQL_C_BINARY
)
297 i_dbDataType
= DB_DATA_TYPE_BLOB
;
300 if ((i_dbDataType
== DB_DATA_TYPE_INTEGER
) && (i_sqlDataType
== SQL_C_DOUBLE
))
302 i_dbDataType
= DB_DATA_TYPE_FLOAT
;
305 switch(i_dbDataType
) // TBD: Still a lot of proper formatting to do
307 case DB_DATA_TYPE_VARCHAR
:
310 case DB_DATA_TYPE_INTEGER
:
313 case DB_DATA_TYPE_FLOAT
:
314 if (decimalDigits
== 0)
317 tempStr
.Printf(wxT("%s%d.%d"),tempStr
.c_str(),columnSize
,decimalDigits
);
318 s_Field
.Printf(wxT("%sf"),tempStr
.c_str());
320 case DB_DATA_TYPE_DATE
:
321 if (i_Nation
== 0) // timestamp YYYY-MM-DD HH:MM:SS.SSS (tested for SYBASE)
323 s_Field
= wxT("%04d-%02d-%02d %02d:%02d:%02d.%03d");
325 if (i_Nation
== 1) // European DD.MM.YYYY HH:MM:SS.SSS
327 s_Field
= wxT("%02d.%02d.%04d %02d:%02d:%02d.%03d");
329 if (i_Nation
== 2) // UK DD/MM/YYYY HH:MM:SS.SSS
331 s_Field
= wxT("%02d/%02d/%04d %02d:%02d:%02d.%03d");
333 if (i_Nation
== 3) // International YYYY-MM-DD HH:MM:SS.SSS
335 s_Field
= wxT("%04d-%02d-%02d %02d:%02d:%02d.%03d");
337 if (i_Nation
== 4) // US MM/DD/YYYY HH:MM:SS.SSS
339 s_Field
= wxT("%02d/%02d/%04d %02d:%02d:%02d.%03d");
342 case DB_DATA_TYPE_BLOB
:
343 s_Field
.Printf(wxT("Unable to format(%d)-SQL(%d)"),dbDataType
,sqlDataType
); //
346 s_Field
.Printf(wxT("Unknown Format(%d)-SQL(%d)"),dbDataType
,sqlDataType
); //
350 } // wxDbColFor::Format()
354 /********** wxDbColInf Constructor **********/
355 wxDbColInf::wxDbColInf()
358 } // wxDbColInf::wxDbColInf()
361 /********** wxDbColInf Destructor ********/
362 wxDbColInf::~wxDbColInf()
367 } // wxDbColInf::~wxDbColInf()
370 bool wxDbColInf::Initialize()
392 } // wxDbColInf::Initialize()
395 /********** wxDbTableInf Constructor ********/
396 wxDbTableInf::wxDbTableInf()
399 } // wxDbTableInf::wxDbTableInf()
402 /********** wxDbTableInf Constructor ********/
403 wxDbTableInf::~wxDbTableInf()
408 } // wxDbTableInf::~wxDbTableInf()
411 bool wxDbTableInf::Initialize()
420 } // wxDbTableInf::Initialize()
423 /********** wxDbInf Constructor *************/
427 } // wxDbInf::wxDbInf()
430 /********** wxDbInf Destructor *************/
436 } // wxDbInf::~wxDbInf()
439 /********** wxDbInf::Initialize() *************/
440 bool wxDbInf::Initialize()
448 } // wxDbInf::Initialize()
451 /********** wxDb Constructor **********/
452 wxDb::wxDb(const HENV
&aHenv
, bool FwdOnlyCursors
)
454 // Copy the HENV into the db class
456 fwdOnlyCursors
= FwdOnlyCursors
;
462 /********** wxDb Destructor **********/
465 wxASSERT_MSG(!IsCached(),wxT("Cached connections must not be manually deleted, use\nwxDbFreeConnection() or wxDbCloseConnections()."));
475 /********** PRIVATE! wxDb::initialize PRIVATE! **********/
476 /********** wxDb::initialize() **********/
477 void wxDb::initialize()
479 * Private member function that sets all wxDb member variables to
480 * known values at creation of the wxDb
485 fpSqlLog
= 0; // Sql Log file pointer
486 sqlLogState
= sqlLogOFF
; // By default, logging is turned off
488 dbmsType
= dbmsUNIDENTIFIED
;
490 wxStrcpy(sqlState
,wxEmptyString
);
491 wxStrcpy(errorMsg
,wxEmptyString
);
492 nativeError
= cbErrorMsg
= 0;
493 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
494 wxStrcpy(errorList
[i
], wxEmptyString
);
496 // Init typeInf structures
497 typeInfVarchar
.TypeName
.Empty();
498 typeInfVarchar
.FsqlType
= 0;
499 typeInfVarchar
.Precision
= 0;
500 typeInfVarchar
.CaseSensitive
= 0;
501 typeInfVarchar
.MaximumScale
= 0;
503 typeInfInteger
.TypeName
.Empty();
504 typeInfInteger
.FsqlType
= 0;
505 typeInfInteger
.Precision
= 0;
506 typeInfInteger
.CaseSensitive
= 0;
507 typeInfInteger
.MaximumScale
= 0;
509 typeInfFloat
.TypeName
.Empty();
510 typeInfFloat
.FsqlType
= 0;
511 typeInfFloat
.Precision
= 0;
512 typeInfFloat
.CaseSensitive
= 0;
513 typeInfFloat
.MaximumScale
= 0;
515 typeInfDate
.TypeName
.Empty();
516 typeInfDate
.FsqlType
= 0;
517 typeInfDate
.Precision
= 0;
518 typeInfDate
.CaseSensitive
= 0;
519 typeInfDate
.MaximumScale
= 0;
521 typeInfBlob
.TypeName
.Empty();
522 typeInfBlob
.FsqlType
= 0;
523 typeInfBlob
.Precision
= 0;
524 typeInfBlob
.CaseSensitive
= 0;
525 typeInfBlob
.MaximumScale
= 0;
527 // Error reporting is turned OFF by default
530 // Allocate a data source connection handle
531 if (SQLAllocConnect(henv
, &hdbc
) != SQL_SUCCESS
)
534 // Initialize the db status flag
537 // Mark database as not open as of yet
540 } // wxDb::initialize()
543 /********** PRIVATE! wxDb::convertUserID PRIVATE! **********/
545 // NOTE: Return value from this function MUST be copied
546 // immediately, as the value is not good after
547 // this function has left scope.
549 const wxChar
*wxDb::convertUserID(const wxChar
*userID
, wxString
&UserID
)
553 if (!wxStrlen(userID
))
561 // dBase does not use user names, and some drivers fail if you try to pass one
562 if ( Dbms() == dbmsDBASE
563 || Dbms() == dbmsXBASE_SEQUITER
)
566 // Oracle user names may only be in uppercase, so force
567 // the name to uppercase
568 if (Dbms() == dbmsORACLE
)
569 UserID
= UserID
.Upper();
571 return UserID
.c_str();
572 } // wxDb::convertUserID()
575 /********** wxDb::Open() **********/
576 bool wxDb::Open(const wxString
&Dsn
, const wxString
&Uid
, const wxString
&AuthStr
, bool failOnDataTypeUnsupported
)
578 wxASSERT(Dsn
.Length());
585 if (!FwdOnlyCursors())
587 // Specify that the ODBC cursor library be used, if needed. This must be
588 // specified before the connection is made.
589 retcode
= SQLSetConnectOption(hdbc
, SQL_ODBC_CURSORS
, SQL_CUR_USE_IF_NEEDED
);
591 #ifdef DBDEBUG_CONSOLE
592 if (retcode
== SQL_SUCCESS
)
593 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) successful") << endl
;
595 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) failed") << endl
;
599 // Connect to the data source
600 retcode
= SQLConnect(hdbc
, (UCHAR FAR
*) dsn
.c_str(), SQL_NTS
,
601 (UCHAR FAR
*) uid
.c_str(), SQL_NTS
,
602 (UCHAR FAR
*) authStr
.c_str(), SQL_NTS
);
604 if ((retcode
!= SQL_SUCCESS
) &&
605 (retcode
!= SQL_SUCCESS_WITH_INFO
))
606 return(DispAllErrors(henv
, hdbc
));
609 If using Intersolv branded ODBC drivers, this is the place where you would substitute
610 your branded driver license information
612 SQLSetConnectOption(hdbc, 1041, (UDWORD) wxEmptyString);
613 SQLSetConnectOption(hdbc, 1042, (UDWORD) wxEmptyString);
616 // Mark database as open
619 // Allocate a statement handle for the database connection
620 if (SQLAllocStmt(hdbc
, &hstmt
) != SQL_SUCCESS
)
621 return(DispAllErrors(henv
, hdbc
));
623 // Set Connection Options
624 if (!setConnectionOptions())
627 // Query the data source for inf. about itself
631 // Query the data source regarding data type information
634 // The way it was determined which SQL data types to use was by calling SQLGetInfo
635 // for all of the possible SQL data types to see which ones were supported. If
636 // a type is not supported, the SQLFetch() that's called from getDataTypeInfo()
637 // fails with SQL_NO_DATA_FOUND. This is ugly because I'm sure the three SQL data
638 // types I've selected below will not alway's be what we want. These are just
639 // what happened to work against an Oracle 7/Intersolv combination. The following is
640 // a complete list of the results I got back against the Oracle 7 database:
642 // SQL_BIGINT SQL_NO_DATA_FOUND
643 // SQL_BINARY SQL_NO_DATA_FOUND
644 // SQL_BIT SQL_NO_DATA_FOUND
645 // SQL_CHAR type name = 'CHAR', Precision = 255
646 // SQL_DATE SQL_NO_DATA_FOUND
647 // SQL_DECIMAL type name = 'NUMBER', Precision = 38
648 // SQL_DOUBLE type name = 'NUMBER', Precision = 15
649 // SQL_FLOAT SQL_NO_DATA_FOUND
650 // SQL_INTEGER SQL_NO_DATA_FOUND
651 // SQL_LONGVARBINARY type name = 'LONG RAW', Precision = 2 billion
652 // SQL_LONGVARCHAR type name = 'LONG', Precision = 2 billion
653 // SQL_NUMERIC SQL_NO_DATA_FOUND
654 // SQL_REAL SQL_NO_DATA_FOUND
655 // SQL_SMALLINT SQL_NO_DATA_FOUND
656 // SQL_TIME SQL_NO_DATA_FOUND
657 // SQL_TIMESTAMP type name = 'DATE', Precision = 19
658 // SQL_VARBINARY type name = 'RAW', Precision = 255
659 // SQL_VARCHAR type name = 'VARCHAR2', Precision = 2000
660 // =====================================================================
661 // Results from a Microsoft Access 7.0 db, using a driver from Microsoft
663 // SQL_VARCHAR type name = 'TEXT', Precision = 255
664 // SQL_TIMESTAMP type name = 'DATETIME'
665 // SQL_DECIMAL SQL_NO_DATA_FOUND
666 // SQL_NUMERIC type name = 'CURRENCY', Precision = 19
667 // SQL_FLOAT SQL_NO_DATA_FOUND
668 // SQL_REAL type name = 'SINGLE', Precision = 7
669 // SQL_DOUBLE type name = 'DOUBLE', Precision = 15
670 // SQL_INTEGER type name = 'LONG', Precision = 10
672 // VARCHAR = Variable length character string
673 if (!getDataTypeInfo(SQL_VARCHAR
, typeInfVarchar
))
674 if (!getDataTypeInfo(SQL_CHAR
, typeInfVarchar
))
677 typeInfVarchar
.FsqlType
= SQL_CHAR
;
679 typeInfVarchar
.FsqlType
= SQL_VARCHAR
;
682 if (!getDataTypeInfo(SQL_DOUBLE
,typeInfFloat
))
683 if (!getDataTypeInfo(SQL_REAL
,typeInfFloat
))
684 if (!getDataTypeInfo(SQL_FLOAT
,typeInfFloat
))
685 if (!getDataTypeInfo(SQL_DECIMAL
,typeInfFloat
))
686 if (!getDataTypeInfo(SQL_NUMERIC
,typeInfFloat
))
688 if (failOnDataTypeUnsupported
)
692 typeInfFloat
.FsqlType
= SQL_NUMERIC
;
694 typeInfFloat
.FsqlType
= SQL_DECIMAL
;
696 typeInfFloat
.FsqlType
= SQL_FLOAT
;
698 typeInfFloat
.FsqlType
= SQL_REAL
;
700 typeInfFloat
.FsqlType
= SQL_DOUBLE
;
703 if (!getDataTypeInfo(SQL_INTEGER
, typeInfInteger
))
705 // If SQL_INTEGER is not supported, use the floating point
706 // data type to store integers as well as floats
707 if (!getDataTypeInfo(typeInfFloat
.FsqlType
, typeInfInteger
))
709 if (failOnDataTypeUnsupported
)
713 typeInfInteger
.FsqlType
= typeInfFloat
.FsqlType
;
716 typeInfInteger
.FsqlType
= SQL_INTEGER
;
719 if (!getDataTypeInfo(SQL_TIMESTAMP
,typeInfDate
))
721 if (!getDataTypeInfo(SQL_DATE
,typeInfDate
))
724 if (getDataTypeInfo(SQL_DATETIME
,typeInfDate
))
726 typeInfDate
.FsqlType
= SQL_TIME
;
729 #endif // SQL_DATETIME defined
731 if (failOnDataTypeUnsupported
)
736 typeInfDate
.FsqlType
= SQL_DATE
;
739 typeInfDate
.FsqlType
= SQL_TIMESTAMP
;
742 if (!getDataTypeInfo(SQL_LONGVARBINARY
, typeInfBlob
))
744 if (!getDataTypeInfo(SQL_VARBINARY
,typeInfBlob
))
746 if (failOnDataTypeUnsupported
)
750 typeInfBlob
.FsqlType
= SQL_VARBINARY
;
753 typeInfBlob
.FsqlType
= SQL_LONGVARBINARY
;
755 //typeInfBlob.TypeName = "BLOB";
757 #ifdef DBDEBUG_CONSOLE
758 cout
<< wxT("VARCHAR DATA TYPE: ") << typeInfVarchar
.TypeName
<< endl
;
759 cout
<< wxT("INTEGER DATA TYPE: ") << typeInfInteger
.TypeName
<< endl
;
760 cout
<< wxT("FLOAT DATA TYPE: ") << typeInfFloat
.TypeName
<< endl
;
761 cout
<< wxT("DATE DATA TYPE: ") << typeInfDate
.TypeName
<< endl
;
762 cout
<< wxT("BLOB DATA TYPE: ") << typeInfBlob
.TypeName
<< endl
;
766 // Completed Successfully
772 bool wxDb::Open(wxDbConnectInf
*dbConnectInf
)
774 return Open(dbConnectInf
->GetDsn(), dbConnectInf
->GetUserID(),
775 dbConnectInf
->GetPassword());
779 bool wxDb::Open(wxDb
*copyDb
)
781 dsn
= copyDb
->GetDatasourceName();
782 uid
= copyDb
->GetUsername();
783 authStr
= copyDb
->GetPassword();
787 if (!FwdOnlyCursors())
789 // Specify that the ODBC cursor library be used, if needed. This must be
790 // specified before the connection is made.
791 retcode
= SQLSetConnectOption(hdbc
, SQL_ODBC_CURSORS
, SQL_CUR_USE_IF_NEEDED
);
793 #ifdef DBDEBUG_CONSOLE
794 if (retcode
== SQL_SUCCESS
)
795 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) successful") << endl
;
797 cout
<< wxT("SQLSetConnectOption(CURSOR_LIB) failed") << endl
;
801 // Connect to the data source
802 retcode
= SQLConnect(hdbc
, (UCHAR FAR
*) dsn
.c_str(), SQL_NTS
,
803 (UCHAR FAR
*) uid
.c_str(), SQL_NTS
,
804 (UCHAR FAR
*) authStr
.c_str(), SQL_NTS
);
806 if (retcode
== SQL_ERROR
)
807 return(DispAllErrors(henv
, hdbc
));
810 If using Intersolv branded ODBC drivers, this is the place where you would substitute
811 your branded driver license information
813 SQLSetConnectOption(hdbc, 1041, (UDWORD) wxEmptyString);
814 SQLSetConnectOption(hdbc, 1042, (UDWORD) wxEmptyString);
817 // Mark database as open
820 // Allocate a statement handle for the database connection
821 if (SQLAllocStmt(hdbc
, &hstmt
) != SQL_SUCCESS
)
822 return(DispAllErrors(henv
, hdbc
));
824 // Set Connection Options
825 if (!setConnectionOptions())
828 // Instead of Querying the data source for info about itself, it can just be copied
829 // from the wxDb instance that was passed in (copyDb).
830 wxStrcpy(dbInf
.serverName
,copyDb
->dbInf
.serverName
);
831 wxStrcpy(dbInf
.databaseName
,copyDb
->dbInf
.databaseName
);
832 wxStrcpy(dbInf
.dbmsName
,copyDb
->dbInf
.dbmsName
);
833 wxStrcpy(dbInf
.dbmsVer
,copyDb
->dbInf
.dbmsVer
);
834 dbInf
.maxConnections
= copyDb
->dbInf
.maxConnections
;
835 dbInf
.maxStmts
= copyDb
->dbInf
.maxStmts
;
836 wxStrcpy(dbInf
.driverName
,copyDb
->dbInf
.driverName
);
837 wxStrcpy(dbInf
.odbcVer
,copyDb
->dbInf
.odbcVer
);
838 wxStrcpy(dbInf
.drvMgrOdbcVer
,copyDb
->dbInf
.drvMgrOdbcVer
);
839 wxStrcpy(dbInf
.driverVer
,copyDb
->dbInf
.driverVer
);
840 dbInf
.apiConfLvl
= copyDb
->dbInf
.apiConfLvl
;
841 dbInf
.cliConfLvl
= copyDb
->dbInf
.cliConfLvl
;
842 dbInf
.sqlConfLvl
= copyDb
->dbInf
.sqlConfLvl
;
843 wxStrcpy(dbInf
.outerJoins
,copyDb
->dbInf
.outerJoins
);
844 wxStrcpy(dbInf
.procedureSupport
,copyDb
->dbInf
.procedureSupport
);
845 wxStrcpy(dbInf
.accessibleTables
,copyDb
->dbInf
.accessibleTables
);
846 dbInf
.cursorCommitBehavior
= copyDb
->dbInf
.cursorCommitBehavior
;
847 dbInf
.cursorRollbackBehavior
= copyDb
->dbInf
.cursorRollbackBehavior
;
848 dbInf
.supportNotNullClause
= copyDb
->dbInf
.supportNotNullClause
;
849 wxStrcpy(dbInf
.supportIEF
,copyDb
->dbInf
.supportIEF
);
850 dbInf
.txnIsolation
= copyDb
->dbInf
.txnIsolation
;
851 dbInf
.txnIsolationOptions
= copyDb
->dbInf
.txnIsolationOptions
;
852 dbInf
.fetchDirections
= copyDb
->dbInf
.fetchDirections
;
853 dbInf
.lockTypes
= copyDb
->dbInf
.lockTypes
;
854 dbInf
.posOperations
= copyDb
->dbInf
.posOperations
;
855 dbInf
.posStmts
= copyDb
->dbInf
.posStmts
;
856 dbInf
.scrollConcurrency
= copyDb
->dbInf
.scrollConcurrency
;
857 dbInf
.scrollOptions
= copyDb
->dbInf
.scrollOptions
;
858 dbInf
.staticSensitivity
= copyDb
->dbInf
.staticSensitivity
;
859 dbInf
.txnCapable
= copyDb
->dbInf
.txnCapable
;
860 dbInf
.loginTimeout
= copyDb
->dbInf
.loginTimeout
;
862 // VARCHAR = Variable length character string
863 typeInfVarchar
.FsqlType
= copyDb
->typeInfVarchar
.FsqlType
;
864 typeInfVarchar
.TypeName
= copyDb
->typeInfVarchar
.TypeName
;
865 typeInfVarchar
.Precision
= copyDb
->typeInfVarchar
.Precision
;
866 typeInfVarchar
.CaseSensitive
= copyDb
->typeInfVarchar
.CaseSensitive
;
867 typeInfVarchar
.MaximumScale
= copyDb
->typeInfVarchar
.MaximumScale
;
870 typeInfFloat
.FsqlType
= copyDb
->typeInfFloat
.FsqlType
;
871 typeInfFloat
.TypeName
= copyDb
->typeInfFloat
.TypeName
;
872 typeInfFloat
.Precision
= copyDb
->typeInfFloat
.Precision
;
873 typeInfFloat
.CaseSensitive
= copyDb
->typeInfFloat
.CaseSensitive
;
874 typeInfFloat
.MaximumScale
= copyDb
->typeInfFloat
.MaximumScale
;
877 typeInfInteger
.FsqlType
= copyDb
->typeInfInteger
.FsqlType
;
878 typeInfInteger
.TypeName
= copyDb
->typeInfInteger
.TypeName
;
879 typeInfInteger
.Precision
= copyDb
->typeInfInteger
.Precision
;
880 typeInfInteger
.CaseSensitive
= copyDb
->typeInfInteger
.CaseSensitive
;
881 typeInfInteger
.MaximumScale
= copyDb
->typeInfInteger
.MaximumScale
;
884 typeInfDate
.FsqlType
= copyDb
->typeInfDate
.FsqlType
;
885 typeInfDate
.TypeName
= copyDb
->typeInfDate
.TypeName
;
886 typeInfDate
.Precision
= copyDb
->typeInfDate
.Precision
;
887 typeInfDate
.CaseSensitive
= copyDb
->typeInfDate
.CaseSensitive
;
888 typeInfDate
.MaximumScale
= copyDb
->typeInfDate
.MaximumScale
;
891 typeInfBlob
.FsqlType
= copyDb
->typeInfBlob
.FsqlType
;
892 typeInfBlob
.TypeName
= copyDb
->typeInfBlob
.TypeName
;
893 typeInfBlob
.Precision
= copyDb
->typeInfBlob
.Precision
;
894 typeInfBlob
.CaseSensitive
= copyDb
->typeInfBlob
.CaseSensitive
;
895 typeInfBlob
.MaximumScale
= copyDb
->typeInfBlob
.MaximumScale
;
897 #ifdef DBDEBUG_CONSOLE
898 cout
<< wxT("VARCHAR DATA TYPE: ") << typeInfVarchar
.TypeName
<< endl
;
899 cout
<< wxT("INTEGER DATA TYPE: ") << typeInfInteger
.TypeName
<< endl
;
900 cout
<< wxT("FLOAT DATA TYPE: ") << typeInfFloat
.TypeName
<< endl
;
901 cout
<< wxT("DATE DATA TYPE: ") << typeInfDate
.TypeName
<< endl
;
902 cout
<< wxT("BLOB DATA TYPE: ") << typeInfBlob
.TypeName
<< endl
;
906 // Completed Successfully
911 /********** wxDb::setConnectionOptions() **********/
912 bool wxDb::setConnectionOptions(void)
914 * NOTE: The Intersolv/Oracle 7 driver was "Not Capable" of setting the login timeout.
919 // I need to get the DBMS name here, because some of the connection options
920 // are database specific and need to call the Dbms() function.
921 if (SQLGetInfo(hdbc
, SQL_DBMS_NAME
, (UCHAR
*) dbInf
.dbmsName
, 40, &cb
) != SQL_SUCCESS
)
922 return(DispAllErrors(henv
, hdbc
));
924 SQLSetConnectOption(hdbc
, SQL_AUTOCOMMIT
, SQL_AUTOCOMMIT_OFF
);
925 SQLSetConnectOption(hdbc
, SQL_OPT_TRACE
, SQL_OPT_TRACE_OFF
);
926 // SQLSetConnectOption(hdbc, SQL_TXN_ISOLATION, SQL_TXN_READ_COMMITTED); // No dirty reads
928 // By default, MS Sql Server closes cursors on commit and rollback. The following
929 // call to SQLSetConnectOption() is needed to force SQL Server to preserve cursors
930 // after a transaction. This is a driver specific option and is not part of the
931 // ODBC standard. Note: this behavior is specific to the ODBC interface to SQL Server.
932 // The database settings don't have any effect one way or the other.
933 if (Dbms() == dbmsMS_SQL_SERVER
)
935 const long SQL_PRESERVE_CURSORS
= 1204L;
936 const long SQL_PC_ON
= 1L;
937 SQLSetConnectOption(hdbc
, SQL_PRESERVE_CURSORS
, SQL_PC_ON
);
940 // Display the connection options to verify them
941 #ifdef DBDEBUG_CONSOLE
943 cout
<< wxT("****** CONNECTION OPTIONS ******") << endl
;
945 if (SQLGetConnectOption(hdbc
, SQL_AUTOCOMMIT
, &l
) != SQL_SUCCESS
)
946 return(DispAllErrors(henv
, hdbc
));
947 cout
<< wxT("AUTOCOMMIT: ") << (l
== SQL_AUTOCOMMIT_OFF
? "OFF" : "ON") << endl
;
949 if (SQLGetConnectOption(hdbc
, SQL_ODBC_CURSORS
, &l
) != SQL_SUCCESS
)
950 return(DispAllErrors(henv
, hdbc
));
951 cout
<< wxT("ODBC CURSORS: ");
954 case(SQL_CUR_USE_IF_NEEDED
):
955 cout
<< wxT("SQL_CUR_USE_IF_NEEDED");
957 case(SQL_CUR_USE_ODBC
):
958 cout
<< wxT("SQL_CUR_USE_ODBC");
960 case(SQL_CUR_USE_DRIVER
):
961 cout
<< wxT("SQL_CUR_USE_DRIVER");
966 if (SQLGetConnectOption(hdbc
, SQL_OPT_TRACE
, &l
) != SQL_SUCCESS
)
967 return(DispAllErrors(henv
, hdbc
));
968 cout
<< wxT("TRACING: ") << (l
== SQL_OPT_TRACE_OFF
? wxT("OFF") : wxT("ON")) << endl
;
973 // Completed Successfully
976 } // wxDb::setConnectionOptions()
979 /********** wxDb::getDbInfo() **********/
980 bool wxDb::getDbInfo(void)
985 if (SQLGetInfo(hdbc
, SQL_SERVER_NAME
, (UCHAR
*) dbInf
.serverName
, 80, &cb
) != SQL_SUCCESS
)
986 return(DispAllErrors(henv
, hdbc
));
988 if (SQLGetInfo(hdbc
, SQL_DATABASE_NAME
, (UCHAR
*) dbInf
.databaseName
, 128, &cb
) != SQL_SUCCESS
)
989 return(DispAllErrors(henv
, hdbc
));
991 if (SQLGetInfo(hdbc
, SQL_DBMS_NAME
, (UCHAR
*) dbInf
.dbmsName
, 40, &cb
) != SQL_SUCCESS
)
992 return(DispAllErrors(henv
, hdbc
));
995 // After upgrading to MSVC6, the original 20 char buffer below was insufficient,
996 // causing database connectivity to fail in some cases.
997 retcode
= SQLGetInfo(hdbc
, SQL_DBMS_VER
, (UCHAR
*) dbInf
.dbmsVer
, 64, &cb
);
999 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
1000 return(DispAllErrors(henv
, hdbc
));
1002 if (SQLGetInfo(hdbc
, SQL_ACTIVE_CONNECTIONS
, (UCHAR
*) &dbInf
.maxConnections
, sizeof(dbInf
.maxConnections
), &cb
) != SQL_SUCCESS
)
1003 return(DispAllErrors(henv
, hdbc
));
1005 if (SQLGetInfo(hdbc
, SQL_ACTIVE_STATEMENTS
, (UCHAR
*) &dbInf
.maxStmts
, sizeof(dbInf
.maxStmts
), &cb
) != SQL_SUCCESS
)
1006 return(DispAllErrors(henv
, hdbc
));
1008 if (SQLGetInfo(hdbc
, SQL_DRIVER_NAME
, (UCHAR
*) dbInf
.driverName
, 40, &cb
) != SQL_SUCCESS
)
1009 return(DispAllErrors(henv
, hdbc
));
1011 if (SQLGetInfo(hdbc
, SQL_DRIVER_ODBC_VER
, (UCHAR
*) dbInf
.odbcVer
, 60, &cb
) == SQL_ERROR
)
1012 return(DispAllErrors(henv
, hdbc
));
1014 retcode
= SQLGetInfo(hdbc
, SQL_ODBC_VER
, (UCHAR
*) dbInf
.drvMgrOdbcVer
, 60, &cb
);
1015 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
1016 return(DispAllErrors(henv
, hdbc
));
1018 if (SQLGetInfo(hdbc
, SQL_DRIVER_VER
, (UCHAR
*) dbInf
.driverVer
, 60, &cb
) == SQL_ERROR
)
1019 return(DispAllErrors(henv
, hdbc
));
1021 if (SQLGetInfo(hdbc
, SQL_ODBC_API_CONFORMANCE
, (UCHAR
*) &dbInf
.apiConfLvl
, sizeof(dbInf
.apiConfLvl
), &cb
) != SQL_SUCCESS
)
1022 return(DispAllErrors(henv
, hdbc
));
1024 if (SQLGetInfo(hdbc
, SQL_ODBC_SAG_CLI_CONFORMANCE
, (UCHAR
*) &dbInf
.cliConfLvl
, sizeof(dbInf
.cliConfLvl
), &cb
) != SQL_SUCCESS
)
1025 // return(DispAllErrors(henv, hdbc));
1027 // Not all drivers support this call - Nick Gorham(unixODBC)
1028 dbInf
.cliConfLvl
= 0;
1031 if (SQLGetInfo(hdbc
, SQL_ODBC_SQL_CONFORMANCE
, (UCHAR
*) &dbInf
.sqlConfLvl
, sizeof(dbInf
.sqlConfLvl
), &cb
) != SQL_SUCCESS
)
1032 return(DispAllErrors(henv
, hdbc
));
1034 if (SQLGetInfo(hdbc
, SQL_OUTER_JOINS
, (UCHAR
*) dbInf
.outerJoins
, 2, &cb
) != SQL_SUCCESS
)
1035 return(DispAllErrors(henv
, hdbc
));
1037 if (SQLGetInfo(hdbc
, SQL_PROCEDURES
, (UCHAR
*) dbInf
.procedureSupport
, 2, &cb
) != SQL_SUCCESS
)
1038 return(DispAllErrors(henv
, hdbc
));
1040 if (SQLGetInfo(hdbc
, SQL_ACCESSIBLE_TABLES
, (UCHAR
*) dbInf
.accessibleTables
, 2, &cb
) != SQL_SUCCESS
)
1041 return(DispAllErrors(henv
, hdbc
));
1043 if (SQLGetInfo(hdbc
, SQL_CURSOR_COMMIT_BEHAVIOR
, (UCHAR
*) &dbInf
.cursorCommitBehavior
, sizeof(dbInf
.cursorCommitBehavior
), &cb
) != SQL_SUCCESS
)
1044 return(DispAllErrors(henv
, hdbc
));
1046 if (SQLGetInfo(hdbc
, SQL_CURSOR_ROLLBACK_BEHAVIOR
, (UCHAR
*) &dbInf
.cursorRollbackBehavior
, sizeof(dbInf
.cursorRollbackBehavior
), &cb
) != SQL_SUCCESS
)
1047 return(DispAllErrors(henv
, hdbc
));
1049 if (SQLGetInfo(hdbc
, SQL_NON_NULLABLE_COLUMNS
, (UCHAR
*) &dbInf
.supportNotNullClause
, sizeof(dbInf
.supportNotNullClause
), &cb
) != SQL_SUCCESS
)
1050 return(DispAllErrors(henv
, hdbc
));
1052 if (SQLGetInfo(hdbc
, SQL_ODBC_SQL_OPT_IEF
, (UCHAR
*) dbInf
.supportIEF
, 2, &cb
) != SQL_SUCCESS
)
1053 return(DispAllErrors(henv
, hdbc
));
1055 if (SQLGetInfo(hdbc
, SQL_DEFAULT_TXN_ISOLATION
, (UCHAR
*) &dbInf
.txnIsolation
, sizeof(dbInf
.txnIsolation
), &cb
) != SQL_SUCCESS
)
1056 return(DispAllErrors(henv
, hdbc
));
1058 if (SQLGetInfo(hdbc
, SQL_TXN_ISOLATION_OPTION
, (UCHAR
*) &dbInf
.txnIsolationOptions
, sizeof(dbInf
.txnIsolationOptions
), &cb
) != SQL_SUCCESS
)
1059 return(DispAllErrors(henv
, hdbc
));
1061 if (SQLGetInfo(hdbc
, SQL_FETCH_DIRECTION
, (UCHAR
*) &dbInf
.fetchDirections
, sizeof(dbInf
.fetchDirections
), &cb
) != SQL_SUCCESS
)
1062 return(DispAllErrors(henv
, hdbc
));
1064 if (SQLGetInfo(hdbc
, SQL_LOCK_TYPES
, (UCHAR
*) &dbInf
.lockTypes
, sizeof(dbInf
.lockTypes
), &cb
) != SQL_SUCCESS
)
1065 return(DispAllErrors(henv
, hdbc
));
1067 if (SQLGetInfo(hdbc
, SQL_POS_OPERATIONS
, (UCHAR
*) &dbInf
.posOperations
, sizeof(dbInf
.posOperations
), &cb
) != SQL_SUCCESS
)
1068 return(DispAllErrors(henv
, hdbc
));
1070 if (SQLGetInfo(hdbc
, SQL_POSITIONED_STATEMENTS
, (UCHAR
*) &dbInf
.posStmts
, sizeof(dbInf
.posStmts
), &cb
) != SQL_SUCCESS
)
1071 return(DispAllErrors(henv
, hdbc
));
1073 if (SQLGetInfo(hdbc
, SQL_SCROLL_CONCURRENCY
, (UCHAR
*) &dbInf
.scrollConcurrency
, sizeof(dbInf
.scrollConcurrency
), &cb
) != SQL_SUCCESS
)
1074 return(DispAllErrors(henv
, hdbc
));
1076 if (SQLGetInfo(hdbc
, SQL_SCROLL_OPTIONS
, (UCHAR
*) &dbInf
.scrollOptions
, sizeof(dbInf
.scrollOptions
), &cb
) != SQL_SUCCESS
)
1077 return(DispAllErrors(henv
, hdbc
));
1079 if (SQLGetInfo(hdbc
, SQL_STATIC_SENSITIVITY
, (UCHAR
*) &dbInf
.staticSensitivity
, sizeof(dbInf
.staticSensitivity
), &cb
) != SQL_SUCCESS
)
1080 return(DispAllErrors(henv
, hdbc
));
1082 if (SQLGetInfo(hdbc
, SQL_TXN_CAPABLE
, (UCHAR
*) &dbInf
.txnCapable
, sizeof(dbInf
.txnCapable
), &cb
) != SQL_SUCCESS
)
1083 return(DispAllErrors(henv
, hdbc
));
1085 if (SQLGetInfo(hdbc
, SQL_LOGIN_TIMEOUT
, (UCHAR
*) &dbInf
.loginTimeout
, sizeof(dbInf
.loginTimeout
), &cb
) != SQL_SUCCESS
)
1086 return(DispAllErrors(henv
, hdbc
));
1088 #ifdef DBDEBUG_CONSOLE
1089 cout
<< wxT("***** DATA SOURCE INFORMATION *****") << endl
;
1090 cout
<< wxT(wxT("SERVER Name: ") << dbInf
.serverName
<< endl
;
1091 cout
<< wxT("DBMS Name: ") << dbInf
.dbmsName
<< wxT("; DBMS Version: ") << dbInf
.dbmsVer
<< endl
;
1092 cout
<< wxT("ODBC Version: ") << dbInf
.odbcVer
<< wxT("; Driver Version: ") << dbInf
.driverVer
<< endl
;
1094 cout
<< wxT("API Conf. Level: ");
1095 switch(dbInf
.apiConfLvl
)
1097 case SQL_OAC_NONE
: cout
<< wxT("None"); break;
1098 case SQL_OAC_LEVEL1
: cout
<< wxT("Level 1"); break;
1099 case SQL_OAC_LEVEL2
: cout
<< wxT("Level 2"); break;
1103 cout
<< wxT("SAG CLI Conf. Level: ");
1104 switch(dbInf
.cliConfLvl
)
1106 case SQL_OSCC_NOT_COMPLIANT
: cout
<< wxT("Not Compliant"); break;
1107 case SQL_OSCC_COMPLIANT
: cout
<< wxT("Compliant"); break;
1111 cout
<< wxT("SQL Conf. Level: ");
1112 switch(dbInf
.sqlConfLvl
)
1114 case SQL_OSC_MINIMUM
: cout
<< wxT("Minimum Grammar"); break;
1115 case SQL_OSC_CORE
: cout
<< wxT("Core Grammar"); break;
1116 case SQL_OSC_EXTENDED
: cout
<< wxT("Extended Grammar"); break;
1120 cout
<< wxT("Max. Connections: ") << dbInf
.maxConnections
<< endl
;
1121 cout
<< wxT("Outer Joins: ") << dbInf
.outerJoins
<< endl
;
1122 cout
<< wxT("Support for Procedures: ") << dbInf
.procedureSupport
<< endl
;
1123 cout
<< wxT("All tables accessible : ") << dbInf
.accessibleTables
<< endl
;
1124 cout
<< wxT("Cursor COMMIT Behavior: ");
1125 switch(dbInf
.cursorCommitBehavior
)
1127 case SQL_CB_DELETE
: cout
<< wxT("Delete cursors"); break;
1128 case SQL_CB_CLOSE
: cout
<< wxT("Close cursors"); break;
1129 case SQL_CB_PRESERVE
: cout
<< wxT("Preserve cursors"); break;
1133 cout
<< wxT("Cursor ROLLBACK Behavior: ");
1134 switch(dbInf
.cursorRollbackBehavior
)
1136 case SQL_CB_DELETE
: cout
<< wxT("Delete cursors"); break;
1137 case SQL_CB_CLOSE
: cout
<< wxT("Close cursors"); break;
1138 case SQL_CB_PRESERVE
: cout
<< wxT("Preserve cursors"); break;
1142 cout
<< wxT("Support NOT NULL clause: ");
1143 switch(dbInf
.supportNotNullClause
)
1145 case SQL_NNC_NULL
: cout
<< wxT("No"); break;
1146 case SQL_NNC_NON_NULL
: cout
<< wxT("Yes"); break;
1150 cout
<< wxT("Support IEF (Ref. Integrity): ") << dbInf
.supportIEF
<< endl
;
1151 cout
<< wxT("Login Timeout: ") << dbInf
.loginTimeout
<< endl
;
1153 cout
<< endl
<< endl
<< wxT("more ...") << endl
;
1156 cout
<< wxT("Default Transaction Isolation: ";
1157 switch(dbInf
.txnIsolation
)
1159 case SQL_TXN_READ_UNCOMMITTED
: cout
<< wxT("Read Uncommitted"); break;
1160 case SQL_TXN_READ_COMMITTED
: cout
<< wxT("Read Committed"); break;
1161 case SQL_TXN_REPEATABLE_READ
: cout
<< wxT("Repeatable Read"); break;
1162 case SQL_TXN_SERIALIZABLE
: cout
<< wxT("Serializable"); break;
1164 case SQL_TXN_VERSIONING
: cout
<< wxT("Versioning"); break;
1169 cout
<< wxT("Transaction Isolation Options: ");
1170 if (dbInf
.txnIsolationOptions
& SQL_TXN_READ_UNCOMMITTED
)
1171 cout
<< wxT("Read Uncommitted, ");
1172 if (dbInf
.txnIsolationOptions
& SQL_TXN_READ_COMMITTED
)
1173 cout
<< wxT("Read Committed, ");
1174 if (dbInf
.txnIsolationOptions
& SQL_TXN_REPEATABLE_READ
)
1175 cout
<< wxT("Repeatable Read, ");
1176 if (dbInf
.txnIsolationOptions
& SQL_TXN_SERIALIZABLE
)
1177 cout
<< wxT("Serializable, ");
1179 if (dbInf
.txnIsolationOptions
& SQL_TXN_VERSIONING
)
1180 cout
<< wxT("Versioning");
1184 cout
<< wxT("Fetch Directions Supported:") << endl
<< wxT(" ");
1185 if (dbInf
.fetchDirections
& SQL_FD_FETCH_NEXT
)
1186 cout
<< wxT("Next, ");
1187 if (dbInf
.fetchDirections
& SQL_FD_FETCH_PRIOR
)
1188 cout
<< wxT("Prev, ");
1189 if (dbInf
.fetchDirections
& SQL_FD_FETCH_FIRST
)
1190 cout
<< wxT("First, ");
1191 if (dbInf
.fetchDirections
& SQL_FD_FETCH_LAST
)
1192 cout
<< wxT("Last, ");
1193 if (dbInf
.fetchDirections
& SQL_FD_FETCH_ABSOLUTE
)
1194 cout
<< wxT("Absolute, ");
1195 if (dbInf
.fetchDirections
& SQL_FD_FETCH_RELATIVE
)
1196 cout
<< wxT("Relative, ");
1198 if (dbInf
.fetchDirections
& SQL_FD_FETCH_RESUME
)
1199 cout
<< wxT("Resume, ");
1201 if (dbInf
.fetchDirections
& SQL_FD_FETCH_BOOKMARK
)
1202 cout
<< wxT("Bookmark");
1205 cout
<< wxT("Lock Types Supported (SQLSetPos): ");
1206 if (dbInf
.lockTypes
& SQL_LCK_NO_CHANGE
)
1207 cout
<< wxT("No Change, ");
1208 if (dbInf
.lockTypes
& SQL_LCK_EXCLUSIVE
)
1209 cout
<< wxT("Exclusive, ");
1210 if (dbInf
.lockTypes
& SQL_LCK_UNLOCK
)
1211 cout
<< wxT("UnLock");
1214 cout
<< wxT("Position Operations Supported (SQLSetPos): ");
1215 if (dbInf
.posOperations
& SQL_POS_POSITION
)
1216 cout
<< wxT("Position, ");
1217 if (dbInf
.posOperations
& SQL_POS_REFRESH
)
1218 cout
<< wxT("Refresh, ");
1219 if (dbInf
.posOperations
& SQL_POS_UPDATE
)
1220 cout
<< wxT("Upd, "));
1221 if (dbInf
.posOperations
& SQL_POS_DELETE
)
1222 cout
<< wxT("Del, ");
1223 if (dbInf
.posOperations
& SQL_POS_ADD
)
1227 cout
<< wxT("Positioned Statements Supported: ");
1228 if (dbInf
.posStmts
& SQL_PS_POSITIONED_DELETE
)
1229 cout
<< wxT("Pos delete, ");
1230 if (dbInf
.posStmts
& SQL_PS_POSITIONED_UPDATE
)
1231 cout
<< wxT("Pos update, ");
1232 if (dbInf
.posStmts
& SQL_PS_SELECT_FOR_UPDATE
)
1233 cout
<< wxT("Select for update");
1236 cout
<< wxT("Scroll Concurrency: ");
1237 if (dbInf
.scrollConcurrency
& SQL_SCCO_READ_ONLY
)
1238 cout
<< wxT("Read Only, ");
1239 if (dbInf
.scrollConcurrency
& SQL_SCCO_LOCK
)
1240 cout
<< wxT("Lock, ");
1241 if (dbInf
.scrollConcurrency
& SQL_SCCO_OPT_ROWVER
)
1242 cout
<< wxT("Opt. Rowver, ");
1243 if (dbInf
.scrollConcurrency
& SQL_SCCO_OPT_VALUES
)
1244 cout
<< wxT("Opt. Values");
1247 cout
<< wxT("Scroll Options: ");
1248 if (dbInf
.scrollOptions
& SQL_SO_FORWARD_ONLY
)
1249 cout
<< wxT("Fwd Only, ");
1250 if (dbInf
.scrollOptions
& SQL_SO_STATIC
)
1251 cout
<< wxT("Static, ");
1252 if (dbInf
.scrollOptions
& SQL_SO_KEYSET_DRIVEN
)
1253 cout
<< wxT("Keyset Driven, ");
1254 if (dbInf
.scrollOptions
& SQL_SO_DYNAMIC
)
1255 cout
<< wxT("Dynamic, ");
1256 if (dbInf
.scrollOptions
& SQL_SO_MIXED
)
1257 cout
<< wxT("Mixed");
1260 cout
<< wxT("Static Sensitivity: ");
1261 if (dbInf
.staticSensitivity
& SQL_SS_ADDITIONS
)
1262 cout
<< wxT("Additions, ");
1263 if (dbInf
.staticSensitivity
& SQL_SS_DELETIONS
)
1264 cout
<< wxT("Deletions, ");
1265 if (dbInf
.staticSensitivity
& SQL_SS_UPDATES
)
1266 cout
<< wxT("Updates");
1269 cout
<< wxT("Transaction Capable?: ");
1270 switch(dbInf
.txnCapable
)
1272 case SQL_TC_NONE
: cout
<< wxT("No"); break;
1273 case SQL_TC_DML
: cout
<< wxT("DML Only"); break;
1274 case SQL_TC_DDL_COMMIT
: cout
<< wxT("DDL Commit"); break;
1275 case SQL_TC_DDL_IGNORE
: cout
<< wxT("DDL Ignore"); break;
1276 case SQL_TC_ALL
: cout
<< wxT("DDL & DML"); break;
1283 // Completed Successfully
1286 } // wxDb::getDbInfo()
1289 /********** wxDb::getDataTypeInfo() **********/
1290 bool wxDb::getDataTypeInfo(SWORD fSqlType
, wxDbSqlTypeInfo
&structSQLTypeInfo
)
1293 * fSqlType will be something like SQL_VARCHAR. This parameter determines
1294 * the data type inf. is gathered for.
1296 * wxDbSqlTypeInfo is a structure that is filled in with data type information,
1301 // Get information about the data type specified
1302 if (SQLGetTypeInfo(hstmt
, fSqlType
) != SQL_SUCCESS
)
1303 return(DispAllErrors(henv
, hdbc
, hstmt
));
1306 retcode
= SQLFetch(hstmt
);
1307 if (retcode
!= SQL_SUCCESS
)
1309 #ifdef DBDEBUG_CONSOLE
1310 if (retcode
== SQL_NO_DATA_FOUND
)
1311 cout
<< wxT("SQL_NO_DATA_FOUND fetching inf. about data type.") << endl
;
1313 DispAllErrors(henv
, hdbc
, hstmt
);
1314 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1318 wxChar typeName
[DB_TYPE_NAME_LEN
+1];
1320 // Obtain columns from the record
1321 if (SQLGetData(hstmt
, 1, SQL_C_CHAR
, (UCHAR
*) typeName
, DB_TYPE_NAME_LEN
, &cbRet
) != SQL_SUCCESS
)
1322 return(DispAllErrors(henv
, hdbc
, hstmt
));
1324 structSQLTypeInfo
.TypeName
= typeName
;
1326 // BJO 20000503: no more needed with new GetColumns...
1329 if (Dbms() == dbmsMY_SQL
)
1331 if (structSQLTypeInfo
.TypeName
== wxT("middleint"))
1332 structSQLTypeInfo
.TypeName
= wxT("mediumint");
1333 else if (structSQLTypeInfo
.TypeName
== wxT("middleint unsigned"))
1334 structSQLTypeInfo
.TypeName
= wxT("mediumint unsigned");
1335 else if (structSQLTypeInfo
.TypeName
== wxT("integer"))
1336 structSQLTypeInfo
.TypeName
= wxT("int");
1337 else if (structSQLTypeInfo
.TypeName
== wxT("integer unsigned"))
1338 structSQLTypeInfo
.TypeName
= wxT("int unsigned");
1339 else if (structSQLTypeInfo
.TypeName
== wxT("middleint"))
1340 structSQLTypeInfo
.TypeName
= wxT("mediumint");
1341 else if (structSQLTypeInfo
.TypeName
== wxT("varchar"))
1342 structSQLTypeInfo
.TypeName
= wxT("char");
1345 // BJO 20000427 : OpenLink driver
1346 if (!wxStrncmp(dbInf
.driverName
, wxT("oplodbc"), 7) ||
1347 !wxStrncmp(dbInf
.driverName
, wxT("OLOD"), 4))
1349 if (structSQLTypeInfo
.TypeName
== wxT("double precision"))
1350 structSQLTypeInfo
.TypeName
= wxT("real");
1354 if (SQLGetData(hstmt
, 3, SQL_C_LONG
, (UCHAR
*) &structSQLTypeInfo
.Precision
, 0, &cbRet
) != SQL_SUCCESS
)
1355 return(DispAllErrors(henv
, hdbc
, hstmt
));
1356 if (SQLGetData(hstmt
, 8, SQL_C_SHORT
, (UCHAR
*) &structSQLTypeInfo
.CaseSensitive
, 0, &cbRet
) != SQL_SUCCESS
)
1357 return(DispAllErrors(henv
, hdbc
, hstmt
));
1358 // if (SQLGetData(hstmt, 14, SQL_C_SHORT, (UCHAR*) &structSQLTypeInfo.MinimumScale, 0, &cbRet) != SQL_SUCCESS)
1359 // return(DispAllErrors(henv, hdbc, hstmt));
1361 if (SQLGetData(hstmt
, 15, SQL_C_SHORT
,(UCHAR
*) &structSQLTypeInfo
.MaximumScale
, 0, &cbRet
) != SQL_SUCCESS
)
1362 return(DispAllErrors(henv
, hdbc
, hstmt
));
1364 if (structSQLTypeInfo
.MaximumScale
< 0)
1365 structSQLTypeInfo
.MaximumScale
= 0;
1367 // Close the statement handle which closes open cursors
1368 if (SQLFreeStmt(hstmt
, SQL_CLOSE
) != SQL_SUCCESS
)
1369 return(DispAllErrors(henv
, hdbc
, hstmt
));
1371 // Completed Successfully
1374 } // wxDb::getDataTypeInfo()
1377 /********** wxDb::Close() **********/
1378 void wxDb::Close(void)
1380 // Close the Sql Log file
1387 // Free statement handle
1390 if (SQLFreeStmt(hstmt
, SQL_DROP
) != SQL_SUCCESS
)
1391 DispAllErrors(henv
, hdbc
);
1394 // Disconnect from the datasource
1395 if (SQLDisconnect(hdbc
) != SQL_SUCCESS
)
1396 DispAllErrors(henv
, hdbc
);
1398 // Free the connection to the datasource
1399 if (SQLFreeConnect(hdbc
) != SQL_SUCCESS
)
1400 DispAllErrors(henv
, hdbc
);
1402 // There should be zero Ctable objects still connected to this db object
1403 wxASSERT(nTables
== 0);
1408 pNode
= TablesInUse
.First();
1412 tiu
= (wxTablesInUse
*)pNode
->Data();
1413 if (tiu
->pDb
== this)
1415 s
.Printf(wxT("(%-20s) tableID:[%6lu] pDb:[%p]"), tiu
->tableName
,tiu
->tableID
,tiu
->pDb
);
1416 s2
.Printf(wxT("Orphaned found using pDb:[%p]"),this);
1417 wxLogDebug (s
.c_str(),s2
.c_str());
1419 pNode
= pNode
->Next();
1423 // Copy the error messages to a global variable
1425 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
1426 wxStrcpy(DBerrorList
[i
], errorList
[i
]);
1428 dbmsType
= dbmsUNIDENTIFIED
;
1434 /********** wxDb::CommitTrans() **********/
1435 bool wxDb::CommitTrans(void)
1439 // Commit the transaction
1440 if (SQLTransact(henv
, hdbc
, SQL_COMMIT
) != SQL_SUCCESS
)
1441 return(DispAllErrors(henv
, hdbc
));
1444 // Completed successfully
1447 } // wxDb::CommitTrans()
1450 /********** wxDb::RollbackTrans() **********/
1451 bool wxDb::RollbackTrans(void)
1453 // Rollback the transaction
1454 if (SQLTransact(henv
, hdbc
, SQL_ROLLBACK
) != SQL_SUCCESS
)
1455 return(DispAllErrors(henv
, hdbc
));
1457 // Completed successfully
1460 } // wxDb::RollbackTrans()
1463 /********** wxDb::DispAllErrors() **********/
1464 bool wxDb::DispAllErrors(HENV aHenv
, HDBC aHdbc
, HSTMT aHstmt
)
1466 * This function is called internally whenever an error condition prevents the user's
1467 * request from being executed. This function will query the datasource as to the
1468 * actual error(s) that just occured on the previous request of the datasource.
1470 * The function will retrieve each error condition from the datasource and
1471 * Printf the codes/text values into a string which it then logs via logError().
1472 * If in DBDEBUG_CONSOLE mode, the constructed string will be displayed in the console
1473 * window and program execution will be paused until the user presses a key.
1475 * This function always returns a FALSE, so that functions which call this function
1476 * can have a line like "return (DispAllErrors(henv, hdbc));" to indicate the failure
1477 * of the users request, so that the calling code can then process the error msg log
1480 wxString odbcErrMsg
;
1482 while (SQLError(aHenv
, aHdbc
, aHstmt
, (UCHAR FAR
*) sqlState
, &nativeError
, (UCHAR FAR
*) errorMsg
, SQL_MAX_MESSAGE_LENGTH
- 1, &cbErrorMsg
) == SQL_SUCCESS
)
1484 odbcErrMsg
.Printf(wxT("SQL State = %s\nNative Error Code = %li\nError Message = %s\n"), sqlState
, nativeError
, errorMsg
);
1485 logError(odbcErrMsg
, sqlState
);
1488 #ifdef DBDEBUG_CONSOLE
1489 // When run in console mode, use standard out to display errors.
1490 cout
<< odbcErrMsg
.c_str() << endl
;
1491 cout
<< wxT("Press any key to continue...") << endl
;
1496 wxLogDebug(odbcErrMsg
,wxT("ODBC DEBUG MESSAGE from DispAllErrors()"));
1501 return(FALSE
); // This function always returns FALSE.
1503 } // wxDb::DispAllErrors()
1506 /********** wxDb::GetNextError() **********/
1507 bool wxDb::GetNextError(HENV aHenv
, HDBC aHdbc
, HSTMT aHstmt
)
1509 if (SQLError(aHenv
, aHdbc
, aHstmt
, (UCHAR FAR
*) sqlState
, &nativeError
, (UCHAR FAR
*) errorMsg
, SQL_MAX_MESSAGE_LENGTH
- 1, &cbErrorMsg
) == SQL_SUCCESS
)
1514 } // wxDb::GetNextError()
1517 /********** wxDb::DispNextError() **********/
1518 void wxDb::DispNextError(void)
1520 wxString odbcErrMsg
;
1522 odbcErrMsg
.Printf(wxT("SQL State = %s\nNative Error Code = %li\nError Message = %s\n"), sqlState
, nativeError
, errorMsg
);
1523 logError(odbcErrMsg
, sqlState
);
1528 #ifdef DBDEBUG_CONSOLE
1529 // When run in console mode, use standard out to display errors.
1530 cout
<< odbcErrMsg
.c_str() << endl
;
1531 cout
<< wxT("Press any key to continue...") << endl
;
1536 wxLogDebug(odbcErrMsg
,wxT("ODBC DEBUG MESSAGE"));
1537 #endif // __WXDEBUG__
1539 } // wxDb::DispNextError()
1542 /********** wxDb::logError() **********/
1543 void wxDb::logError(const wxString
&errMsg
, const wxString
&SQLState
)
1545 wxASSERT(errMsg
.Length());
1547 static int pLast
= -1;
1550 if (++pLast
== DB_MAX_ERROR_HISTORY
)
1553 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
1554 wxStrcpy(errorList
[i
], errorList
[i
+1]);
1558 wxStrcpy(errorList
[pLast
], errMsg
);
1560 if (SQLState
.Length())
1561 if ((dbStatus
= TranslateSqlState(SQLState
)) != DB_ERR_FUNCTION_SEQUENCE_ERROR
)
1562 DB_STATUS
= dbStatus
;
1564 // Add the errmsg to the sql log
1565 WriteSqlLog(errMsg
);
1567 } // wxDb::logError()
1570 /**********wxDb::TranslateSqlState() **********/
1571 int wxDb::TranslateSqlState(const wxString
&SQLState
)
1573 if (!wxStrcmp(SQLState
, wxT("01000")))
1574 return(DB_ERR_GENERAL_WARNING
);
1575 if (!wxStrcmp(SQLState
, wxT("01002")))
1576 return(DB_ERR_DISCONNECT_ERROR
);
1577 if (!wxStrcmp(SQLState
, wxT("01004")))
1578 return(DB_ERR_DATA_TRUNCATED
);
1579 if (!wxStrcmp(SQLState
, wxT("01006")))
1580 return(DB_ERR_PRIV_NOT_REVOKED
);
1581 if (!wxStrcmp(SQLState
, wxT("01S00")))
1582 return(DB_ERR_INVALID_CONN_STR_ATTR
);
1583 if (!wxStrcmp(SQLState
, wxT("01S01")))
1584 return(DB_ERR_ERROR_IN_ROW
);
1585 if (!wxStrcmp(SQLState
, wxT("01S02")))
1586 return(DB_ERR_OPTION_VALUE_CHANGED
);
1587 if (!wxStrcmp(SQLState
, wxT("01S03")))
1588 return(DB_ERR_NO_ROWS_UPD_OR_DEL
);
1589 if (!wxStrcmp(SQLState
, wxT("01S04")))
1590 return(DB_ERR_MULTI_ROWS_UPD_OR_DEL
);
1591 if (!wxStrcmp(SQLState
, wxT("07001")))
1592 return(DB_ERR_WRONG_NO_OF_PARAMS
);
1593 if (!wxStrcmp(SQLState
, wxT("07006")))
1594 return(DB_ERR_DATA_TYPE_ATTR_VIOL
);
1595 if (!wxStrcmp(SQLState
, wxT("08001")))
1596 return(DB_ERR_UNABLE_TO_CONNECT
);
1597 if (!wxStrcmp(SQLState
, wxT("08002")))
1598 return(DB_ERR_CONNECTION_IN_USE
);
1599 if (!wxStrcmp(SQLState
, wxT("08003")))
1600 return(DB_ERR_CONNECTION_NOT_OPEN
);
1601 if (!wxStrcmp(SQLState
, wxT("08004")))
1602 return(DB_ERR_REJECTED_CONNECTION
);
1603 if (!wxStrcmp(SQLState
, wxT("08007")))
1604 return(DB_ERR_CONN_FAIL_IN_TRANS
);
1605 if (!wxStrcmp(SQLState
, wxT("08S01")))
1606 return(DB_ERR_COMM_LINK_FAILURE
);
1607 if (!wxStrcmp(SQLState
, wxT("21S01")))
1608 return(DB_ERR_INSERT_VALUE_LIST_MISMATCH
);
1609 if (!wxStrcmp(SQLState
, wxT("21S02")))
1610 return(DB_ERR_DERIVED_TABLE_MISMATCH
);
1611 if (!wxStrcmp(SQLState
, wxT("22001")))
1612 return(DB_ERR_STRING_RIGHT_TRUNC
);
1613 if (!wxStrcmp(SQLState
, wxT("22003")))
1614 return(DB_ERR_NUMERIC_VALUE_OUT_OF_RNG
);
1615 if (!wxStrcmp(SQLState
, wxT("22005")))
1616 return(DB_ERR_ERROR_IN_ASSIGNMENT
);
1617 if (!wxStrcmp(SQLState
, wxT("22008")))
1618 return(DB_ERR_DATETIME_FLD_OVERFLOW
);
1619 if (!wxStrcmp(SQLState
, wxT("22012")))
1620 return(DB_ERR_DIVIDE_BY_ZERO
);
1621 if (!wxStrcmp(SQLState
, wxT("22026")))
1622 return(DB_ERR_STR_DATA_LENGTH_MISMATCH
);
1623 if (!wxStrcmp(SQLState
, wxT("23000")))
1624 return(DB_ERR_INTEGRITY_CONSTRAINT_VIOL
);
1625 if (!wxStrcmp(SQLState
, wxT("24000")))
1626 return(DB_ERR_INVALID_CURSOR_STATE
);
1627 if (!wxStrcmp(SQLState
, wxT("25000")))
1628 return(DB_ERR_INVALID_TRANS_STATE
);
1629 if (!wxStrcmp(SQLState
, wxT("28000")))
1630 return(DB_ERR_INVALID_AUTH_SPEC
);
1631 if (!wxStrcmp(SQLState
, wxT("34000")))
1632 return(DB_ERR_INVALID_CURSOR_NAME
);
1633 if (!wxStrcmp(SQLState
, wxT("37000")))
1634 return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL
);
1635 if (!wxStrcmp(SQLState
, wxT("3C000")))
1636 return(DB_ERR_DUPLICATE_CURSOR_NAME
);
1637 if (!wxStrcmp(SQLState
, wxT("40001")))
1638 return(DB_ERR_SERIALIZATION_FAILURE
);
1639 if (!wxStrcmp(SQLState
, wxT("42000")))
1640 return(DB_ERR_SYNTAX_ERROR_OR_ACCESS_VIOL2
);
1641 if (!wxStrcmp(SQLState
, wxT("70100")))
1642 return(DB_ERR_OPERATION_ABORTED
);
1643 if (!wxStrcmp(SQLState
, wxT("IM001")))
1644 return(DB_ERR_UNSUPPORTED_FUNCTION
);
1645 if (!wxStrcmp(SQLState
, wxT("IM002")))
1646 return(DB_ERR_NO_DATA_SOURCE
);
1647 if (!wxStrcmp(SQLState
, wxT("IM003")))
1648 return(DB_ERR_DRIVER_LOAD_ERROR
);
1649 if (!wxStrcmp(SQLState
, wxT("IM004")))
1650 return(DB_ERR_SQLALLOCENV_FAILED
);
1651 if (!wxStrcmp(SQLState
, wxT("IM005")))
1652 return(DB_ERR_SQLALLOCCONNECT_FAILED
);
1653 if (!wxStrcmp(SQLState
, wxT("IM006")))
1654 return(DB_ERR_SQLSETCONNECTOPTION_FAILED
);
1655 if (!wxStrcmp(SQLState
, wxT("IM007")))
1656 return(DB_ERR_NO_DATA_SOURCE_DLG_PROHIB
);
1657 if (!wxStrcmp(SQLState
, wxT("IM008")))
1658 return(DB_ERR_DIALOG_FAILED
);
1659 if (!wxStrcmp(SQLState
, wxT("IM009")))
1660 return(DB_ERR_UNABLE_TO_LOAD_TRANSLATION_DLL
);
1661 if (!wxStrcmp(SQLState
, wxT("IM010")))
1662 return(DB_ERR_DATA_SOURCE_NAME_TOO_LONG
);
1663 if (!wxStrcmp(SQLState
, wxT("IM011")))
1664 return(DB_ERR_DRIVER_NAME_TOO_LONG
);
1665 if (!wxStrcmp(SQLState
, wxT("IM012")))
1666 return(DB_ERR_DRIVER_KEYWORD_SYNTAX_ERROR
);
1667 if (!wxStrcmp(SQLState
, wxT("IM013")))
1668 return(DB_ERR_TRACE_FILE_ERROR
);
1669 if (!wxStrcmp(SQLState
, wxT("S0001")))
1670 return(DB_ERR_TABLE_OR_VIEW_ALREADY_EXISTS
);
1671 if (!wxStrcmp(SQLState
, wxT("S0002")))
1672 return(DB_ERR_TABLE_NOT_FOUND
);
1673 if (!wxStrcmp(SQLState
, wxT("S0011")))
1674 return(DB_ERR_INDEX_ALREADY_EXISTS
);
1675 if (!wxStrcmp(SQLState
, wxT("S0012")))
1676 return(DB_ERR_INDEX_NOT_FOUND
);
1677 if (!wxStrcmp(SQLState
, wxT("S0021")))
1678 return(DB_ERR_COLUMN_ALREADY_EXISTS
);
1679 if (!wxStrcmp(SQLState
, wxT("S0022")))
1680 return(DB_ERR_COLUMN_NOT_FOUND
);
1681 if (!wxStrcmp(SQLState
, wxT("S0023")))
1682 return(DB_ERR_NO_DEFAULT_FOR_COLUMN
);
1683 if (!wxStrcmp(SQLState
, wxT("S1000")))
1684 return(DB_ERR_GENERAL_ERROR
);
1685 if (!wxStrcmp(SQLState
, wxT("S1001")))
1686 return(DB_ERR_MEMORY_ALLOCATION_FAILURE
);
1687 if (!wxStrcmp(SQLState
, wxT("S1002")))
1688 return(DB_ERR_INVALID_COLUMN_NUMBER
);
1689 if (!wxStrcmp(SQLState
, wxT("S1003")))
1690 return(DB_ERR_PROGRAM_TYPE_OUT_OF_RANGE
);
1691 if (!wxStrcmp(SQLState
, wxT("S1004")))
1692 return(DB_ERR_SQL_DATA_TYPE_OUT_OF_RANGE
);
1693 if (!wxStrcmp(SQLState
, wxT("S1008")))
1694 return(DB_ERR_OPERATION_CANCELLED
);
1695 if (!wxStrcmp(SQLState
, wxT("S1009")))
1696 return(DB_ERR_INVALID_ARGUMENT_VALUE
);
1697 if (!wxStrcmp(SQLState
, wxT("S1010")))
1698 return(DB_ERR_FUNCTION_SEQUENCE_ERROR
);
1699 if (!wxStrcmp(SQLState
, wxT("S1011")))
1700 return(DB_ERR_OPERATION_INVALID_AT_THIS_TIME
);
1701 if (!wxStrcmp(SQLState
, wxT("S1012")))
1702 return(DB_ERR_INVALID_TRANS_OPERATION_CODE
);
1703 if (!wxStrcmp(SQLState
, wxT("S1015")))
1704 return(DB_ERR_NO_CURSOR_NAME_AVAIL
);
1705 if (!wxStrcmp(SQLState
, wxT("S1090")))
1706 return(DB_ERR_INVALID_STR_OR_BUF_LEN
);
1707 if (!wxStrcmp(SQLState
, wxT("S1091")))
1708 return(DB_ERR_DESCRIPTOR_TYPE_OUT_OF_RANGE
);
1709 if (!wxStrcmp(SQLState
, wxT("S1092")))
1710 return(DB_ERR_OPTION_TYPE_OUT_OF_RANGE
);
1711 if (!wxStrcmp(SQLState
, wxT("S1093")))
1712 return(DB_ERR_INVALID_PARAM_NO
);
1713 if (!wxStrcmp(SQLState
, wxT("S1094")))
1714 return(DB_ERR_INVALID_SCALE_VALUE
);
1715 if (!wxStrcmp(SQLState
, wxT("S1095")))
1716 return(DB_ERR_FUNCTION_TYPE_OUT_OF_RANGE
);
1717 if (!wxStrcmp(SQLState
, wxT("S1096")))
1718 return(DB_ERR_INF_TYPE_OUT_OF_RANGE
);
1719 if (!wxStrcmp(SQLState
, wxT("S1097")))
1720 return(DB_ERR_COLUMN_TYPE_OUT_OF_RANGE
);
1721 if (!wxStrcmp(SQLState
, wxT("S1098")))
1722 return(DB_ERR_SCOPE_TYPE_OUT_OF_RANGE
);
1723 if (!wxStrcmp(SQLState
, wxT("S1099")))
1724 return(DB_ERR_NULLABLE_TYPE_OUT_OF_RANGE
);
1725 if (!wxStrcmp(SQLState
, wxT("S1100")))
1726 return(DB_ERR_UNIQUENESS_OPTION_TYPE_OUT_OF_RANGE
);
1727 if (!wxStrcmp(SQLState
, wxT("S1101")))
1728 return(DB_ERR_ACCURACY_OPTION_TYPE_OUT_OF_RANGE
);
1729 if (!wxStrcmp(SQLState
, wxT("S1103")))
1730 return(DB_ERR_DIRECTION_OPTION_OUT_OF_RANGE
);
1731 if (!wxStrcmp(SQLState
, wxT("S1104")))
1732 return(DB_ERR_INVALID_PRECISION_VALUE
);
1733 if (!wxStrcmp(SQLState
, wxT("S1105")))
1734 return(DB_ERR_INVALID_PARAM_TYPE
);
1735 if (!wxStrcmp(SQLState
, wxT("S1106")))
1736 return(DB_ERR_FETCH_TYPE_OUT_OF_RANGE
);
1737 if (!wxStrcmp(SQLState
, wxT("S1107")))
1738 return(DB_ERR_ROW_VALUE_OUT_OF_RANGE
);
1739 if (!wxStrcmp(SQLState
, wxT("S1108")))
1740 return(DB_ERR_CONCURRENCY_OPTION_OUT_OF_RANGE
);
1741 if (!wxStrcmp(SQLState
, wxT("S1109")))
1742 return(DB_ERR_INVALID_CURSOR_POSITION
);
1743 if (!wxStrcmp(SQLState
, wxT("S1110")))
1744 return(DB_ERR_INVALID_DRIVER_COMPLETION
);
1745 if (!wxStrcmp(SQLState
, wxT("S1111")))
1746 return(DB_ERR_INVALID_BOOKMARK_VALUE
);
1747 if (!wxStrcmp(SQLState
, wxT("S1C00")))
1748 return(DB_ERR_DRIVER_NOT_CAPABLE
);
1749 if (!wxStrcmp(SQLState
, wxT("S1T00")))
1750 return(DB_ERR_TIMEOUT_EXPIRED
);
1755 } // wxDb::TranslateSqlState()
1758 /********** wxDb::Grant() **********/
1759 bool wxDb::Grant(int privileges
, const wxString
&tableName
, const wxString
&userList
)
1763 // Build the grant statement
1764 sqlStmt
= wxT("GRANT ");
1765 if (privileges
== DB_GRANT_ALL
)
1766 sqlStmt
+= wxT("ALL");
1770 if (privileges
& DB_GRANT_SELECT
)
1772 sqlStmt
+= wxT("SELECT");
1775 if (privileges
& DB_GRANT_INSERT
)
1778 sqlStmt
+= wxT(", ");
1779 sqlStmt
+= wxT("INSERT");
1781 if (privileges
& DB_GRANT_UPDATE
)
1784 sqlStmt
+= wxT(", ");
1785 sqlStmt
+= wxT("UPDATE");
1787 if (privileges
& DB_GRANT_DELETE
)
1790 sqlStmt
+= wxT(", ");
1791 sqlStmt
+= wxT("DELETE");
1795 sqlStmt
+= wxT(" ON ");
1796 sqlStmt
+= SQLTableName(tableName
);
1797 sqlStmt
+= wxT(" TO ");
1798 sqlStmt
+= userList
;
1800 #ifdef DBDEBUG_CONSOLE
1801 cout
<< endl
<< sqlStmt
.c_str() << endl
;
1804 WriteSqlLog(sqlStmt
);
1806 return(ExecSql(sqlStmt
));
1811 /********** wxDb::CreateView() **********/
1812 bool wxDb::CreateView(const wxString
&viewName
, const wxString
&colList
,
1813 const wxString
&pSqlStmt
, bool attemptDrop
)
1817 // Drop the view first
1818 if (attemptDrop
&& !DropView(viewName
))
1821 // Build the create view statement
1822 sqlStmt
= wxT("CREATE VIEW ");
1823 sqlStmt
+= viewName
;
1825 if (colList
.Length())
1827 sqlStmt
+= wxT(" (");
1829 sqlStmt
+= wxT(")");
1832 sqlStmt
+= wxT(" AS ");
1833 sqlStmt
+= pSqlStmt
;
1835 WriteSqlLog(sqlStmt
);
1837 #ifdef DBDEBUG_CONSOLE
1838 cout
<< sqlStmt
.c_str() << endl
;
1841 return(ExecSql(sqlStmt
));
1843 } // wxDb::CreateView()
1846 /********** wxDb::DropView() **********/
1847 bool wxDb::DropView(const wxString
&viewName
)
1850 * NOTE: This function returns TRUE if the View does not exist, but
1851 * only for identified databases. Code will need to be added
1852 * below for any other databases when those databases are defined
1853 * to handle this situation consistently
1857 sqlStmt
.Printf(wxT("DROP VIEW %s"), viewName
.c_str());
1859 WriteSqlLog(sqlStmt
);
1861 #ifdef DBDEBUG_CONSOLE
1862 cout
<< endl
<< sqlStmt
.c_str() << endl
;
1865 if (SQLExecDirect(hstmt
, (UCHAR FAR
*) sqlStmt
.c_str(), SQL_NTS
) != SQL_SUCCESS
)
1867 // Check for "Base table not found" error and ignore
1868 GetNextError(henv
, hdbc
, hstmt
);
1869 if (wxStrcmp(sqlState
,wxT("S0002"))) // "Base table not found"
1871 // Check for product specific error codes
1872 if (!((Dbms() == dbmsSYBASE_ASA
&& !wxStrcmp(sqlState
,wxT("42000"))))) // 5.x (and lower?)
1875 DispAllErrors(henv
, hdbc
, hstmt
);
1882 // Commit the transaction
1888 } // wxDb::DropView()
1891 /********** wxDb::ExecSql() **********/
1892 bool wxDb::ExecSql(const wxString
&pSqlStmt
)
1896 SQLFreeStmt(hstmt
, SQL_CLOSE
);
1898 retcode
= SQLExecDirect(hstmt
, (UCHAR FAR
*) pSqlStmt
.c_str(), SQL_NTS
);
1899 if (retcode
== SQL_SUCCESS
||
1900 (Dbms() == dbmsDB2
&& (retcode
== SQL_SUCCESS_WITH_INFO
|| retcode
== SQL_NO_DATA_FOUND
)))
1906 DispAllErrors(henv
, hdbc
, hstmt
);
1910 } // wxDb::ExecSql()
1913 /********** wxDb::GetNext() **********/
1914 bool wxDb::GetNext(void)
1916 if (SQLFetch(hstmt
) == SQL_SUCCESS
)
1920 DispAllErrors(henv
, hdbc
, hstmt
);
1924 } // wxDb::GetNext()
1927 /********** wxDb::GetData() **********/
1928 bool wxDb::GetData(UWORD colNo
, SWORD cType
, PTR pData
, SDWORD maxLen
, SDWORD FAR
*cbReturned
)
1931 wxASSERT(cbReturned
);
1933 if (SQLGetData(hstmt
, colNo
, cType
, pData
, maxLen
, cbReturned
) == SQL_SUCCESS
)
1937 DispAllErrors(henv
, hdbc
, hstmt
);
1941 } // wxDb::GetData()
1944 /********** wxDb::GetKeyFields() **********/
1945 int wxDb::GetKeyFields(const wxString
&tableName
, wxDbColInf
* colInf
, UWORD noCols
)
1947 wxChar szPkTable
[DB_MAX_TABLE_NAME_LEN
+1]; /* Primary key table name */
1948 wxChar szFkTable
[DB_MAX_TABLE_NAME_LEN
+1]; /* Foreign key table name */
1950 // SQLSMALLINT iKeySeq;
1951 wxChar szPkCol
[DB_MAX_COLUMN_NAME_LEN
+1]; /* Primary key column */
1952 wxChar szFkCol
[DB_MAX_COLUMN_NAME_LEN
+1]; /* Foreign key column */
1958 * -----------------------------------------------------------------------
1959 * -- 19991224 : mj10777 : Create ------
1960 * -- : Three things are done and stored here : ------
1961 * -- : 1) which Column(s) is/are Primary Key(s) ------
1962 * -- : 2) which tables use this Key as a Foreign Key ------
1963 * -- : 3) which columns are Foreign Key and the name ------
1964 * -- : of the Table where the Key is the Primary Key -----
1965 * -- : Called from GetColumns(const wxString &tableName, ------
1966 * -- int *numCols,const wxChar *userID ) ------
1967 * -----------------------------------------------------------------------
1970 /*---------------------------------------------------------------------*/
1971 /* Get the names of the columns in the primary key. */
1972 /*---------------------------------------------------------------------*/
1973 retcode
= SQLPrimaryKeys(hstmt
,
1974 NULL
, 0, /* Catalog name */
1975 NULL
, 0, /* Schema name */
1976 (UCHAR FAR
*) tableName
.c_str(), SQL_NTS
); /* Table name */
1978 /*---------------------------------------------------------------------*/
1979 /* Fetch and display the result set. This will be a list of the */
1980 /* columns in the primary key of the tableName table. */
1981 /*---------------------------------------------------------------------*/
1982 while ((retcode
== SQL_SUCCESS
) || (retcode
== SQL_SUCCESS_WITH_INFO
))
1984 retcode
= SQLFetch(hstmt
);
1985 if (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
1987 GetData( 4, SQL_C_CHAR
, szPkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
1988 GetData( 5, SQL_C_SSHORT
, &iKeySeq
, 0, &cb
);
1990 for (i
=0;i
<noCols
;i
++) // Find the Column name
1991 if (!wxStrcmp(colInf
[i
].colName
,szPkCol
)) // We have found the Column
1992 colInf
[i
].PkCol
= iKeySeq
; // Which Primary Key is this (first, second usw.) ?
1995 SQLFreeStmt(hstmt
, SQL_CLOSE
); /* Close the cursor (the hstmt is still allocated). */
1997 /*---------------------------------------------------------------------*/
1998 /* Get all the foreign keys that refer to tableName primary key. */
1999 /*---------------------------------------------------------------------*/
2000 retcode
= SQLForeignKeys(hstmt
,
2001 NULL
, 0, /* Primary catalog */
2002 NULL
, 0, /* Primary schema */
2003 (UCHAR FAR
*)tableName
.c_str(), SQL_NTS
,/* Primary table */
2004 NULL
, 0, /* Foreign catalog */
2005 NULL
, 0, /* Foreign schema */
2006 NULL
, 0); /* Foreign table */
2008 /*---------------------------------------------------------------------*/
2009 /* Fetch and display the result set. This will be all of the foreign */
2010 /* keys in other tables that refer to the tableName primary key. */
2011 /*---------------------------------------------------------------------*/
2014 while ((retcode
== SQL_SUCCESS
) || (retcode
== SQL_SUCCESS_WITH_INFO
))
2016 retcode
= SQLFetch(hstmt
);
2017 if (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
2019 GetData( 3, SQL_C_CHAR
, szPkTable
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2020 GetData( 4, SQL_C_CHAR
, szPkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2021 GetData( 5, SQL_C_SSHORT
, &iKeySeq
, 0, &cb
);
2022 GetData( 7, SQL_C_CHAR
, szFkTable
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2023 GetData( 8, SQL_C_CHAR
, szFkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2024 tempStr
.Printf(wxT("%s[%s] "),tempStr
.c_str(),szFkTable
); // [ ] in case there is a blank in the Table name
2028 tempStr
.Trim(); // Get rid of any unneeded blanks
2029 if (!tempStr
.IsEmpty())
2031 for (i
=0; i
<noCols
; i
++)
2032 { // Find the Column name
2033 if (!wxStrcmp(colInf
[i
].colName
, szPkCol
)) // We have found the Column, store the Information
2034 wxStrcpy(colInf
[i
].PkTableName
, tempStr
.c_str()); // Name of the Tables where this Primary Key is used as a Foreign Key
2038 SQLFreeStmt(hstmt
, SQL_CLOSE
); /* Close the cursor (the hstmt is still allocated). */
2040 /*---------------------------------------------------------------------*/
2041 /* Get all the foreign keys in the tablename table. */
2042 /*---------------------------------------------------------------------*/
2043 retcode
= SQLForeignKeys(hstmt
,
2044 NULL
, 0, /* Primary catalog */
2045 NULL
, 0, /* Primary schema */
2046 NULL
, 0, /* Primary table */
2047 NULL
, 0, /* Foreign catalog */
2048 NULL
, 0, /* Foreign schema */
2049 (UCHAR
*)tableName
.c_str(), SQL_NTS
);/* Foreign table */
2051 /*---------------------------------------------------------------------*/
2052 /* Fetch and display the result set. This will be all of the */
2053 /* primary keys in other tables that are referred to by foreign */
2054 /* keys in the tableName table. */
2055 /*---------------------------------------------------------------------*/
2057 while ((retcode
== SQL_SUCCESS
) || (retcode
== SQL_SUCCESS_WITH_INFO
))
2059 retcode
= SQLFetch(hstmt
);
2060 if (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
2062 GetData( 3, SQL_C_CHAR
, szPkTable
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2063 GetData( 5, SQL_C_SSHORT
, &iKeySeq
, 0, &cb
);
2064 GetData( 8, SQL_C_CHAR
, szFkCol
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2066 for (i
=0; i
<noCols
; i
++) // Find the Column name
2068 if (!wxStrcmp(colInf
[i
].colName
,szFkCol
)) // We have found the (Foreign Key) Column
2070 colInf
[i
].FkCol
= iKeySeq
; // Which Foreign Key is this (first, second usw.) ?
2071 wxStrcpy(colInf
[i
].FkTableName
,szPkTable
); // Name of the Table where this Foriegn is the Primary Key
2076 SQLFreeStmt(hstmt
, SQL_CLOSE
); /* Close the cursor (the hstmt is still allocated). */
2080 } // wxDb::GetKeyFields()
2084 /********** wxDb::GetColumns() **********/
2085 wxDbColInf
*wxDb::GetColumns(wxChar
*tableName
[], const wxChar
*userID
)
2087 * 1) The last array element of the tableName[] argument must be zero (null).
2088 * This is how the end of the array is detected.
2089 * 2) This function returns an array of wxDbColInf structures. If no columns
2090 * were found, or an error occured, this pointer will be zero (null). THE
2091 * CALLING FUNCTION IS RESPONSIBLE FOR DELETING THE MEMORY RETURNED WHEN IT
2092 * IS FINISHED WITH IT. i.e.
2094 * wxDbColInf *colInf = pDb->GetColumns(tableList, userID);
2097 * // Use the column inf
2099 * // Destroy the memory
2103 * userID is evaluated in the following manner:
2104 * userID == NULL ... UserID is ignored
2105 * userID == "" ... UserID set equal to 'this->uid'
2106 * userID != "" ... UserID set equal to 'userID'
2108 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2109 * by this function. This function should use its own wxDb instance
2110 * to avoid undesired unbinding of columns.
2115 wxDbColInf
*colInf
= 0;
2123 convertUserID(userID
,UserID
);
2125 // Pass 1 - Determine how many columns there are.
2126 // Pass 2 - Allocate the wxDbColInf array and fill in
2127 // the array with the column information.
2129 for (pass
= 1; pass
<= 2; pass
++)
2133 if (noCols
== 0) // Probably a bogus table name(s)
2135 // Allocate n wxDbColInf objects to hold the column information
2136 colInf
= new wxDbColInf
[noCols
+1];
2139 // Mark the end of the array
2140 wxStrcpy(colInf
[noCols
].tableName
,wxEmptyString
);
2141 wxStrcpy(colInf
[noCols
].colName
,wxEmptyString
);
2142 colInf
[noCols
].sqlDataType
= 0;
2144 // Loop through each table name
2146 for (tbl
= 0; tableName
[tbl
]; tbl
++)
2148 TableName
= tableName
[tbl
];
2149 // Oracle and Interbase table names are uppercase only, so force
2150 // the name to uppercase just in case programmer forgot to do this
2151 if ((Dbms() == dbmsORACLE
) ||
2152 (Dbms() == dbmsINTERBASE
))
2153 TableName
= TableName
.Upper();
2155 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2157 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2158 // use the call below that leaves out the user name
2159 if (!UserID
.IsEmpty() &&
2160 Dbms() != dbmsMY_SQL
&&
2161 Dbms() != dbmsACCESS
&&
2162 Dbms() != dbmsMS_SQL_SERVER
)
2164 retcode
= SQLColumns(hstmt
,
2165 NULL
, 0, // All qualifiers
2166 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2167 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2168 NULL
, 0); // All columns
2172 retcode
= SQLColumns(hstmt
,
2173 NULL
, 0, // All qualifiers
2175 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2176 NULL
, 0); // All columns
2178 if (retcode
!= SQL_SUCCESS
)
2179 { // Error occured, abort
2180 DispAllErrors(henv
, hdbc
, hstmt
);
2183 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2187 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2189 if (pass
== 1) // First pass, just add up the number of columns
2191 else // Pass 2; Fill in the array of structures
2193 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
2195 // NOTE: Only the ODBC 1.x fields are retrieved
2196 GetData( 1, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].catalog
, 128+1, &cb
);
2197 GetData( 2, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].schema
, 128+1, &cb
);
2198 GetData( 3, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2199 GetData( 4, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2200 GetData( 5, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].sqlDataType
, 0, &cb
);
2201 GetData( 6, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].typeName
, 128+1, &cb
);
2202 GetData( 7, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].columnSize
, 0, &cb
);
2203 GetData( 8, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].bufferLength
, 0, &cb
);
2204 GetData( 9, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].decimalDigits
,0, &cb
);
2205 GetData(10, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].numPrecRadix
, 0, &cb
);
2206 GetData(11, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].nullable
, 0, &cb
);
2207 GetData(12, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].remarks
, 254+1, &cb
);
2209 // Determine the wxDb data type that is used to represent the native data type of this data source
2210 colInf
[colNo
].dbDataType
= 0;
2211 if (!wxStricmp(typeInfVarchar
.TypeName
,colInf
[colNo
].typeName
))
2214 // IODBC does not return a correct columnSize, so we set
2215 // columnSize = bufferLength if no column size was returned
2216 // IODBC returns the columnSize in bufferLength.. (bug)
2217 if (colInf
[colNo
].columnSize
< 1)
2219 colInf
[colNo
].columnSize
= colInf
[colNo
].bufferLength
;
2222 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_VARCHAR
;
2224 else if (!wxStricmp(typeInfInteger
.TypeName
, colInf
[colNo
].typeName
))
2225 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_INTEGER
;
2226 else if (!wxStricmp(typeInfFloat
.TypeName
, colInf
[colNo
].typeName
))
2227 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_FLOAT
;
2228 else if (!wxStricmp(typeInfDate
.TypeName
, colInf
[colNo
].typeName
))
2229 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_DATE
;
2230 else if (!wxStricmp(typeInfBlob
.TypeName
, colInf
[colNo
].typeName
))
2231 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_BLOB
;
2236 if (retcode
!= SQL_NO_DATA_FOUND
)
2237 { // Error occured, abort
2238 DispAllErrors(henv
, hdbc
, hstmt
);
2241 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2247 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2250 } // wxDb::GetColumns()
2253 /********** wxDb::GetColumns() **********/
2255 wxDbColInf
*wxDb::GetColumns(const wxString
&tableName
, UWORD
*numCols
, const wxChar
*userID
)
2257 // Same as the above GetColumns() function except this one gets columns
2258 // only for a single table, and if 'numCols' is not NULL, the number of
2259 // columns stored in the returned wxDbColInf is set in '*numCols'
2261 // userID is evaluated in the following manner:
2262 // userID == NULL ... UserID is ignored
2263 // userID == "" ... UserID set equal to 'this->uid'
2264 // userID != "" ... UserID set equal to 'userID'
2266 // NOTE: ALL column bindings associated with this wxDb instance are unbound
2267 // by this function. This function should use its own wxDb instance
2268 // to avoid undesired unbinding of columns.
2273 wxDbColInf
*colInf
= 0;
2281 convertUserID(userID
,UserID
);
2283 // Pass 1 - Determine how many columns there are.
2284 // Pass 2 - Allocate the wxDbColInf array and fill in
2285 // the array with the column information.
2287 for (pass
= 1; pass
<= 2; pass
++)
2291 if (noCols
== 0) // Probably a bogus table name(s)
2293 // Allocate n wxDbColInf objects to hold the column information
2294 colInf
= new wxDbColInf
[noCols
+1];
2297 // Mark the end of the array
2298 wxStrcpy(colInf
[noCols
].tableName
, wxEmptyString
);
2299 wxStrcpy(colInf
[noCols
].colName
, wxEmptyString
);
2300 colInf
[noCols
].sqlDataType
= 0;
2303 TableName
= tableName
;
2304 // Oracle and Interbase table names are uppercase only, so force
2305 // the name to uppercase just in case programmer forgot to do this
2306 if ((Dbms() == dbmsORACLE
) ||
2307 (Dbms() == dbmsINTERBASE
))
2308 TableName
= TableName
.Upper();
2310 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2312 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2313 // use the call below that leaves out the user name
2314 if (!UserID
.IsEmpty() &&
2315 Dbms() != dbmsMY_SQL
&&
2316 Dbms() != dbmsACCESS
&&
2317 Dbms() != dbmsMS_SQL_SERVER
)
2319 retcode
= SQLColumns(hstmt
,
2320 NULL
, 0, // All qualifiers
2321 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2322 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2323 NULL
, 0); // All columns
2327 retcode
= SQLColumns(hstmt
,
2328 NULL
, 0, // All qualifiers
2330 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2331 NULL
, 0); // All columns
2333 if (retcode
!= SQL_SUCCESS
)
2334 { // Error occured, abort
2335 DispAllErrors(henv
, hdbc
, hstmt
);
2338 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2344 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2346 if (pass
== 1) // First pass, just add up the number of columns
2348 else // Pass 2; Fill in the array of structures
2350 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
2352 // NOTE: Only the ODBC 1.x fields are retrieved
2353 GetData( 1, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].catalog
, 128+1, &cb
);
2354 GetData( 2, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].schema
, 128+1, &cb
);
2355 GetData( 3, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2356 GetData( 4, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2357 GetData( 5, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].sqlDataType
, 0, &cb
);
2358 GetData( 6, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].typeName
, 128+1, &cb
);
2359 GetData( 7, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].columnSize
, 0, &cb
);
2360 // BJO 991214 : SQL_C_SSHORT instead of SQL_C_SLONG, otherwise fails on Sparc (probably all 64 bit architectures)
2361 GetData( 8, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].bufferLength
, 0, &cb
);
2362 GetData( 9, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].decimalDigits
,0, &cb
);
2363 GetData(10, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].numPrecRadix
, 0, &cb
);
2364 GetData(11, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].nullable
, 0, &cb
);
2365 GetData(12, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].remarks
, 254+1, &cb
);
2366 // Start Values for Primary/Foriegn Key (=No)
2367 colInf
[colNo
].PkCol
= 0; // Primary key column 0=No; 1= First Key, 2 = Second Key etc.
2368 colInf
[colNo
].PkTableName
[0] = 0; // Tablenames where Primary Key is used as a Foreign Key
2369 colInf
[colNo
].FkCol
= 0; // Foreign key column 0=No; 1= First Key, 2 = Second Key etc.
2370 colInf
[colNo
].FkTableName
[0] = 0; // Foreign key table name
2372 // BJO 20000428 : Virtuoso returns type names with upper cases!
2373 if (Dbms() == dbmsVIRTUOSO
)
2375 wxString s
= colInf
[colNo
].typeName
;
2377 wxStrcmp(colInf
[colNo
].typeName
, s
.c_str());
2380 // Determine the wxDb data type that is used to represent the native data type of this data source
2381 colInf
[colNo
].dbDataType
= 0;
2382 if (!wxStricmp(typeInfVarchar
.TypeName
, colInf
[colNo
].typeName
))
2385 // IODBC does not return a correct columnSize, so we set
2386 // columnSize = bufferLength if no column size was returned
2387 // IODBC returns the columnSize in bufferLength.. (bug)
2388 if (colInf
[colNo
].columnSize
< 1)
2390 colInf
[colNo
].columnSize
= colInf
[colNo
].bufferLength
;
2394 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_VARCHAR
;
2396 else if (!wxStricmp(typeInfInteger
.TypeName
, colInf
[colNo
].typeName
))
2397 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_INTEGER
;
2398 else if (!wxStricmp(typeInfFloat
.TypeName
, colInf
[colNo
].typeName
))
2399 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_FLOAT
;
2400 else if (!wxStricmp(typeInfDate
.TypeName
, colInf
[colNo
].typeName
))
2401 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_DATE
;
2402 else if (!wxStricmp(typeInfBlob
.TypeName
, colInf
[colNo
].typeName
))
2403 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_BLOB
;
2409 if (retcode
!= SQL_NO_DATA_FOUND
)
2410 { // Error occured, abort
2411 DispAllErrors(henv
, hdbc
, hstmt
);
2414 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2421 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2423 // Store Primary and Foriegn Keys
2424 GetKeyFields(tableName
,colInf
,noCols
);
2430 } // wxDb::GetColumns()
2433 #else // New GetColumns
2438 These are tentative new GetColumns members which should be more database
2439 independant and which always returns the columns in the order they were
2442 - The first one (wxDbColInf *wxDb::GetColumns(wxChar *tableName[], const
2443 wxChar* userID)) calls the second implementation for each separate table
2444 before merging the results. This makes the code easier to maintain as
2445 only one member (the second) makes the real work
2446 - wxDbColInf *wxDb::GetColumns(const wxString &tableName, int *numCols, const
2447 wxChar *userID) is a little bit improved
2448 - It doesn't anymore rely on the type-name to find out which database-type
2450 - It ends by sorting the columns, so that they are returned in the same
2451 order they were created
2461 wxDbColInf
*wxDb::GetColumns(wxChar
*tableName
[], const wxChar
*userID
)
2464 // The last array element of the tableName[] argument must be zero (null).
2465 // This is how the end of the array is detected.
2469 // How many tables ?
2471 for (tbl
= 0 ; tableName
[tbl
]; tbl
++);
2473 // Create a table to maintain the columns for each separate table
2474 _TableColumns
*TableColumns
= new _TableColumns
[tbl
];
2477 for (i
= 0 ; i
< tbl
; i
++)
2480 TableColumns
[i
].colInf
= GetColumns(tableName
[i
], &TableColumns
[i
].noCols
, userID
);
2481 if (TableColumns
[i
].colInf
== NULL
)
2483 noCols
+= TableColumns
[i
].noCols
;
2486 // Now merge all the separate table infos
2487 wxDbColInf
*colInf
= new wxDbColInf
[noCols
+1];
2489 // Mark the end of the array
2490 wxStrcpy(colInf
[noCols
].tableName
, wxEmptyString
);
2491 wxStrcpy(colInf
[noCols
].colName
, wxEmptyString
);
2492 colInf
[noCols
].sqlDataType
= 0;
2497 for (i
= 0 ; i
< tbl
; i
++)
2499 for (j
= 0 ; j
< TableColumns
[i
].noCols
; j
++)
2501 colInf
[offset
++] = TableColumns
[i
].colInf
[j
];
2505 delete [] TableColumns
;
2508 } // wxDb::GetColumns() -- NEW
2511 wxDbColInf
*wxDb::GetColumns(const wxString
&tableName
, int *numCols
, const wxChar
*userID
)
2513 // Same as the above GetColumns() function except this one gets columns
2514 // only for a single table, and if 'numCols' is not NULL, the number of
2515 // columns stored in the returned wxDbColInf is set in '*numCols'
2517 // userID is evaluated in the following manner:
2518 // userID == NULL ... UserID is ignored
2519 // userID == "" ... UserID set equal to 'this->uid'
2520 // userID != "" ... UserID set equal to 'userID'
2522 // NOTE: ALL column bindings associated with this wxDb instance are unbound
2523 // by this function. This function should use its own wxDb instance
2524 // to avoid undesired unbinding of columns.
2528 wxDbColInf
*colInf
= 0;
2536 convertUserID(userID
,UserID
);
2538 // Pass 1 - Determine how many columns there are.
2539 // Pass 2 - Allocate the wxDbColInf array and fill in
2540 // the array with the column information.
2542 for (pass
= 1; pass
<= 2; pass
++)
2546 if (noCols
== 0) // Probably a bogus table name(s)
2548 // Allocate n wxDbColInf objects to hold the column information
2549 colInf
= new wxDbColInf
[noCols
+1];
2552 // Mark the end of the array
2553 wxStrcpy(colInf
[noCols
].tableName
, wxEmptyString
);
2554 wxStrcpy(colInf
[noCols
].colName
, wxEmptyString
);
2555 colInf
[noCols
].sqlDataType
= 0;
2558 TableName
= tableName
;
2559 // Oracle and Interbase table names are uppercase only, so force
2560 // the name to uppercase just in case programmer forgot to do this
2561 if ((Dbms() == dbmsORACLE
) ||
2562 (Dbms() == dbmsINTERBASE
))
2563 TableName
= TableName
.Upper();
2565 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2567 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2568 // use the call below that leaves out the user name
2569 if (!UserID
.IsEmpty() &&
2570 Dbms() != dbmsMY_SQL
&&
2571 Dbms() != dbmsACCESS
&&
2572 Dbms() != dbmsMS_SQL_SERVER
)
2574 retcode
= SQLColumns(hstmt
,
2575 NULL
, 0, // All qualifiers
2576 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2577 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2578 NULL
, 0); // All columns
2582 retcode
= SQLColumns(hstmt
,
2583 NULL
, 0, // All qualifiers
2585 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2586 NULL
, 0); // All columns
2588 if (retcode
!= SQL_SUCCESS
)
2589 { // Error occured, abort
2590 DispAllErrors(henv
, hdbc
, hstmt
);
2593 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2599 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2601 if (pass
== 1) // First pass, just add up the number of columns
2603 else // Pass 2; Fill in the array of structures
2605 if (colNo
< noCols
) // Some extra error checking to prevent memory overwrites
2607 // NOTE: Only the ODBC 1.x fields are retrieved
2608 GetData( 1, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].catalog
, 128+1, &cb
);
2609 GetData( 2, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].schema
, 128+1, &cb
);
2610 GetData( 3, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2611 GetData( 4, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].colName
, DB_MAX_COLUMN_NAME_LEN
+1, &cb
);
2612 GetData( 5, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].sqlDataType
, 0, &cb
);
2613 GetData( 6, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].typeName
, 128+1, &cb
);
2614 GetData( 7, SQL_C_SLONG
, (UCHAR
*) &colInf
[colNo
].columnSize
, 0, &cb
);
2615 GetData( 8, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].bufferLength
, 0, &cb
);
2616 GetData( 9, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].decimalDigits
,0, &cb
);
2617 GetData(10, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].numPrecRadix
, 0, &cb
);
2618 GetData(11, SQL_C_SSHORT
, (UCHAR
*) &colInf
[colNo
].nullable
, 0, &cb
);
2619 GetData(12, SQL_C_CHAR
, (UCHAR
*) colInf
[colNo
].remarks
, 254+1, &cb
);
2620 // Start Values for Primary/Foriegn Key (=No)
2621 colInf
[colNo
].PkCol
= 0; // Primary key column 0=No; 1= First Key, 2 = Second Key etc.
2622 colInf
[colNo
].PkTableName
[0] = 0; // Tablenames where Primary Key is used as a Foreign Key
2623 colInf
[colNo
].FkCol
= 0; // Foreign key column 0=No; 1= First Key, 2 = Second Key etc.
2624 colInf
[colNo
].FkTableName
[0] = 0; // Foreign key table name
2627 // IODBC does not return a correct columnSize, so we set
2628 // columnSize = bufferLength if no column size was returned
2629 // IODBC returns the columnSize in bufferLength.. (bug)
2630 if (colInf
[colNo
].columnSize
< 1)
2632 colInf
[colNo
].columnSize
= colInf
[colNo
].bufferLength
;
2636 // Determine the wxDb data type that is used to represent the native data type of this data source
2637 colInf
[colNo
].dbDataType
= 0;
2638 // Get the intern datatype
2639 switch (colInf
[colNo
].sqlDataType
)
2643 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_VARCHAR
;
2649 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_INTEGER
;
2656 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_FLOAT
;
2659 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_DATE
;
2662 colInf
[colNo
].dbDataType
= DB_DATA_TYPE_BLOB
;
2667 errMsg
.Printf(wxT("SQL Data type %d currently not supported by wxWindows"), colInf
[colNo
].sqlDataType
);
2668 wxLogDebug(errMsg
,wxT("ODBC DEBUG MESSAGE"));
2675 if (retcode
!= SQL_NO_DATA_FOUND
)
2676 { // Error occured, abort
2677 DispAllErrors(henv
, hdbc
, hstmt
);
2680 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2687 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2689 // Store Primary and Foreign Keys
2690 GetKeyFields(tableName
,colInf
,noCols
);
2692 ///////////////////////////////////////////////////////////////////////////
2693 // Now sort the the columns in order to make them appear in the right order
2694 ///////////////////////////////////////////////////////////////////////////
2696 // Build a generic SELECT statement which returns 0 rows
2699 Stmt
.Printf(wxT("select * from \"%s\" where 0=1"), tableName
);
2702 if (SQLExecDirect(hstmt
, (UCHAR FAR
*) Stmt
.c_str(), SQL_NTS
) != SQL_SUCCESS
)
2704 DispAllErrors(henv
, hdbc
, hstmt
);
2708 // Get the number of result columns
2709 if (SQLNumResultCols (hstmt
, &noCols
) != SQL_SUCCESS
)
2711 DispAllErrors(henv
, hdbc
, hstmt
);
2715 if (noCols
== 0) // Probably a bogus table name
2724 for (colNum
= 0; colNum
< noCols
; colNum
++)
2726 if (SQLColAttributes(hstmt
,colNum
+1, SQL_COLUMN_NAME
,
2728 &Sword
, &Sdword
) != SQL_SUCCESS
)
2730 DispAllErrors(henv
, hdbc
, hstmt
);
2734 wxString Name1
= name
;
2735 Name1
= Name1
.Upper();
2737 // Where is this name in the array ?
2738 for (i
= colNum
; i
< noCols
; i
++)
2740 wxString Name2
= colInf
[i
].colName
;
2741 Name2
= Name2
.Upper();
2744 if (colNum
!= i
) // swap to sort
2746 wxDbColInf tmpColInf
= colInf
[colNum
];
2747 colInf
[colNum
] = colInf
[i
];
2748 colInf
[i
] = tmpColInf
;
2754 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2756 ///////////////////////////////////////////////////////////////////////////
2758 ///////////////////////////////////////////////////////////////////////////
2764 } // wxDb::GetColumns()
2767 #endif // #else OLD_GETCOLUMNS
2770 /********** wxDb::GetColumnCount() **********/
2771 int wxDb::GetColumnCount(const wxString
&tableName
, const wxChar
*userID
)
2773 * Returns a count of how many columns are in a table.
2774 * If an error occurs in computing the number of columns
2775 * this function will return a -1 for the count
2777 * userID is evaluated in the following manner:
2778 * userID == NULL ... UserID is ignored
2779 * userID == "" ... UserID set equal to 'this->uid'
2780 * userID != "" ... UserID set equal to 'userID'
2782 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2783 * by this function. This function should use its own wxDb instance
2784 * to avoid undesired unbinding of columns.
2794 convertUserID(userID
,UserID
);
2796 TableName
= tableName
;
2797 // Oracle and Interbase table names are uppercase only, so force
2798 // the name to uppercase just in case programmer forgot to do this
2799 if ((Dbms() == dbmsORACLE
) ||
2800 (Dbms() == dbmsINTERBASE
))
2801 TableName
= TableName
.Upper();
2803 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2805 // MySQL, SQLServer, and Access cannot accept a user name when looking up column names, so we
2806 // use the call below that leaves out the user name
2807 if (!UserID
.IsEmpty() &&
2808 Dbms() != dbmsMY_SQL
&&
2809 Dbms() != dbmsACCESS
&&
2810 Dbms() != dbmsMS_SQL_SERVER
)
2812 retcode
= SQLColumns(hstmt
,
2813 NULL
, 0, // All qualifiers
2814 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Owner
2815 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2816 NULL
, 0); // All columns
2820 retcode
= SQLColumns(hstmt
,
2821 NULL
, 0, // All qualifiers
2823 (UCHAR
*) TableName
.c_str(), SQL_NTS
,
2824 NULL
, 0); // All columns
2826 if (retcode
!= SQL_SUCCESS
)
2827 { // Error occured, abort
2828 DispAllErrors(henv
, hdbc
, hstmt
);
2829 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2833 // Count the columns
2834 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
)
2837 if (retcode
!= SQL_NO_DATA_FOUND
)
2838 { // Error occured, abort
2839 DispAllErrors(henv
, hdbc
, hstmt
);
2840 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2844 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2847 } // wxDb::GetColumnCount()
2850 /********** wxDb::GetCatalog() *******/
2851 wxDbInf
*wxDb::GetCatalog(const wxChar
*userID
)
2853 * ---------------------------------------------------------------------
2854 * -- 19991203 : mj10777 : Create ------
2855 * -- : Creates a wxDbInf with Tables / Cols Array ------
2856 * -- : uses SQLTables and fills pTableInf; ------
2857 * -- : pColInf is set to NULL and numCols to 0; ------
2858 * -- : returns pDbInf (wxDbInf) ------
2859 * -- - if unsuccesfull (pDbInf == NULL) ------
2860 * -- : pColInf can be filled with GetColumns(..); ------
2861 * -- : numCols can be filled with GetColumnCount(..); ------
2862 * ---------------------------------------------------------------------
2864 * userID is evaluated in the following manner:
2865 * userID == NULL ... UserID is ignored
2866 * userID == "" ... UserID set equal to 'this->uid'
2867 * userID != "" ... UserID set equal to 'userID'
2869 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2870 * by this function. This function should use its own wxDb instance
2871 * to avoid undesired unbinding of columns.
2874 wxDbInf
*pDbInf
= NULL
; // Array of catalog entries
2875 int noTab
= 0; // Counter while filling table entries
2879 wxString tblNameSave
;
2882 convertUserID(userID
,UserID
);
2884 //-------------------------------------------------------------
2885 pDbInf
= new wxDbInf
; // Create the Database Array
2886 //-------------------------------------------------------------
2887 // Table Information
2888 // Pass 1 - Determine how many Tables there are.
2889 // Pass 2 - Create the Table array and fill it
2890 // - Create the Cols array = NULL
2891 //-------------------------------------------------------------
2893 for (pass
= 1; pass
<= 2; pass
++)
2895 SQLFreeStmt(hstmt
, SQL_CLOSE
); // Close if Open
2896 tblNameSave
.Empty();
2898 if (!UserID
.IsEmpty() &&
2899 Dbms() != dbmsMY_SQL
&&
2900 Dbms() != dbmsACCESS
&&
2901 Dbms() != dbmsMS_SQL_SERVER
)
2903 retcode
= SQLTables(hstmt
,
2904 NULL
, 0, // All qualifiers
2905 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // User specified
2906 NULL
, 0, // All tables
2907 NULL
, 0); // All columns
2911 retcode
= SQLTables(hstmt
,
2912 NULL
, 0, // All qualifiers
2913 NULL
, 0, // User specified
2914 NULL
, 0, // All tables
2915 NULL
, 0); // All columns
2918 if (retcode
!= SQL_SUCCESS
)
2920 DispAllErrors(henv
, hdbc
, hstmt
);
2922 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2926 while ((retcode
= SQLFetch(hstmt
)) == SQL_SUCCESS
) // Table Information
2928 if (pass
== 1) // First pass, just count the Tables
2930 if (pDbInf
->numTables
== 0)
2932 GetData( 1, SQL_C_CHAR
, (UCHAR
*) pDbInf
->catalog
, 128+1, &cb
);
2933 GetData( 2, SQL_C_CHAR
, (UCHAR
*) pDbInf
->schema
, 128+1, &cb
);
2935 pDbInf
->numTables
++; // Counter for Tables
2937 if (pass
== 2) // Create and fill the Table entries
2939 if (pDbInf
->pTableInf
== NULL
) // Has the Table Array been created
2940 { // no, then create the Array
2941 pDbInf
->pTableInf
= new wxDbTableInf
[pDbInf
->numTables
];
2943 } // if (pDbInf->pTableInf == NULL) // Has the Table Array been created
2945 GetData( 3, SQL_C_CHAR
, (UCHAR
*) (pDbInf
->pTableInf
+noTab
)->tableName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
2946 GetData( 4, SQL_C_CHAR
, (UCHAR
*) (pDbInf
->pTableInf
+noTab
)->tableType
, 30+1, &cb
);
2947 GetData( 5, SQL_C_CHAR
, (UCHAR
*) (pDbInf
->pTableInf
+noTab
)->tableRemarks
, 254+1, &cb
);
2953 SQLFreeStmt(hstmt
, SQL_CLOSE
);
2955 // Query how many columns are in each table
2956 for (noTab
=0;noTab
<pDbInf
->numTables
;noTab
++)
2958 (pDbInf
->pTableInf
+noTab
)->numCols
= GetColumnCount((pDbInf
->pTableInf
+noTab
)->tableName
,UserID
);
2963 } // wxDb::GetCatalog()
2966 /********** wxDb::Catalog() **********/
2967 bool wxDb::Catalog(const wxChar
*userID
, const wxString
&fileName
)
2969 * Creates the text file specified in 'filename' which will contain
2970 * a minimal data dictionary of all tables accessible by the user specified
2973 * userID is evaluated in the following manner:
2974 * userID == NULL ... UserID is ignored
2975 * userID == "" ... UserID set equal to 'this->uid'
2976 * userID != "" ... UserID set equal to 'userID'
2978 * NOTE: ALL column bindings associated with this wxDb instance are unbound
2979 * by this function. This function should use its own wxDb instance
2980 * to avoid undesired unbinding of columns.
2983 wxASSERT(fileName
.Length());
2987 wxChar tblName
[DB_MAX_TABLE_NAME_LEN
+1];
2988 wxString tblNameSave
;
2989 wxChar colName
[DB_MAX_COLUMN_NAME_LEN
+1];
2991 wxChar typeName
[30+1];
2992 SDWORD precision
, length
;
2994 FILE *fp
= fopen(fileName
.c_str(),wxT("wt"));
2998 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3001 convertUserID(userID
,UserID
);
3003 if (!UserID
.IsEmpty() &&
3004 Dbms() != dbmsMY_SQL
&&
3005 Dbms() != dbmsACCESS
&&
3006 Dbms() != dbmsINTERBASE
&&
3007 Dbms() != dbmsMS_SQL_SERVER
)
3009 retcode
= SQLColumns(hstmt
,
3010 NULL
, 0, // All qualifiers
3011 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // User specified
3012 NULL
, 0, // All tables
3013 NULL
, 0); // All columns
3017 retcode
= SQLColumns(hstmt
,
3018 NULL
, 0, // All qualifiers
3019 NULL
, 0, // User specified
3020 NULL
, 0, // All tables
3021 NULL
, 0); // All columns
3023 if (retcode
!= SQL_SUCCESS
)
3025 DispAllErrors(henv
, hdbc
, hstmt
);
3031 tblNameSave
.Empty();
3036 retcode
= SQLFetch(hstmt
);
3037 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
3040 if (wxStrcmp(tblName
, tblNameSave
.c_str()))
3043 fputs(wxT("\n"), fp
);
3044 fputs(wxT("================================ "), fp
);
3045 fputs(wxT("================================ "), fp
);
3046 fputs(wxT("===================== "), fp
);
3047 fputs(wxT("========= "), fp
);
3048 fputs(wxT("=========\n"), fp
);
3049 outStr
.Printf(wxT("%-32s %-32s %-21s %9s %9s\n"),
3050 wxT("TABLE NAME"), wxT("COLUMN NAME"), wxT("DATA TYPE"), wxT("PRECISION"), wxT("LENGTH"));
3051 fputs(outStr
.c_str(), fp
);
3052 fputs(wxT("================================ "), fp
);
3053 fputs(wxT("================================ "), fp
);
3054 fputs(wxT("===================== "), fp
);
3055 fputs(wxT("========= "), fp
);
3056 fputs(wxT("=========\n"), fp
);
3057 tblNameSave
= tblName
;
3060 GetData(3,SQL_C_CHAR
, (UCHAR
*) tblName
, DB_MAX_TABLE_NAME_LEN
+1, &cb
);
3061 GetData(4,SQL_C_CHAR
, (UCHAR
*) colName
, DB_MAX_COLUMN_NAME_LEN
+1,&cb
);
3062 GetData(5,SQL_C_SSHORT
,(UCHAR
*)&sqlDataType
, 0, &cb
);
3063 GetData(6,SQL_C_CHAR
, (UCHAR
*) typeName
, sizeof(typeName
), &cb
);
3064 GetData(7,SQL_C_SLONG
, (UCHAR
*)&precision
, 0, &cb
);
3065 GetData(8,SQL_C_SLONG
, (UCHAR
*)&length
, 0, &cb
);
3067 outStr
.Printf(wxT("%-32s %-32s (%04d)%-15s %9ld %9ld\n"),
3068 tblName
, colName
, sqlDataType
, typeName
, precision
, length
);
3069 if (fputs(outStr
.c_str(), fp
) == EOF
)
3071 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3078 if (retcode
!= SQL_NO_DATA_FOUND
)
3079 DispAllErrors(henv
, hdbc
, hstmt
);
3081 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3084 return(retcode
== SQL_NO_DATA_FOUND
);
3086 } // wxDb::Catalog()
3089 bool wxDb::TableExists(const wxString
&tableName
, const wxChar
*userID
, const wxString
&tablePath
)
3091 * Table name can refer to a table, view, alias or synonym. Returns TRUE
3092 * if the object exists in the database. This function does not indicate
3093 * whether or not the user has privleges to query or perform other functions
3096 * userID is evaluated in the following manner:
3097 * userID == NULL ... UserID is ignored
3098 * userID == "" ... UserID set equal to 'this->uid'
3099 * userID != "" ... UserID set equal to 'userID'
3102 wxASSERT(tableName
.Length());
3106 if (Dbms() == dbmsDBASE
)
3109 if (tablePath
.Length())
3110 dbName
.Printf(wxT("%s/%s.dbf"), tablePath
.c_str(), tableName
.c_str());
3112 dbName
.Printf(wxT("%s.dbf"), tableName
.c_str());
3115 exists
= wxFileExists(dbName
);
3120 convertUserID(userID
,UserID
);
3122 TableName
= tableName
;
3123 // Oracle and Interbase table names are uppercase only, so force
3124 // the name to uppercase just in case programmer forgot to do this
3125 if ((Dbms() == dbmsORACLE
) ||
3126 (Dbms() == dbmsINTERBASE
))
3127 TableName
= TableName
.Upper();
3129 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3132 // Some databases cannot accept a user name when looking up table names,
3133 // so we use the call below that leaves out the user name
3134 if (!UserID
.IsEmpty() &&
3135 Dbms() != dbmsMY_SQL
&&
3136 Dbms() != dbmsACCESS
&&
3137 Dbms() != dbmsMS_SQL_SERVER
&&
3138 Dbms() != dbmsDB2
&&
3139 Dbms() != dbmsINTERBASE
&&
3140 Dbms() != dbmsPERVASIVE_SQL
)
3142 retcode
= SQLTables(hstmt
,
3143 NULL
, 0, // All qualifiers
3144 (UCHAR
*) UserID
.c_str(), SQL_NTS
, // Only tables owned by this user
3145 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
,
3146 NULL
, 0); // All table types
3150 retcode
= SQLTables(hstmt
,
3151 NULL
, 0, // All qualifiers
3152 NULL
, 0, // All owners
3153 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
,
3154 NULL
, 0); // All table types
3156 if (retcode
!= SQL_SUCCESS
)
3157 return(DispAllErrors(henv
, hdbc
, hstmt
));
3159 retcode
= SQLFetch(hstmt
);
3160 if (retcode
!= SQL_SUCCESS
&& retcode
!= SQL_SUCCESS_WITH_INFO
)
3162 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3163 return(DispAllErrors(henv
, hdbc
, hstmt
));
3166 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3170 } // wxDb::TableExists()
3173 /********** wxDb::TablePrivileges() **********/
3174 bool wxDb::TablePrivileges(const wxString
&tableName
, const wxString
&priv
, const wxChar
*userID
,
3175 const wxChar
*schema
, const wxString
&tablePath
)
3177 wxASSERT(tableName
.Length());
3179 wxDbTablePrivilegeInfo result
;
3183 // We probably need to be able to dynamically set this based on
3184 // the driver type, and state.
3185 wxChar curRole
[]=wxT("public");
3189 wxString UserID
,Schema
;
3190 convertUserID(userID
,UserID
);
3191 convertUserID(schema
,Schema
);
3193 TableName
= tableName
;
3194 // Oracle and Interbase table names are uppercase only, so force
3195 // the name to uppercase just in case programmer forgot to do this
3196 if ((Dbms() == dbmsORACLE
) ||
3197 (Dbms() == dbmsINTERBASE
))
3198 TableName
= TableName
.Upper();
3200 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3202 // Some databases cannot accept a user name when looking up table names,
3203 // so we use the call below that leaves out the user name
3204 if (!Schema
.IsEmpty() &&
3205 Dbms() != dbmsMY_SQL
&&
3206 Dbms() != dbmsACCESS
&&
3207 Dbms() != dbmsMS_SQL_SERVER
)
3209 retcode
= SQLTablePrivileges(hstmt
,
3211 (UCHAR FAR
*)Schema
.c_str(), SQL_NTS
, // Schema
3212 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
);
3216 retcode
= SQLTablePrivileges(hstmt
,
3219 (UCHAR FAR
*)TableName
.c_str(), SQL_NTS
);
3222 #ifdef DBDEBUG_CONSOLE
3223 fprintf(stderr
,wxT("SQLTablePrivileges() returned %i \n"),retcode
);
3226 if ((retcode
!= SQL_SUCCESS
) && (retcode
!= SQL_SUCCESS_WITH_INFO
))
3227 return(DispAllErrors(henv
, hdbc
, hstmt
));
3229 bool failed
= FALSE
;
3230 retcode
= SQLFetch(hstmt
);
3231 while (retcode
== SQL_SUCCESS
|| retcode
== SQL_SUCCESS_WITH_INFO
)
3233 if (SQLGetData(hstmt
, 1, SQL_C_CHAR
, (UCHAR
*) result
.tableQual
, sizeof(result
.tableQual
), &cbRetVal
) != SQL_SUCCESS
)
3236 if (!failed
&& SQLGetData(hstmt
, 2, SQL_C_CHAR
, (UCHAR
*) result
.tableOwner
, sizeof(result
.tableOwner
), &cbRetVal
) != SQL_SUCCESS
)
3239 if (!failed
&& SQLGetData(hstmt
, 3, SQL_C_CHAR
, (UCHAR
*) result
.tableName
, sizeof(result
.tableName
), &cbRetVal
) != SQL_SUCCESS
)
3242 if (!failed
&& SQLGetData(hstmt
, 4, SQL_C_CHAR
, (UCHAR
*) result
.grantor
, sizeof(result
.grantor
), &cbRetVal
) != SQL_SUCCESS
)
3245 if (!failed
&& SQLGetData(hstmt
, 5, SQL_C_CHAR
, (UCHAR
*) result
.grantee
, sizeof(result
.grantee
), &cbRetVal
) != SQL_SUCCESS
)
3248 if (!failed
&& SQLGetData(hstmt
, 6, SQL_C_CHAR
, (UCHAR
*) result
.privilege
, sizeof(result
.privilege
), &cbRetVal
) != SQL_SUCCESS
)
3251 if (!failed
&& SQLGetData(hstmt
, 7, SQL_C_CHAR
, (UCHAR
*) result
.grantable
, sizeof(result
.grantable
), &cbRetVal
) != SQL_SUCCESS
)
3256 return(DispAllErrors(henv
, hdbc
, hstmt
));
3258 #ifdef DBDEBUG_CONSOLE
3259 fprintf(stderr
,wxT("Scanning %s privilege on table %s.%s granted by %s to %s\n"),
3260 result
.privilege
,result
.tableOwner
,result
.tableName
,
3261 result
.grantor
, result
.grantee
);
3264 if (UserID
.IsSameAs(result
.tableOwner
,FALSE
))
3266 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3270 if (UserID
.IsSameAs(result
.grantee
,FALSE
) &&
3271 !wxStrcmp(result
.privilege
,priv
))
3273 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3277 if (!wxStrcmp(result
.grantee
,curRole
) &&
3278 !wxStrcmp(result
.privilege
,priv
))
3280 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3284 retcode
= SQLFetch(hstmt
);
3287 SQLFreeStmt(hstmt
, SQL_CLOSE
);
3290 } // wxDb::TablePrivileges
3293 const wxString
wxDb::SQLTableName(const wxChar
*tableName
)
3297 if (Dbms() == dbmsACCESS
)
3299 TableName
+= tableName
;
3300 if (Dbms() == dbmsACCESS
)
3304 } // wxDb::SQLTableName()
3307 const wxString
wxDb::SQLColumnName(const wxChar
*colName
)
3311 if (Dbms() == dbmsACCESS
)
3314 if (Dbms() == dbmsACCESS
)
3318 } // wxDb::SQLColumnName()
3321 /********** wxDb::SetSqlLogging() **********/
3322 bool wxDb::SetSqlLogging(wxDbSqlLogState state
, const wxString
&filename
, bool append
)
3324 wxASSERT(state
== sqlLogON
|| state
== sqlLogOFF
);
3325 wxASSERT(state
== sqlLogOFF
|| filename
.Length());
3327 if (state
== sqlLogON
)
3331 fpSqlLog
= fopen(filename
, (append
? wxT("at") : wxT("wt")));
3332 if (fpSqlLog
== NULL
)
3340 if (fclose(fpSqlLog
))
3346 sqlLogState
= state
;
3349 } // wxDb::SetSqlLogging()
3352 /********** wxDb::WriteSqlLog() **********/
3353 bool wxDb::WriteSqlLog(const wxString
&logMsg
)
3355 wxASSERT(logMsg
.Length());
3357 if (fpSqlLog
== 0 || sqlLogState
== sqlLogOFF
)
3360 if (fputs(wxT("\n"), fpSqlLog
) == EOF
)
3362 if (fputs(logMsg
, fpSqlLog
) == EOF
)
3364 if (fputs(wxT("\n"), fpSqlLog
) == EOF
)
3369 } // wxDb::WriteSqlLog()
3372 /********** wxDb::Dbms() **********/
3373 wxDBMS
wxDb::Dbms(void)
3375 * Be aware that not all database engines use the exact same syntax, and not
3376 * every ODBC compliant database is compliant to the same level of compliancy.
3377 * Some manufacturers support the minimum Level 1 compliancy, and others up
3378 * through Level 3. Others support subsets of features for levels above 1.
3380 * If you find an inconsistency between the wxDb class and a specific database
3381 * engine, and an identifier to this section, and special handle the database in
3382 * the area where behavior is non-conforming with the other databases.
3385 * NOTES ABOUT ISSUES SPECIFIC TO EACH DATABASE ENGINE
3386 * ---------------------------------------------------
3389 * - Currently the only database supported by the class to support VIEWS
3392 * - Does not support the SQL_TIMESTAMP structure
3393 * - Supports only one cursor and one connect (apparently? with Microsoft driver only?)
3394 * - Does not automatically create the primary index if the 'keyField' param of SetColDef
3395 * is TRUE. The user must create ALL indexes from their program.
3396 * - Table names can only be 8 characters long
3397 * - Column names can only be 10 characters long
3400 * - To lock a record during QUERY functions, the reserved word 'HOLDLOCK' must be added
3401 * after every table name involved in the query/join if that tables matching record(s)
3403 * - Ignores the keywords 'FOR UPDATE'. Use the HOLDLOCK functionality described above
3405 * SYBASE (Enterprise)
3406 * - If a column is part of the Primary Key, the column cannot be NULL
3407 * - Maximum row size is somewhere in the neighborhood of 1920 bytes
3410 * - If a column is part of the Primary Key, the column cannot be NULL
3411 * - Cannot support selecting for update [::CanSelectForUpdate()]. Always returns FALSE
3412 * - Columns that are part of primary or secondary keys must be defined as being NOT NULL
3413 * when they are created. Some code is added in ::CreateIndex to try to adjust the
3414 * column definition if it is not defined correctly, but it is experimental
3415 * - Does not support sub-queries in SQL statements
3418 * - Does not support the keywords 'ASC' or 'DESC' as of release v6.5.0
3419 * - Does not support sub-queries in SQL statements
3422 * - Primary keys must be declared as NOT NULL
3423 * - Table and index names must not be longer than 13 characters in length (technically
3424 * table names can be up to 18 characters, but the primary index is created using the
3425 * base table name plus "_PIDX", so the limit if the table has a primary index is 13.
3430 * - Columns that are part of primary keys must be defined as being NOT NULL
3431 * when they are created. Some code is added in ::CreateIndex to try to adjust the
3432 * column definition if it is not defined correctly, but it is experimental
3435 // Should only need to do this once for each new database connection
3436 // so return the value we already determined it to be to save time
3437 // and lots of string comparisons
3438 if (dbmsType
!= dbmsUNIDENTIFIED
)
3441 wxChar baseName
[25+1];
3442 wxStrncpy(baseName
,dbInf
.dbmsName
,25);
3445 // RGG 20001025 : add support for Interbase
3446 // GT : Integrated to base classes on 20001121
3447 if (!wxStricmp(dbInf
.dbmsName
,wxT("Interbase")))
3448 return((wxDBMS
)(dbmsType
= dbmsINTERBASE
));
3450 // BJO 20000428 : add support for Virtuoso
3451 if (!wxStricmp(dbInf
.dbmsName
,wxT("OpenLink Virtuoso VDBMS")))
3452 return((wxDBMS
)(dbmsType
= dbmsVIRTUOSO
));
3454 if (!wxStricmp(dbInf
.dbmsName
,wxT("Adaptive Server Anywhere")))
3455 return((wxDBMS
)(dbmsType
= dbmsSYBASE_ASA
));
3457 // BJO 20000427 : The "SQL Server" string is also returned by SQLServer when
3458 // connected through an OpenLink driver.
3459 // Is it also returned by Sybase Adapatitve server?
3460 // OpenLink driver name is OLOD3032.DLL for msw and oplodbc.so for unix
3461 if (!wxStricmp(dbInf
.dbmsName
,wxT("SQL Server")))
3463 if (!wxStrncmp(dbInf
.driverName
, wxT("oplodbc"), 7) ||
3464 !wxStrncmp(dbInf
.driverName
, wxT("OLOD"), 4))
3465 return ((wxDBMS
)(dbmsMS_SQL_SERVER
));
3467 return ((wxDBMS
)(dbmsType
= dbmsSYBASE_ASE
));
3470 if (!wxStricmp(dbInf
.dbmsName
,wxT("Microsoft SQL Server")))
3471 return((wxDBMS
)(dbmsType
= dbmsMS_SQL_SERVER
));
3472 if (!wxStricmp(dbInf
.dbmsName
,wxT("MySQL")))
3473 return((wxDBMS
)(dbmsType
= dbmsMY_SQL
));
3474 if (!wxStricmp(dbInf
.dbmsName
,wxT("PostgreSQL"))) // v6.5.0
3475 return((wxDBMS
)(dbmsType
= dbmsPOSTGRES
));
3478 if (!wxStricmp(dbInf
.dbmsName
,wxT("Pervasive")))
3479 return((wxDBMS
)(dbmsType
= dbmsPERVASIVE_SQL
));
3482 if (!wxStricmp(baseName
,wxT("Informix")))
3483 return((wxDBMS
)(dbmsType
= dbmsINFORMIX
));
3486 if (!wxStricmp(baseName
,wxT("Oracle")))
3487 return((wxDBMS
)(dbmsType
= dbmsORACLE
));
3488 if (!wxStricmp(dbInf
.dbmsName
,wxT("ACCESS")))
3489 return((wxDBMS
)(dbmsType
= dbmsACCESS
));
3490 if (!wxStricmp(dbInf
.dbmsName
,wxT("MySQL")))
3491 return((wxDBMS
)(dbmsType
= dbmsMY_SQL
));
3492 if (!wxStricmp(baseName
,wxT("Sybase")))
3493 return((wxDBMS
)(dbmsType
= dbmsSYBASE_ASE
));
3496 if (!wxStricmp(baseName
,wxT("DBASE")))
3497 return((wxDBMS
)(dbmsType
= dbmsDBASE
));
3499 if (!wxStricmp(baseName
,wxT("xBase")))
3500 return((wxDBMS
)(dbmsType
= dbmsXBASE_SEQUITER
));
3502 if (!wxStricmp(baseName
,wxT("MySQL")))
3503 return((wxDBMS
)(dbmsType
= dbmsMY_SQL
));
3506 if (!wxStricmp(baseName
,wxT("DB2")))
3507 return((wxDBMS
)(dbmsType
= dbmsDBASE
));
3509 return((wxDBMS
)(dbmsType
= dbmsUNIDENTIFIED
));
3514 bool wxDb::ModifyColumn(const wxString
&tableName
, const wxString
&columnName
,
3515 int dataType
, ULONG columnLength
,
3516 const wxString
&optionalParam
)
3518 wxASSERT(tableName
.Length());
3519 wxASSERT(columnName
.Length());
3520 wxASSERT((dataType
== DB_DATA_TYPE_VARCHAR
&& columnLength
> 0) ||
3521 dataType
!= DB_DATA_TYPE_VARCHAR
);
3523 // Must specify a columnLength if modifying a VARCHAR type column
3524 if (dataType
== DB_DATA_TYPE_VARCHAR
&& !columnLength
)
3527 wxString dataTypeName
;
3529 wxString alterSlashModify
;
3533 case DB_DATA_TYPE_VARCHAR
:
3534 dataTypeName
= typeInfVarchar
.TypeName
;
3536 case DB_DATA_TYPE_INTEGER
:
3537 dataTypeName
= typeInfInteger
.TypeName
;
3539 case DB_DATA_TYPE_FLOAT
:
3540 dataTypeName
= typeInfFloat
.TypeName
;
3542 case DB_DATA_TYPE_DATE
:
3543 dataTypeName
= typeInfDate
.TypeName
;
3545 case DB_DATA_TYPE_BLOB
:
3546 dataTypeName
= typeInfBlob
.TypeName
;
3552 // Set the modify or alter syntax depending on the type of database connected to
3556 alterSlashModify
= "MODIFY";
3558 case dbmsMS_SQL_SERVER
:
3559 alterSlashModify
= "ALTER COLUMN";
3561 case dbmsUNIDENTIFIED
:
3563 case dbmsSYBASE_ASA
:
3564 case dbmsSYBASE_ASE
:
3569 case dbmsXBASE_SEQUITER
:
3571 alterSlashModify
= "MODIFY";
3575 // create the SQL statement
3576 if ( Dbms() == dbmsMY_SQL
)
3578 sqlStmt
.Printf(wxT("ALTER TABLE %s %s %s %s"), tableName
.c_str(), alterSlashModify
.c_str(),
3579 columnName
.c_str(), dataTypeName
.c_str());
3583 sqlStmt
.Printf(wxT("ALTER TABLE \"%s\" \"%s\" \"%s\" %s"), tableName
.c_str(), alterSlashModify
.c_str(),
3584 columnName
.c_str(), dataTypeName
.c_str());
3587 // For varchars only, append the size of the column
3588 if (dataType
== DB_DATA_TYPE_VARCHAR
&&
3589 (Dbms() != dbmsMY_SQL
|| dataTypeName
!= "text"))
3592 s
.Printf(wxT("(%lu)"), columnLength
);
3596 // for passing things like "NOT NULL"
3597 if (optionalParam
.Length())
3599 sqlStmt
+= wxT(" ");
3600 sqlStmt
+= optionalParam
;
3603 return ExecSql(sqlStmt
);
3605 } // wxDb::ModifyColumn()
3608 /********** wxDbGetConnection() **********/
3609 wxDb WXDLLEXPORT
*wxDbGetConnection(wxDbConnectInf
*pDbConfig
, bool FwdOnlyCursors
)
3613 // Used to keep a pointer to a DB connection that matches the requested
3614 // DSN and FwdOnlyCursors settings, even if it is not FREE, so that the
3615 // data types can be copied from it (using the wxDb::Open(wxDb *) function)
3616 // rather than having to re-query the datasource to get all the values
3617 // using the wxDb::Open(Dsn,Uid,AuthStr) function
3618 wxDb
*matchingDbConnection
= NULL
;
3620 // Scan the linked list searching for an available database connection
3621 // that's already been opened but is currently not in use.
3622 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3624 // The database connection must be for the same datasource
3625 // name and must currently not be in use.
3627 (pList
->PtrDb
->FwdOnlyCursors() == FwdOnlyCursors
) &&
3628 (!wxStrcmp(pDbConfig
->GetDsn(), pList
->Dsn
))) // Found a free connection
3630 pList
->Free
= FALSE
;
3631 return(pList
->PtrDb
);
3634 if (!wxStrcmp(pDbConfig
->GetDsn(), pList
->Dsn
) &&
3635 !wxStrcmp(pDbConfig
->GetUserID(), pList
->Uid
) &&
3636 !wxStrcmp(pDbConfig
->GetPassword(), pList
->AuthStr
))
3637 matchingDbConnection
= pList
->PtrDb
;
3640 // No available connections. A new connection must be made and
3641 // appended to the end of the linked list.
3644 // Find the end of the list
3645 for (pList
= PtrBegDbList
; pList
->PtrNext
; pList
= pList
->PtrNext
);
3646 // Append a new list item
3647 pList
->PtrNext
= new wxDbList
;
3648 pList
->PtrNext
->PtrPrev
= pList
;
3649 pList
= pList
->PtrNext
;
3653 // Create the first node on the list
3654 pList
= PtrBegDbList
= new wxDbList
;
3658 // Initialize new node in the linked list
3660 pList
->Free
= FALSE
;
3661 pList
->Dsn
= pDbConfig
->GetDsn();
3662 pList
->Uid
= pDbConfig
->GetUserID();
3663 pList
->AuthStr
= pDbConfig
->GetPassword();
3665 pList
->PtrDb
= new wxDb(pDbConfig
->GetHenv(), FwdOnlyCursors
);
3667 bool opened
= FALSE
;
3669 if (!matchingDbConnection
)
3670 opened
= pList
->PtrDb
->Open(pDbConfig
->GetDsn(), pDbConfig
->GetUserID(), pDbConfig
->GetPassword());
3672 opened
= pList
->PtrDb
->Open(matchingDbConnection
);
3674 // Connect to the datasource
3677 pList
->PtrDb
->setCached(TRUE
); // Prevent a user from deleting a cached connection
3678 pList
->PtrDb
->SetSqlLogging(SQLLOGstate
,SQLLOGfn
,TRUE
);
3679 return(pList
->PtrDb
);
3681 else // Unable to connect, destroy list item
3684 pList
->PtrPrev
->PtrNext
= 0;
3686 PtrBegDbList
= 0; // Empty list again
3687 pList
->PtrDb
->CommitTrans(); // Commit any open transactions on wxDb object
3688 pList
->PtrDb
->Close(); // Close the wxDb object
3689 delete pList
->PtrDb
; // Deletes the wxDb object
3690 delete pList
; // Deletes the linked list object
3694 } // wxDbGetConnection()
3697 /********** wxDbFreeConnection() **********/
3698 bool WXDLLEXPORT
wxDbFreeConnection(wxDb
*pDb
)
3702 // Scan the linked list searching for the database connection
3703 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3705 if (pList
->PtrDb
== pDb
) // Found it, now free it!!!
3706 return (pList
->Free
= TRUE
);
3709 // Never found the database object, return failure
3712 } // wxDbFreeConnection()
3715 /********** wxDbCloseConnections() **********/
3716 void WXDLLEXPORT
wxDbCloseConnections(void)
3718 wxDbList
*pList
, *pNext
;
3720 // Traverse the linked list closing database connections and freeing memory as I go.
3721 for (pList
= PtrBegDbList
; pList
; pList
= pNext
)
3723 pNext
= pList
->PtrNext
; // Save the pointer to next
3724 pList
->PtrDb
->CommitTrans(); // Commit any open transactions on wxDb object
3725 pList
->PtrDb
->Close(); // Close the wxDb object
3726 pList
->PtrDb
->setCached(FALSE
); // Allows deletion of the wxDb instance
3727 delete pList
->PtrDb
; // Deletes the wxDb object
3728 delete pList
; // Deletes the linked list object
3731 // Mark the list as empty
3734 } // wxDbCloseConnections()
3737 /********** wxDbConnectionsInUse() **********/
3738 int WXDLLEXPORT
wxDbConnectionsInUse(void)
3743 // Scan the linked list counting db connections that are currently in use
3744 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3746 if (pList
->Free
== FALSE
)
3752 } // wxDbConnectionsInUse()
3756 /********** wxDbLogExtendedErrorMsg() **********/
3757 // DEBUG ONLY function
3758 const wxChar
* WXDLLEXPORT
wxDbLogExtendedErrorMsg(const wxChar
*userText
,
3760 const wxChar
*ErrFile
,
3763 static wxString msg
;
3768 if (ErrFile
|| ErrLine
)
3770 msg
+= wxT("File: ");
3772 msg
+= wxT(" Line: ");
3773 tStr
.Printf(wxT("%d"),ErrLine
);
3774 msg
+= tStr
.c_str();
3778 msg
.Append (wxT("\nODBC errors:\n"));
3781 // Display errors for this connection
3783 for (i
= 0; i
< DB_MAX_ERROR_HISTORY
; i
++)
3785 if (pDb
->errorList
[i
])
3787 msg
.Append(pDb
->errorList
[i
]);
3788 if (wxStrcmp(pDb
->errorList
[i
],wxT("")) != 0)
3789 msg
.Append(wxT("\n"));
3790 // Clear the errmsg buffer so the next error will not
3791 // end up showing the previous error that have occurred
3792 wxStrcpy(pDb
->errorList
[i
],wxT(""));
3797 wxLogDebug(msg
.c_str());
3800 } // wxDbLogExtendedErrorMsg()
3803 /********** wxDbSqlLog() **********/
3804 bool wxDbSqlLog(wxDbSqlLogState state
, const wxChar
*filename
)
3806 bool append
= FALSE
;
3809 for (pList
= PtrBegDbList
; pList
; pList
= pList
->PtrNext
)
3811 if (!pList
->PtrDb
->SetSqlLogging(state
,filename
,append
))
3816 SQLLOGstate
= state
;
3817 SQLLOGfn
= filename
;
3825 /********** wxDbCreateDataSource() **********/
3826 int wxDbCreateDataSource(const wxString
&driverName
, const wxString
&dsn
, const wxString
&description
,
3827 bool sysDSN
, const wxString
&defDir
, wxWindow
*parent
)
3829 * !!!! ONLY FUNCTIONAL UNDER MSW with VC6 !!!!
3830 * Very rudimentary creation of an ODBC data source.
3832 * ODBC driver must be ODBC 3.0 compliant to use this function
3837 //!!!! ONLY FUNCTIONAL UNDER MSW with VC6 !!!!
3843 dsnLocation
= ODBC_ADD_SYS_DSN
;
3845 dsnLocation
= ODBC_ADD_DSN
;
3847 // NOTE: The decimal 2 is an invalid character in all keyword pairs
3848 // so that is why I used it, as wxString does not deal well with
3849 // embedded nulls in strings
3850 setupStr
.Printf(wxT("DSN=%s%cDescription=%s%cDefaultDir=%s%c"),dsn
,2,description
,2,defDir
,2);
3852 // Replace the separator from above with the '\0' seperator needed
3853 // by the SQLConfigDataSource() function
3857 k
= setupStr
.Find((wxChar
)2,TRUE
);
3858 if (k
!= wxNOT_FOUND
)
3859 setupStr
[(UINT
)k
] = wxT('\0');
3861 while (k
!= wxNOT_FOUND
);
3863 result
= SQLConfigDataSource((HWND
)parent
->GetHWND(), dsnLocation
,
3864 driverName
, setupStr
.c_str());
3866 if ((result
!= SQL_SUCCESS
) && (result
!= SQL_SUCCESS_WITH_INFO
))
3868 // check for errors caused by ConfigDSN based functions
3871 wxChar errMsg
[SQL_MAX_MESSAGE_LENGTH
];
3872 errMsg
[0] = wxT('\0');
3874 // This function is only supported in ODBC drivers v3.0 compliant and above
3875 SQLInstallerError(1,&retcode
,errMsg
,SQL_MAX_MESSAGE_LENGTH
-1,&cb
);
3878 #ifdef DBDEBUG_CONSOLE
3879 // When run in console mode, use standard out to display errors.
3880 cout
<< errMsg
<< endl
;
3881 cout
<< wxT("Press any key to continue...") << endl
;
3883 #endif // DBDEBUG_CONSOLE
3886 wxLogDebug(errMsg
,wxT("ODBC DEBUG MESSAGE"));
3887 #endif // __WXDEBUG__
3893 // Using iODBC/unixODBC or some other compiler which does not support the APIs
3894 // necessary to use this function, so this function is not supported
3896 wxLogDebug(wxT("wxDbCreateDataSource() not available except under VC++/MSW"),wxT("ODBC DEBUG MESSAGE"));
3899 #endif // __VISUALC__
3903 } // wxDbCreateDataSource()
3907 /********** wxDbGetDataSource() **********/
3908 bool wxDbGetDataSource(HENV henv
, wxChar
*Dsn
, SWORD DsnMax
, wxChar
*DsDesc
,
3909 SWORD DsDescMax
, UWORD direction
)
3911 * Dsn and DsDesc will contain the data source name and data source
3912 * description upon return
3917 if (SQLDataSources(henv
, direction
, (UCHAR FAR
*) Dsn
, DsnMax
, &cb1
,
3918 (UCHAR FAR
*) DsDesc
, DsDescMax
, &cb2
) == SQL_SUCCESS
)
3923 } // wxDbGetDataSource()
3926 // Change this to 0 to remove use of all deprecated functions
3927 #if wxODBC_BACKWARD_COMPATABILITY
3928 /********************************************************************
3929 ********************************************************************
3931 * The following functions are all DEPRECATED and are included for
3932 * backward compatability reasons only
3934 ********************************************************************
3935 ********************************************************************/
3936 bool SqlLog(sqlLog state
, const wxChar
*filename
)
3938 return wxDbSqlLog((enum wxDbSqlLogState
)state
, filename
);
3940 /***** DEPRECATED: use wxGetDataSource() *****/
3941 bool GetDataSource(HENV henv
, char *Dsn
, SWORD DsnMax
, char *DsDesc
, SWORD DsDescMax
,
3944 return wxDbGetDataSource(henv
, Dsn
, DsnMax
, DsDesc
, DsDescMax
, direction
);
3946 /***** DEPRECATED: use wxDbGetConnection() *****/
3947 wxDb WXDLLEXPORT
*GetDbConnection(DbStuff
*pDbStuff
, bool FwdOnlyCursors
)
3949 return wxDbGetConnection((wxDbConnectInf
*)pDbStuff
, FwdOnlyCursors
);
3951 /***** DEPRECATED: use wxDbFreeConnection() *****/
3952 bool WXDLLEXPORT
FreeDbConnection(wxDb
*pDb
)
3954 return wxDbFreeConnection(pDb
);
3956 /***** DEPRECATED: use wxDbCloseConnections() *****/
3957 void WXDLLEXPORT
CloseDbConnections(void)
3959 wxDbCloseConnections();
3961 /***** DEPRECATED: use wxDbConnectionsInUse() *****/
3962 int WXDLLEXPORT
NumberDbConnectionsInUse(void)
3964 return wxDbConnectionsInUse();