org.jboss.invocation

Interface AsynchronousInterceptor

All Known Implementing Classes:

ExecutorAsynchronousInterceptor, QueuedAsynchronousInterceptor, SynchronousInterceptor

public interface AsynchronousInterceptor

An asynchronous interceptor, which can optionally defer execution to another thread or later time without blocking.

Author:

David M. Lloyd

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	AsynchronousInterceptor.CancellationHandle A handle for cancellation of an asynchronous invocation request.
static interface	AsynchronousInterceptor.ResultHandler A handler for the result of a method invocation.
static interface	AsynchronousInterceptor.ResultSupplier The invocation result supplier, which returns the invocation result or propagates its exception.

Field Summary

Fields

Modifier and Type	Field and Description
static AsynchronousInterceptor[]	EMPTY_ARRAY An empty asynchronous interceptor array.

Method Summary

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

Field Detail

EMPTY_ARRAY

static final AsynchronousInterceptor[] EMPTY_ARRAY

An empty asynchronous interceptor array.

Method Detail

processInvocation

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

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.

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)