Class InternalFutureFailureAccess
java.lang.Object
com.google.common.util.concurrent.internal.InternalFutureFailureAccess
- Direct Known Subclasses:
AbstractFuture
A future that, if it fails, may optionally provide access to the cause of the failure.
This class is used only for micro-optimization. Standard Future utilities benefit from
this optimization, so there is no need to specialize methods to return or accept this type
instead of ListenableFuture.
This class is GWT-compatible.
- Since:
com.google.guava:failureaccess:1.0, which was added as a dependency of Guava in Guava 27.0
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedConstructor for use by subclasses. -
Method Summary
Modifier and TypeMethodDescriptionprotected abstract ThrowableUsually returnsnullbut, if thisFuturehas failed, may optionally return the cause of the failure.
-
Constructor Details
-
InternalFutureFailureAccess
protected InternalFutureFailureAccess()Constructor for use by subclasses.
-
-
Method Details
-
tryInternalFastPathGetFailure
Usually returnsnullbut, if thisFuturehas failed, may optionally return the cause of the failure. "Failure" means specifically "completed with an exception"; it does not include "was cancelled." To be explicit: If this method returns a non-null value, then:isDone()must returntrueisCancelled()must returnfalseget()must not block, and it must throw anExecutionExceptionwith the return value of this method as its cause
This method is
protectedso that classes likecom.google.common.util.concurrent.SettableFuturedo not expose it to their users as an instance method. In the unlikely event that you need to call this method, callInternalFutures.tryInternalFastPathGetFailure(InternalFutureFailureAccess).
-