eu.bandm.tools.message

Class MessageCatcher

java.lang.Object

eu.bandm.tools.message.SingleSender<Message>

eu.bandm.tools.message.MessageCatcher

All Implemented Interfaces:

Runnable

public class MessageCatcher
extends SingleSender<Message>
implements Runnable

Executes some code (given explicitly as argument) and sends the first exception caught to its message drain.

The code can either be defined (1) as a Runnable and given as constructor argument, or (2) be re-defining code() in a derived class.
Then call run() to start execution.

Caught throwables which are Messages are sent directly to the MessageReceiver in SingleSender.receiver. All other Exception are wrapped into a SimpleMessageof kind failure.
Errors are not caught.

Field Summary

Fields

Modifier and Type	Field and Description
protected Exception	caught
protected Runnable	runnable

Fields inherited from class eu.bandm.tools.message.SingleSender

receiver

Constructor Summary

Constructors

Constructor and Description
MessageCatcher(MessageReceiver<Message> rec) When using this constructor, you have to re-define teh method code().
MessageCatcher(Runnable c, MessageReceiver<Message> rec)

Method Summary

Modifier and Type	Method and Description
protected void	code() Redefine this method, or set the value of runnable via constructor call.
Exception	getCaught() returns the last throwable caught, if any.
void	run()

Methods inherited from class eu.bandm.tools.message.SingleSender

getReceiver, send, setReceiver

Methods inherited from class java.lang.Object

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

Field Detail

caught

protected Exception caught

runnable

protected final Runnable runnable

Constructor Detail

MessageCatcher

public MessageCatcher(Runnable c,
                      MessageReceiver<Message> rec)

MessageCatcher

public MessageCatcher(MessageReceiver<Message> rec)

When using this constructor, you have to re-define teh method code(). Otherwise code will crash intentionally.

Method Detail

getCaught

public Exception getCaught()

returns the last throwable caught, if any.

code

protected void code()

Redefine this method, or set the value of runnable via constructor call. Otherwise code will crash intentionally.

run

public void run()

Specified by:

run in interface Runnable