apache > db
Apache DB Project
Font size:      

Getting a DataSource

Getting a DataSource

Normally, you can simply work with the interfaces for javax.sql.DataSource, javax.sql.ConnectionPoolDataSource, and javax.sql.XADataSource, as shown in the following examples.

import org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource;
import org.apache.derby.jdbc.EmbeddedDataSource;
import org.apache.derby.jdbc.EmbeddedXADataSource; 
javax.sql.ConnectionPoolDataSource cpds = new DerbyConnectionPoolDataSource(); 
javax.sql.DataSource ds = new DerbyDataSource(); 
javax.sql.XADataSource xads = new DerbyXADataSource();

Derby provides six properties for a DataSource. These properties are in org.apache.derby.jdbc.EmbeddedDataSource. They are:

  • DatabaseName

    This mandatory property must be set. It identifies which database to access. If a database named wombat located at /local1/db/wombat is to be accessed, then one should call setDatabaseName("/local1/db/wombat") on the data source object.

  • CreateDatabase

    Optional. Sets a property to create a database the next time the XADataSource.getXAConection() method is called. The string createString is always "create" (or possibly null). (Use the method setDatabaseName() to define the name of the database.)

  • ShutdownDatabase

    Optional. Sets a property to shut down a database. The string shutDownString is always "shutdown" (or possibly null). Shuts down the database the next time XADataSource.getXAConnection().getConnection() method is called.

  • DataSourceName

    Optional. Name for ConnectionPooledDataSource or XADataSource. Not used by the data source object. Used for informational purpose only.

  • Description

    Optional. Description of the data source. Not used by the data source object. Used for informational purpose only.

  • connectionAttributes

    Optional. Connection attributes specific to Derby. See the Derby Reference Manual for a more information about the attributes.

Previous Page
Next Page
Table of Contents