Package com.google.common.util.concurrent

Interface CheckedFuture<V,X extends Exception>

All Superinterfaces:

Future<V>, ListenableFuture<V>

All Known Implementing Classes:

AbstractCheckedFuture, ForwardingCheckedFuture, ForwardingCheckedFuture.SimpleForwardingCheckedFuture

@Beta
@Deprecated(since="2022-12-01")
public interface CheckedFuture<V,X extends Exception>
extends ListenableFuture<V>

Deprecated.

The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023

A CheckedFuture is a ListenableFuture that includes versions of the get methods that can throw a checked exception. This makes it easier to create a future that executes logic which can throw an exception.

A common implementation is Futures.immediateCheckedFuture(V).

Implementations of this interface must adapt the exceptions thrown by Future#get(): CancellationException, ExecutionException and InterruptedException into the type specified by the X type parameter.

This interface also extends the ListenableFuture interface to allow listeners to be added. This allows the future to be used as a normal Future or as an asynchronous callback mechanism as needed. This allows multiple callbacks to be registered for a particular task, and the future will guarantee execution of all listeners when the task completes.

For a simpler alternative to CheckedFuture, consider accessing Future values with Futures.get().

Since:

1.0

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.concurrent.Future

Future.State

Method Summary

Modifier and Type	Method	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, TimeUnit unit)	Deprecated. Exception checking version of Future.get(long, TimeUnit) that will translate InterruptedException, CancellationException and ExecutionException into application-specific exceptions.

Methods inherited from interface java.util.concurrent.Future

cancel, exceptionNow, get, get, isCancelled, isDone, resultNow, state

Methods inherited from interface com.google.common.util.concurrent.ListenableFuture

addListener

Method Details

checkedGet

V checkedGet()
      throws X

Deprecated.

Exception checking version of Future.get() that will translate InterruptedException, CancellationException and ExecutionException into application-specific exceptions.

Returns:

the result of executing the future.

Throws:

X - on interruption, cancellation or execution exceptions.

checkedGet

V checkedGet(long timeout,
 TimeUnit unit)
      throws TimeoutException,
X

Deprecated.

Exception checking version of Future.get(long, TimeUnit) that will translate InterruptedException, CancellationException and ExecutionException into application-specific exceptions. On timeout this method throws a normal TimeoutException.

Returns:

the result of executing the future.

Throws:

TimeoutException - if retrieving the result timed out.

X - on interruption, cancellation or execution exceptions.