PromiseImpl (Apache Aries Async Promise API 1.0.1 API)

java.lang.Object
- org.apache.aries.async.promise.PromiseImpl<T>

All Implemented Interfaces:: Promise<T>

public class PromiseImpl<T>
extends Object
implements Promise<T>

Constructor Summary

Constructors
Constructor and Description

PromiseImpl()

Constructors
Constructor and Description
`PromiseImpl()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`fail(Throwable failure)`
`Promise<T>`	`fallbackTo(Promise<? extends T> fallback)` Fall back to the value of the specified Promise if this Promise fails.
`Promise<T>`	`filter(Predicate<? super T> predicate)` Filter the value of this Promise.
`<R> Promise<R>`	`flatMap(Function<? super T,Promise<? extends R>> mapper)` FlatMap the value of this Promise.
`Throwable`	`getFailure()` Returns the failure of this Promise.
`T`	`getValue()` Returns the value of this Promise.
`boolean`	`isDone()` Returns whether this Promise has been resolved.
`<R> Promise<R>`	`map(Function<? super T,? extends R> mapper)` Map the value of this Promise.
`Promise<T>`	`onResolve(Runnable callback)` Register a callback to be called when this Promise is resolved.
`Promise<T>`	`recover(Function<Promise<?>,? extends T> recovery)` Recover from a failure of this Promise with a recovery value.
`Promise<T>`	`recoverWith(Function<Promise<?>,Promise<? extends T>> recovery)` Recover from a failure of this Promise with a recovery Promise.
`void`	`resolve(T value)`
`Promise<Void>`	`resolveWith(Promise<? extends T> with)`
`<R> Promise<R>`	`then(Success<? super T,? extends R> success)` Chain a new Promise to this Promise with a Success callback.
`<R> Promise<R>`	`then(Success<? super T,? extends R> success, Failure failure)` Chain a new Promise to this Promise with Success and Failure callbacks.

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

- Constructor Detail
  - PromiseImpl
```
public PromiseImpl()
```
- Method Detail
  - fail
```
public void fail(Throwable failure)
```
  - resolve
```
public void resolve(T value)
```
  - resolveWith
```
public Promise<Void> resolveWith(Promise<? extends T> with)
```
  - isDone
```
public boolean isDone()
```
    Description copied from interface: Promise
    
    Returns whether this Promise has been resolved.
    This Promise may be successfully resolved or resolved with a failure.
    
    Specified by:
    
    isDone in interface Promise<T>
    
    Returns:
    true if this Promise was resolved either successfully or with a failure; false if this Promise is unresolved.
  - getValue
```
public T getValue()
           throws InvocationTargetException,
                  InterruptedException
```
    Description copied from interface: Promise
    
    Returns the value of this Promise.
    If this Promise is not resolved, this method must block and wait for this Promise to be resolved before completing.
    If this Promise was successfully resolved, this method returns with the value of this Promise. If this Promise was resolved with a failure, this method must throw an InvocationTargetException with the failure exception as the cause.
    
    Specified by:
    
    getValue in interface Promise<T>
    
    Returns:
    The value of this resolved Promise.
    
    Throws:
    
    InvocationTargetException - If this Promise was resolved with a failure. The cause of the InvocationTargetException is the failure exception.
    
    InterruptedException - If the current thread was interrupted while waiting.
  - getFailure
```
public Throwable getFailure()
                     throws InterruptedException
```
    Description copied from interface: Promise
    
    Returns the failure of this Promise.
    If this Promise is not resolved, this method must block and wait for this Promise to be resolved before completing.
    If this Promise was resolved with a failure, this method returns with the failure of this Promise. If this Promise was successfully resolved, this method must return null.
    
    Specified by:
    
    getFailure in interface Promise<T>
    
    Returns:
    The failure of this resolved Promise or null if this Promise was successfully resolved.
    
    Throws:
    
    InterruptedException - If the current thread was interrupted while waiting.
  - onResolve
```
public Promise<T> onResolve(Runnable callback)
```
    Description copied from interface: Promise
    
    Register a callback to be called when this Promise is resolved.
    The specified callback is called when this Promise is resolved either successfully or with a failure.
    This method may be called at any time including before and after this Promise has been resolved.
    Resolving this Promise happens-before any registered callback is called. That is, in a registered callback, isDone() must return true and getValue() and getFailure() must not block.
    A callback may be called on a different thread than the thread which registered the callback. So the callback must be thread safe but can rely upon that the registration of the callback happens-before the registered callback is called.
    
    Specified by:
    
    onResolve in interface Promise<T>
    
    Parameters:
    callback - A callback to be called when this Promise is resolved. Must not be null.
    
    Returns:
    This Promise.
  - then
```
public <R> Promise<R> then(Success<? super T,? extends R> success,
                  Failure failure)
