wxDba wrapper library for debea

This library wraps original debea API and makes this API more like wxWidgets API. This allows you to connect to SQL databases using ODBC (and other native plugins provided by Debea) from wxWidgets application. For documentation, you can use original doxygen docs remembering that:

  • all classes and methods should be used upcase. For example dba::Dbconnection::sendQuery becomes wxdba::DbConnection::SendQuery
  • all in and out function arguments require wxString instead of const char*.
  • conversion between database charset and wxString is done on the fly using dba::ConversionSpecs::mDbCharset as source encoding

wxDba is supported using Unicode build. ANSI build is not supported.

To build wxDba wrapper under MSW you need to set WXWIN enviroment variable and have wxWidgets libraries built in $(WXWIN)/lib/vc_lib/mswu(d) directory.

wxDba filters

wxDba contains classes for storing class members that have wxWidgets basic types. Supported types are listed below.

wxBase classes:

  • wxString
  • wxDateTime (as date only and date and time)
  • wxDouble
  • wxInt32
  • wxTimeSpan
  • wxDateSpan

GUI classes:

  • wxFont
  • wxColour
  • wxPageSetupDialogData

Filters are named as base classes without wx prefix. For example wxString filter is named wxdba::String, wxDateTime is named wxdba::DateTime and so on.

wxdba-only API

  • The wxdba::Exception::GetWxMsg returns exception message as wxString. This method should be used instead of dba::exception::what()
  • Some classes including Database, DbConnection, SQLArchive, SQL have GetDbaInternalHandle() method which returns the plain C++ API interface from the dba library

Requirements

wxDba needs the new conversion functions introduced in wxWidgets 2.8

Libraries:

  • wxWidgets 2.8.x
  • wxWidgets 2.9.x

Flags:

  • UNICODE=1