SettablePartialFuture (FoundationDB Java Client API)

java.lang.Object
- com.foundationdb.async.AbstractPartialFuture<T>
- - com.foundationdb.async.SettablePartialFuture<T>

Type Parameters:
T - the output type of a successful process

All Implemented Interfaces:

Cancellable, PartialFuture<T>, Settable<T>, SettablePartial<T>, Disposable
```
public class SettablePartialFuture<T>
extends AbstractPartialFuture<T>
implements SettablePartial<T>
```
Represents a PartialFuture that can be fulfilled via the SettablePartial interface. SettablePartialFuture has a default Executor that is used when a SettablePartialFuture is created without passing this parameter, which runs callback functions immediately on the stack when the future is fulfilled.

See Also:
ReadyPartialFuture

Constructor Summary

Constructors
Constructor and Description
`SettablePartialFuture()` Construct a `SettableFuture` with the default `Executor`
`SettablePartialFuture(Executor executor)` Construct a `SettableFuture` with a specified `Executor`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`blockInterruptibly()` Blocks until this `Future` is set to either a value or an error.
`void`	`blockUntilReady()` Blocks until this `Future` is set to either a value or an error.
`void`	`cancel()` Cancels this asynchronous operation.
`Throwable`	`getError()` Gets the error from a `Future` if it has been set to this state.
`T`	`getIfDone()` Gets the value from this `Future`.
`boolean`	`isDone()` Gets the readiness of this `Future`.
`boolean`	`isError()` Tests if this `Future` is set to an error
`boolean`	`isSet()` Returns `true` if this `Settable` has been set to a value or error.
`boolean`	`onCancelled(Runnable r)` Register code to be called if this operation is cancelled.
`void`	`onCancelledCancel(Cancellable c)` Link an operation to cancel in the event that this `Settable` is cancelled.
`void`	`set(T value)` Set this `Settable` to a value.
`void`	`setError(Error error)` Set this `Settable` to an error.
`void`	`setError(Exception error)` Set this `Settable` to an error.
`void`	`setError(RuntimeException error)` Set this `Settable` to an error.

Methods inherited from class com.foundationdb.async.AbstractPartialFuture
dispose, flatMap, get, getInterruptibly, map, onReady, onReadyAlready, rescue, rescue

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SettablePartialFuture
```
public SettablePartialFuture()
```
    Construct a SettableFuture with the default Executor
  - SettablePartialFuture
```
public SettablePartialFuture(Executor executor)
```
    Construct a SettableFuture with a specified Executor
    
    Parameters:
    executor - the Executor with which to execute callbacks
- Method Detail
  - set
```
public void set(T value)
```
    Description copied from interface: Settable
    
    Set this Settable to a value. This will invoke callbacks, and unblock all Threads waiting on associated Futures. A Settable can be set only once and this call will throw an exception if this object is already set to a value or error. It is not, however, an error to call this if the operation has been cancelled. If the task has been cancelled, this call will have no effect.
    
    Specified by:
    
    set in interface Settable<T>
    
    Parameters:
    value - the output of this successful process
  - setError
```
public void setError(Error error)
```
    Description copied from interface: Settable
    
    Set this Settable to an error. This call will invoke callbacks, and unblock all Threads waiting on associated Futures. A Settable can be set only once and this call will throw an exception if this object is already set to a value or error. It is not, however, an error to call this method if the operation has been cancelled. If the task has been cancelled, this call will have no effect.
    
    Specified by:
    
    setError in interface Settable<T>
    
    Parameters:
    error - the error encountered in the course of this process
  - setError
```
public void setError(RuntimeException error)
```
    Description copied from interface: Settable
    
    Set this Settable to an error. This call will invoke callbacks, and unblock all Threads waiting on associated Futures. A Settable can be set only once and this call will throw an exception if this object is already set to a value or error. It is not, however, an error to call this method if the operation has been cancelled. If the task has been cancelled, this call will have no effect.
    
    Specified by:
    
    setError in interface Settable<T>
    
    Parameters:
    error - the error encountered in the course of this process
  - setError
```
public void setError(Exception error)
```
    Description copied from interface: SettablePartial
    
    Set this Settable to an error. This call will invoke callbacks, and unblock all Threads waiting on associated Futures. A Settable can be set only once and this call will throw an exception if this object is already set to a value or error. It is not, however, an error to call this method if the operation has been cancelled. If the task has been cancelled, this call will have no effect.
    
    Specified by:
    
    setError in interface SettablePartial<T>
    
    Parameters:
    error - the error encountered in the course of this process
  - cancel
