Package com.google.common.util.concurrent

Class SettableFuture<V>

java.lang.Object

com.google.common.util.concurrent.AbstractFuture<V>

com.google.common.util.concurrent.SettableFuture<V>

All Implemented Interfaces:

ListenableFuture<V>, java.util.concurrent.Future<V>

public final class SettableFuture<V>
extends AbstractFuture<V>

A ListenableFuture whose result may be set by a set(Object) or setException(Throwable) call. It may also be cancelled.

Since:

9.0 (in 1.0 as ValueFuture)

Method Summary

Modifier and Type	Method	Description
static <V> SettableFuture<V>	create()	Creates a new SettableFuture in the default state.
boolean	set(V value)	Sets the value of this future.
boolean	setException(java.lang.Throwable throwable)	Sets the future to having failed with the given exception.

Methods inherited from class com.google.common.util.concurrent.AbstractFuture

addListener, cancel, get, get, isCancelled, isDone

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static <V> SettableFuture<V> create()

Creates a new SettableFuture in the default state.

set

public boolean set(@Nullable
                   V value)

Sets the value of this future. This method will return true if the value was successfully set, or false if the future has already been set or cancelled.

Parameters:

value - the value the future should hold.

Returns:

true if the value was successfully set.

setException

public boolean setException(java.lang.Throwable throwable)

Sets the future to having failed with the given exception. This exception will be wrapped in an ExecutionException and thrown from the get methods. This method will return true if the exception was successfully set, or false if the future has already been set or cancelled.

Parameters:

throwable - the exception the future should hold.

Returns:

true if the exception was successfully set.