oracle.ifs.fdk
Class GuestSessionPool

java.lang.Object
oracle.ifs.fdk.GuestSessionPool

public abstract class GuestSessionPool

extends java.lang.Object

This is a pool of guest FdkSessions. These sessions are very limited in their abilities and can generally only perform read-only actions, and those only on objects that give the appropriate permissions to World. There should be at most one instance of this class per-JVM.

Constructor Summary

GuestSessionPool()

Method Summary

abstract FdkSession	getGuestSession() Gets a guest session.
static GuestSessionPool	getInstance() Singleton method.
abstract void	releaseGuestSession(FdkSession sess) Indicate that you're done with a guest session.

Methods inherited from class java.lang.Object

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

Constructor Detail

GuestSessionPool

public GuestSessionPool()

Method Detail

getGuestSession

public abstract FdkSession getGuestSession()
                                    throws FdkException

Gets a guest session. General algorithm:

• if there are sessions in the pool, pop one off and return it
• otherwise, if we haven't reached our allocation limit, allocate a new one and return it
• otherwise, we've failed; return null

Sessions acquired with getGuestSession must be released with releaseGuestSession, probably in a finally block.

Returns:

a new guest session, or null if no more are available

Throws:

FdkException - if unable to allocate a new session

getInstance

public static GuestSessionPool getInstance()
                                    throws FdkException

Singleton method.

Returns:

the singleton GuestSessionPool

Throws:

FdkException

releaseGuestSession

public abstract void releaseGuestSession(FdkSession sess)

Indicate that you're done with a guest session. If the pool has less than its target, add session back to pool; otherwise disconnect it.