org.nustaq.kontraktor.impl

Class CallbackWrapper<T>

java.lang.Object

org.nustaq.kontraktor.impl.CallbackWrapper<T>

All Implemented Interfaces:

Serializable, Callback<T>, IPromise<T>

public class CallbackWrapper<T>
extends Object
implements IPromise<T>, Serializable

..

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.nustaq.kontraktor.Callback

CONT, FIN, FINSILENT

Constructor Summary

Constructors

Constructor and Description
CallbackWrapper(Actor targetQ, Callback<T> realFuture)

Method Summary

Modifier and Type	Method and Description
T	await(long timeout) schedule other events/messages until future is resolved/settled (Nonblocking delay).
IPromise<T>	awaitPromise(long timeout) schedule other events/messages until future is resolved/settled (Nonblocking delay).
<OUT> IPromise<OUT>	catchError(java.util.function.Consumer<Object> function) called if an error has been signaled by one of the futures in the previous future chain.
<OUT> IPromise<OUT>	catchError(java.util.function.Function<Object,IPromise<OUT>> function) called if an error has been signaled by one of the futures in the previous future chain.
void	complete(T result, Object error) set result or error.
T	get() Warning: this is different to JDK's BLOCKING future
Object	getError()
boolean	isSettled()
IPromise<T>	onError(java.util.function.Consumer errorHandler) called when an error is set as the result forwards to (new) "catchError" variant.
IPromise<T>	onResult(java.util.function.Consumer<T> resultHandler) called when a valid result of a future becomes available.
IPromise<T>	onTimeout(java.util.function.Consumer timeoutHandler) called when the async call times out.
IPromise	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(java.util.function.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(java.util.function.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(java.util.function.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	timeoutIn(long millis) tell the future to call the onTimeout callback in N milliseconds if future is not settled until then

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nustaq.kontraktor.IPromise

await, awaitPromise, onTimeout

Methods inherited from interface org.nustaq.kontraktor.Callback

complete, finish, reject, resolve, resolve, stream

Constructor Detail

CallbackWrapper

public CallbackWrapper(Actor targetQ,
                       Callback<T> realFuture)

Method Detail

complete

public void complete(T result,
                     Object error)

Description copied from interface: Callback

set result or error. error might also contain flow indicators to signal end/continue of stream when remoting. (Actor.FIN Actor.CONT)

Specified by:

complete in interface Callback<T>

then

public IPromise<T> then(Runnable result)

Description copied from interface: IPromise

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() );

Specified by:

then in interface IPromise<T>

Returns:

a future ressolved after this

thenAnd

public IPromise<T> thenAnd(java.util.function.Supplier<IPromise<T>> result)

Description copied from interface: IPromise

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"); } );

Specified by:

thenAnd in interface IPromise<T>

Returns:

a future ressolved with the Supüplier result after this

then

public IPromise then(Callback<T> result)

Description copied from interface: IPromise

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() );

Specified by:

then in interface IPromise<T>

Returns:

a future ressolved with the Callable result after this

onResult

public IPromise<T> onResult(java.util.function.Consumer<T> resultHandler)

Description copied from interface: IPromise

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

Specified by:

onResult in interface IPromise<T>

Returns:

onError

public IPromise<T> onError(java.util.function.Consumer errorHandler)

Description copied from interface: IPromise

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

Specified by:

onError in interface IPromise<T>

Returns:

onTimeout

public IPromise<T> onTimeout(java.util.function.Consumer timeoutHandler)

Description copied from interface: IPromise

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

Specified by:

onTimeout in interface IPromise<T>

Returns:

thenAnd

public <OUT> IPromise<OUT> thenAnd(java.util.function.Function<T,IPromise<OUT>> function)

Description copied from interface: IPromise

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"); } );

Specified by:

thenAnd in interface IPromise<T>

Returns:

a future ressolved with the Function result after this

then

public <OUT> IPromise<OUT> then(java.util.function.Consumer<T> function)

Description copied from interface: IPromise

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"); } );

Specified by:

then in interface IPromise<T>

Returns:

a future ressolved empty after this

catchError

public <OUT> IPromise<OUT> catchError(java.util.function.Function<Object,IPromise<OUT>> function)

Description copied from interface: IPromise

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 -> .. );

Specified by:

catchError in interface IPromise<T>

catchError

public <OUT> IPromise<OUT> catchError(java.util.function.Consumer<Object> function)

Description copied from interface: IPromise

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( () -> .. );

Specified by:

catchError in interface IPromise<T>

get

public T get()

Description copied from interface: IPromise

Warning: this is different to JDK's BLOCKING future

Specified by:

get in interface IPromise<T>

Returns:

result if avaiable (no blocking no awaiting).

await

public T await(long timeout)

Description copied from interface: IPromise

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.

Specified by:

await in interface IPromise<T>

Returns:

the futures result or throw exception in case of error

awaitPromise

public IPromise<T> awaitPromise(long timeout)

Description copied from interface: IPromise

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.

Specified by:

awaitPromise in interface IPromise<T>

Returns:

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

getError

public Object getError()

Specified by:

getError in interface IPromise<T>

Returns:

error if avaiable

timeoutIn

public IPromise timeoutIn(long millis)

Description copied from interface: IPromise

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

Specified by:

timeoutIn in interface IPromise<T>

Returns:

this for chaining

isSettled

public boolean isSettled()

Specified by:

isSettled in interface IPromise<T>

Returns:

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