Failure
Date: 2016-06-25

org.osgi.util.promise

## Interface Failure

-     @ConsumerType
      public interface Failure

  Failure callback for a Promise.

  A Failure callback is registered with a `Promise` using the `Promise.then(Success, Failure)` method and is called if the Promise is resolved with a failure.

  This is a functional interface and can be used as the assignment target for a lambda expression or method reference.

- - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `fail(Promise<?> resolved)` Failure callback for a Promise.

- - ### Method Detail

    - #### fail

          void fail(Promise<?> resolved)
                    throws java.lang.Exception

      Failure callback for a Promise.

      This method is called if the Promise with which it is registered resolves with a failure.

      In the remainder of this description we will refer to the Promise returned by `Promise.then(Success, Failure)` when this Failure callback was registered as the chained Promise.

      If this methods completes normally, the chained Promise must be failed with the same exception which failed the resolved Promise. If this method throws an exception, the chained Promise must be failed with the thrown exception.

      Parameters:
        `resolved` - The failed resolved `Promise`.
      Throws:
        `java.lang.Exception` - The chained Promise must be failed with the thrown exception.