org.apache.cassandra.utils.concurrent

Interface Future<V>

All Superinterfaces:

Awaitable, java.util.concurrent.Future<V>, com.google.common.util.concurrent.ListenableFuture<V>

All Known Subinterfaces:

Promise<V>, RunnableFuture<V>

public interface Future<V>
extends io.netty.util.concurrent.Future<V>, com.google.common.util.concurrent.ListenableFuture<V>, Awaitable

A Future that integrates several different (but equivalent) APIs used within Cassandra into a single concept, integrating also with our Awaitable abstraction, to overall improve coherency and clarity in the codebase.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.cassandra.utils.concurrent.Awaitable

Awaitable.AbstractAwaitable, Awaitable.AsyncAwaitable, Awaitable.Defaults, Awaitable.SyncAwaitable

Method Summary

Modifier and Type	Method and Description
Future<V>	addCallback(java.util.function.BiConsumer<? super V,java.lang.Throwable> callback) Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively
Future<V>	addCallback(java.util.function.BiConsumer<? super V,java.lang.Throwable> callback, java.util.concurrent.Executor executor) Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively
Future<V>	addCallback(java.util.function.Consumer<? super V> onSuccess, java.util.function.Consumer<? super java.lang.Throwable> onFailure) Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively
Future<V>	addCallback(java.util.function.Consumer<? super V> onSuccess, java.util.function.Consumer<? super java.lang.Throwable> onFailure, java.util.concurrent.Executor executor) Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively
Future<V>	addCallback(com.google.common.util.concurrent.FutureCallback<? super V> callback) Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively
Future<V>	addCallback(com.google.common.util.concurrent.FutureCallback<? super V> callback, java.util.concurrent.Executor executor) Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively
Future<V>	addListener(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>> genericFutureListener)
void	addListener(java.lang.Runnable runnable) Invoke runnable on completion.
void	addListener(java.lang.Runnable runnable, java.util.concurrent.Executor executor) Invoke runnable on completion, using executor.
Future<V>	addListeners(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>>... genericFutureListeners)
Future<V>	await() Wait indefinitely for this future to complete, throwing any interrupt
default boolean	await(long l) Deprecated.
Future<V>	awaitThrowUncheckedOnInterrupt() Wait indefinitely for this promise to complete, throwing any interrupt as an UncheckedInterruptedException
Future<V>	awaitUninterruptibly() Wait indefinitely for this future to complete
default boolean	awaitUninterruptibly(long l) Deprecated.
default <T> Future<T>	flatMap(java.util.function.Function<? super V,? extends Future<T>> flatMapper) Support Futures.transformAsync(ListenableFuture, AsyncFunction, Executor) natively
<T> Future<T>	flatMap(java.util.function.Function<? super V,? extends Future<T>> flatMapper, java.util.concurrent.Executor executor) Support Futures.transformAsync(ListenableFuture, AsyncFunction, Executor) natively
default <T> Future<T>	map(java.util.function.Function<? super V,? extends T> mapper) Support Futures.transform(ListenableFuture, com.google.common.base.Function, Executor) natively
<T> Future<T>	map(java.util.function.Function<? super V,? extends T> mapper, java.util.concurrent.Executor executor) Support Futures.transform(ListenableFuture, com.google.common.base.Function, Executor) natively
java.util.concurrent.Executor	notifyExecutor()
Future<V>	removeListener(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>> genericFutureListener)
Future<V>	removeListeners(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>>... genericFutureListeners)
default void	rethrowIfFailed()
default Future<V>	sync() waits for completion; in case of failure rethrows the original exception without a new wrapping exception so may cause problems for reporting stack traces
default Future<V>	syncThrowUncheckedOnInterrupt() waits for completion; in case of failure rethrows the original exception without a new wrapping exception so may cause problems for reporting stack traces
default Future<V>	syncUninterruptibly() waits for completion; in case of failure rethrows the original exception without a new wrapping exception so may cause problems for reporting stack traces

Methods inherited from interface io.netty.util.concurrent.Future

await, awaitUninterruptibly, cancel, cause, getNow, isCancellable, isSuccess

Methods inherited from interface java.util.concurrent.Future

get, get, isCancelled, isDone

Methods inherited from interface org.apache.cassandra.utils.concurrent.Awaitable

await, awaitThrowUncheckedOnInterrupt, awaitUninterruptibly, awaitUntil, awaitUntilThrowUncheckedOnInterrupt, awaitUntilUninterruptibly

Method Detail

await

Future<V> await()
         throws java.lang.InterruptedException

