net.tascalate.concurrent.decorators

Class AbstractPromiseDecorator<T,D extends Promise<T>>

java.lang.Object

net.tascalate.concurrent.decorators.AbstractCompletionStageDecorator<T,D>

net.tascalate.concurrent.decorators.AbstractPromiseLikeDecorator<T,D>

net.tascalate.concurrent.decorators.AbstractFutureDecorator<T,D>

net.tascalate.concurrent.decorators.AbstractPromiseDecorator<T,D>

Type Parameters:

T - a type of the successfully resolved promise value

D - a type of the concrete Promise subclass

All Implemented Interfaces:

CompletionStage<T>, Future<T>, Decorator<T>, Promise<T>

Direct Known Subclasses:

AbstractDependentPromiseDecorator, ExecutorBoundPromise, ExtendedPromiseDecorator

public abstract class AbstractPromiseDecorator<T,D extends Promise<T>>
extends AbstractFutureDecorator<T,D>
implements Promise<T>

Helper class to create a concrete Promise subclass via delegation to the wrapped Promise

Author:

vsilaev

Field Summary

Fields inherited from class net.tascalate.concurrent.decorators.AbstractCompletionStageDecorator

delegate

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractPromiseDecorator(D delegate)

Method Summary

Modifier and Type	Method and Description
Promise<T>	defaultAsyncOn(Executor executor)
Promise<T>	delay(Duration duration)
Promise<T>	delay(Duration duration, boolean delayOnError)
Promise<T>	delay(long timeout, TimeUnit unit)
Promise<T>	delay(long timeout, TimeUnit unit, boolean delayOnError)
DependentPromise<T>	dependent() Converts this Promise to a DependentPromise The returned DependentPromise does not implicitly enlist any CompletionStage for cancellation (neither self, nor passed as arguments to combining methods); only enlisting via explicit parameter is supported
DependentPromise<T>	dependent(Set<PromiseOrigin> defaultEnlistOptions) Converts this Promise to a DependentPromise The returned DependentPromise does implicitly enlist CompletionStage for cancellation (either self, and/or passed as arguments to combining methods) according to defaultEnlistOptions parameter
Promise<T>	exceptionallyAsync(Function<Throwable,? extends T> fn)
Promise<T>	exceptionallyAsync(Function<Throwable,? extends T> fn, Executor executor)
Promise<T>	exceptionallyCompose(Function<Throwable,? extends CompletionStage<T>> fn)
Promise<T>	exceptionallyComposeAsync(Function<Throwable,? extends CompletionStage<T>> fn)
Promise<T>	exceptionallyComposeAsync(Function<Throwable,? extends CompletionStage<T>> fn, Executor executor)
T	getNow(Supplier<? extends T> valueIfAbsent)
T	getNow(T valueIfAbsent)
boolean	isCompletedExceptionally()
T	join()
Promise<T>	onCancel(Runnable action)
Promise<T>	onTimeout(Supplier<? extends T> supplier, Duration duration)
Promise<T>	onTimeout(Supplier<? extends T> supplier, Duration duration, boolean cancelOnTimeout)
Promise<T>	onTimeout(Supplier<? extends T> supplier, long timeout, TimeUnit unit)
Promise<T>	onTimeout(Supplier<? extends T> supplier, long timeout, TimeUnit unit, boolean cancelOnTimeout)
Promise<T>	onTimeout(T value, Duration duration)
Promise<T>	onTimeout(T value, Duration duration, boolean cancelOnTimeout)
Promise<T>	onTimeout(T value, long timeout, TimeUnit unit)
Promise<T>	onTimeout(T value, long timeout, TimeUnit unit, boolean cancelOnTimeout)
Promise<T>	orTimeout(Duration duration)
Promise<T>	orTimeout(Duration duration, boolean cancelOnTimeout)
Promise<T>	orTimeout(long timeout, TimeUnit unit)
Promise<T>	orTimeout(long timeout, TimeUnit unit, boolean cancelOnTimeout)
Promise<T>	raw() Fully unwraps underlying Promise (removes all decoration layers)
Promise<T>	thenFilter(Predicate<? super T> predicate)
Promise<T>	thenFilter(Predicate<? super T> predicate, Function<? super T,Throwable> errorSupplier)
Promise<T>	thenFilterAsync(Predicate<? super T> predicate)
Promise<T>	thenFilterAsync(Predicate<? super T> predicate, Executor executor)
Promise<T>	thenFilterAsync(Predicate<? super T> predicate, Function<? super T,Throwable> errorSupplier)
Promise<T>	thenFilterAsync(Predicate<? super T> predicate, Function<? super T,Throwable> errorSupplier, Executor executor)
Promise<T>	unwrap() Unwraps underlying Promise if it was decorated (removes one level of decorators)

