Skip navigation links

oracle.jdbc.pool
Class OracleConnectionCacheManager

java.lang.Object
oracle.jdbc.pool.OracleConnectionCacheManager

Deprecated. Use Oracle Universal Connection Pool instead. Connection Cache Manager class for the Implicit Connection Caching Mechanism.

public class OracleConnectionCacheManager

extends Object

Field Summary

protected static String	EVENT_DELIMITER Deprecated.
protected static int	FAILOVER_EVENT_TYPE_HOST Deprecated.
protected static int	FAILOVER_EVENT_TYPE_SERVICE Deprecated.
protected int	failoverEnabledCacheCount Deprecated.
protected oracle.jdbc.pool.OracleFailoverEventHandlerThread	failoverEventHandlerThread Deprecated.
protected int[]	fatalErrorCodes Deprecated.
protected Hashtable	m_connCache Deprecated.
static String	PHYSICAL_CONNECTION_CLOSED_COUNT Deprecated.
static String	PHYSICAL_CONNECTION_CREATED_COUNT Deprecated.
static int	REFRESH_ALL_CONNECTIONS Deprecated.
static int	REFRESH_INVALID_CONNECTIONS Deprecated.
static boolean	TRACE Deprecated.
protected static AtomicInteger	UNNAMED_CACHE_COUNT Deprecated.

Method Summary

