Package io.activej.promise

Class NextPromise<T,R>

java.lang.Object

io.activej.promise.NextPromise<T,R>

All Implemented Interfaces:

AsyncComputation<R>, Callback<T>, Promisable<R>, Promise<R>

public abstract class NextPromise<T,R>
extends Object

Helps to create sequent chains of Promises.

Nested Class Summary

Nested classes/interfaces inherited from interface io.activej.promise.Promise

Promise.BlockingCallable<V>, Promise.BlockingRunnable

Field Summary

Fields

Modifier and Type	Field	Description
protected @Nullable Throwable	exception
protected @Nullable Callback<? super T>	next
protected T	result

Constructor Summary

Constructors

Constructor	Description
NextPromise()

Method Summary

Modifier and Type	Method	Description
@NotNull Promise<T>	async()	Ensures that Promise completes asynchronously: if this Promise is already completed, its completion will be posted to next eventloop tick.
@NotNull Promise<Void>	both(@NotNull Promise<?> other)	Returns a new Promise when both this and provided other Promises complete.
<U,V> @NotNull Promise<V>	combine(@NotNull Promise<? extends U> other, @NotNull BiFunction<? super T,? super U,? extends V> fn)	Returns a new Promise that, when this and the other given Promise both complete, is executed with the two results as arguments to the supplied function.
protected void	complete(T value)
protected void	complete(T value, @Nullable Throwable e)
protected void	completeExceptionally(@Nullable Throwable e)
protected String	describe()
@NotNull Promise<T>	either(@NotNull Promise<? extends T> other)	Returns the Promise which was completed first.
Throwable	getException()
T	getResult()
io.activej.common.collection.Try<T>	getTry()
boolean	isComplete()
boolean	isException()
boolean	isResult()
<U> @NotNull Promise<U>	map(@NotNull Function<? super T,? extends U> fn)	Returns a new Promise which is executed with this Promise's result as the argument to the provided function when this Promise completes successfully.
<U> @NotNull Promise<U>	mapEx(@NotNull BiFunction<? super T,Throwable,? extends U> fn)	Returns a new Promise which is executed with this Promise's result as the argument to the provided function when this Promise completes either successfully (when exception is null) or with an exception.
<U,P extends Callback<? super T> & Promise<U>> @NotNull Promise<U>	next(P promise)	Executes given promise after execution of this Promise completes.
protected static @Nullable Void	recycleToVoid(Object item)
void	reset()
void	resetCallbacks()
protected void	subscribe(@NotNull Callback<? super T> callback)
<U> @NotNull Promise<U>	then(@NotNull Function<? super T,? extends Promise<? extends U>> fn)	Returns a new Promise which, when this Promise completes successfully, is executed with this Promise's result as the argument to the supplied function.
<U> @NotNull Promise<U>	then(@NotNull Supplier<? extends Promise<? extends U>> fn)
<U> @NotNull Promise<U>	thenEx(@NotNull BiFunction<? super T,Throwable,? extends Promise<? extends U>> fn)	Returns a new Promise which, when this Promise completes either successfully (if exception is null) or exceptionally (if exception is not null), is executed with this Promise's result as the argument to the supplied function.
@NotNull CompletableFuture<T>	toCompletableFuture()	Wraps Promise into CompletableFuture.
String	toString()
@NotNull Promise<io.activej.common.collection.Try<T>>	toTry()	Returns Promise that always completes successfully with result or exception wrapped in Try.
@NotNull Promise<Void>	toVoid()	Waits for result and discards it.
protected boolean	tryComplete(T value)
protected boolean	tryComplete(T value, @Nullable Throwable e)
protected boolean	tryCompleteExceptionally(@NotNull Throwable e)
@NotNull Promise<T>	whenComplete(@NotNull Callback<? super T> action)	Subscribes given action to be executed after this Promise completes and returns a new Promise.
@NotNull Promise<T>	whenComplete(@NotNull Runnable action)	Subscribes given action to be executed after this Promise completes and returns a new Promise.
Promise<T>	whenException(@NotNull Runnable action)
Promise<T>	whenException(@NotNull Consumer<Throwable> action)	Subscribes given action to be executed after this Promise completes exceptionally and returns a new Promise.
Promise<T>	whenResult(@NotNull Runnable action)
@NotNull Promise<T>	whenResult(Consumer<? super T> action)	Subscribes given action to be executed after this Promise completes successfully and returns a new Promise.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.activej.async.callback.Callback

