Package org.nuxeo.ecm.automation.core.events

Class EventRegistry

java.lang.Object

org.nuxeo.runtime.model.ContributionFragmentRegistry<EventHandler>

org.nuxeo.ecm.automation.core.events.EventRegistry

public class EventRegistry
extends ContributionFragmentRegistry<EventHandler>

Since:

5.6

Nested Class Summary

Nested classes/interfaces inherited from class org.nuxeo.runtime.model.ContributionFragmentRegistry

ContributionFragmentRegistry.Fragment<T>, ContributionFragmentRegistry.FragmentList<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected Map<String,List<EventHandler>>	handlers
protected Map<String,List<EventHandler>>	lookup

Fields inherited from class org.nuxeo.runtime.model.ContributionFragmentRegistry

contribs

Constructor Summary

Constructors

Constructor	Description
EventRegistry()

Method Summary

Modifier and Type	Method	Description
EventHandler	clone(EventHandler orig)	CLone the given contribution object
void	contributionRemoved(String id, EventHandler handler)	All the fragments in the contribution was removed.
void	contributionUpdated(String id, EventHandler handler, EventHandler newOrigContrib)	Adds or updates a contribution.
String	getContributionId(EventHandler contrib)	Returns the contribution ID given the contribution object
boolean	isSupportingMerge()	Returns true if merge is supported.
Map<String,List<EventHandler>>	lookup()
void	merge(EventHandler src, EventHandler dst)	Merge 'src' into 'dst'.
protected void	putEventHandler(String eventId, EventHandler handler)

Methods inherited from class org.nuxeo.runtime.model.ContributionFragmentRegistry

addContribution, addFragment, getContribution, getFragments, removeContribution, removeContribution, removeFragment, toMap

Methods inherited from class java.lang.Object

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

Field Detail

handlers

protected Map<String,List<EventHandler>> handlers

lookup

protected volatile Map<String,List<EventHandler>> lookup

Constructor Detail

EventRegistry

public EventRegistry()

Method Detail

getContributionId

public String getContributionId(EventHandler contrib)

Description copied from class: ContributionFragmentRegistry

Returns the contribution ID given the contribution object

Specified by:

getContributionId in class ContributionFragmentRegistry<EventHandler>

contributionUpdated

public void contributionUpdated(String id,
                                EventHandler handler,
                                EventHandler newOrigContrib)

Description copied from class: ContributionFragmentRegistry

Adds or updates a contribution.

If the contribution doesn't yet exists then it will be added, otherwise the value will be updated. If the given value is null the existing contribution must be removed.

The second parameter is the contribution that should be updated when merging, as well as stored and used. This usually represents a clone of the original contribution or a merge of multiple contribution fragments. Modifications on this object at application level will be lost on next method call on the same object id: modifications should be done in the ContributionFragmentRegistry.merge(Object, Object) method.

The last parameter is the new contribution object, unchanged (original) which was neither cloned nor merged. This object should never be modified at application level, because it will be used each time a subsequent merge is done. Also, it never should be stored.

Specified by:

contributionUpdated in class ContributionFragmentRegistry<EventHandler>

Parameters:

id - - the id of the contribution that needs to be updated

handler - the updated contribution object that

newOrigContrib - - the new, unchanged (original) contribution fragment that triggered the update.

putEventHandler

protected void putEventHandler(String eventId,
                               EventHandler handler)

contributionRemoved

public void contributionRemoved(String id,
                                EventHandler handler)

Description copied from class: ContributionFragmentRegistry

All the fragments in the contribution was removed. Contribution must be unregistered.

The first parameter is the contribution ID that should be remove and the second parameter the original contribution fragment that as unregistered causing the contribution to be removed.

Specified by:

contributionRemoved in class ContributionFragmentRegistry<EventHandler>

isSupportingMerge

public boolean isSupportingMerge()

Description copied from class: ContributionFragmentRegistry

Returns true if merge is supported.

Hook method to be overridden if merge logics behind Object.clone() and ContributionFragmentRegistry.merge(Object, Object) cannot be implemented.

Overrides:

isSupportingMerge in class ContributionFragmentRegistry<EventHandler>

clone

public EventHandler clone(EventHandler orig)

Description copied from class: ContributionFragmentRegistry

CLone the given contribution object

Specified by:

clone in class ContributionFragmentRegistry<EventHandler>

merge

public void merge(EventHandler src,
                  EventHandler dst)

Description copied from class: ContributionFragmentRegistry

Merge 'src' into 'dst'. When merging only the 'dst' object is modified.

Specified by:

merge in class ContributionFragmentRegistry<EventHandler>

Parameters:

src - the object to copy over the 'dst' object

dst - this object is modified

lookup

public Map<String,List<EventHandler>> lookup()