org.apache.geronimo.clustering
Interface ClusteredInvocation

All Known Implementing Classes:

AbstractClusteredPreHandler.WebClusteredInvocation, AbstractClusteredValve.WebClusteredInvocation, WADIClusteredPreHandler.WADIWebClusteredInvocation, WADIClusteredValve.WADIWebClusteredInvocation

public interface ClusteredInvocation

Represents a clustered invocation.

A clustered invocation is intended to be a thin wrapper around an actual invocation enhancing this latter with an association to a local SessionManager. For instance, an HTTPRequest is an actual invocation.

A clustered invocation is interposed between a client and the Session he wants to access to provide cluster wide access serialization to the requested Session. A clustered invocation is associated to a local SessionManager, even if no contract captures such a relationship. When a clustered invocation is executed one of the two following scenarios happen:

• the clustered invocation is executed locally. A local execution implies that the local SessionManager associated to the clustered invocation is owning the Session (may be after a migration); or
• the clustered invocation is executed remotely on the Node where the Session is being owned.

Method Summary

String	getRequestedSessionId() Gets the sessionId of the Session bound to the invocation represented by this instance.
void	invoke() Invokes the clustered invocation.

Method Detail

invoke

void invoke()
            throws ClusteredInvocationException

Invokes the clustered invocation.

Throws:

ClusteredInvocationException - Thrown when the invocation cannot be successfully executed. This may be either due to the fact that the actual invocation has failed or the requestedSessionId is unknown by the associated local SessionManager and its remote peers.

getRequestedSessionId

String getRequestedSessionId()

Gets the sessionId of the Session bound to the invocation represented by this instance.

Returns:

sessionId of the targeted Session.