V
- the value typepublic class AsyncResult<V> extends 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) |
CompletableFuture<V> |
completable() |
static <V> org.springframework.util.concurrent.ListenableFuture<V> |
forExecutionException(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,
TimeUnit unit) |
boolean |
isCancelled() |
boolean |
isDone() |
public AsyncResult(@Nullable V value)
value
- the value to pass throughpublic boolean cancel(boolean mayInterruptIfRunning)
public boolean isCancelled()
isCancelled
in interface Future<V>
@Nullable public V get() throws ExecutionException
get
in interface Future<V>
ExecutionException
@Nullable public V get(long timeout, TimeUnit unit) throws ExecutionException
get
in interface Future<V>
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 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(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