V
- The result type returned by this Future's get
methodX
- The type of the Exception thrown by the Future's checkedGet
methodCheckedFuture
cannot properly support the chained operations that are the
primary goal of ListenableFuture
. CheckedFuture
also encourages users to
rethrow exceptions from one thread in another thread, producing misleading stack traces.
Additionally, it has a surprising policy about which exceptions to map and which to leave
untouched. Guava users who want a CheckedFuture
can fork the classes for their own
use, possibly specializing them to the particular exception type they use. We recommend that
most people use ListenableFuture
and perform any exception wrapping themselves. This
class is scheduled for removal from Guava in January 2019.@Beta @Deprecated @GwtIncompatible public abstract class ForwardingCheckedFuture<V,X extends java.lang.Exception> extends ForwardingListenableFuture<V> implements CheckedFuture<V,X>
Most subclasses can simply extend ForwardingCheckedFuture.SimpleForwardingCheckedFuture
.
Modifier and Type | Class and Description |
---|---|
static class |
ForwardingCheckedFuture.SimpleForwardingCheckedFuture<V,X extends java.lang.Exception>
Deprecated.
CheckedFuture cannot properly support the chained operations that are the
primary goal of ListenableFuture . CheckedFuture also encourages users to
rethrow exceptions from one thread in another thread, producing misleading stack traces.
Additionally, it has a surprising policy about which exceptions to map and which to leave
untouched. Guava users who want a CheckedFuture can fork the classes for their own
use, possibly specializing them to the particular exception type they use. We recommend
that most people use ListenableFuture and perform any exception wrapping
themselves. This class is scheduled for removal from Guava in October 2018. |
ForwardingListenableFuture.SimpleForwardingListenableFuture<V>
ForwardingFuture.SimpleForwardingFuture<V>
Constructor and Description |
---|
ForwardingCheckedFuture()
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
V |
checkedGet()
Deprecated.
Exception checking version of
Future.get() that will translate InterruptedException , CancellationException and ExecutionException into
application-specific exceptions. |
V |
checkedGet(long timeout,
java.util.concurrent.TimeUnit unit)
Deprecated.
Exception checking version of
Future.get(long, TimeUnit) that will translate InterruptedException , CancellationException and ExecutionException into
application-specific exceptions. |
protected abstract CheckedFuture<V,X> |
delegate()
Deprecated.
Returns the backing delegate instance that methods are forwarded to.
|
addListener
cancel, get, get, isCancelled, isDone
toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
addListener
public ForwardingCheckedFuture()
@CanIgnoreReturnValue public V checkedGet() throws X extends java.lang.Exception
CheckedFuture
Future.get()
that will translate InterruptedException
, CancellationException
and ExecutionException
into
application-specific exceptions.checkedGet
in interface CheckedFuture<V,X extends java.lang.Exception>
X
- on interruption, cancellation or execution exceptions.X extends java.lang.Exception
@CanIgnoreReturnValue public V checkedGet(long timeout, java.util.concurrent.TimeUnit unit) throws java.util.concurrent.TimeoutException, X extends java.lang.Exception
CheckedFuture
Future.get(long, TimeUnit)
that will translate InterruptedException
, CancellationException
and ExecutionException
into
application-specific exceptions. On timeout this method throws a normal TimeoutException
.checkedGet
in interface CheckedFuture<V,X extends java.lang.Exception>
java.util.concurrent.TimeoutException
- if retrieving the result timed out.X
- on interruption, cancellation or execution exceptions.X extends java.lang.Exception
protected abstract CheckedFuture<V,X> delegate()
ForwardingObject
ForwardingSet.delegate()
. Concrete subclasses override this method to supply the
instance being decorated.delegate
in class ForwardingListenableFuture<V>
Copyright © 2010–2019 JBoss by Red Hat. All rights reserved.