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) |
java.util.concurrent.CompletableFuture<V> |
completable() |
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(@Nullable 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>
@Nullable public V get() throws java.util.concurrent.ExecutionException
get
in interface java.util.concurrent.Future<V>
java.util.concurrent.ExecutionException
@Nullable public 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.ExecutionException
public 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 java.util.concurrent.CompletableFuture<V> completable()
completable
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