org.apache.kafka.server.util

Class FutureUtils

java.lang.Object

org.apache.kafka.server.util.FutureUtils

public class FutureUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
FutureUtils()

Method Summary

Modifier and Type	Method and Description
static <T> void	chainFuture(CompletableFuture<? extends T> sourceFuture, CompletableFuture<T> destinationFuture) Complete a given destination future when a source future is completed.
static <T> CompletableFuture<T>	failedFuture(Throwable ex) Returns a new CompletableFuture that is already completed exceptionally with the given exception.
static <T> T	waitWithLogging(org.slf4j.Logger log, String prefix, String action, CompletableFuture<T> future, Deadline deadline, org.apache.kafka.common.utils.Time time) Wait for a future until a specific time in the future, with copious logging.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FutureUtils

public FutureUtils()

Method Detail

waitWithLogging

public static <T> T waitWithLogging(org.slf4j.Logger log,
                                    String prefix,
                                    String action,
                                    CompletableFuture<T> future,
                                    Deadline deadline,
                                    org.apache.kafka.common.utils.Time time)
                             throws Throwable

Wait for a future until a specific time in the future, with copious logging.

Type Parameters:

T - The type of the future.

Parameters:

log - The slf4j object to use to log success and failure.

action - The action we are waiting for.

future - The future we are waiting for.

deadline - The deadline in the future we are waiting for.

time - The clock object.

Returns:

The result of the future.

Throws:

TimeoutException - If the future times out.

Throwable - If the future fails. Note: we unwrap ExecutionException here.

chainFuture

public static <T> void chainFuture(CompletableFuture<? extends T> sourceFuture,
                                   CompletableFuture<T> destinationFuture)

Complete a given destination future when a source future is completed.

Type Parameters:

T - The destination future type.

Parameters:

sourceFuture - The future to trigger off of.

destinationFuture - The future to complete when the source future is completed.

failedFuture

public static <T> CompletableFuture<T> failedFuture(Throwable ex)

Returns a new CompletableFuture that is already completed exceptionally with the given exception.

Parameters:

ex - The exception.

Returns:

The exceptionally completed CompletableFuture.