Package org.osgi.util.promise

Interface Success<T,​R>

  • Type Parameters:
    T - The value type of the resolved Promise passed as input to this callback.
    R - The value type of the returned Promise from this callback.
    Functional Interface:
    This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
    @ConsumerType
@FunctionalInterface
public interface Success<T,​R>
    Success callback for a Promise.

    A Success callback is registered with a Promise using the Promise.then(Success) method and is called if the Promise is resolved successfully.

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

    • Method Detail

      • call

        Promise<R> call​(Promise<T> resolved)
         throws java.lang.Exception
        Success callback for a Promise.

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

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

        If the returned Promise is null then the chained Promise must resolve immediately with a successful value of null. If the returned Promise is not null then the chained Promise must be resolved when the returned Promise is resolved.

        Parameters:
        resolved - The successfully resolved Promise.
        Returns:
        The Promise to use to resolve the chained Promise, or null if the chained Promise is to be resolved immediately with the value null.
        Throws:
        java.lang.Exception - The chained Promise must be failed with the thrown exception.