accept

Methods inherited from interface io.activej.promise.Promise

post, promise, run

Field Detail

result

protected T result

exception

@Nullable
protected @Nullable Throwable exception

next

@Nullable
protected @Nullable Callback<? super T> next

Constructor Detail

NextPromise

public NextPromise()

Method Detail

reset

public void reset()

resetCallbacks

public void resetCallbacks()

isComplete

public final boolean isComplete()

Specified by:

isComplete in interface Promise<T>

isResult

public final boolean isResult()

Specified by:

isResult in interface Promise<T>

isException

public final boolean isException()

Specified by:

isException in interface Promise<T>

getResult

public T getResult()

Specified by:

getResult in interface Promise<T>

getException

public Throwable getException()

Specified by:

getException in interface Promise<T>

getTry

public io.activej.common.collection.Try<T> getTry()

Specified by:

getTry in interface Promise<T>

complete

protected void complete(@Nullable
                        T value,
                        @Nullable
                        @Nullable Throwable e)

complete

protected void complete(@Nullable
                        T value)

completeExceptionally

protected void completeExceptionally(@Nullable
                                     @Nullable Throwable e)

tryComplete

protected boolean tryComplete(@Nullable
                              T value,
                              @Nullable
                              @Nullable Throwable e)

tryComplete

protected boolean tryComplete(@Nullable
                              T value)

tryCompleteExceptionally

protected boolean tryCompleteExceptionally(@NotNull
                                           @NotNull Throwable e)

next

@NotNull
public <U,P extends Callback<? super T> & Promise<U>> @NotNull Promise<U> next(@NotNull
                                                                                     P promise)

Description copied from interface: Promise

Executes given promise after execution of this Promise completes.

Specified by:

next in interface Promise<T>

Type Parameters:

U - type of result

Parameters:

promise - given promise

Returns:

subscribed Promise

subscribe

protected void subscribe(@NotNull
                         @NotNull Callback<? super T> callback)

map

@NotNull
public <U> @NotNull Promise<U> map(@NotNull
                                   @NotNull Function<? super T,? extends U> fn)

Description copied from interface: Promise

Returns a new Promise which is executed with this Promise's result as the argument to the provided function when this Promise completes successfully.

Specified by:

map in interface Promise<T>

Parameters:

fn - function to be applied to this Promise when it completes successfully

Returns:

new Promise which is the result of function applied to the result of this Promise

See Also:

CompletionStage.thenApply(Function)

mapEx

@NotNull
public <U> @NotNull Promise<U> mapEx(@NotNull
                                     @NotNull BiFunction<? super T,Throwable,? extends U> fn)

Description copied from interface: Promise

Returns a new Promise which is executed with this Promise's result as the argument to the provided function when this Promise completes either successfully (when exception is null) or with an exception.

Specified by:

mapEx in interface Promise<T>

Parameters:

fn - function to be applied to this Promise when it completes either successfully or with an exception

Returns:

new Promise which is the result of function applied to the result of this Promise

then

@NotNull
public <U> @NotNull Promise<U> then(@NotNull
                                    @NotNull Function<? super T,? extends Promise<? extends U>> fn)

Description copied from interface: Promise

Returns a new Promise which, when this Promise completes successfully, is executed with this Promise's result as the argument to the supplied function.

Specified by:

then in interface Promise<T>

Parameters:

fn - to be applied

then

@NotNull
public <U> @NotNull Promise<U> then(@NotNull
                                    @NotNull Supplier<? extends Promise<? extends U>> fn)

Specified by:

then in interface Promise<T>

thenEx

@NotNull
public <U> @NotNull Promise<U> thenEx(@NotNull
                                      @NotNull BiFunction<? super T,Throwable,? extends Promise<? extends U>> fn)