Methods inherited from class net.tascalate.concurrent.decorators.AbstractFutureDecorator

cancel, get, get, isCancelled, isDone

Methods inherited from class net.tascalate.concurrent.decorators.AbstractPromiseLikeDecorator

acceptEither, acceptEitherAsync, acceptEitherAsync, applyToEither, applyToEitherAsync, applyToEitherAsync, exceptionally, handle, handleAsync, handleAsync, runAfterBoth, runAfterBothAsync, runAfterBothAsync, runAfterEither, runAfterEitherAsync, runAfterEitherAsync, thenAccept, thenAcceptAsync, thenAcceptAsync, thenAcceptBoth, thenAcceptBothAsync, thenAcceptBothAsync, thenApply, thenApplyAsync, thenApplyAsync, thenCombine, thenCombineAsync, thenCombineAsync, thenCompose, thenComposeAsync, thenComposeAsync, thenRun, thenRunAsync, thenRunAsync, whenComplete, whenCompleteAsync, whenCompleteAsync, wrap, wrapNew, α

Methods inherited from class net.tascalate.concurrent.decorators.AbstractCompletionStageDecorator

toCompletableFuture, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.tascalate.concurrent.Promise

acceptEither, acceptEitherAsync, acceptEitherAsync, applyToEither, applyToEitherAsync, applyToEitherAsync, as, exceptionally, handle, handleAsync, handleAsync, runAfterBoth, runAfterBothAsync, runAfterBothAsync, runAfterEither, runAfterEitherAsync, runAfterEitherAsync, thenAccept, thenAcceptAsync, thenAcceptAsync, thenAcceptBoth, thenAcceptBothAsync, thenAcceptBothAsync, thenApply, thenApplyAsync, thenApplyAsync, thenCombine, thenCombineAsync, thenCombineAsync, thenCompose, thenComposeAsync, thenComposeAsync, thenRun, thenRunAsync, thenRunAsync, whenComplete, whenCompleteAsync, whenCompleteAsync

Methods inherited from interface java.util.concurrent.Future

cancel, get, get, isCancelled, isDone

Methods inherited from interface java.util.concurrent.CompletionStage

toCompletableFuture

Constructor Detail

AbstractPromiseDecorator

protected AbstractPromiseDecorator(D delegate)

Method Detail

getNow

public T getNow(T valueIfAbsent)
         throws CancellationException,
                CompletionException

Specified by:

getNow in interface Promise<T>

Throws:

CancellationException

CompletionException

getNow

public T getNow(Supplier<? extends T> valueIfAbsent)
         throws CancellationException,
                CompletionException

Specified by:

getNow in interface Promise<T>

Throws:

CancellationException

CompletionException

join

public T join()
       throws CancellationException,
              CompletionException

Specified by:

join in interface Promise<T>

Throws:

CancellationException

CompletionException

isCompletedExceptionally

public boolean isCompletedExceptionally()

Specified by:

isCompletedExceptionally in interface Promise<T>

unwrap

public Promise<T> unwrap()

Description copied from interface: Promise

Unwraps underlying Promise if it was decorated (removes one level of decorators)

Specified by:

unwrap in interface Promise<T>

Returns:

the underlying un-decorated Promise or self if not decorated

raw

public Promise<T> raw()

Description copied from interface: Promise

Fully unwraps underlying Promise (removes all decoration layers)

Specified by:

raw in interface Promise<T>

Returns:

the underlying un-decorated Promise or self if not decorated

dependent

public DependentPromise<T> dependent()

Description copied from interface: Promise

Converts this Promise to a DependentPromise The returned DependentPromise does not implicitly enlist any CompletionStage for cancellation (neither self, nor passed as arguments to combining methods); only enlisting via explicit parameter is supported

Specified by:

dependent in interface Promise<T>

Returns:

created DependentPromise

dependent

public DependentPromise<T> dependent(Set<PromiseOrigin> defaultEnlistOptions)

Description copied from interface: Promise

Converts this Promise to a DependentPromise The returned DependentPromise does implicitly enlist CompletionStage for cancellation (either self, and/or passed as arguments to combining methods) according to defaultEnlistOptions parameter

Specified by:

dependent in interface Promise<T>

Parameters:

defaultEnlistOptions - defines what CompletionStage should be enlisted implicitly for cancellation

Returns:

created DependentPromise

defaultAsyncOn

public Promise<T> defaultAsyncOn(Executor executor)

Specified by:

defaultAsyncOn in interface Promise<T>

onCancel

public Promise<T> onCancel(Runnable action)

Specified by:

