oracle.ifs.beans

Class ClonedLibrarySessionManager

java.lang.Object

oracle.ifs.beans.ClonedLibrarySessionManager

public class ClonedLibrarySessionManager
extends Object

A ClonedLibrarySessionManager manages the cloned sessions on behalf of a master LibrarySession.

Version:

1.0

Author:

Dave Long

(Published)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ClonedLibrarySessionManager.ClonedSessionExecutor An Executor that handles the management of cloned sessions.
class	ClonedLibrarySessionManager.IncreasePoolTask IncreasePoolTask results in creating new unallocated sessions in the session pool.
class	ClonedLibrarySessionManager.RequestSessionCreationTask RequestSessionCreationTask creates a new cloned session, and posts a SessionCreationAcknowledgementTask back to the main thread.
class	ClonedLibrarySessionManager.RequestShutdownTask RequestShutdownTask requests the executor to shut down.
class	ClonedLibrarySessionManager.ReserveSessionTask ReserveSessionTask reserves a cloned session in the executor's thread.
class	ClonedLibrarySessionManager.SessionCreationAcknowledgementTask SessionCreationAcknowledgementTask results in creating new unallocated sessions in the session pool.
class	ClonedLibrarySessionManager.SessionCreatorExecutor An Executor that handles the creation of new cloned sessions.
class	ClonedLibrarySessionManager.UnreserveSessionTask UnreserveSessionTask unreserves a cloned session in the executor's thread.

Constructor Summary

Constructors

Constructor and Description
ClonedLibrarySessionManager(LibrarySession session) Construct a ClonedLibrarySessionManager.

Method Summary

Modifier and Type	Method and Description
void	createClonedSession() Creates a cloned session without reserving it, which will increase the number of pooled cloned sessions.
LibrarySession	getMasterSession() Returns the master session used to clone other sessions.
void	requestShutdown() Request a shutdown of this ClonedLibrarySessionManager.
LibrarySession	reserveClonedSession() Reserves a cloned session.
LibrarySession	reserveClonedSession(long retryDelay) Reserves a cloned session.
void	unreserveClonedSession(LibrarySession sess) Unreserves a cloned session.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClonedLibrarySessionManager

public ClonedLibrarySessionManager(LibrarySession session)
                            throws IfsException

Construct a ClonedLibrarySessionManager.

Parameters:

session - the master LibrarySession

Throws:

IfsException - if operation fails.

(Published)

Method Detail

getMasterSession

public LibrarySession getMasterSession()

Returns the master session used to clone other sessions.

Returns:

the master session

(Published)

reserveClonedSession

public LibrarySession reserveClonedSession()
                                    throws IfsException

Reserves a cloned session.

Returns:

the reserved cloned session

Throws:

IfsException - if the operation fails

(Unpublished)

reserveClonedSession

public LibrarySession reserveClonedSession(long retryDelay)
                                    throws IfsException

Reserves a cloned session.

Parameters:

retryDelay - the delay before retrying in case we have hit max pool size

Returns:

the reserved cloned session

Throws:

IfsException - if the operation fails

(Unpublished)

unreserveClonedSession

public void unreserveClonedSession(LibrarySession sess)

Unreserves a cloned session.

Parameters:

sess - the previously reserved cloned session to unreserve

(Unpublished)

createClonedSession

public void createClonedSession()
                         throws IfsException

Creates a cloned session without reserving it, which will increase the number of pooled cloned sessions.

Throws:

IfsException - if the operation fails

(Unpublished)

requestShutdown

public void requestShutdown()
                     throws IfsException

Request a shutdown of this ClonedLibrarySessionManager.

Throws:

IfsException - if an error occurs, or if the Manager has already terminated