org.cojen.dirmi

Class SessionAccess

java.lang.Object

org.cojen.dirmi.SessionAccess

public class SessionAccess
extends Object

Provides session link access for client-side and server-side remote objects.

Author:

Brian S O'Neill

See Also:

SessionAware

Method Summary

Modifier and Type	Method and Description
static Link	current() Returns the current thread-local session link.
static Link	obtain(Remote obj) Returns the link for the session that a client-side remote object is bound to.
static Link	tryCurrent() Returns the current thread-local session link.
static Link	tryObtain(Remote obj) Returns the link for the session that a client-side remote object is bound to.

Methods inherited from class java.lang.Object

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

Method Detail

current

public static Link current()

Returns the current thread-local session link. The current link is set immediately before invoking a method for a SessionAware remote object, and it is cleared when the method returns. Closing the link closes the session.

Throws:

IllegalStateException - if no link is currently available, possibly because remote object doesn't implement SessionAware

tryCurrent

public static Link tryCurrent()

Returns the current thread-local session link. The current link is set immediately before invoking a method for a SessionAware remote object, and it is cleared when the method returns. Closing the link closes the session.

Returns:

null if no link is currently available, possibly because remote object doesn't implement SessionAware

obtain

public static Link obtain(Remote obj)

Returns the link for the session that a client-side remote object is bound to.

Throws:

IllegalArgumentException - if object is not a client-side remote object stub

tryObtain

public static Link tryObtain(Remote obj)

Returns the link for the session that a client-side remote object is bound to.

Returns:

null if object is not a client-side remote object stub