com.firefly.utils.concurrent

接口 Callback

所有已知子接口:

Callback.NonBlocking

所有已知实现类:

Callback.Completable, Callback.Nested, CompletableCallback, CountingCallback, FutureCallback, IteratingCallback, IteratingNestedCallback, SharedBlockingCallback.Blocker

public interface Callback

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

Semantically this is equivalent to an optimise Promise<Void>, but callback is a more meaningful name than EmptyPromise

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	Callback.Completable A CompletableFuture that is also a Callback.
static class	Callback.Nested
static interface	Callback.NonBlocking Callback interface that declares itself as non-blocking

字段概要

字段

限定符和类型	字段和说明
static Callback	NOOP Instance of Adapter that can be used when the callback methods need an empty implementation without incurring in the cost of allocating a new Adapter object.

方法概要

限定符和类型	方法和说明
default void	failed(Throwable x) Callback invoked when the operation fails.
static Callback	from(CompletableFuture<?> completable) Creates a non-blocking callback from the given incomplete CompletableFuture.
static Callback	from(CompletableFuture<?> completable, boolean blocking) Creates a callback from the given incomplete CompletableFuture, with the given blocking characteristic.
default boolean	isNonBlocking()
default void	succeeded() Callback invoked when the operation completes.

字段详细资料

NOOP

static final Callback NOOP

Instance of Adapter that can be used when the callback methods need an empty implementation without incurring in the cost of allocating a new Adapter object.

方法详细资料

succeeded

default void succeeded()

Callback invoked when the operation completes.

另请参阅:

failed(Throwable)

failed

default void failed(Throwable x)

Callback invoked when the operation fails.

参数:

x - the reason for the operation failure

isNonBlocking

default boolean isNonBlocking()

返回:

True if the callback is known to never block the caller

from

static Callback from(CompletableFuture<?> completable)

Creates a non-blocking callback from the given incomplete CompletableFuture.

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

参数:

completable - the CompletableFuture to convert into a callback

返回:

a callback that when completed, completes the given CompletableFuture

from

static Callback from(CompletableFuture<?> completable,
                     boolean blocking)

Creates a callback from the given incomplete CompletableFuture, with the given blocking characteristic.

参数:

completable - the CompletableFuture to convert into a callback

blocking - whether the callback is blocking

返回:

a callback that when completed, completes the given CompletableFuture