org.jboss.invocation

Class QueuedAsynchronousInterceptor

java.lang.Object

org.jboss.invocation.QueuedAsynchronousInterceptor

All Implemented Interfaces:

AsynchronousInterceptor

public final class QueuedAsynchronousInterceptor
extends Object
implements AsynchronousInterceptor

An interceptor which queues concurrent accesses such that only one invocation runs at a time. The invocations are run in FIFO (first-in, first-out) order.

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
QueuedAsynchronousInterceptor(Executor executor) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
void	cancelAll() Cancel all currently waiting invocations.
int	getQueueSize()
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

QueuedAsynchronousInterceptor

public QueuedAsynchronousInterceptor(Executor executor)

Construct a new instance.

Parameters:

executor - the executor to use to continue previously suspended invocations

Method Detail

cancelAll

public void cancelAll()

Cancel all currently waiting invocations.

getQueueSize

public int getQueueSize()

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)