X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f6bcfd974ef26faf6f91a62cac09827e09463fd1..19e30148e18cc99296b26503c155e5cef59045f4:/samples/db/dbtest.h diff --git a/samples/db/dbtest.h b/samples/db/dbtest.h index 375dd149e3..d20fd3d9b5 100644 --- a/samples/db/dbtest.h +++ b/samples/db/dbtest.h @@ -14,30 +14,45 @@ #endif #include -#include #include enum DialogModes {mView,mCreate,mEdit,mSearch}; // ID for the menu quit command -#define FILE_CREATE 100 -#define FILE_EXIT 199 -#define EDIT_PARAMETERS 200 -#define ABOUT_DEMO 300 +#define FILE_CREATE 100 +#define FILE_RECREATE_TABLE 110 +#define FILE_RECREATE_INDEXES 120 +#if wxUSE_NEW_GRID +#define FILE_DBGRID_TABLE 130 +#endif +#define FILE_EXIT 199 +#define EDIT_PARAMETERS 200 +#define HELP_ABOUT 300 // this seems to be missing, Robert Roebling (?) #ifndef MAX_PATH -#define MAX_PATH 200 + #if defined(__WXMAC__) + #define MAX_PATH 260 /* max. length of full pathname */ + #else /* _MAC */ + #define MAX_PATH 256 /* max. length of full pathname */ + #endif #endif // Name of the table to be created/opened -const char CONTACT_TABLE_NAME[] = "contacts"; +const wxChar CONTACT_TABLE_NAME[] = "contacts"; + -// Nuber of columns in the above table -const int CONTACT_NO_COLS = 12; // 0-11 +#define wxODBC_BLOB_EXPERIMENT 0 + +// Number of columns in the CONTACT table +#if wxODBC_BLOB_EXPERIMENT > 0 +const int CONTACT_NO_COLS = 13; // 0-12 +#else +const int CONTACT_NO_COLS = 12; // 0-11 +#endif + +const wxChar PARAM_FILENAME[] = "dbtest.cfg"; -// Global structure for holding ODBC connection information -struct wxDbConnectInf DbConnectInf; enum Language {langENGLISH, langFRENCH, langGERMAN, langSPANISH, langOTHER}; @@ -45,28 +60,34 @@ enum Language {langENGLISH, langFRENCH, langGERMAN, langSPANISH, langOTHER}; class CeditorDlg; class CparameterDlg; -const char paramFilename[] = "dbtest.cfg"; + +// Used for displaying many of the database capabilites +// and usage statistics on a database connection +void DisplayDbDiagnostics(wxDb *pDb); -/* - * This class contains the actual data members that are used for transferring - * data back and forth from the database to the program. - * - * NOTE: The object described in this class is just for example purposes, and has no - * real meaning other than to show each type of field being used by the database - */ +// +// This class contains the actual data members that are used for transferring +// data back and forth from the database to the program. +// +// NOTE: The object described in this class is just for example purposes, and has no +// real meaning other than to show each type of field being used by the database +// class CstructContact : public wxObject { public: - char Name[50+1]; // Contact's name - char Addr1[50+1]; - char Addr2[50+1]; - char City[25+1]; - char State[25+1]; - char PostalCode[15+1]; - char Country[20+1]; + wxChar Name[50+1]; // Contact's name + wxChar Addr1[50+1]; + wxChar Addr2[50+1]; + wxChar City[25+1]; + wxChar State[25+1]; + wxChar PostalCode[15+1]; + wxChar Country[20+1]; TIMESTAMP_STRUCT JoinDate; // Date on which this person joined the wxWindows project Language NativeLanguage; // Enumerated type indicating person's native language +#if wxODBC_BLOB_EXPERIMENT > 0 + wxChar Picture[50000]; +#endif bool IsDeveloper; // Is this person a developer for wxWindows, or just a subscriber UCHAR Contributions; // Something to show off an integer field ULONG LinesOfCode; // Something to show off a 'long' field @@ -74,49 +95,62 @@ class CstructContact : public wxObject // -// NOTE: Ccontact inherits wxDbTable, which gives access to all the database functionality +// The Ccontact class derives from wxDbTable, so we have access to all +// of the database table functions and the local memory variables that +// the database classes will store the data into (and read the data from) +// all combined in this one class. // class Ccontact : public wxDbTable, public CstructContact { private: + // Used to keep track of whether this class had a wxDb instance + // passed in to it or not. If an existing wxDb instance was not + // passed in at Ccontact creation time, then when the Ccontact + // instance is deleted, the connection will be freed as Ccontact + // created its own connection when it was created. bool freeDbConn; + + // Calls wxDbTable::SetColDefs() once for each column that is + // to be associated with some member variable for use with + // this database object. void SetupColumns(); public: + // Used in places where we need to construct a WHERE clause to + // be passed to the SetWhereClause() function. From example, + // where building the WHERE clause requires using ::Printf() + // to build the string. wxString whereStr; - wxString qryWhereStr; // Where string returned from the query dialog + + // WHERE string returned from the query dialog + wxString qryWhereStr; Ccontact(wxDb *pwxDb=NULL); ~Ccontact(); void Initialize(); - bool CreateIndexes(void); - bool FetchByName(char *name); + + // Contains all the index definitions and calls to wxDbTable::CreateIndex() + // required to create all the indexes we wish to define for this table. + bool CreateIndexes(bool recreate); + + // Since we do not wish to have duplicate code blocks all over our program + // for a common query/fetch that we will need to do in many places, we + // include this member function that does it all for us in one place. + bool FetchByName(const wxString &name); }; // Ccontact class definition typedef struct Cparameters { - // The length of these strings were arbitrarily picked, and are - // dependent on the OS and database engine you will be using. - char ODBCSource[100+1]; - char UserName[25+1]; - char Password[25+1]; - char DirPath[MAX_PATH+1]; + wxChar ODBCSource[SQL_MAX_DSN_LENGTH+1]; + wxChar UserName[SQL_MAX_USER_NAME_LEN+1]; + wxChar Password[SQL_MAX_AUTHSTR_LEN+1]; + wxChar DirPath[MAX_PATH+1]; } Cparameters; -// Define a new application type -class DatabaseDemoApp: public wxApp -{ - public: - Cparameters params; - bool OnInit(); -}; // DatabaseDemoApp - -DECLARE_APP(DatabaseDemoApp) - // Define a new frame type class DatabaseDemoFrame: public wxFrame { @@ -126,14 +160,19 @@ class DatabaseDemoFrame: public wxFrame public: DatabaseDemoFrame(wxFrame *frame, const wxString& title, const wxPoint& pos, const wxSize& sz); + ~DatabaseDemoFrame(); void OnCloseWindow(wxCloseEvent& event); void OnCreate(wxCommandEvent& event); + void OnRecreateTable(wxCommandEvent& event); + void OnRecreateIndexes(wxCommandEvent& event); void OnExit(wxCommandEvent& event); void OnEditParameters(wxCommandEvent& event); void OnAbout(wxCommandEvent& event); - - void CreateDataTable(); +#if wxUSE_NEW_GRID + void OnDbGridTable( wxCommandEvent& ); +#endif + void CreateDataTable(bool recreate); void BuildEditorDialog(); void BuildParameterDialog(wxWindow *parent); @@ -141,19 +180,104 @@ DECLARE_EVENT_TABLE() }; // DatabaseDemoFrame +#if wxUSE_NEW_GRID + +// *************************** DBGridFrame *************************** + +class DbGridFrame : public wxFrame +{ +public: + bool initialized; + + DbGridFrame(wxWindow *parent); + + void OnCloseWindow(wxCloseEvent& event); + bool Initialize(); + + DECLARE_EVENT_TABLE() +}; + +#endif + +// Define a new application type +class DatabaseDemoApp: public wxApp +{ + public: + // These are the parameters that are stored in the "PARAM_FILENAME" file + // that are read in at startup of the program that indicate the connection + // parameters to be used for connecting to the ODBC data source. + Cparameters params; + + // Pointer to the main frame used by the App + DatabaseDemoFrame *DemoFrame; + + // Pointer to the main database connection used in the program. This + // pointer would normally be used for doing things as database lookups + // for user login names and passwords, getting workstation settings, etc. + // + // ---> IMPORTANT <--- + // + // For each database object created which uses this wxDb pointer + // connection to the database, when a CommitTrans() or RollBackTrans() + // will commit or rollback EVERY object which uses this wxDb pointer. + // + // To allow each table object (those derived from wxDbTable) to be + // individually committed or rolled back, you MUST use a different + // instance of wxDb in the constructor of the table. Doing so creates + // more overhead, and will use more database connections (some DBs have + // connection limits...), so use connections sparringly. + // + // It is recommended that one "main" database connection be created for + // the entire program to use for READ-ONLY database accesses, but for each + // table object which will do a CommitTrans() or RollbackTrans() that a + // new wxDb object be created and used for it. + wxDb *READONLY_DB; + + // Contains the ODBC connection information used by + // all database connections + wxDbConnectInf *DbConnectInf; + + bool OnInit(); + + // Read/Write ODBC connection parameters to the "PARAM_FILENAME" file + bool ReadParamFile(Cparameters ¶ms); + bool WriteParamFile(Cparameters ¶ms); + + void CreateDataTable(bool recreate); + + // Pointer to the wxDbTable instance that is used to manipulate + // the data in memory and in the database + Ccontact *Contact; + +}; // DatabaseDemoApp + + +DECLARE_APP(DatabaseDemoApp) + // *************************** CeditorDlg *************************** class CeditorDlg : public wxPanel { private: - bool widgetPtrsSet; - wxString saveName; + // Used to indicate whether all of the widget pointers (defined + // below) have been initialized to point to the memory for + // the named widget. Used as a safeguard from using the widget + // before it has been initialized. + bool widgetPtrsSet; + + // Used when the EDIT button has been pressed to maintain the + // original name that was displayed in the editor before the + // EDIT button was pressed, so that if CANCEL is pressed, a + // FetchByName() can be done to retrieve the original data + // to repopulate the dialog. + wxString saveName; // Pointers to all widgets on the dialog wxButton *pCreateBtn, *pEditBtn, *pDeleteBtn, *pCopyBtn, *pSaveBtn, *pCancelBtn; wxButton *pPrevBtn, *pNextBtn, *pQueryBtn, *pResetBtn, *pDoneBtn, *pHelpBtn; wxButton *pNameListBtn; + wxButton *pCatalogBtn, *pDataTypesBtn, *pDbDiagsBtn; wxTextCtrl *pNameTxt, *pAddress1Txt, *pAddress2Txt,*pCityTxt, *pStateTxt, *pCountryTxt,*pPostalCodeTxt; wxStaticText *pNameMsg, *pAddress1Msg, *pAddress2Msg,*pCityMsg, *pStateMsg, *pCountryMsg,*pPostalCodeMsg; wxTextCtrl *pJoinDateTxt,*pContribTxt, *pLinesTxt; @@ -163,8 +287,12 @@ class CeditorDlg : public wxPanel wxStaticText *pNativeLangMsg; public: - enum DialogModes mode; - Ccontact *Contact; // this is the table object that will be being manipulated + // Indicates if the editor dialog has been initialized yet (used to + // help trap if the Initialize() function failed to load all required + // resources or not. + bool initialized; + + enum DialogModes mode; CeditorDlg(wxWindow *parent); @@ -173,14 +301,33 @@ class CeditorDlg : public wxPanel void OnCommand(wxWindow& win, wxCommandEvent& event); void OnActivate(bool) {}; // necessary for hot keys + bool Initialize(); + + // Sets wxStaticText fields to be editable or not depending + // on the current value of 'mode' void FieldsEditable(); + + // Sets the editor mode, determining what state widgets + // on the dialog are to be in based on the operation + // being performed. void SetMode(enum DialogModes m); + + // Update/Retrieve data from the widgets on the dialog bool PutData(); bool GetData(); + + // Inserts/updates the database with the current data + // retrieved from the editor dialog bool Save(); + + // Database functions for changing the data that is to + // be displayed on the dialog. GetNextRec()/GetPrevRec() + // provide database independent methods that do not require + // backward scrolling cursors to obtain the record that + // is prior to the current record in the search sequence. bool GetNextRec(); bool GetPrevRec(); - bool GetRec(char *whereStr); + bool GetRec(const wxString &whereStr); DECLARE_EVENT_TABLE() }; // CeditorDlg @@ -226,15 +373,28 @@ DECLARE_EVENT_TABLE() #define EDITOR_DIALOG_DEVELOPER 236 #define EDITOR_DIALOG_JOIN_MSG 237 #define EDITOR_DIALOG_JOIN_TEXT 238 +#define EDITOR_DIALOG_CATALOG 240 +#define EDITOR_DIALOG_DATATYPES 250 +#define EDITOR_DIALOG_DB_DIAGS 260 // *************************** CparameterDlg *************************** class CparameterDlg : public wxDialog { private: + // Used to indicate whether all of the widget pointers (defined + // below) have been initialized to point to the memory for + // the named widget. Used as a safeguard from using the widget + // before it has been initialized. bool widgetPtrsSet; + enum DialogModes mode; + + // Have the parameters been saved yet, or do they + // need to be saved to update the params on disk bool saved; + + // Original params Cparameters savedParamSettings; // Pointers to all widgets on the dialog @@ -252,9 +412,16 @@ class CparameterDlg : public wxDialog void OnCommand(wxWindow& win, wxCommandEvent& event); void OnActivate(bool) {}; // necessary for hot keys + // Update/Retrieve data from the widgets on the dialog bool PutData(); bool GetData(); + + // Stores the defined parameter for connecting to the selected ODBC + // data source to the config file name in "PARAM_FILENAME" bool Save(); + + // Populates the 'pParamODBCSourceList' listbox with the names of all + // ODBC datasource defined for use at the current workstation void FillDataSourceList(); DECLARE_EVENT_TABLE() @@ -293,27 +460,31 @@ enum qryOp // Query strings -char * const langQRY_EQ = "column = column | value"; -char * const langQRY_LT = "column < column | value"; -char * const langQRY_GT = "column > column | value"; -char * const langQRY_LE = "column <= column | value"; -char * const langQRY_GE = "column >= column | value"; -char * const langQRY_BEGINS = "columns that BEGIN with the string entered"; -char * const langQRY_CONTAINS = "columns that CONTAIN the string entered"; -char * const langQRY_LIKE = "% matches 0 or more of any char; _ matches 1 char"; -char * const langQRY_BETWEEN = "column BETWEEN value AND value"; +wxChar * const langQRY_EQ = "column = column | value"; +wxChar * const langQRY_LT = "column < column | value"; +wxChar * const langQRY_GT = "column > column | value"; +wxChar * const langQRY_LE = "column <= column | value"; +wxChar * const langQRY_GE = "column >= column | value"; +wxChar * const langQRY_BEGINS = "columns that BEGIN with the string entered"; +wxChar * const langQRY_CONTAINS = "columns that CONTAIN the string entered"; +wxChar * const langQRY_LIKE = "% matches 0 or more of any char; _ matches 1 char"; +wxChar * const langQRY_BETWEEN = "column BETWEEN value AND value"; class CqueryDlg : public wxDialog { private: - wxDbColInf *colInf; // Column inf. returned by db->GetColumns() - wxDbTable *dbTable; - char *masterTableName; - char *pWhere; // A pointer to the storage for the resulting where clause + wxDbColInf *colInf; // Column inf. returned by db->GetColumns() + wxDbTable *dbTable; // generic wxDbTable object for attaching to the table to query + wxChar *masterTableName; // Name of the table that 'dbTable' will be associated with + wxString pWhere; // A pointer to the storage for the resulting where clause wxDb *pDB; public: + // Used to indicate whether all of the widget pointers (defined + // below) have been initialized to point to the memory for + // the named widget. Used as a safeguard from using the widget + // before it has been initialized. bool widgetPtrsSet; // Widget pointers @@ -343,9 +514,9 @@ class CqueryDlg : public wxDialog wxStaticBox *pQueryHintGrp; wxStaticText *pQueryHintMsg; - wxTextCtrl *pFocusTxt; + wxTextCtrl *pFocusTxt; - CqueryDlg(wxWindow *parent, wxDb *pDb, char *tblName[], char *pWhereArg); + CqueryDlg(wxWindow *parent, wxDb *pDb, wxChar *tblName[], const wxString &pWhereArg); ~CqueryDlg(); void OnButton( wxCommandEvent &event ); @@ -353,7 +524,7 @@ class CqueryDlg : public wxDialog void OnCloseWindow(wxCloseEvent& event); void OnActivate(bool) {}; // necessary for hot keys - void AppendToWhere(char *s); + void AppendToWhere(wxChar *s); void ProcessAddBtn(); void ProcessCountBtn(); bool ValidateWhereClause(); @@ -389,3 +560,95 @@ DECLARE_EVENT_TABLE() #define QUERY_DIALOG_HINT_GROUP 323 #define QUERY_DIALOG_HINT_MSG 324 +char * const langNO = "No"; +char * const langYES = "Yes"; +char * const langDBINF_DB_NAME = "Database Name = "; +char * const langDBINF_DB_VER = "Database Version = "; +char * const langDBINF_DRIVER_NAME = "Driver Name = "; +char * const langDBINF_DRIVER_ODBC_VER = "Driver ODBC Version = "; +char * const langDBINF_DRIVER_MGR_ODBC_VER = "Driver Manager ODBC Version = "; +char * const langDBINF_DRIVER_VER = "Driver Version = "; +char * const langDBINF_SERVER_NAME = "Server Name = "; +char * const langDBINF_FILENAME = "Filename = "; +char * const langDBINF_OUTER_JOINS = "Outer Joins = "; +char * const langDBINF_STORED_PROC = "Stored Procedures = "; +char * const langDBINF_MAX_HDBC = "Max # of Db connections = "; +char * const langDBINF_MAX_HSTMT = "Max # of cursors (per db connection) = "; +char * const langDBINF_UNLIMITED = "Unlimited or Unknown"; +char * const langDBINF_API_LVL = "ODBC API conformance level = "; +char * const langDBINF_CLI_LVL = "Client (SAG) conformance level = "; +char * const langDBINF_SQL_LVL = "SQL conformance level = "; +char * const langDBINF_COMMIT_BEHAVIOR = "Commit Behavior = "; +char * const langDBINF_ROLLBACK_BEHAVIOR = "Rollback Behavior = "; +char * const langDBINF_SUPP_NOT_NULL = "Support NOT NULL clause = "; +char * const langDBINF_SUPP_IEF = "Support IEF = "; +char * const langDBINF_TXN_ISOLATION = "Transaction Isolation Level (default) = "; +char * const langDBINF_TXN_ISOLATION_CURR = "Transaction Isolation Level (current) = "; +char * const langDBINF_TXN_ISOLATION_OPTS = "Transaction Isolation Options Available = "; +char * const langDBINF_FETCH_DIRS = "Fetch Directions = "; +char * const langDBINF_LOCK_TYPES = "Lock Types (SQLSetPos) = "; +char * const langDBINF_POS_OPERS = "Position Operations (SQLSetPos) = "; +char * const langDBINF_POS_STMTS = "Position Statements = "; +char * const langDBINF_SCROLL_CONCURR = "Concurrency Options (scrollable cursors) = "; +char * const langDBINF_SCROLL_OPTS = "Scroll Options (scrollable cursors) = "; +char * const langDBINF_STATIC_SENS = "Static Sensitivity = "; +char * const langDBINF_TXN_CAPABLE = "Transaction Support = "; +char * const langDBINF_LOGIN_TIMEOUT = "Login Timeout = "; +char * const langDBINF_NONE = "None"; +char * const langDBINF_LEVEL1 = "Level 1"; +char * const langDBINF_LEVEL2 = "Level 2"; +char * const langDBINF_NOT_COMPLIANT = "Not Compliant"; +char * const langDBINF_COMPLIANT = "Compliant"; +char * const langDBINF_MIN_GRAMMAR = "Minimum Grammer"; +char * const langDBINF_CORE_GRAMMAR = "Core Grammer"; +char * const langDBINF_EXT_GRAMMAR = "Extended Grammer"; +char * const langDBINF_DELETE_CURSORS = "Delete cursors"; +char * const langDBINF_CLOSE_CURSORS = "Close cursors"; +char * const langDBINF_PRESERVE_CURSORS = "Preserve cursors"; +char * const langDBINF_READ_UNCOMMITTED = "Read Uncommitted"; +char * const langDBINF_READ_COMMITTED = "Read Committed"; +char * const langDBINF_REPEATABLE_READ = "Repeatable Read"; +char * const langDBINF_SERIALIZABLE = "Serializable"; +char * const langDBINF_VERSIONING = "Versioning"; +char * const langDBINF_NEXT = "Next"; +char * const langDBINF_PREV = "Prev"; +char * const langDBINF_FIRST = "First"; +char * const langDBINF_LAST = "Last"; +char * const langDBINF_ABSOLUTE = "Absolute"; +char * const langDBINF_RELATIVE = "Relative"; +char * const langDBINF_RESUME = "Resume"; +char * const langDBINF_BOOKMARK = "Bookmark"; +char * const langDBINF_NO_CHANGE = "No Change"; +char * const langDBINF_EXCLUSIVE = "Exclusive"; +char * const langDBINF_UNLOCK = "Unlock"; +char * const langDBINF_POSITION = "Position"; +char * const langDBINF_REFRESH = "Refresh"; +char * const langDBINF_UPD = "Upd"; +char * const langDBINF_DEL = "Del"; +char * const langDBINF_ADD = "Add"; +char * const langDBINF_POS_DEL = "Pos Delete"; +char * const langDBINF_POS_UPD = "Pos Update"; +char * const langDBINF_SELECT_FOR_UPD = "Select For Update"; +char * const langDBINF_READ_ONLY = "Read Only"; +char * const langDBINF_LOCK = "Lock"; +char * const langDBINF_OPT_ROWVER = "Opt. Rowver"; +char * const langDBINF_OPT_VALUES = "Opt. Values"; +char * const langDBINF_FWD_ONLY = "Fwd Only"; +char * const langDBINF_STATIC = "Static"; +char * const langDBINF_KEYSET_DRIVEN = "Keyset Driven"; +char * const langDBINF_DYNAMIC = "Dynamic"; +char * const langDBINF_MIXED = "Mixed"; +char * const langDBINF_ADDITIONS = "Additions"; +char * const langDBINF_DELETIONS = "Deletions"; +char * const langDBINF_UPDATES = "Updates"; +char * const langDBINF_DML_ONLY = "DML Only"; +char * const langDBINF_DDL_COMMIT = "DDL Commit"; +char * const langDBINF_DDL_IGNORE = "DDL Ignore"; +char * const langDBINF_DDL_AND_DML = "DDL and DML"; +char * const langDBINF_ORACLE_BANNER = ">>> ORACLE STATISTICS AND TUNING INFORMATION <<<"; +char * const langDBINF_DB_BLOCK_GETS = "DB block gets"; +char * const langDBINF_CONSISTENT_GETS = "Consistent gets"; +char * const langDBINF_PHYSICAL_READS = "Physical reads"; +char * const langDBINF_CACHE_HIT_RATIO = "Cache hit ratio"; +char * const langDBINF_TABLESPACE_IO = "TABLESPACE I/O LEVELS"; +char * const langDBINF_PHYSICAL_WRITES = "Physical writes";