Class EmbeddedConnectionPoolDataSource

java.lang.Object
org.apache.derby.jdbc.BasicEmbeddedDataSource40
org.apache.derby.jdbc.ReferenceableDataSource
org.apache.derby.jdbc.EmbeddedDataSource
org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
All Implemented Interfaces:
Serializable, Wrapper, Referenceable, ObjectFactory, CommonDataSource, ConnectionPoolDataSource, DataSource
public class EmbeddedConnectionPoolDataSource extends EmbeddedDataSource

This datasource is suitable for an application using embedded Derby, running on full Java SE 6 and higher, corresponding to 4.0 and higher. 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 4.0 - Java SE 6
  • JDBC 4.1 - Java SE 7
  • JDBC 4.2 - full Java SE 8

Use BasicEmbeddedConnectionPoolDataSource40 if your application runs on Java 8 Compact Profile 2.

EmbeddedConnectionPoolDataSource is serializable and referenceable.

See EmbeddedDataSource for DataSource properties.

See Also:

  • Constructor Details

    • EmbeddedConnectionPoolDataSource

      public EmbeddedConnectionPoolDataSource()
      No-arg constructor.

  • Method Details

    • getPooledConnection

      public final PooledConnection getPooledConnection() throws SQLException
      Attempt to establish a database connection.
      Specified by:
      getPooledConnection in interface ConnectionPoolDataSource
      Returns:
      a Connection to the database
      Throws:
      SQLException - if a database-access error occurs.

    • getPooledConnection

      public final PooledConnection getPooledConnection(String username, String password) throws SQLException
      Attempt to establish a database connection.
      Specified by:
      getPooledConnection in interface 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:
      SQLException - if a database-access error occurs.

    • setDatabaseName

      void setDatabaseName(String databaseName)

    • getDatabaseName

      String getDatabaseName()

    • setDataSourceName

      void setDataSourceName(String dsn)

    • getDataSourceName

      String getDataSourceName()

    • setDescription

      void setDescription(String desc)

    • getDescription

      String getDescription()

    • setUser

      void setUser(String user)

    • getUser

      String getUser()

    • setPassword

      void setPassword(String password)

    • getPassword

      String getPassword()

    • setCreateDatabase

      void setCreateDatabase(String create)

    • getCreateDatabase

      String getCreateDatabase()

    • setConnectionAttributes

      void setConnectionAttributes(String prop)

    • getConnectionAttributes

      String getConnectionAttributes()

    • setShutdownDatabase

      void setShutdownDatabase(String shutdown)

    • getShutdownDatabase

      String getShutdownDatabase()

    • setAttributesAsPassword

      void setAttributesAsPassword(boolean attributesAsPassword)

    • getAttributesAsPassword

      boolean getAttributesAsPassword()

    • getConnection

      Connection getConnection(String username, String password, boolean requestPassword) throws SQLException
      Get a user connection.
      Parameters:
      username - the user name
      password - the password
      requestPassword - true if the password came from the getConnection() call with user and password arguments..
      Returns:
      user connection
      Throws:
      SQLException - on error