org.nustaq.kontraktor

Interface IPromise<T>

All Superinterfaces:

Callback<T>, Serializable

All Known Implementing Classes:

CallbackWrapper, Promise

public interface IPromise<T>
extends Callback<T>

IPromise interface. Promise is another term for Future, to avoid naming clashes with JDK. The only implementation is "Promise" currently. I try to stick to ES6/7 terminology where possible.

Field Summary

Fields inherited from interface org.nustaq.kontraktor.Callback

CONT

Method Summary

Modifier and Type	Method and Description
default T	await() schedule other events/messages until future is resolved/settled (Nonblocking wait).
T	await(long timeoutMillis) schedule other events/messages until future is resolved/settled (Nonblocking delay).
default IPromise<T>	awaitPromise() similar to await but does not unwrap the promise.
IPromise<T>	awaitPromise(long timeout) schedule other events/messages until future is resolved/settled (Nonblocking delay).
<OUT> IPromise<OUT>	catchError(Consumer<Object> function) called if an error has been signaled by one of the futures in the previous future chain.
<OUT> IPromise<OUT>	catchError(Function<Object,IPromise<OUT>> function) called if an error has been signaled by one of the futures in the previous future chain.
T	get() Warning: this is different to JDK's BLOCKING future
Object	getError()
boolean	isSettled()
default IPromise<T>	onError(Consumer<Object> errorHandler) called when an error is set as the result forwards to (new) "catchError" variant.
default IPromise<T>	onResult(Consumer<T> resultHandler) called when a valid result of a future becomes available.
IPromise<T>	onTimeout(Consumer timeoutHandler) called when the async call times out.
default IPromise<T>	onTimeout(Runnable timeoutHandler)
IPromise<T>	then(Callback<T> result) called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing.
<OUT> IPromise<OUT>	then(Consumer<T> function) called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing.
IPromise<T>	then(Runnable result) called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing.
<OUT> IPromise<OUT>	thenAnd(Function<T,IPromise<OUT>> function) called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing.
IPromise<T>	thenAnd(Supplier<IPromise<T>> result) called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing.
IPromise<T>	timeoutIn(long millis) tellMsg the future to call the onTimeout callback in N milliseconds if future is not settled until then

Methods inherited from interface org.nustaq.kontraktor.Callback

complete, complete, finish, isTerminated, pipe, reject, resolve, resolve

Method Detail

then

IPromise<T> then(Runnable result)

called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing. e.g. actor.asyncMehod().then( () -> furtherProcessing() );

Returns:

a future ressolved after this

then

IPromise<T> then(Callback<T> result)

called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing. e.g. actor.asyncMehod().then( () -> furtherProcessing() );

Returns:

a future ressolved with the Callable result after this

thenAnd

IPromise<T> thenAnd(Supplier<IPromise<T>> result)

called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing. e.g. actor.asyncMehod().then( () -> { furtherProcessing(); return new Promise("result"); } );

Returns:

a future ressolved with the Supüplier result after this

thenAnd

<OUT> IPromise<OUT> thenAnd(Function<T,IPromise<OUT>> function)

called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing. e.g. actor.asyncMehod().then( () -> { furtherProcessing(); return new Promise("result"); } );

Returns:

a future ressolved with the Function result after this

then

<OUT> IPromise<OUT> then(Consumer<T> function)

called once any result of a future becomes available Can be used in case a sender is not interested in the actual result but when a remote method has finished processing. e.g. actor.asyncMethod().then( () -> { furtherProcessing(); return new Promise("result"); } );

Returns:

a future ressolved empty after this

catchError

<OUT> IPromise<OUT> catchError(Function<Object,IPromise<OUT>> function)

called if an error has been signaled by one of the futures in the previous future chain. e.e. actor.async().then( ).then( ).then( ).catchError( error -> .. );

catchError

<OUT> IPromise<OUT> catchError(Consumer<Object> function)

called if an error has been signaled by one of the futures in the previous future chain. e.e. actor.async().then( ).then( ).then( ).catchError( () -> .. );

onResult

default IPromise<T> onResult(Consumer<T> resultHandler)

called when a valid result of a future becomes available. forwards to (new) "then" variant.

Returns:

onError

default IPromise<T> onError(Consumer<Object> errorHandler)

called when an error is set as the result forwards to (new) "catchError" variant.

Returns:

onTimeout

IPromise<T> onTimeout(Consumer timeoutHandler)

called when the async call times out. see 'timeOutIn'

Parameters:

timeoutHandler -

Returns:

onTimeout

default IPromise<T> onTimeout(Runnable timeoutHandler)

get

T get()

Warning: this is different to JDK's BLOCKING future

Returns:

result if avaiable (no blocking no awaiting).

await

default T await()

schedule other events/messages until future is resolved/settled (Nonblocking wait). In case this is called from a non-actor thread, the current thread is blocked until the result is avaiable. If the future is rejected (resolves to an error) an exception is raised. This method is aequivalent to await(15000) = 15 seconds timeout. use await(0) to wait infinetely.

Returns:

the futures result or throw exception in case of error

await

T await(long timeoutMillis)

schedule other events/messages until future is resolved/settled (Nonblocking delay). In case this is called from a non-actor thread, the current thread is blocked until the result is avaiable. If the future is rejected (resolves to an error) an excpetion is raised. if timeout is 0l - wait forever.

Returns:

the futures result or throw exception in case of error

awaitPromise

IPromise<T> awaitPromise(long timeout)

schedule other events/messages until future is resolved/settled (Nonblocking delay). In case this is called from a non-actor thread, the current thread is blocked until the result is avaiable.

Parameters:

timeout -

Returns:

the settled promise. No Exception is thrown, but the exception can be obtained by IPromise.getError()

awaitPromise

default IPromise<T> awaitPromise()

similar to await but does not unwrap the promise. So a fulfilled promise is returned. In case of errors, no exception is thrown to the caller but the promise error is set.

Returns:

getError

Object getError()

Returns:

error if avaiable

timeoutIn

IPromise<T> timeoutIn(long millis)

tellMsg the future to call the onTimeout callback in N milliseconds if future is not settled until then

Parameters:

millis -

Returns:

this for chaining

isSettled

boolean isSettled()

Returns:

wether an error or a result has been set to this future