onCancel in interface Promise<T>

delay

public Promise<T> delay(long timeout,
                        TimeUnit unit)

Specified by:

delay in interface Promise<T>

delay

public Promise<T> delay(long timeout,
                        TimeUnit unit,
                        boolean delayOnError)

Specified by:

delay in interface Promise<T>

delay

public Promise<T> delay(Duration duration)

Specified by:

delay in interface Promise<T>

delay

public Promise<T> delay(Duration duration,
                        boolean delayOnError)

Specified by:

delay in interface Promise<T>

orTimeout

public Promise<T> orTimeout(long timeout,
                            TimeUnit unit)

Specified by:

orTimeout in interface Promise<T>

orTimeout

public Promise<T> orTimeout(long timeout,
                            TimeUnit unit,
                            boolean cancelOnTimeout)

Specified by:

orTimeout in interface Promise<T>

orTimeout

public Promise<T> orTimeout(Duration duration)

Specified by:

orTimeout in interface Promise<T>

orTimeout

public Promise<T> orTimeout(Duration duration,
                            boolean cancelOnTimeout)

Specified by:

orTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(T value,
                            long timeout,
                            TimeUnit unit)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(T value,
                            long timeout,
                            TimeUnit unit,
                            boolean cancelOnTimeout)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(T value,
                            Duration duration)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(T value,
                            Duration duration,
                            boolean cancelOnTimeout)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(Supplier<? extends T> supplier,
                            long timeout,
                            TimeUnit unit)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(Supplier<? extends T> supplier,
                            long timeout,
                            TimeUnit unit,
                            boolean cancelOnTimeout)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(Supplier<? extends T> supplier,
                            Duration duration)

Specified by:

onTimeout in interface Promise<T>

onTimeout

public Promise<T> onTimeout(Supplier<? extends T> supplier,
                            Duration duration,
                            boolean cancelOnTimeout)

Specified by:

onTimeout in interface Promise<T>

exceptionallyAsync

public Promise<T> exceptionallyAsync(Function<Throwable,? extends T> fn)

Specified by:

exceptionallyAsync in interface Promise<T>

Overrides:

exceptionallyAsync in class AbstractPromiseLikeDecorator<T,D extends Promise<T>>

exceptionallyAsync

public Promise<T> exceptionallyAsync(Function<Throwable,? extends T> fn,
                                     Executor executor)

Specified by:

exceptionallyAsync in interface Promise<T>

Overrides:

exceptionallyAsync in class AbstractPromiseLikeDecorator<T,D extends Promise<T>>

exceptionallyCompose

public Promise<T> exceptionallyCompose(Function<Throwable,? extends CompletionStage<T>> fn)

Specified by:

exceptionallyCompose in interface Promise<T>

Overrides:

exceptionallyCompose in class AbstractPromiseLikeDecorator<T,D extends Promise<T>>

exceptionallyComposeAsync

public Promise<T> exceptionallyComposeAsync(Function<Throwable,? extends CompletionStage<T>> fn)

Specified by:

exceptionallyComposeAsync in interface Promise<T>

Overrides:

exceptionallyComposeAsync in class AbstractPromiseLikeDecorator<T,D extends Promise<T>>

exceptionallyComposeAsync

public Promise<T> exceptionallyComposeAsync(Function<Throwable,? extends CompletionStage<T>> fn,
                                            Executor executor)

Specified by:

exceptionallyComposeAsync in interface Promise<T>

Overrides:

exceptionallyComposeAsync in class AbstractPromiseLikeDecorator<T,D extends Promise<T>>

thenFilter

public Promise<T> thenFilter(Predicate<? super T> predicate)

Specified by:

thenFilter in interface Promise<T>

thenFilter

public Promise<T> thenFilter(Predicate<? super T> predicate,
                             Function<? super T,Throwable> errorSupplier)

Specified by:

thenFilter in interface Promise<T>

thenFilterAsync

public Promise<T> thenFilterAsync(Predicate<? super T> predicate)

Specified by:

thenFilterAsync in interface Promise<T>

thenFilterAsync

public Promise<T> thenFilterAsync(Predicate<? super T> predicate,
                                  Function<? super T,Throwable> errorSupplier)

Specified by:

thenFilterAsync in interface Promise<T>

thenFilterAsync

public Promise<T> thenFilterAsync(Predicate<? super T> predicate,
                                  Executor executor)

Specified by:

thenFilterAsync in interface Promise<T>

thenFilterAsync

public Promise<T> thenFilterAsync(Predicate<? super T> predicate,
                                  Function<? super T,Throwable> errorSupplier,
                                  Executor executor)

Specified by:

thenFilterAsync in interface Promise<T>