Class 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 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:
    Serialized Form
    • 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.
        Parameters:
        user - The user name
        password - The password
        requestPassword -
        Returns:
        A pooled connection
        Throws:
        java.sql.SQLException - An error occurred