```
    Description copied from interface: Promise
    
    Chain a new Promise to this Promise with Success and Failure callbacks.
    The specified Success callback is called when this Promise is successfully resolved and the specified Failure callback is called when this Promise is resolved with a failure.
    This method returns a new Promise which is chained to this Promise. The returned Promise must be resolved when this Promise is resolved after the specified Success or Failure callback is executed. The result of the executed callback must be used to resolve the returned Promise. Multiple calls to this method can be used to create a chain of promises which are resolved in sequence.
    If this Promise is successfully resolved, the Success callback is executed and the result Promise, if any, or thrown exception is used to resolve the returned Promise from this method. If this Promise is resolved with a failure, the Failure callback is executed and the returned Promise from this method is failed.
    This method may be called at any time including before and after this Promise has been resolved.
    Resolving this Promise happens-before any registered callback is called. That is, in a registered callback, isDone() must return true and getValue() and getFailure() must not block.
    A callback may be called on a different thread than the thread which registered the callback. So the callback must be thread safe but can rely upon that the registration of the callback happens-before the registered callback is called.
    
    Specified by:
    
    then in interface Promise<T>
    
    Type Parameters:
    R - The value type associated with the returned Promise.
    Parameters:
    success - A Success callback to be called when this Promise is successfully resolved. May be null if no Success callback is required. In thi
    failure - A Failure callback to be called when this Promise is resolved with a failure. May be null if no Failure callback is required.
    
    Returns:
    A new Promise which is chained to this Promise. The returned Promise must be resolved when this Promise is resolved after the specified Success or Failure callback, if any, is executed
  - then
```
public <R> Promise<R> then(Success<? super T,? extends R> success)
```
    Description copied from interface: Promise
    
    Chain a new Promise to this Promise with a Success callback.
    This method performs the same function as calling then(Success, Failure) with the specified Success callback and null for the Failure callback
    
    Specified by:
    
    then in interface Promise<T>
    
    Type Parameters:
    R - The value type associated with the returned Promise.
    Parameters:
    success - A Success callback to be called when this Promise is successfully resolved. May be null if no Success callback is required. In this case, the returned Promise must be resolved with the value null when this Promise is successfully resolved.
    
    Returns:
    A new Promise which is chained to this Promise. The returned Promise must be resolved when this Promise is resolved after the specified Success, if any, is executed.
    See Also:
    Promise.then(Success, Failure)
  - filter
```
public Promise<T> filter(Predicate<? super T> predicate)
```
    Description copied from interface: Promise
    
    Filter the value of this Promise.
    If this Promise is successfully resolved, the returned Promise will either be resolved with the value of this Promise if the specified Predicate accepts that value or failed with a NoSuchElementException if the specified Predicate does not accept that value. If the specified Predicate throws an exception, the returned Promise will be failed with the exception.
    If this Promise is resolved with a failure, the returned Promise will be failed with that failure.
    This method may be called at any time including before and after this Promise has been resolved.
    
    Specified by:
    
    filter in interface Promise<T>
    
    Parameters:
    predicate - The Predicate to evaluate the value of this Promise. Must not be null.
    
    Returns:
    A Promise that filters the value of this Promise.
  - map
```
public <R> Promise<R> map(Function<? super T,? extends R> mapper)
```
    Description copied from interface: Promise
    
    Map the value of this Promise.
    If this Promise is successfully resolved, the returned Promise will be resolved with the value of specified Function as applied to the value of this Promise. If the specified Function throws an exception, the returned Promise will be failed with the exception.
    If this Promise is resolved with a failure, the returned Promise will be failed with that failure.
    This method may be called at any time including before and after this Promise has been resolved.
    
    Specified by:
    
    map in interface Promise<T>
    
    Type Parameters:
    R - The value type associated with the returned Promise.
    Parameters:
    mapper - The Function that will map the value of this Promise to the value that will be used to resolve the returned Promise. Must not be null.
    
    Returns:
    A Promise that returns the value of this Promise as mapped by the specified Function.
  - flatMap
```
public <R> Promise<R> flatMap(Function<? super T,Promise<? extends R>> mapper)
```
    Description copied from interface: Promise
    
    FlatMap the value of this Promise.
    If this Promise is successfully resolved, the returned Promise will be resolved with the Promise from the specified Function as applied to the value of this Promise. If the specified Function throws an exception, the returned Promise will be failed with the exception.
    If this Promise is resolved with a failure, the returned Promise will be failed with that failure.
    This method may be called at any time including before and after this Promise has been resolved.
    
    Specified by:
    
    flatMap in interface Promise<T>
    
    Type Parameters:
    R - The value type associated with the returned Promise.
    Parameters:
    mapper - The Function that will flatMap the value of this Promise to a Promise that will be used to resolve the returned Promise. Must not be null.
    
    Returns:
    A Promise that returns the value of this Promise as mapped by the specified Function.
  - recover
```
public Promise<T> recover(Function<Promise<?>,? extends T> recovery)
```
    Description copied from interface: Promise
    
    Recover from a failure of this Promise with a recovery value.
    If this Promise is successfully resolved, the returned Promise will be resolved with the value of this Promise.
    If this Promise is resolved with a failure, the specified Function is applied to this Promise to produce a recovery value.
    If the recovery value is not null, the returned Promise will be resolved with the recovery value.
    If the recovery value is null, the returned Promise will be failed with the failure of this Promise.
    If the specified Function throws an exception, the returned Promise will be failed with that exception.
    To recover from a failure of this Promise with a recovery value of null, the recoverWith(Function) method must be used. The specified Function for recoverWith(Function) can return Promises.resolved(null) to supply the desired null value.
    This method may be called at any time including before and after this Promise has been resolved.
    
    Specified by:
    
    recover in interface Promise<T>
    
    Parameters:
    recovery - If this Promise resolves with a failure, the specified Function is called to produce a recovery value to be used to resolve the returned Promise. Must not be null.
    
    Returns:
    A Promise that resolves with the value of this Promise or recovers from the failure of this Promise.
  - recoverWith
```
public Promise<T> recoverWith(Function<Promise<?>,Promise<? extends T>> recovery)
```
    Description copied from interface: Promise
    
    Recover from a failure of this Promise with a recovery Promise.
    If this Promise is successfully resolved, the returned Promise will be resolved with the value of this Promise.
    If this Promise is resolved with a failure, the specified Function is applied to this Promise to produce a recovery Promise.
    If the recovery Promise is not null, the returned Promise will be resolved with the recovery Promise.
    If the recovery Promise is null, the returned Promise will be failed with the failure of this Promise.
    If the specified Function throws an exception, the returned Promise will be failed with that exception.
    This method may be called at any time including before and after this Promise has been resolved.
    
    Specified by:
    
    recoverWith in interface Promise<T>
    
    Parameters:
    recovery - If this Promise resolves with a failure, the specified Function is called to produce a recovery Promise to be used to resolve the returned Promise. Must not be null.
    
    Returns:
    A Promise that resolves with the value of this Promise or recovers from the failure of this Promise.
  - fallbackTo
```
public Promise<T> fallbackTo(Promise<? extends T> fallback)
```
    Description copied from interface: Promise
    
    Fall back to the value of the specified Promise if this Promise fails.
    If this Promise is successfully resolved, the returned Promise will be resolved with the value of this Promise.
    If this Promise is resolved with a failure, the successful result of the specified Promise is used to resolve the returned Promise. If the specified Promise is resolved with a failure, the returned Promise will be failed with the failure of this Promise rather than the failure of the specified Promise.
    This method may be called at any time including before and after this Promise has been resolved.
    
    Specified by:
    
    fallbackTo in interface Promise<T>
    
    Parameters:
    fallback - The Promise whose value will be used to resolve the returned Promise if this Promise resolves with a failure. Must not be null.
    
    Returns:
    A Promise that returns the value of this Promise or falls back to the value of the specified Promise.

Class PromiseImpl<T>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PromiseImpl

Method Detail

fail

resolve

resolveWith

isDone

getValue

getFailure

onResolve

then

then

filter

map

flatMap

recover

recoverWith

fallbackTo