Description copied from interface: Promise

Returns a new Promise which, when this Promise completes either successfully (if exception is null) or exceptionally (if exception is not null), is executed with this Promise's result as the argument to the supplied function.

Specified by:

thenEx in interface Promise<T>

Parameters:

fn - to be applied to the result of this Promise

Returns:

new Promise

whenComplete

@NotNull
public @NotNull Promise<T> whenComplete(@NotNull
                                        @NotNull Callback<? super T> action)

Description copied from interface: Promise

Subscribes given action to be executed after this Promise completes and returns a new Promise.

Specified by:

whenComplete in interface Promise<T>

Parameters:

action - to be executed

whenComplete

@NotNull
public @NotNull Promise<T> whenComplete(@NotNull
                                        @NotNull Runnable action)

Description copied from interface: Promise

Subscribes given action to be executed after this Promise completes and returns a new Promise.

Specified by:

whenComplete in interface Promise<T>

Parameters:

action - to be executed

whenResult

@NotNull
public @NotNull Promise<T> whenResult(Consumer<? super T> action)

Description copied from interface: Promise

Subscribes given action to be executed after this Promise completes successfully and returns a new Promise.

Specified by:

whenResult in interface Promise<T>

Parameters:

action - to be executed

whenResult

public Promise<T> whenResult(@NotNull
                             @NotNull Runnable action)

Specified by:

whenResult in interface Promise<T>

whenException

public Promise<T> whenException(@NotNull
                                @NotNull Consumer<Throwable> action)

Description copied from interface: Promise

Subscribes given action to be executed after this Promise completes exceptionally and returns a new Promise.

Specified by:

whenException in interface Promise<T>

Parameters:

action - to be executed

whenException

public Promise<T> whenException(@NotNull
                                @NotNull Runnable action)

Specified by:

whenException in interface Promise<T>

async

@NotNull
public @NotNull Promise<T> async()

Description copied from interface: Promise

Ensures that Promise completes asynchronously: if this Promise is already completed, its completion will be posted to next eventloop tick. Otherwise, does nothing.

Specified by:

async in interface Promise<T>

combine

@NotNull
public <U,V> @NotNull Promise<V> combine(@NotNull
                                               @NotNull Promise<? extends U> other,
                                               @NotNull
                                               @NotNull BiFunction<? super T,? super U,? extends V> fn)

Description copied from interface: Promise

Returns a new Promise that, when this and the other given Promise both complete, is executed with the two results as arguments to the supplied function.

Specified by:

combine in interface Promise<T>

Parameters:

other - the other Promise

fn - the function to use to compute the value of the returned Promise

Returns:

new Promise

both

@NotNull
public @NotNull Promise<Void> both(@NotNull
                                   @NotNull Promise<?> other)

Description copied from interface: Promise

Returns a new Promise when both this and provided other Promises complete.

Specified by:

both in interface Promise<T>

Parameters:

other - the other Promise

Returns:

Promise of null when both this and other Promise complete

recycleToVoid

@Nullable
protected static @Nullable Void recycleToVoid(Object item)

either

@NotNull
public @NotNull Promise<T> either(@NotNull
                                  @NotNull Promise<? extends T> other)

Description copied from interface: Promise

Returns the Promise which was completed first.

Specified by:

either in interface Promise<T>

Parameters:

other - the other Promise

Returns:

the first completed Promise

toTry

@NotNull
public @NotNull Promise<io.activej.common.collection.Try<T>> toTry()

Description copied from interface: Promise

Returns Promise that always completes successfully with result or exception wrapped in Try.

Specified by:

toTry in interface Promise<T>

toVoid

@NotNull
public @NotNull Promise<Void> toVoid()

Description copied from interface: Promise

Waits for result and discards it.

Specified by:

toVoid in interface Promise<T>

toCompletableFuture

@NotNull
public @NotNull CompletableFuture<T> toCompletableFuture()

Description copied from interface: Promise

Wraps Promise into CompletableFuture.

Specified by:

toCompletableFuture in interface Promise<T>

describe

protected String describe()

toString

public String toString()

Overrides:

toString in class Object