Package org.eclipse.jetty.util

Interface Promise<C>

Type Parameters:

C - the type of the context object

All Known Implementing Classes:

FuturePromise, Promise.Adapter, Promise.Completable, Promise.Wrapper

public interface Promise<C>

A callback abstraction that handles completed/failed events of asynchronous operations.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	Promise.Adapter<U>	Empty implementation of Promise.
static class	Promise.Completable<S>	A CompletableFuture that is also a Promise.
static class	Promise.Wrapper<W>

Method Summary

Modifier and Type	Method	Description
default void	failed(java.lang.Throwable x)	Callback invoked when the operation fails.
static <T> Promise<T>	from(java.util.concurrent.CompletableFuture<? super T> completable)	Creates a promise from the given incomplete CompletableFuture.
default void	succeeded(C result)	Callback invoked when the operation completes.

Method Detail

succeeded

default void succeeded(C result)

Callback invoked when the operation completes.

Parameters:

result - the context

See Also:

failed(Throwable)

failed

default void failed(java.lang.Throwable x)

Callback invoked when the operation fails.

Parameters:

x - the reason for the operation failure

from

static <T> Promise<T> from(java.util.concurrent.CompletableFuture<? super T> completable)

Creates a promise from the given incomplete CompletableFuture.

When the promise completes, either succeeding or failing, the CompletableFuture is also completed, respectively via CompletableFuture.complete(Object) or CompletableFuture.completeExceptionally(Throwable).

Type Parameters:

T - the type of the result

Parameters:

completable - the CompletableFuture to convert into a promise

Returns:

a promise that when completed, completes the given CompletableFuture