```
public void cancel()
```
    Description copied from interface: PartialFuture
    
    Cancels this asynchronous operation. If called before the Future is ready, subsequent attempts to access its value will throw. Cancelling a Future which is already set has no effect. Cancelling a Future should not be assumed to eliminate the affects of launching the operation. Many asynchronous operations start work on remote machines -- this work will generally not be stopped if the local Future is cancelled.
    
    Specified by:
    
    cancel in interface Cancellable
    
    Specified by:
    
    cancel in interface PartialFuture<T>
  - isSet
```
public boolean isSet()
```
    Description copied from interface: Settable
    
    Returns true if this Settable has been set to a value or error.
    
    Specified by:
    
    isSet in interface Settable<T>
    
    Returns:
    true if a value or error has been set, false otherwise
  - onCancelled
```
public boolean onCancelled(Runnable r)
```
    Description copied from interface: Settable
    
    Register code to be called if this operation is cancelled. Settables can be cancelled by calls to PartialFuture.cancel() on associated Futures. If this Settable is already set, the callback will not be registered and this call will return false. If this call returns true the registered callback is guaranteed to be called if the associated Future is cancelled.
    
    Specified by:
    
    onCancelled in interface Settable<T>
    
    Parameters:
    r - routine to execute if cancelled.
    
    Returns:
    true if the callback was registered, false otherwise.
  - onCancelledCancel
```
public void onCancelledCancel(Cancellable c)
```
    Description copied from interface: Settable
    
    Link an operation to cancel in the event that this Settable is cancelled. This is a convenience method (for more complicated calls to Settable.onCancelled(Runnable)) with possible internal optimizations.
    
    Specified by:
    
    onCancelledCancel in interface Settable<T>
    
    Parameters:
    c - the operation to cancel
  - getIfDone
```
public T getIfDone()
            throws Exception
```
    Description copied from class: AbstractPartialFuture
    
    Gets the value from this Future. It must be in the ready and non-error state. This is a non-blocking call. If this Future is set to an error get() throws this error.
    
    Returns:
    the value to which this Future has been set.
    
    Throws:
    
    FDBException - if the value is either unset, or has been set to an error.
    
    Exception
  - blockUntilReady
```
public void blockUntilReady()
```
    Description copied from interface: PartialFuture
    
    Blocks until this Future is set to either a value or an error. When this function returns without an error, PartialFuture.isDone() will return true.
    Code should never block for a future to become ready in code invoked as a callback. Blocking in callback code will generally block client networking and cause a deadlock.
    
    Specified by:
    
    blockUntilReady in interface PartialFuture<T>
  - blockInterruptibly
```
public void blockInterruptibly()
                        throws InterruptedException
```
    Description copied from interface: PartialFuture
    
    Blocks until this Future is set to either a value or an error. When this function returns without an error, PartialFuture.isDone() will return true.
    Code should never block for a future to become ready in code invoked as a callback. Blocking in callback code will generally block client networking and cause a deadlock.
    
    Specified by:
    
    blockInterruptibly in interface PartialFuture<T>
    
    Throws:
    
    InterruptedException - if the blocked thread is interrupted
  - isDone
```
public boolean isDone()
```
    Description copied from interface: PartialFuture
    
    Gets the readiness of this Future. A Future is ready if the value has been set or an error has been set.
    
    Specified by:
    
    isDone in interface PartialFuture<T>
    
    Returns:
    true if the Future is set to a value or error
  - isError
```
public boolean isError()
```
    Description copied from interface: PartialFuture
    
    Tests if this Future is set to an error
    
    Specified by:
    
    isError in interface PartialFuture<T>
    
    Returns:
    true if in error state, false otherwise
  - getError
```
public Throwable getError()
```
    Description copied from interface: PartialFuture
    
    Gets the error from a Future if it has been set to this state. If this Future is not yet set, or has not been set to an error, throws an exception. Although this method returns a Throwable, the set of possible types is more limited. A PartialFuture is limited to be set in an error state to an Exception (or a subclass thereof) or an unchecked Error.
    
    Specified by:
    
    getError in interface PartialFuture<T>
    
    Returns:
    the error output of the Future

Class SettablePartialFuture<T>

Constructor Summary

Method Summary

Methods inherited from class com.foundationdb.async.AbstractPartialFuture

Methods inherited from class java.lang.Object

Constructor Detail

SettablePartialFuture

SettablePartialFuture

Method Detail

set

setError

setError

setError

cancel

isSet

onCancelled

onCancelledCancel

getIfDone

blockUntilReady

blockInterruptibly

isDone

isError

getError