org.jboss.invocation

Class ExecutorAsynchronousInterceptor

java.lang.Object

org.jboss.invocation.ExecutorAsynchronousInterceptor

All Implemented Interfaces:

AsynchronousInterceptor

public final class ExecutorAsynchronousInterceptor
extends Object
implements AsynchronousInterceptor

An interceptor which dispatches to an executor.

Author:

David M. Lloyd

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.invocation.AsynchronousInterceptor

AsynchronousInterceptor.CancellationHandle, AsynchronousInterceptor.ResultHandler, AsynchronousInterceptor.ResultSupplier

Field Summary

Fields inherited from interface org.jboss.invocation.AsynchronousInterceptor

EMPTY_ARRAY

Constructor Summary

Constructors

Constructor and Description
ExecutorAsynchronousInterceptor(Executor executor, boolean onlyIfBlocking) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
AsynchronousInterceptor.CancellationHandle	processInvocation(AsynchronousInterceptorContext context, AsynchronousInterceptor.ResultHandler resultHandler) Process an invocation.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutorAsynchronousInterceptor

public ExecutorAsynchronousInterceptor(Executor executor,
                                       boolean onlyIfBlocking)

Construct a new instance.

Parameters:

executor - the executor to dispatch to (must not be null)

onlyIfBlocking - true to only dispatch invocations that are blocking the caller; false to dispatch all invocations

Method Detail

processInvocation

public AsynchronousInterceptor.CancellationHandle processInvocation(AsynchronousInterceptorContext context,
                                                                    AsynchronousInterceptor.ResultHandler resultHandler)

Description copied from interface: AsynchronousInterceptor

Process an invocation. The invocation can be handled directly, or passed on to the next processor in the chain. This method must eventually call a method on the given AsynchronousInterceptor.ResultHandler, otherwise the invocation may hang.

This method must return a handle which can be used to request cancellation.

Specified by:

processInvocation in interface AsynchronousInterceptor

Parameters:

context - the interceptor context (not null)

resultHandler - the handler for the invocation result (not null)

Returns:

a handle which can be used to request a cancellation of the invocation (must not be null)