org.apache.derby.jdbc
Class EmbeddedConnectionPoolDataSource

java.lang.Object
  org.apache.derby.jdbc.EmbeddedBaseDataSource
      org.apache.derby.jdbc.ReferenceableDataSource
          org.apache.derby.jdbc.EmbeddedDataSource
              org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource

All Implemented Interfaces:

java.io.Serializable, java.sql.Wrapper, javax.naming.Referenceable, javax.naming.spi.ObjectFactory, javax.sql.CommonDataSource, javax.sql.ConnectionPoolDataSource, javax.sql.DataSource, EmbeddedConnectionPoolDataSourceInterface, EmbeddedDataSourceInterface

Direct Known Subclasses:

EmbeddedConnectionPoolDataSource40

public class EmbeddedConnectionPoolDataSource
extends EmbeddedDataSource
implements EmbeddedConnectionPoolDataSourceInterface

This datasource is suitable for an application using embedded Derby, running on full Java SE 5 or 6, corresponding to JDBC 3.0 and 4.0. If running on Java SE 7 or higher, consider a more capable data source.

EmbeddedConnectionPoolDataSource is a ConnectionPoolDataSource implementation.

A ConnectionPoolDataSource is a factory for PooledConnection objects. An object that implements this interface will typically be registered with a JNDI service.

EmbeddedConnectionPoolDataSource automatically supports the correct JDBC specification version for the Java Virtual Machine's environment.

• JDBC 3.0 - J2SE 5.0
• JDBC 4.0 - Java SE 6

EmbeddedConnectionPoolDataSource is serializable and referenceable.

See EmbeddedDataSource for DataSource properties.

See Also:

Serialized Form

Field Summary

private static long

serialVersionUID

Fields inherited from class org.apache.derby.jdbc.EmbeddedBaseDataSource

attributesAsPassword, connectionAttributes, createDatabase, databaseName, dataSourceName, description, driver, jdbcurl, loginTimeout, shutdownDatabase

Constructor Summary

EmbeddedConnectionPoolDataSource()
No-arg constructor.

Method Summary

private javax.sql.PooledConnection	createPooledConnection(java.lang.String user, java.lang.String password, boolean requestPassword) Create and return an EmbedPooledConnection from this instance of EmbeddedConnectionPoolDataSource.
javax.sql.PooledConnection	getPooledConnection() Attempt to establish a database connection.
javax.sql.PooledConnection	getPooledConnection(java.lang.String username, java.lang.String password) Attempt to establish a database connection.

Methods inherited from class org.apache.derby.jdbc.EmbeddedDataSource

getReference

Methods inherited from class org.apache.derby.jdbc.ReferenceableDataSource

getObjectInstance

Methods inherited from class org.apache.derby.jdbc.EmbeddedBaseDataSource

equals, findDriver, getAttributesAsPassword, getConnection, getConnection, getConnection, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getLoginTimeout, getLogWriter, getPassword, getShortDatabaseName, getShutdownDatabase, getUser, isWrapperFor, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setLoginTimeout, setLogWriter, setPassword, setShutdownDatabase, setupResourceAdapter, setUser, unwrap, update

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.derby.jdbc.EmbeddedDataSourceInterface

getAttributesAsPassword, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getPassword, getShutdownDatabase, getUser, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setPassword, setShutdownDatabase, setUser

Methods inherited from interface javax.sql.DataSource

getConnection, getConnection

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

EmbeddedConnectionPoolDataSource

public EmbeddedConnectionPoolDataSource()

No-arg constructor.

Method Detail

getPooledConnection

public final javax.sql.PooledConnection getPooledConnection()
                                                     throws java.sql.SQLException

Attempt to establish a database connection.

Specified by:

getPooledConnection in interface javax.sql.ConnectionPoolDataSource

Returns:

a Connection to the database

Throws:

java.sql.SQLException - if a database-access error occurs.

getPooledConnection

public final javax.sql.PooledConnection getPooledConnection(java.lang.String username,
                                                            java.lang.String password)
                                                     throws java.sql.SQLException

Attempt to establish a database connection.

Specified by:

getPooledConnection in interface javax.sql.ConnectionPoolDataSource

Parameters:

username - the database user on whose behalf the Connection is being made

password - the user's password

Returns:

a Connection to the database

Throws:

java.sql.SQLException - if a database-access error occurs.

createPooledConnection

private javax.sql.PooledConnection createPooledConnection(java.lang.String user,
                                                          java.lang.String password,
                                                          boolean requestPassword)
                                                   throws java.sql.SQLException

Create and return an EmbedPooledConnection from this instance of EmbeddedConnectionPoolDataSource.

Throws:

java.sql.SQLException