public class AsyncResult<V>
extends java.lang.Object
implements org.springframework.util.concurrent.ListenableFuture<V>
Future handle that can be used for method signatures
which are declared with a Future return type for asynchronous execution.
As of Spring 4.1, this class implements ListenableFuture, not just
plain Future, along with the corresponding support
in @Async processing.
As of Spring 4.2, this class also supports passing execution exceptions back to the caller.
Async,
forValue(Object),
forExecutionException(Throwable)| Constructor and Description |
|---|
AsyncResult(V value)
Create a new AsyncResult holder.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addCallback(org.springframework.util.concurrent.ListenableFutureCallback<? super V> callback) |
void |
addCallback(org.springframework.util.concurrent.SuccessCallback<? super V> successCallback,
org.springframework.util.concurrent.FailureCallback failureCallback) |
boolean |
cancel(boolean mayInterruptIfRunning) |
static <V> org.springframework.util.concurrent.ListenableFuture<V> |
forExecutionException(java.lang.Throwable ex)
Create a new async result which exposes the given exception as an
ExecutionException from Future.get(). |
static <V> org.springframework.util.concurrent.ListenableFuture<V> |
forValue(V value)
Create a new async result which exposes the given value from
Future.get(). |
V |
get() |
V |
get(long timeout,
java.util.concurrent.TimeUnit unit) |
boolean |
isCancelled() |
boolean |
isDone() |
public AsyncResult(V value)
value - the value to pass throughpublic boolean cancel(boolean mayInterruptIfRunning)
cancel in interface java.util.concurrent.Future<V>public boolean isCancelled()
isCancelled in interface java.util.concurrent.Future<V>public boolean isDone()
isDone in interface java.util.concurrent.Future<V>public V get() throws java.util.concurrent.ExecutionException
get in interface java.util.concurrent.Future<V>java.util.concurrent.ExecutionExceptionpublic V get(long timeout, java.util.concurrent.TimeUnit unit) throws java.util.concurrent.ExecutionException
get in interface java.util.concurrent.Future<V>java.util.concurrent.ExecutionExceptionpublic void addCallback(org.springframework.util.concurrent.ListenableFutureCallback<? super V> callback)
addCallback in interface org.springframework.util.concurrent.ListenableFuture<V>public void addCallback(org.springframework.util.concurrent.SuccessCallback<? super V> successCallback, org.springframework.util.concurrent.FailureCallback failureCallback)
addCallback in interface org.springframework.util.concurrent.ListenableFuture<V>public static <V> org.springframework.util.concurrent.ListenableFuture<V> forValue(V value)
Future.get().value - the value to exposeFuture.get()public static <V> org.springframework.util.concurrent.ListenableFuture<V> forExecutionException(java.lang.Throwable ex)
ExecutionException from Future.get().ex - the exception to expose (either an pre-built ExecutionException
or a cause to be wrapped in an ExecutionException)ExecutionException