public class AsyncExecutionInterceptor extends AsyncExecutionAspectSupport implements MethodInterceptor, Ordered
MethodInterceptorthat processes method invocations asynchronously, using a given
AsyncTaskExecutor. Typically used with the
In terms of target method signatures, any parameter types are supported.
However, the return type is constrained to either
java.util.concurrent.Future. In the latter case, the Future handle
returned from the proxy will be an actual asynchronous Future that can be used
to track the result of the asynchronous method execution. However, since the
target method needs to implement the same signature, it will have to return
a temporary Future handle that just passes the return value through
or EJB 3.1's
When the return type is
java.util.concurrent.Future, any exception thrown
during the execution can be accessed and managed by the caller. With
return type however, such exceptions cannot be transmitted back. In that case an
AsyncUncaughtExceptionHandler can be registered to process such exceptions.
As of Spring 3.1.2 the
AnnotationAsyncExecutionInterceptor subclass is
preferred for use due to its support for executor qualification in conjunction with
|Constructor and Description|
Create a new instance with a default
Create a new
|Modifier and Type||Method and Description|
This implementation is a no-op for compatibility in Spring 3.1.2.
Return the order value of this object, with a higher value meaning greater in terms of sorting.
Handles a fatal error thrown while asynchronously invoking the specified
Intercept the given method invocation, submit the actual calling of the method to the correct task executor and return immediately to the caller.
determineAsyncExecutor, setBeanFactory, setExecutor
public AsyncExecutionInterceptor(Executor defaultExecutor, AsyncUncaughtExceptionHandler exceptionHandler)
public void setExceptionHandler(AsyncUncaughtExceptionHandler exceptionHandler)
AsyncUncaughtExceptionHandlerto use to handle exceptions thrown by invoking asynchronous methods with a
public Object invoke(MethodInvocation invocation) throws Throwable
If the return type of the method is a
Future object, the original
exception can be propagated by just throwing it at the higher level. However,
for all other cases, the exception will not be transmitted back to the client.
In that later case, the current
AsyncUncaughtExceptionHandler will be
used to manage such exception.
ex- the exception to handle
method- the method that was invoked
params- the parameters used to invoke the method
method- the method to inspect for executor qualifier metadata
public int getOrder()
Normally starting with 0, with
indicating the greatest value. Same order values will result
in arbitrary positions for the affected objects.
Higher values can be interpreted as lower priority. As a consequence, the object with the lowest value has highest priority (somewhat analogous to Servlet "load-on-startup" values).