org.apache.cassandra.utils.concurrent

Interface Promise<V>

All Superinterfaces:

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

public interface Promise<V>
extends io.netty.util.concurrent.Promise<V>, Future<V>

A Promise that integrates Promise with our Future API to improve clarity and coherence 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
Promise<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
Promise<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
Promise<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
Promise<V>	addListener(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>> var1)
Promise<V>	addListeners(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>>... var1)
Promise<V>	await() Wait indefinitely for this promise to complete, throwing any interrupt
Promise<V>	awaitThrowUncheckedOnInterrupt() Wait indefinitely for this promise to complete, throwing any interrupt as an UncheckedInterruptedException
Promise<V>	awaitUninterruptibly() Wait indefinitely for this promise to complete
static <V> io.netty.util.concurrent.GenericFutureListener<? extends Future<V>>	listener(java.util.concurrent.ExecutorService executor, com.google.common.util.concurrent.FutureCallback<V> callback)
static <V> io.netty.util.concurrent.GenericFutureListener<? extends Future<V>>	listener(com.google.common.util.concurrent.FutureCallback<V> callback)
Promise<V>	removeListener(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>> var1)
Promise<V>	removeListeners(io.netty.util.concurrent.GenericFutureListener<? extends io.netty.util.concurrent.Future<? super V>>... var1)
Promise<V>	setFailure(java.lang.Throwable throwable) Complete the promise abnormally if not already complete
Promise<V>	setSuccess(V v) Complete the promise successfully if not already complete
boolean	setUncancellableExclusive() Prevent a future caller from cancelling this promise
Promise<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
Promise<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.Promise

setUncancellable, tryFailure, trySuccess

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

addCallback, addCallback, addCallback, addListener, addListener, await, awaitUninterruptibly, flatMap, flatMap, map, map, notifyExecutor, rethrowIfFailed, syncThrowUncheckedOnInterrupt

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

listener

static <V> io.netty.util.concurrent.GenericFutureListener<? extends Future<V>> listener(com.google.common.util.concurrent.FutureCallback<V> callback)

listener

static <V> io.netty.util.concurrent.GenericFutureListener<? extends Future<V>> listener(java.util.concurrent.ExecutorService executor,
                                                                                        com.google.common.util.concurrent.FutureCallback<V> callback)

addCallback

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

Description copied from interface: Future

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

addCallback

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

Description copied from interface: Future

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

addCallback

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

Description copied from interface: Future

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

addListener

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

Specified by:

addListener in interface io.netty.util.concurrent.Promise<V>

addListeners

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

Specified by:

addListeners in interface io.netty.util.concurrent.Promise<V>

removeListener

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

Specified by:

removeListener in interface io.netty.util.concurrent.Promise<V>

removeListeners

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

Specified by:

removeListeners in interface io.netty.util.concurrent.Promise<V>

setSuccess

Promise<V> setSuccess(V v)
               throws java.lang.IllegalStateException

Complete the promise successfully if not already complete

Specified by:

setSuccess in interface io.netty.util.concurrent.Promise<V>

Throws:

java.lang.IllegalStateException - if already set

setFailure

Promise<V> setFailure(java.lang.Throwable throwable)
               throws java.lang.IllegalStateException

Complete the promise abnormally if not already complete

Specified by:

setFailure in interface io.netty.util.concurrent.Promise<V>

Throws:

java.lang.IllegalStateException - if already set

setUncancellableExclusive

boolean setUncancellableExclusive()

Prevent a future caller from cancelling this promise

Returns:

true iff this invocation set it to uncancellable, whether or not now uncancellable

await

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

Wait indefinitely for this promise to complete, throwing any interrupt

Specified by:

await in interface Awaitable

Specified by:

await in interface io.netty.util.concurrent.Promise<V>

Throws:

java.lang.InterruptedException - if interrupted

awaitUninterruptibly

Promise<V> awaitUninterruptibly()

Wait indefinitely for this promise to complete

Specified by:

awaitUninterruptibly in interface Awaitable

Specified by:

awaitUninterruptibly in interface io.netty.util.concurrent.Promise<V>

awaitThrowUncheckedOnInterrupt

Promise<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

sync

Promise<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

Specified by:

sync in interface io.netty.util.concurrent.Promise<V>

Throws:

java.lang.InterruptedException

syncUninterruptibly

Promise<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

Specified by:

syncUninterruptibly in interface io.netty.util.concurrent.Promise<V>