org.openzen.zengarden.promise

Class ProcessedPromise<R,R2,S,E extends java.lang.Throwable>

java.lang.Object

org.openzen.zengarden.promise.ProcessedPromise<R,R2,S,E>

All Implemented Interfaces:

Promise<R2,S,E>

public class ProcessedPromise<R,R2,S,E extends java.lang.Throwable>
extends java.lang.Object
implements Promise<R2,S,E>

Contains a promise that has been processed by a specific function. Can be

Constructor Summary

Constructors

Constructor and Description
ProcessedPromise(Promise<R,S,E> originalPromise, ErrorableFunction<R,R2,E> processor) Contains a processed promise, processing the result of the original promise with the given function.

Method Summary

Modifier and Type	Method and Description
R2	get() Retrieves a result synchronously.
java.lang.Class<E>	getErrorClass() Retrieves the error class.
Promise<R2,S,E>	onCached(Consumer<R2> consumer) Registers a consumer to be called when cached data becomes available.
Promise<R2,S,E>	onDone(Consumer<R2> consumer) Registers a consumer to be called when the call has finished.
Promise<R2,S,E>	onFail(Consumer<E> consumer) Registers a consumer to be called when an error occurs.
Promise<R2,S,E>	onStatus(Consumer<S> consumer) Registers a consumer to be called when status updates are available.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openzen.zengarden.promise.Promise

onData, pipe

Constructor Detail

ProcessedPromise

public ProcessedPromise(Promise<R,S,E> originalPromise,
                        ErrorableFunction<R,R2,E> processor)

Contains a processed promise, processing the result of the original promise with the given function.

Parameters:

originalPromise - original promise

processor - value processor

Method Detail

getErrorClass

public java.lang.Class<E> getErrorClass()

Description copied from interface: Promise

Retrieves the error class. Used to perform proper error handling.

Specified by:

getErrorClass in interface Promise<R2,S,E extends java.lang.Throwable>

Returns:

error class

onDone

public Promise<R2,S,E> onDone(Consumer<R2> consumer)

Description copied from interface: Promise

Registers a consumer to be called when the call has finished. The consumer might be called immediately.

Specified by:

onDone in interface Promise<R2,S,E extends java.lang.Throwable>

Parameters:

consumer - result consumer

Returns:

this promise

onCached

public Promise<R2,S,E> onCached(Consumer<R2> consumer)

Description copied from interface: Promise

Registers a consumer to be called when cached data becomes available. The consumer might be called immediately.

Specified by:

onCached in interface Promise<R2,S,E extends java.lang.Throwable>

Parameters:

consumer - cached value consumer

Returns:

this promise

onStatus

public Promise<R2,S,E> onStatus(Consumer<S> consumer)

Description copied from interface: Promise

Registers a consumer to be called when status updates are available. This consumer might be called any number of times, or not at all.

Specified by:

onStatus in interface Promise<R2,S,E extends java.lang.Throwable>

Parameters:

consumer - status consumer

Returns:

this promise

onFail

public Promise<R2,S,E> onFail(Consumer<E> consumer)

Description copied from interface: Promise

Registers a consumer to be called when an error occurs.

Specified by:

onFail in interface Promise<R2,S,E extends java.lang.Throwable>

Parameters:

consumer - error consumer

Returns:

this promise

get

public R2 get()
       throws E extends java.lang.Throwable

Description copied from interface: Promise

Retrieves a result synchronously. Might wait return a result immediately, wait until one is a available, or throw an exception if an error occurs.

Specified by:

get in interface Promise<R2,S,E extends java.lang.Throwable>

Returns:

resulting value

Throws:

E - if the request failed

E extends java.lang.Throwable