#
JDBC Driver Information Extension

###### Identifier:

org.eclipse.birt.report.data.oda.jdbc.driverinfo

###### Since:

1.0

###### Description:

An extension to supply additional information about a JDBC driver available to the JDBC-ODA Bridge. The information provided for a JDBC driver by this extension include: Driver class name (which uniquely identifies the driver in the BIRT environment), a display-friendly driver name and a URL template to help report desinger compose a data source connection URL.

###### Configuration Markup:

<!ELEMENT extension (jdbcDriver*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT jdbcDriver EMPTY>

<!ATTLIST jdbcDriver

name CDATA #IMPLIED

driverClass CDATA #REQUIRED

urlTemplate CDATA #IMPLIED

connectionFactory CDATA #IMPLIED>

Provides information about a JDBC driver available to the JDBC-ODA bridge.

- name - Displayable name of the JDBD driver. Can be translatable.
- driverClass - Name of the JDBD driver's class implementing java.sql.Driver. For example, "sun.jdbc.odbc.JdbcOdbcDriver".
- urlTemplate - A template string to help the user compose a proper URL accepted by the JDBD driver. For example: "jdbc:odbc:[;=]*"
- connectionFactory - Defines an extension class which provides connections using this JDBC driver. If defined, an instance of this class will be used instead of java.sql.DriverManager to obtain connections for the given driverClass. The extension class must implement interface org.eclipse.birt.report.data.oda.jdbc.IConnectionFactory.

###### Examples:

This is a sample extension which defines the embedded Derby JDBC driver. It is an excerpt from the jdbc-oda driver's plugin manifest.

Copyright (c) 2004-2005 Actuate Corporation. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html