oracle.toplink.essentials.threetier

Class ExternalConnectionPool

java.lang.Object

oracle.toplink.essentials.threetier.ConnectionPool

oracle.toplink.essentials.threetier.ExternalConnectionPool

public class ExternalConnectionPool
extends ConnectionPool

Purpose: This subclass is intended to be used with external connection pools. For these pools, TopLink does not control the pooling behaviour. The login should have the usesExternalConnectionPooling set to "true".

Field Summary

Fields

Modifier and Type	Field and Description
protected Accessor	cachedConnection

Fields inherited from class oracle.toplink.essentials.threetier.ConnectionPool

connectionsAvailable, connectionsUsed, isConnected, login, maxNumberOfConnections, minNumberOfConnections, name, owner

Constructor Summary

Constructors

Constructor and Description
ExternalConnectionPool() PUBLIC: Build a new external connection pool.
ExternalConnectionPool(java.lang.String name, Login login, ServerSession owner) PUBLIC: Build a new external connection pool.

Method Summary

Modifier and Type	Method and Description
Accessor	acquireConnection() INTERNAL: When we acquire a connection from an ExternalConnectionPool we build a new connection (retrieve it from the external pool).
protected Accessor	getCachedConnection() INTERNAL: Return the currently cached connection to the external connection pool
boolean	hasConnectionAvailable() INTERNAL: Assume true as the driver is responsible for blocking.
boolean	isThereConflictBetweenLoginAndType() INTERNAL: Checks for a conflict between pool's type and pool's login
void	releaseConnection(Accessor connection) INTERNAL: When you release an external connection, you simply let it go.
protected void	setCachedConnection(Accessor cachedConnection) Set the currently cached connection to the external connection pool.
void	shutDown() INTERNAL: This mehtod is a no-op for external pools.
void	startUp() INTERNAL: Build the default connection.

Methods inherited from class oracle.toplink.essentials.threetier.ConnectionPool

buildConnection, getConnectionsAvailable, getConnectionsUsed, getLogin, getMaxNumberOfConnections, getMinNumberOfConnections, getName, getOwner, getTotalNumberOfConnections, isConnected, resetConnections, setConnectionsAvailable, setConnectionsUsed, setIsConnected, setLogin, setMaxNumberOfConnections, setMinNumberOfConnections, setName, setOwner, toString

Methods inherited from class java.lang.Object

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

Field Detail

cachedConnection

protected Accessor cachedConnection

Constructor Detail

ExternalConnectionPool

public ExternalConnectionPool()

PUBLIC: Build a new external connection pool. The JDBC driver is responsible for pooling the connections.

ExternalConnectionPool

public ExternalConnectionPool(java.lang.String name,
                              Login login,
                              ServerSession owner)

PUBLIC: Build a new external connection pool. The JDBC driver is responsible for pooling the connections.

Method Detail

acquireConnection

public Accessor acquireConnection()
                           throws ConcurrencyException

INTERNAL: When we acquire a connection from an ExternalConnectionPool we build a new connection (retrieve it from the external pool).

Overrides:

acquireConnection in class ConnectionPool

Throws:

ConcurrencyException

getCachedConnection

protected Accessor getCachedConnection()

INTERNAL: Return the currently cached connection to the external connection pool

Returns:

oracle.toplink.essentials.internal.databaseaccess.Accessor

hasConnectionAvailable

public boolean hasConnectionAvailable()

INTERNAL: Assume true as the driver is responsible for blocking.

Overrides:

hasConnectionAvailable in class ConnectionPool

isThereConflictBetweenLoginAndType

public boolean isThereConflictBetweenLoginAndType()

INTERNAL: Checks for a conflict between pool's type and pool's login

Overrides:

isThereConflictBetweenLoginAndType in class ConnectionPool

releaseConnection

public void releaseConnection(Accessor connection)
                       throws DatabaseException

INTERNAL: When you release an external connection, you simply let it go.

Overrides:

releaseConnection in class ConnectionPool

Throws:

DatabaseException

setCachedConnection

protected void setCachedConnection(Accessor cachedConnection)

Set the currently cached connection to the external connection pool.

Parameters:

oracle.toplink.essentials.internal.databaseaccess.Accessor -

shutDown

public void shutDown()

INTERNAL: This mehtod is a no-op for external pools.

Overrides:

shutDown in class ConnectionPool

startUp

public void startUp()

INTERNAL: Build the default connection. This validates that connect will work and sets up the parent accessor to clone.

Overrides:

startUp in class ConnectionPool