org.jboss.ejb.client

Class TransactionInterceptor

java.lang.Object

org.jboss.ejb.client.TransactionInterceptor

All Implemented Interfaces:

EJBClientInterceptor

public final class TransactionInterceptor
extends Object
implements EJBClientInterceptor

The client interceptor which associates the current transaction with the invocation. Additionally, it influences discovery to "stick" load-balanced requests to a single node during the scope of a transaction.

Author:

David M. Lloyd, Jason T. Greene

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.ejb.client.EJBClientInterceptor

EJBClientInterceptor.Registration

Field Summary

Fields

Modifier and Type	Field and Description
static int	PRIORITY This interceptor's priority.

Constructor Summary

Constructors

Constructor and Description
TransactionInterceptor() Construct a new instance.

Method Summary

Modifier and Type	Method and Description
void	handleInvocation(EJBClientInvocationContext context) Handle the invocation.
Object	handleInvocationResult(EJBClientInvocationContext context) Handle the invocation result.
SessionID	handleSessionCreation(EJBSessionCreationInvocationContext context) Optionally handle a session creation invocation.

Methods inherited from class java.lang.Object

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

Field Detail

PRIORITY

public static final int PRIORITY

This interceptor's priority.

See Also:

Constant Field Values

Constructor Detail

TransactionInterceptor

public TransactionInterceptor()

Construct a new instance.

Method Detail

handleSessionCreation

public SessionID handleSessionCreation(EJBSessionCreationInvocationContext context)
                                throws Exception

Description copied from interface: EJBClientInterceptor

Optionally handle a session creation invocation. Explicit session creation is always a blocking operation. The default operation forwards to the next interceptor in the chain.

Specified by:

handleSessionCreation in interface EJBClientInterceptor

Parameters:

context - the session creation invocation context (not null)

Returns:

the stateful EJB locator (must not be null)

Throws:

Exception - if an invocation error occurred

handleInvocation

public void handleInvocation(EJBClientInvocationContext context)
                      throws Exception

Description copied from interface: EJBClientInterceptor

Handle the invocation. Implementations may short-circuit the invocation by throwing an exception. This method should process any per-interceptor state and call EJBClientInvocationContext.sendRequest().

Specified by:

handleInvocation in interface EJBClientInterceptor

Parameters:

context - the invocation context

Throws:

Exception - if an invocation error occurs

handleInvocationResult

public Object handleInvocationResult(EJBClientInvocationContext context)
                              throws Exception

Description copied from interface: EJBClientInterceptor

Handle the invocation result. The implementation should generally call EJBClientInvocationContext.getResult() immediately and perform any post-invocation cleanup task in a finally block.

Specified by:

handleInvocationResult in interface EJBClientInterceptor

Parameters:

context - the invocation context

Returns:

the invocation result, if any

Throws:

Exception - if an invocation error occurred