Package oracle.jdbc.pool

Class OracleConnectionPoolDataSource

java.lang.Object

oracle.jdbc.pool.OracleDataSource

oracle.jdbc.pool.OracleConnectionPoolDataSource

All Implemented Interfaces:

Serializable, Wrapper, Referenceable, CommonDataSource, ConnectionPoolDataSource, DataSource, OracleCommonDataSource, OracleConnectionPoolDataSource, OracleDataSource

Direct Known Subclasses:

OracleXADataSource

public class OracleConnectionPoolDataSource
extends OracleDataSource
implements OracleConnectionPoolDataSource

A DataSource object is a factory for Connection objects. An object that implements the DataSource interface will typically be registered with a JNDI service provider. A JDBC driver that is accessed via the DataSource API does not automatically register itself with the DriverManager.

See Also:

Serialized Form

Field Summary

Fields inherited from class oracle.jdbc.pool.OracleDataSource

cacheManager, connCacheName, connCacheProperties, connCachingEnabled, connectionProperties, databaseName, dataSourceName, DEFAULT_SERVICE_NAME, description, driver, driverType, ENABLE_AC_SUPPORT_PROPERTY, explicitCachingEnabled, explicitCachingEnabledSet, fastConnFailover, implicitCachingEnabled, implicitCachingEnabledSet, isOracleDataSource, loginTimeout, logWriter, maxStatements, maxStatementsSet, networkProtocol, odsCache, onsConfigStr, password, portNumber, serverName, serviceName, tnsEntry, TRACE, url, user

Constructor Summary

Constructors

Constructor	Description
OracleConnectionPoolDataSource()

Method Summary

Modifier and Type	Method	Description
OraclePooledConnectionBuilder	createPooledConnectionBuilder()	Creates a new OraclePooledConnectionBuilder instance
protected Connection	getPhysicalConnection()	Get a Physical Connection with default url, user name, and password
protected Connection	getPhysicalConnection(String _user, String _passwd)	Get a Physical Connection with the user name and password & default URL
protected Connection	getPhysicalConnection(String _url, String _user, String _passwd)	Get a Physical Connection with the given url, user name, and password
PooledConnection	getPooledConnection()	Attempt to establish a database connection.
PooledConnection	getPooledConnection(String _user, String _passwd)	Attempt to establish a database connection.
protected OraclePooledConnection	getPooledConnection(OracleConnectionBuilderImpl connBuilder)

Methods inherited from interface javax.sql.CommonDataSource

getParentLogger

Methods inherited from interface javax.sql.ConnectionPoolDataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface oracle.jdbc.datasource.OracleCommonDataSource

createShardingKeyBuilder, getConnectionProperties, getDatabaseName, getDataSourceName, getDescription, getExplicitCachingEnabled, getImplicitCachingEnabled, getMaxStatements, getNetworkProtocol, getPortNumber, getRoleName, getServerName, getURL, getUser, setConnectionProperties, setDatabaseName, setDataSourceName, setDescription, setExplicitCachingEnabled, setImplicitCachingEnabled, setMaxStatements, setNetworkProtocol, setPassword, setPortNumber, setRoleName, setServerName, setSSLContext, setURL, setUser

Methods inherited from class oracle.jdbc.pool.OracleDataSource

addRefProperties, close, copy, createConnectionBuilder, debug, getConnection, getConnection, getConnection, getConnection, getConnection, getConnectionCacheName, getConnectionCacheProperties, getConnectionCachingEnabled, getConnectionDuringExceptionHandling, getConnectionProperties, getConnectionProperty, getDatabaseName, getDataSourceName, getDescription, getDriverType, getExplicitCachingEnabled, getFastConnectionFailoverEnabled, getImplicitCachingEnabled, getLoginTimeout, getLogWriter, getMaxStatements, getNetworkProtocol, getONSConfiguration, getParentLogger, getPassword, getPhysicalConnection, getPortNumber, getReference, getRoleName, getServerName, getServiceName, getTNSEntryName, getURL, getUser, isWrapperFor, setConnectionCacheName, setConnectionCacheProperties, setConnectionCachingEnabled, setConnectionProperties, setConnectionProperty, setDatabaseName, setDataSourceName, setDescription, setDriverType, setExplicitCachingEnabled, setFastConnectionFailoverEnabled, setImplicitCachingEnabled, setLoginTimeout, setLogWriter, setMaxStatements, setNetworkProtocol, setONSConfiguration, setPassword, setPortNumber, setRoleName, setServerName, setServiceName, setSSLContext, setTNSEntryName, setURL, setUser, trace, unwrap

Constructor Detail

OracleConnectionPoolDataSource

public OracleConnectionPoolDataSource()
                               throws SQLException

Throws:

SQLException

Method Detail

getPooledConnection

public PooledConnection getPooledConnection()
                                     throws SQLException

Attempt to establish a database connection.

Specified by:

getPooledConnection in interface ConnectionPoolDataSource

Returns:

a PooledConnection to the database

Throws:

SQLException - if a database-access error occurs.

getPooledConnection

public PooledConnection getPooledConnection(String _user,
                                            String _passwd)
                                     throws SQLException

Attempt to establish a database connection.

Specified by:

getPooledConnection in interface ConnectionPoolDataSource

Parameters:

user - the database user on whose behalf the Connection is being made

password - the user's password

Returns:

a PooledConnection to the database

Throws:

SQLException - if a database-access error occurs.

getPhysicalConnection

protected Connection getPhysicalConnection()
                                    throws SQLException

Get a Physical Connection with default url, user name, and password

Throws:

SQLException

getPhysicalConnection

protected Connection getPhysicalConnection(String _url,
                                           String _user,
                                           String _passwd)
                                    throws SQLException

Get a Physical Connection with the given url, user name, and password

Throws:

SQLException

getPhysicalConnection

protected Connection getPhysicalConnection(String _user,
                                           String _passwd)
                                    throws SQLException

Get a Physical Connection with the user name and password & default URL

Throws:

SQLException

getPooledConnection

protected OraclePooledConnection getPooledConnection(OracleConnectionBuilderImpl connBuilder)
                                              throws SQLException

Throws:

SQLException

createPooledConnectionBuilder

public OraclePooledConnectionBuilder createPooledConnectionBuilder()
                                                            throws SQLException

Description copied from interface: OracleConnectionPoolDataSource

Creates a new OraclePooledConnectionBuilder instance

Specified by:

createPooledConnectionBuilder in interface ConnectionPoolDataSource

Specified by:

createPooledConnectionBuilder in interface OracleConnectionPoolDataSource

Returns:

The OraclePooledConnectionBuilder instance that was created

Throws:

SQLException - if an error occurs while creating the builder