office-gobmx/connectivity/workben/skeleton/how_to_write_a_driver.txt
2012-06-12 22:24:55 +01:00

69 lines
2.5 KiB
Text

#
# This file is part of the LibreOffice project.
#
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
#
# This file incorporates work covered by the following license notice:
#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed
# with this work for additional information regarding copyright
# ownership. The ASF licenses this file to you under the Apache
# License, Version 2.0 (the "License"); you may not use this file
# except in compliance with the License. You may obtain a copy of
# the License at http://www.apache.org/licenses/LICENSE-2.0 .
#
How to write my own sdbc driver
all example files can be found in connectivity/workben/skeleton
Pre implementation steps
- copy all files from connectivity/workben/skeleton into your new created directory under
connectivity/source/drivers and rename the first char of the files to one which isn't used so far
( please have a look at the other drivers )
- search all occurrences of skeleton and replace them to a name which you prefer
1. Implement a class called driver or modify the existing skeleton -> have a look at SDriver.?xx
2. Implement a class called connection -> have a look at SConnection.?xx
3. Have a look at the DatabaseMetaData -> see SDatabaseMetaData.cxx
The methods which should be implemented at least are
- getTableTypes
- getTables
- getTypeInfo
- getColumns
4. You need a statement to show/access some data -> have a look at SStatement.cxx
-> especially executeQuery()
5. The ResultSet: without you see nothing -> look at SResultSet.cxx
6. The ResultSetMetaData needed to get some information about what are waiting for us
-> look at SResultSetMetaData.cxx
7. The prepared statement is the last class we have to implement now
-> you have to allow statements like "SELECT * FROM table WHERE id = ?"
8. insert entry in version.mk
# ----------------------------SKELETON settings-----------------------------------#
# target
SKELETON_TARGET=skeleton
# the major
SKELETON_MAJOR=2
# the minor
SKELETON_MINOR=0
# the micro
SKELETON_MICRO=0
# this is a c++ compatible library
SKELETON_CPP=1
SKELETON=$(SKELETON_TARGET_TARGET)_$(CMPEXT)
9. copy dll to program dir of office and register the dll
10. congratulations you have now implement your own driver :-)