Module org.refcodes.observer
Package org.refcodes.observer
This package provides types supporting the Observable-Pattern. E.g. we have
the definitions of an
Observable and the
according Observer.
An Observable for example can be observed by
Observer instances being subscribed to it via
Observable.subscribeObserver(Object).
-
Interface Summary Interface Description ActionEvent AnActionEventextends theEventand provides additional means to provide an actionActionAccessor.getAction()being of typeEnum.Event EventMatcher<E extends GenericEvent<?>> This interface typifies theMatcherinterface for the usage withGenericActionEventinstances.GenericActionEvent<A,SRC> AnGenericActionEventextends theGenericEventand provides additional means to provide an action viaActionAccessor.getAction()being of a generic type.GenericActionMetaDataEvent<A,EM extends org.refcodes.mixin.EventMetaData,SRC> AnGenericActionMetaDataEventprovides Meta-Data describing theGenericActionEventin more detail and a source being the origin of theGenericActionMetaDataEvent.GenericActionMetaDataEvent.GenericActionMetaDataEventBuilder<A,EM extends org.refcodes.mixin.EventMetaData,SRC,B extends GenericActionMetaDataEvent.GenericActionMetaDataEventBuilder<A,EM,SRC,B>> Builder extension for theGenericActionMetaDataEventtype.GenericActionPayloadEvent<A,P,SRC> TheGenericActionPayloadEventrepresents anActionEventwhich carries an additional payload.GenericActionPayloadMetaDataEvent<A,P,EM extends org.refcodes.mixin.EventMetaData,SRC> AnGenericActionPayloadMetaDataEventprovides Meta-Data describing theGenericActionPayloadMetaDataEventin more detail and a payload as well as an action.GenericActionPayloadMetaDataEvent.GenericActionPayloadMetaDataEventBuilder<A,P,EM extends org.refcodes.mixin.EventMetaData,SRC,B extends GenericActionPayloadMetaDataEvent.GenericActionPayloadMetaDataEventBuilder<A,P,EM,SRC,B>> Builder extension for theGenericActionPayloadMetaDataEventtype.GenericEvent<SRC> GenericMetaDataEvent<EM extends org.refcodes.mixin.EventMetaData,SRC> AnGenericMetaDataEventprovides Meta-Data describing theGenericActionEventin more detail and a source being the origin of theGenericMetaDataEvent.GenericPayloadEvent<P,SRC> TheGenericPayloadEventrepresents anEventwhich carries an additional payload accessible viaPayloadAccessor.getPayload().GenericPayloadMetaDataEvent<P,EM extends org.refcodes.mixin.EventMetaData,SRC> AnGenericPayloadMetaDataEventprovides Meta-Data describing theGenericPayloadMetaDataEventin more detail and a payload.MetaDataActionEvent AnMetaDataActionEventis published by anObservableand is consumed by zero to manyObserverinstances.MetaDataActionEvent.ActionMetaDataEventBuilder Builder for theMetaDataActionEvent.MetaDataEvent MetaDataEventMatcher<E extends GenericMetaDataEvent<?,?>> This interface typifies theMatcherinterface for the usage withGenericMetaDataEventinstances.Observable<O> TheObservableinterface can be implemented by any class which can be observed byObserverinstances (proposal) or any listener interface (custom as of your needs).ObservableObserver<O extends Observable<?>> AnObservableObserveris an observer, observing an observable.Observer<E extends GenericEvent<?>> The listener of an event subscriber to be fed with events by a event publisher.ObserverDescriptor<E extends GenericEvent<?>,O extends Observer<E>,EM extends EventMatcher<E>> ThisObserverDescriptordescribes theObserver, i.e. in some cases anObserverrequires anEventMatcherwhich determines whichGenericActionEventinstances to pass to theObserver.Observers<O,B extends Observers<O,B>> Provides methods to manage all subscribedObserverinstances as a whole and is intended as an extension of theObservableinterface.PayloadActionEvent<P> ThePayloadActionEventrepresents anActionEventwhich carries an additional payload.PayloadEvent<P> ThePayloadEventrepresents anEventwhich carries an additional payload accessible viaPayloadAccessor.getPayload().PayloadMetaDataActionEvent<P> AnPayloadMetaDataActionEventprovides Meta-Data describing thePayloadMetaDataActionEventin more detail and a payload as well as an action.PayloadMetaDataActionEvent.ActionPayloadMetaDataEventBuilder<P> Builder extension for thePayloadMetaDataActionEventtype.PayloadMetaDataEvent<P> AnPayloadMetaDataEventprovides Meta-Data describing theGenericPayloadMetaDataEventin more detail and a payload.Publisher<E extends GenericEvent<?>> A system publishingGenericActionEventinstances (such as an event bus), may implement this interface.SubscribeEvent<O extends Observable<?>> AnSubscribeEventis published by anObservablewhen an observer is being subscribed.UnsubscribeEvent<O extends Observable<?>> AnUnsubscribeEventis published by anObservablewhen an observer is being unsubscribed. -
Class Summary Class Description AbstractActionEvent<A,SRC> The Class AbstractActionEvent.AbstractEvent<SRC> Basic implementation of theGenericEvent.AbstractMetaDataActionEvent<A,EM extends org.refcodes.mixin.EventMetaData,SRC> Ready to useGenericActionEventstoring a defined set ofEventMetaData.AbstractMetaDataActionEvent.AbstractActionMetaDataEventBuilder<A,EM extends org.refcodes.mixin.EventMetaData,SRC,B extends GenericActionMetaDataEvent.GenericActionMetaDataEventBuilder<A,EM,SRC,B>> Implementation of theGenericActionMetaDataEvent.GenericActionMetaDataEventBuilderinterface for easily creatingMetaDataActionEventinstances.AbstractMetaDataEvent<EM extends org.refcodes.mixin.EventMetaData,SRC> Ready to useGenericActionEventstoring a defined set ofEventMetaData.AbstractObservable<O,EV> This abstract class provides functionality to implement default refcodesObservablebehavior.AbstractPayloadActionEvent<A,P,SRC> Basic implementation of theGenericActionPayloadEvent.AbstractPayloadEvent<P,SRC> Basic implementation of theGenericPayloadEvent.AbstractPayloadMetaDataActionEvent<A,P,EM extends org.refcodes.mixin.EventMetaData,SRC> Basic implementation of theGenericActionPayloadMetaDataEvent.AbstractPayloadMetaDataActionEvent.AbstractActionPayloadMetaDataEventBuilder<A,P,EM extends org.refcodes.mixin.EventMetaData,SRC,B extends GenericActionPayloadMetaDataEvent.GenericActionPayloadMetaDataEventBuilder<A,P,EM,SRC,B>> Basic implementation of theGenericActionPayloadMetaDataEvent.GenericActionPayloadMetaDataEventBuilder.AbstractPayloadMetaDataEvent<P,EM extends org.refcodes.mixin.EventMetaData,SRC> Basic implementation of theGenericActionPayloadEvent.ActionEventImpl Basic implementation of theEventinterface.EventImpl Basic implementation of theEventinterface.EventMatcherSugar Declarative syntactic sugar which may be statically imported in order to allow declarative definitions for theEventMatcherelements.MetaDataActionEventBuilderImpl Implementation of theMetaDataActionEvent.ActionMetaDataEventBuilderinterface for easily creatingMetaDataActionEventinstances.MetaDataActionEventImpl MetaDataEventImpl Basic implementation of theEventinterface.ObserverDescriptorImpl<E extends GenericEvent<?>,O extends Observer<E>,EM extends EventMatcher<E>> As a descriptor describes something fixed, this class is immutable in the sense that there are no setters for the attributes.PayloadActionEventImpl<P> ThePayloadActionEventrepresents anActionEventwhich carries an additional payload.PayloadEventImpl<P> Basic implementation of thePayloadEventinterface.PayloadMetaDataActionEventBuilderImpl<P> Implementation of thePayloadMetaDataActionEvent.ActionPayloadMetaDataEventBuilderinterface for easily creatingPayloadMetaDataActionEventinstances.PayloadMetaDataActionEventImpl<P> Basic implementation of theAbstractPayloadMetaDataActionEvent.PayloadMetaDataEventImpl<P> Basic implementation of thePayloadMetaDataEventinterface.SubscribeEventImpl<O extends Observable<?>> The Class SubscribeEventImpl.UnsubscribeEventImpl<O extends Observable<?>> The Class UnsubscribeEventImpl.