Module org.refcodes.observer
Package 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).
-
ClassDescriptionAbstractActionEvent<A,
SRC> The Class AbstractActionEvent.AbstractEvent<SRC>Basic implementation of theGenericEvent.AbstractEventMatcher<E extends GenericEvent<?>>Abstract implementation of anEventMatchertype.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.Matches the given action with the action stored in an event's meta data (ACTION EQUAL WITH).AnActionEventextends theEventand provides additional means to provide an actionActionAccessor.getAction()being of typeEnum.Basic implementation of theEventinterface.Matches the given alias with the alias stored in an event's meta data (ALIAS EQUAL WITH).Catches all events, no matching is done (CATCH ALL).Catches no events, no matching is done (CATCH NONE).Matches the given channel with the channel stored in an event's meta data (CHANNEL EQUAL WITH).Basic implementation of theEventinterface.EventMatcher<E extends GenericEvent<?>>This interface typifies theMatcherinterface for the usage withGenericActionEventinstances.Declarative syntactic sugar which may be statically imported in order to allow declarative definitions for theEventMatcherelements.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.Matches the given group with the group stored in an event's meta data (GROUP EQUAL WITH).AnMetaDataActionEventis published by anObservableand is consumed by zero to manyObserverinstances.Builder for theMetaDataActionEvent.Implementation of theMetaDataActionEvent.ActionMetaDataEventBuilderinterface for easily creatingMetaDataActionEventinstances.The Class MetaDataActionEventImpl.Basic implementation of theEventinterface.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.ThisObserverDescriptordescribes theObserver, i.e. in some cases anObserverrequires anEventMatcherwhich determines whichGenericActionEventinstances to pass to theObserver.As a descriptor describes something fixed, this class is immutable in the sense that there are no setters for the attributes.Provides methods to manage all subscribedObserverinstances as a whole and is intended as an extension of theObservableinterface.ThePayloadActionEventrepresents anActionEventwhich carries an additional payload.ThePayloadActionEventrepresents anActionEventwhich carries an additional payload.PayloadEvent<P>ThePayloadEventrepresents anEventwhich carries an additional payload accessible viaPayloadAccessor.getPayload().Basic implementation of thePayloadEventinterface.AnPayloadMetaDataActionEventprovides Meta-Data describing thePayloadMetaDataActionEventin more detail and a payload as well as an action.Builder extension for thePayloadMetaDataActionEventtype.Implementation of thePayloadMetaDataActionEvent.ActionPayloadMetaDataEventBuilderinterface for easily creatingPayloadMetaDataActionEventinstances.Basic implementation of theAbstractPayloadMetaDataActionEvent.AnPayloadMetaDataEventprovides Meta-Data describing theGenericPayloadMetaDataEventin more detail and a payload.Basic implementation of thePayloadMetaDataEventinterface.Publisher<E extends GenericEvent<?>>A system publishingGenericActionEventinstances (such as an event bus), may implement this interface.Matches by event publisher type (EVENT PUBLISHER TYPE).SubscribeEvent<O extends Observable<?>>AnSubscribeEventis published by anObservablewhen an observer is being subscribed.SubscribeEventImpl<O extends Observable<?>>The Class SubscribeEventImpl.Matches the given universal ID with the universal ID stored in an event's meta data (UNIVERSAL ID EQUAL WITH).UnsubscribeEvent<O extends Observable<?>>AnUnsubscribeEventis published by anObservablewhen an observer is being unsubscribed.UnsubscribeEventImpl<O extends Observable<?>>The Class UnsubscribeEventImpl.