protected void	checkAndStartThread(Thread thr) Deprecated. Check and start the Failover thread.
protected void	cleanupFCFEventHandlerThread() Deprecated.
protected void	cleanupFCFThreads(oracle.jdbc.pool.OracleImplicitConnectionCache oicc) Deprecated.
protected void	cleanupFCFWorkerThread(oracle.jdbc.pool.OracleImplicitConnectionCache oicc) Deprecated.
String	createCache(OracleDataSource ods, Properties cacheProperties) Deprecated. Use Oracle Universal Connection Pool instead. Creates a connection cache using an auto-generated Connection Cache name, and the supplied Connection Cache Properties. The Connection Cache created is associated with the DataSource Object provided.
void	createCache(String cacheName, OracleDataSource ods, Properties cacheProperties) Deprecated. Use Oracle Universal Connection Pool instead. Creates a connection cache using the supplied Connection Cache name, and the Connection Cache Properties. The Connection Cache created is associated with the DataSource Object provided.
void	disableCache(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Disable a given connection cache
void	enableCache(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Enable a given connection cache
boolean	existsCache(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Check if connection cache exists.
protected boolean	failoverEnabledCacheExists() Deprecated.
String[]	getCacheNameList() Deprecated. Use Oracle Universal Connection Pool instead. Get all the cache names managed by this connection cache manager
Properties	getCacheProperties(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Get the connection cache properties corresponding to the cache name.
static OracleConnectionCacheManager	getConnectionCacheManagerInstance() Deprecated. Use Oracle Universal Connection Pool instead. Returns the static ConnectionCacheManager Instance. If necessary a new instance is created and returned to the caller.
protected oracle.jdbc.internal.OracleConnection	getConnectionDuringExceptionHandling() Deprecated.
int[]	getConnectionErrorCodes() Deprecated.
int	getNumberOfActiveConnections(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Get the number of connections already in use (checked out connections)
int	getNumberOfAvailableConnections(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Get the number connections in the cache, that are available for use
Map	getStatistics(String cacheName) Deprecated. Use Oracle Universal Connection Pool instead. Get the statistics about the implicit connection cache. The stats contains the number of connections opened and the number of connections closed.
boolean	isFatalConnectionError(SQLException se) Deprecated.
protected void	parseRuntimeLoadBalancingEvent(String service, byte[] eventBody) Deprecated.
void	purgeCache(String cacheName, boolean cleanupCheckedOutConnections) Deprecated. Use Oracle Universal Connection Pool instead. Purges Connections in the Connection Cache. A boolean flag indicates whether all connections in the cache are cleaned up(including checkedout connections) or just the connections in the cache
void	refreshCache(String cacheName, int mode) Deprecated. Use Oracle Universal Connection Pool instead. Refreshes Connections in the Connection Cache.
void	reinitializeCache(String cacheName, Properties cacheProperties) Deprecated. Use Oracle Universal Connection Pool instead. Reinitialize a connection cache using the new set of properties supplied
void	removeCache(String cacheName, long waitTimeout) Deprecated. Use Oracle Universal Connection Pool instead. Removes the Connection Cache, associated with the given Connection Cache Name. When a timeout value is specified, the remove processing pauses for the specified period of time, before proceeding to remove the connection cache.
void	setConnectionErrorCodes(int[] fatalErrorCodes) Deprecated.
void	setConnectionPoolDataSource(String cacheName, ConnectionPoolDataSource ds) Deprecated. Use Oracle Universal Connection Pool instead. Sets the ConnectionPoolDataSource that may be used to create the implicit connection cache. If the connections are already created on the connection cache, then an exception is thrown. If no connections are opened, then the new ConnectionPoolDataSource is used and may overwrite the previous one, if any.
protected void	verifyAndHandleEvent(int eventType, byte[] eventBody) Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

m_connCache

protected Hashtable m_connCache

Deprecated.

REFRESH_INVALID_CONNECTIONS

public static final int REFRESH_INVALID_CONNECTIONS

Deprecated.

See Also:

Constant Field Values

REFRESH_ALL_CONNECTIONS

public static final int REFRESH_ALL_CONNECTIONS

Deprecated.

See Also:

Constant Field Values

PHYSICAL_CONNECTION_CREATED_COUNT

public static final String PHYSICAL_CONNECTION_CREATED_COUNT

Deprecated.

See Also:

Constant Field Values

PHYSICAL_CONNECTION_CLOSED_COUNT

public static final String PHYSICAL_CONNECTION_CLOSED_COUNT

Deprecated.

See Also:

Constant Field Values

FAILOVER_EVENT_TYPE_SERVICE

protected static final int FAILOVER_EVENT_TYPE_SERVICE

Deprecated.

See Also:

Constant Field Values

FAILOVER_EVENT_TYPE_HOST

protected static final int FAILOVER_EVENT_TYPE_HOST

Deprecated.

See Also:

Constant Field Values

EVENT_DELIMITER

protected static final String EVENT_DELIMITER

Deprecated.

See Also:

Constant Field Values

failoverEventHandlerThread

protected oracle.jdbc.pool.OracleFailoverEventHandlerThread failoverEventHandlerThread

Deprecated.

fatalErrorCodes

protected int[] fatalErrorCodes

Deprecated.

failoverEnabledCacheCount

protected int failoverEnabledCacheCount

Deprecated.

UNNAMED_CACHE_COUNT

protected static AtomicInteger UNNAMED_CACHE_COUNT

Deprecated.

TRACE

public static final boolean TRACE

Deprecated.

See Also:

Constant Field Values

Method Detail

getConnectionCacheManagerInstance

public static OracleConnectionCacheManager getConnectionCacheManagerInstance()
                                                                      throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Returns the static ConnectionCacheManager Instance. If necessary a new instance is created and returned to the caller.

Parameters:

None -

Returns:

OracleConnectionCacheManager object

Throws:

SQLException - if a database access error occurs

createCache

public String createCache(OracleDataSource ods,
                          Properties cacheProperties)
                   throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Creates a connection cache using an auto-generated Connection Cache name, and the supplied Connection Cache Properties. The Connection Cache created is associated with the DataSource Object provided.

Parameters:

ods - OracleDataSource object

cacheProperties - Connection Cache Properties for this cache

Returns:

The auto-generated Connection Cache Name

Throws:

SQLException - if a database access error occurs

createCache

public void createCache(String cacheName,
                        OracleDataSource ods,
                        Properties cacheProperties)
                 throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Creates a connection cache using the supplied Connection Cache name, and the Connection Cache Properties. The Connection Cache created is associated with the DataSource Object provided.

Parameters:

cacheName - Connection Cache Name

ods - OracleDataSource object

cacheProperties - Connection Cache Properties for this cache

Throws:

SQLException - if a database access error occurs

removeCache

public void removeCache(String cacheName,
                        long waitTimeout)
                 throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Removes the Connection Cache, associated with the given Connection Cache Name. When a timeout value is specified, the remove processing pauses for the specified period of time, before proceeding to remove the connection cache.

Parameters:

cacheName - Connection Cache Name

waitTimeout - Timeout value, specified in seconds. A zero or a positive value will be the time allowed before closure of the cache. A negative timeout prompts aborting all the connections before close.

Throws:

SQLException - if a database access error occurs

reinitializeCache

public void reinitializeCache(String cacheName,
                              Properties cacheProperties)
                       throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Reinitialize a connection cache using the new set of properties supplied

Parameters:

cacheName - Connection Cache Name

Throws:

SQLException - if a database access error occurs

existsCache

public boolean existsCache(String cacheName)
                    throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Check if connection cache exists.

Parameters:

cacheName - Connection Cache Name

Returns:

true or false, depending on whether the Connection Cache exists

Throws:

SQLException - if a database access error occurs

enableCache

public void enableCache(String cacheName)
                 throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Enable a given connection cache

Parameters:

cacheName - Connection Cache Name

Throws:

SQLException - if a database access error occurs

disableCache

public void disableCache(String cacheName)
                  throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Disable a given connection cache

Parameters:

cacheName - Connection Cache Name

Throws:

SQLException - if a database access error occurs

refreshCache

public void refreshCache(String cacheName,
                         int mode)
                  throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Refreshes Connections in the Connection Cache.

Parameters:

cacheName - Connection Cache Name

mode - The operation to be done on the cache. Operation modes are, REFRESH_INVALID_CONNECTIONS - Refresh invalid connection on the node which is down. REFRESH_ALL_CONNECTIONS - Refresh all connection on the node which is down.

Throws:

SQLException - if a database access error occurs

purgeCache

public void purgeCache(String cacheName,
                       boolean cleanupCheckedOutConnections)
                throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Purges Connections in the Connection Cache. A boolean flag indicates whether all connections in the cache are cleaned up(including checkedout connections) or just the connections in the cache

Parameters:

cacheName - Connection Cache Name

Throws:

SQLException - if a database access error occurs

getCacheProperties

public Properties getCacheProperties(String cacheName)
                              throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Get the connection cache properties corresponding to the cache name.

Parameters:

cacheName - Connection Cache Name

Returns:

Connection Cache Properties

Throws:

SQLException - if a database access error occurs

getCacheNameList

public String[] getCacheNameList()
                          throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Get all the cache names managed by this connection cache manager

Parameters:

None -

Returns:

List of Connection Cache Names, returned as a String Array

Throws:

SQLException - if a database access error occurs

getNumberOfAvailableConnections

public int getNumberOfAvailableConnections(String cacheName)
                                    throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Get the number connections in the cache, that are available for use

Parameters:

cacheName - Connection Cache Name

Returns:

Number of Connections in the Cache

Throws:

SQLException - if a database access error occurs

getNumberOfActiveConnections

public int getNumberOfActiveConnections(String cacheName)
                                 throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Get the number of connections already in use (checked out connections)

Parameters:

cacheName - Connection Cache Name

Returns:

Number of Connections checked out

Throws:

SQLException - if a database access error occurs

setConnectionPoolDataSource

public void setConnectionPoolDataSource(String cacheName,
                                        ConnectionPoolDataSource ds)
                                 throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Sets the ConnectionPoolDataSource that may be used to create the implicit connection cache. If the connections are already created on the connection cache, then an exception is thrown. If no connections are opened, then the new ConnectionPoolDataSource is used and may overwrite the previous one, if any.

Parameters:

cacheName - Connection Cache Name

ds - a datasource from which the Implicit Cache can create PooledConnections.

Throws:

SQLException - A ConnectionPoolDataSource object already exists and connections are already open.

verifyAndHandleEvent

protected void verifyAndHandleEvent(int eventType,
                                    byte[] eventBody)
                             throws SQLException

Deprecated.

Throws:

SQLException

checkAndStartThread

protected void checkAndStartThread(Thread thr)
                            throws SQLException

Deprecated.

Check and start the Failover thread. isAlive() returns false, only if the thread state is (1) New thread (2) Terminated

Throws:

SQLException

failoverEnabledCacheExists

protected boolean failoverEnabledCacheExists()

Deprecated.

parseRuntimeLoadBalancingEvent

protected void parseRuntimeLoadBalancingEvent(String service,
                                              byte[] eventBody)
                                       throws SQLException

Deprecated.

Throws:

SQLException

cleanupFCFThreads

protected void cleanupFCFThreads(oracle.jdbc.pool.OracleImplicitConnectionCache oicc)
                          throws SQLException

Deprecated.

Throws:

SQLException

cleanupFCFWorkerThread

protected void cleanupFCFWorkerThread(oracle.jdbc.pool.OracleImplicitConnectionCache oicc)
                               throws SQLException

Deprecated.

Throws:

SQLException

cleanupFCFEventHandlerThread

protected void cleanupFCFEventHandlerThread()
                                     throws SQLException

Deprecated.

Throws:

SQLException

isFatalConnectionError

public boolean isFatalConnectionError(SQLException se)

Deprecated.

setConnectionErrorCodes

public void setConnectionErrorCodes(int[] fatalErrorCodes)
                             throws SQLException

Deprecated.

Throws:

SQLException

getConnectionErrorCodes

public int[] getConnectionErrorCodes()
                              throws SQLException

Deprecated.

Throws:

SQLException

getStatistics

public Map getStatistics(String cacheName)
                  throws SQLException

Deprecated. Use Oracle Universal Connection Pool instead. Get the statistics about the implicit connection cache. The stats contains the number of connections opened and the number of connections closed.

Parameters:

cacheName - Name of the cache

Returns:

A map file containing the value of key: CONNECTION_CREATED_COUNT Number of connections opened. key: CONNECTION_CLOSED_COUNT Number of connections closed.

Throws:

SQLException

getConnectionDuringExceptionHandling

protected oracle.jdbc.internal.OracleConnection getConnectionDuringExceptionHandling()

Deprecated.

Skip navigation links