Class EmbeddedConnectionPoolDataSource

All Implemented Interfaces:
Serializable, Wrapper, Referenceable, ObjectFactory, CommonDataSource, ConnectionPoolDataSource, 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 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:
  • Field Details

  • 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.
    • createPooledConnection

      private PooledConnection createPooledConnection(String user, String password, boolean requestPassword) throws SQLException
      Create and return an EmbedPooledConnection from this instance of EmbeddedConnectionPoolDataSource.
      Parameters:
      user - The user name
      password - The password
      requestPassword - @false if original call is from a no-argument constructor, otherwise true
      Returns:
      A pooled connection
      Throws:
      SQLException - An error occurred