com.flyingspaniel.nava.callback

Interface Callback<IN,OUT>

All Known Subinterfaces:

Callback.ProducesMore<IN,OUT,MORE>, Callback.ProducesMultiple<IN,OUT>

All Known Implementing Classes:

AbstractCallback, AbstractCallback.Canned, AbstractCallback.NOP, EmittingCallbackFn, EmittingCallbackFn.NOP, Request

public interface Callback<IN,OUT>

Interface for a javascript/node.js like callback (and chain) Warning: The generics are mainly for documentation and decoration. Internally there are unchecked casts and if you screw up you will get ClassCastExceptions Also, currently there is limited support for more...

Since:

Copyright(c) 2013 Morgan Conrad

Author:

Morgan Conrad

See Also:

This software is released under the MIT License

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Callback.ProducesMore<IN,OUT,MORE> Implement this (rare) if your callback produces "more" than a single output This will be used by a single followup callback as its more...
static interface	Callback.ProducesMultiple<IN,OUT> Implement this if your callback produces multiple single outputs to be used by multiple followup callbacks as their IN argument.

Method Summary

Methods

Modifier and Type	Method and Description
OUT	callback(Exception ex, IN in, Object... more) The callback method
Callback	getNextCallback() Get the callback to follow this one.
void	setNextCallback(Callback nextCallback) Set the callback to follow this one.

Method Detail

callback

OUT callback(Exception ex,
           IN in,
           Object... more)
             throws Exception

The callback method

Parameters:

ex - null, or an Exception thrown from an earlier callback. You should test for this!

in - input data, probably coming from a previous callback

more - additional input data (rarely used)

Returns:

result of processing

Throws:

Exception

setNextCallback

void setNextCallback(Callback nextCallback)

Set the callback to follow this one.

Parameters:

nextCallback - null means end of the line

getNextCallback

Callback getNextCallback()

Get the callback to follow this one.

Returns:

null means end of the line