Package org.javasimon.callback

Callback is an event listener registered with the Manager, listening for manager or Simon events.

See: Description

Interface Summary

Interface	Description
Callback	Callback processes various events of the Java Simon API and is used as an extension point of the API.
CompositeCallback	Composite Callback can hold more callbacks which allows to form callback trees where events are passed to sub-callbacks.
FilterCallback	FilterCallback extends Callback adding filtering capabilities.

Class Summary

Class	Description
CallbackSkeleton	Implements Callback interface so that it does nothing - intended for extension by simple (non-composite) callbacks.
CompositeCallbackImpl	Composite callbacks holds child-callbacks and delegates any operations to all of them.
CompositeFilterCallback	This callback combines Composite and Filter behavior.
FilterRule	Represents filtering rule that checks whether sub-callbacks will get the event.

Enum Summary

Enum	Description
Callback.Event	Enumeration of all supported callback actions.
FilterRule.Type	Enumeration of rule types that determines the evaluation of multiple rules in a chain.

Package org.javasimon.callback Description

Callback is an event listener registered with the Manager, listening for manager or Simon events. Any number of callbacks can be registered on a manager using Manager.callback() and CompositeCallback.addCallback(Callback).

Non-composite callbacks are used to perform expected actions for particular events. CallbackSkeleton can be extended if only selected events are desired to be implemented instead of implementating the whole Callback interface.

Composite callbacks are used to organize other callbacks in trees and then to delegate all events to them. It is not recommended to mix composite callbacks with functionality, generally it should not be necessary to implement composite callbacks in addition to the following two provided implementations:

• CompositeCallbackImpl delegates all events to all sub-callbacks (used in EnabledManager for instance);
• CompositeFilterCallback allows to filter events that should be propagated to the sub-callbacks, filter rules can be added using FilterCallback.addRule(org.javasimon.callback.FilterRule.Type, String, String, org.javasimon.callback.Callback.Event...).