connectivity/workben/skeleton/how_to_write_a_driver.txt

   1 How to write my own sdbc driver
   2
   3 all example files can be found in connectivity/workben/skeleton
   4
   5 Pre implementation steps
   6 - copy all files from connectivity/workben/skeleton into your new created directory under
   7   connectivity/source/drivers and rename the first char of the files to one which isn't used so far
   8   ( please have a look at the other drivers )
   9 - search all occurances of skeleton and replace them to a name which you prefer
  10
  11 1. Implement a class called driver or modify the existing skeleton      -> have a look at SDriver.?xx
  12 2. Implement a class called connection                                                          -> have a look at SConnection.?xx
  13 3. Have a look at the DatabaseMetaData                                                          -> see SDatabaseMetaData.cxx
  14         The methods which should be implemented at least are
  15                 - getTableTypes
  16                 - getTables
  17                 - getTypeInfo
  18                 - getColumns
  19
  20 4. You need a statement to show/access some data                                        -> have a look at SStatement.cxx
  21                                                                                                                                         -> especially executeQuery()
  22
  23 5. The ResultSet: without you see nothing                                                       -> look at SResultSet.cxx
  24 6. The ResultSetMetaData needed to get some information about what are waiting for us
  25                                                                                                                                         -> look at SResultSetMetaData.cxx
  26
  27 7. The prepared statement is the last class we have to implement now
  28         -> you have to allow statements like "SELECT * FROM table WHERE id = ?"
  29
  30
  31 8. insert entry in version.mk
  32 # ----------------------------SKELETON settings-----------------------------------#
  33 # target
  34 SKELETON_TARGET=skeleton
  35
  36 # the major
  37 SKELETON_MAJOR=2
  38 # the minor
  39 SKELETON_MINOR=0
  40 # the micro
  41 SKELETON_MICRO=0
  42
  43 # this is a c++ compatible library
  44 SKELETON_CPP=1
  45
  46 SKELETON=$(SKELETON_TARGET_TARGET)_$(CMPEXT)
  47
  48
  49 9. copy dll to program dir of office and register the dll
  50
  51 10. congratulations you have now implement your own driver :-)