org.apache.derby.jdbc
Class EmbeddedConnectionPoolDataSource

java.lang.Object
  extended byorg.apache.derby.jdbc.ReferenceableDataSource
      extended byorg.apache.derby.jdbc.EmbeddedDataSource
          extended byorg.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
All Implemented Interfaces:
javax.sql.ConnectionPoolDataSource, javax.sql.DataSource, javax.naming.spi.ObjectFactory, javax.naming.Referenceable, java.io.Serializable

public class EmbeddedConnectionPoolDataSource
extends EmbeddedDataSource
implements javax.sql.ConnectionPoolDataSource

EmbeddedConnectionPoolDataSource is Derby's ConnectionPoolDataSource implementation for the JDBC3.0 environment.

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.

EmbeddedConnectionPoolDataSource is serializable and referenceable.

See EmbeddedDataSource for DataSource properties.

See Also:
Serialized Form

Constructor Summary
EmbeddedConnectionPoolDataSource()
          No-arg constructor.
 
Method Summary
protected  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
equals, getAttributesAsPassword, getConnection, getConnection, getConnectionAttributes, getCreateDatabase, getShutdownDatabase, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setShutdownDatabase
 
Methods inherited from class org.apache.derby.jdbc.ReferenceableDataSource
getDatabaseName, getDataSourceName, getDescription, getLoginTimeout, getLogWriter, getObjectInstance, getPassword, getReference, getUser, setDatabaseName, setDataSourceName, setDescription, setLoginTimeout, setLogWriter, setPassword, setUser
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.sql.ConnectionPoolDataSource
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
 
Methods inherited from interface javax.sql.DataSource
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
 

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

protected 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

Built on Wed 2007-08-01 06:53:39-0700, from revision 561794

Apache Derby 10.3 API Documentation - Copyright © 2004,2007 The Apache Software Foundation. All Rights Reserved.