ConnectionPoolDataSource

AI-generated Key Takeaways

• ConnectionPoolDataSource is a factory for creating PooledConnection objects, used for managing physical database connections in a pool.

• It's typically registered with a JNDI naming service for easy lookup and access.

• The getPooledConnection() methods establish physical database connections that can be used as pooled connections.

• It inherits methods from CommonDataSource for managing logging and login timeout.

• ConnectionPoolDataSource is part of the JDBC API and facilitates connection pooling for efficient database interactions.

public interface ConnectionPoolDataSource implements CommonDataSource

A factory for PooledConnection objects. An object that implements this interface will typically be registered with a naming service that is based on the Java^TM Naming and Directory Interface (JNDI).

Public Method Summary

abstract PooledConnection	getPooledConnection() Attempts to establish a physical database connection that can be used as a pooled connection.
abstract PooledConnection	getPooledConnection(String user, String password) Attempts to establish a physical database connection that can be used as a pooled connection.

Inherited Method Summary

From interface javax.sql.CommonDataSource

abstract PrintWriter	getLogWriter() Retrieves the log writer for this DataSource object.
abstract int	getLoginTimeout() Gets the maximum time in seconds that this data source can wait while attempting to connect to a database.
abstract Logger	getParentLogger() Return the parent Logger of all the Loggers used by this data source.
abstract void	setLogWriter(PrintWriter out) Sets the log writer for this DataSource object to the given java.io.PrintWriter object.
abstract void	setLoginTimeout(int seconds) Sets the maximum time in seconds that this data source will wait while attempting to connect to a database.

Public Methods

public abstract PooledConnection getPooledConnection ()

Attempts to establish a physical database connection that can be used as a pooled connection.

Returns

• a PooledConnection object that is a physical connection to the database that this ConnectionPoolDataSource object represents

Throws

SQLException	if a database access error occurs
	if the JDBC driver does not support this method

public abstract PooledConnection getPooledConnection (String user, String password)

Attempts to establish a physical database connection that can be used as a pooled connection.

Parameters

user	the database user on whose behalf the connection is being made
password	the user's password

Returns

• a PooledConnection object that is a physical connection to the database that this ConnectionPoolDataSource object represents

Throws

SQLException	if a database access error occurs
	if the JDBC driver does not support this method