Method Detail

• set

  void set(T value)

  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.

  Parameters:

  value - the output of this successful process

  Throws:

  IllegalStateException - if set() or setError() has already been called.

• setError

  void setError(RuntimeException error)

  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.

  Parameters:

  error - the error encountered in the course of this process

  Throws:

  IllegalStateException - if set() or setError() has already been called.

• setError

  void setError(Error error)

  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.

  Parameters:

  error - the error encountered in the course of this process

  Throws:

  IllegalStateException - if set() or setError() has already been called.

• isSet

  boolean isSet()

  Returns true if this Settable has been set to a value or error.

  Returns:

  true if a value or error has been set, false otherwise

• onCancelled

  boolean onCancelled(Runnable r)

  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.

  Parameters:

  r - routine to execute if cancelled.

  Returns:

  true if the callback was registered, false otherwise.

• onCancelledCancel

  void onCancelledCancel(Cancellable c)

  Link an operation to cancel in the event that this Settable is cancelled. This is a convenience method (for more complicated calls to onCancelled(Runnable)) with possible internal optimizations.

  Parameters:

  c - the operation to cancel