oracle.wcc.ridc.adfca.session

Class RidcSessionPoolManager

java.lang.Object

oracle.wcc.ridc.adfca.session.RidcSessionPoolManager

All Implemented Interfaces:

Serializable, oracle.adf.share.ADFScopeListener

public final class RidcSessionPoolManager
extends Object
implements oracle.adf.share.ADFScopeListener, Serializable

Manages content connections associated with ADF session scopes. An ADF session scope is equivalent to an HttpSession for a suitably initialized ADF HTTP application, e.g. initialized by means of ADFBindingFilter. RidcSessionPoolManager is by design intended to manage the connections for a single user.

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
static RidcSessionPoolManager	getCurrent() Gets the RidcSessionPoolManager associated with the session scope of the current ADF Context.
RidcSessionPool	getSessionPool(String connectionName) Gets an ADF session-scoped session pool for the named connection.
void	scopeInvalidated(String scopeName) RidcSessionPoolManager is an ADFScopeListener and is registered with the ADF session scope to be notified when the session scope is invalidated (i.e.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getCurrent

public static RidcSessionPoolManager getCurrent()

Gets the RidcSessionPoolManager associated with the session scope of the current ADF Context. The RidcSessionPoolManager object is (initially saved to and subsequently) retrieved from the user's ADFSessionScope under the key oracle.wcc.ridc.adfca.session.RidcSessionPoolManager_<user>. This method has a dependency on the app having correctly initialized ADF (such as using the ADFBindingFilter). In the case where ADF has been initialized associated with a servlet, the ADFSessionScope will be back by the HTTP servlet's session. If no such RidcSessionPoolManager is stored by this key in the callers ADFSessionScope, then a new RidcSessionPoolManager is created and stored in the ADF session scope. The RidcSessionPoolManager is by design intended to manage the connections for a single user.

Returns:

The session's connection manager.

getSessionPool

public RidcSessionPool getSessionPool(String connectionName)
                               throws NamingException,
                                      IdcClientException

Gets an ADF session-scoped session pool for the named connection. (i.e. a pool of RIDC sessions [typically of size 1] that can be used by a single ADF session (~= HttpSession) instance to invoke service calls against the UCM server associated with the connection). A pool size greater than one may result for example when concurrent downloads are triggered.

Parameters:

connectionName - The JNDI connection name

Returns:

The session pool allowing access to an RidcSession (which in turn wraps an IdcContext instance and IdcClient instance)

Throws:

NamingException - If the connection name does not point to a valid RIDC connection

IdcClientException - If the one-time initial connection check associated with the RidcConnection fails

scopeInvalidated

public void scopeInvalidated(String scopeName)

RidcSessionPoolManager is an ADFScopeListener and is registered with the ADF session scope to be notified when the session scope is invalidated (i.e. destroyed). Invalidation of the session scope causes all connections cached for scope to be closed.

Specified by:

scopeInvalidated in interface oracle.adf.share.ADFScopeListener

Parameters:

scopeName - The name of the scope.

toString

public String toString()

Overrides:

toString in class Object