Wait indefinitely for this future to complete, throwing any interrupt

Specified by:

await in interface Awaitable

Throws:

java.lang.InterruptedException - if interrupted

awaitUninterruptibly

Future<V> awaitUninterruptibly()

Wait indefinitely for this future to complete

Specified by:

awaitUninterruptibly in interface Awaitable

awaitThrowUncheckedOnInterrupt

Future<V> awaitThrowUncheckedOnInterrupt()

Wait indefinitely for this promise to complete, throwing any interrupt as an UncheckedInterruptedException

Specified by:

awaitThrowUncheckedOnInterrupt in interface Awaitable

Throws:

UncheckedInterruptedException - if interrupted

rethrowIfFailed

default void rethrowIfFailed()

sync

default Future<V> sync()
                throws java.lang.InterruptedException

waits for completion; in case of failure rethrows the original exception without a new wrapping exception so may cause problems for reporting stack traces

Throws:

java.lang.InterruptedException

syncUninterruptibly

default Future<V> syncUninterruptibly()

waits for completion; in case of failure rethrows the original exception without a new wrapping exception so may cause problems for reporting stack traces

syncThrowUncheckedOnInterrupt

default Future<V> syncThrowUncheckedOnInterrupt()

waits for completion; in case of failure rethrows the original exception without a new wrapping exception so may cause problems for reporting stack traces

await

@Deprecated
default boolean await(long l)
                           throws java.lang.InterruptedException

Deprecated.

Throws:

java.lang.InterruptedException

awaitUninterruptibly

@Deprecated
default boolean awaitUninterruptibly(long l)

Deprecated.

addCallback

Future<V> addCallback(java.util.function.BiConsumer<? super V,java.lang.Throwable> callback)

Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively

addCallback

Future<V> addCallback(java.util.function.BiConsumer<? super V,java.lang.Throwable> callback,
                      java.util.concurrent.Executor executor)

Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively

addCallback

Future<V> addCallback(com.google.common.util.concurrent.FutureCallback<? super V> callback)

Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively

addCallback

Future<V> addCallback(com.google.common.util.concurrent.FutureCallback<? super V> callback,
                      java.util.concurrent.Executor executor)

Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively

addCallback

Future<V> addCallback(java.util.function.Consumer<? super V> onSuccess,
                      java.util.function.Consumer<? super java.lang.Throwable> onFailure)

Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively

addCallback

Future<V> addCallback(java.util.function.Consumer<? super V> onSuccess,
                      java.util.function.Consumer<? super java.lang.Throwable> onFailure,
                      java.util.concurrent.Executor executor)

Support Futures.addCallback(com.google.common.util.concurrent.ListenableFuture<V>, com.google.common.util.concurrent.FutureCallback<? super V>, java.util.concurrent.Executor) natively

map

default <T> Future<T> map(java.util.function.Function<? super V,? extends T> mapper)

Support Futures.transform(ListenableFuture, com.google.common.base.Function, Executor) natively

map

<T> Future<T> map(java.util.function.Function<? super V,? extends T> mapper,
                  java.util.concurrent.Executor executor)

Support Futures.transform(ListenableFuture, com.google.common.base.Function, Executor) natively

flatMap

default <T> Future<T> flatMap(java.util.function.Function<? super V,? extends Future<T>> flatMapper)

Support Futures.transformAsync(ListenableFuture, AsyncFunction, Executor) natively

flatMap

<T> Future<T> flatMap(java.util.function.Function<? super V,? extends Future<T>> flatMapper,
                      java.util.concurrent.Executor executor)

Support Futures.transformAsync(ListenableFuture, AsyncFunction, Executor) natively

addListener

void addListener(java.lang.Runnable runnable,
                 java.util.concurrent.Executor executor)

Invoke runnable on completion, using executor. Tasks are submitted to their executors in the order they were added to this Future.

Specified by:

addListener in interface com.google.common.util.concurrent.ListenableFuture<V>

addListener

void addListener(java.lang.Runnable runnable)

Invoke runnable on completion. Depending on the implementation and its configuration, this may be executed immediately by the notifying/completing thread, or asynchronously by an executor. Tasks are executed, or submitted to the executor, in the order they were added to this Future.

notifyExecutor

java.util.concurrent.Executor notifyExecutor()

addListener

Future<V> addListener(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>> genericFutureListener)

addListeners

Future<V> addListeners(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>>... genericFutureListeners)

removeListener

Future<V> removeListener(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>> genericFutureListener)

removeListeners

Future<V> removeListeners(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>>... genericFutureListeners)