org.jboss.weld.event

Class ObserverNotifier

java.lang.Object

org.jboss.weld.event.ObserverNotifier

Direct Known Subclasses:

TransactionalObserverNotifier

public class ObserverNotifier
extends Object

Provides event-related operations such as observer method resolution and event delivery. An ObserverNotifier may be created with strict checks enabled. In such case event type checks are performed. Otherwise, the ObserverNotifier is called lenient. The lenient version should be used for internal dispatching of events only.

Author:

Jozef Hartinger, David Allen

Field Summary

Fields

Modifier and Type	Field and Description
protected CurrentEventMetadata	currentEventMetadata

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ObserverNotifier(TypeSafeObserverResolver resolver, ServiceRegistry services, boolean strict)

Method Summary

Modifier and Type	Method and Description
protected Resolvable	buildEventResolvable(Type eventType, Annotation... qualifiers)
protected Resolvable	buildEventResolvable(Type eventType, Set<Annotation> qualifiers)
void	clear() Clears cached observer method resolutions and event type checks.
void	fireEvent(Object event, EventMetadata metadata, Annotation... qualifiers) Delivers the given event object to observer methods resolved based on the runtime type of the event object and given event qualifiers.
void	fireEvent(Object event, Resolvable resolvable) Delivers the given event object to observer methods resolved based on the given resolvable.
void	fireEvent(Type eventType, Object event, Annotation... qualifiers) Delivers the given event object to observer methods resolved based on the given event type and qualifiers.
void	fireEvent(Type eventType, Object event, EventMetadata metadata, Annotation... qualifiers)
protected void	checkEventObjectType(Object event)
void	checkEventObjectType(Type eventType) If strict checks are enabled this method performs event type checks on the given type.
void	checkEventSubtype(Type subtype)
<T> void	notify(ResolvedObservers<T> observers, T event, EventMetadata metadata) Delivers the given event object to given observer methods.
protected <T> void	notifySyncObservers(List<ObserverMethod<? super T>> observers, T event, EventMetadata metadata)
protected <T> void	notifyTransactionObservers(List<ObserverMethod<? super T>> observers, T event, EventMetadata metadata)
static ObserverNotifier	of(String contextId, TypeSafeObserverResolver resolver, ServiceRegistry services, boolean strict)
<T> ResolvedObservers<T>	resolveObserverMethods(Resolvable resolvable) Resolves observer methods using the given resolvable.
<T> ResolvedObservers<T>	resolveObserverMethods(Type eventType, Annotation... qualifiers) Resolves observer methods based on the given event type and qualifiers.
<T> ResolvedObservers<T>	resolveObserverMethods(Type eventType, Set<Annotation> qualifiers) Resolves observer methods based on the given event type and qualifiers.

Methods inherited from class java.lang.Object

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

Field Detail

currentEventMetadata

protected final CurrentEventMetadata currentEventMetadata

Constructor Detail

ObserverNotifier

protected ObserverNotifier(TypeSafeObserverResolver resolver,
                           ServiceRegistry services,
                           boolean strict)

Method Detail

of

public static ObserverNotifier of(String contextId,
                                  TypeSafeObserverResolver resolver,
                                  ServiceRegistry services,
                                  boolean strict)

Parameters:

resolver -

services -

strict - indicates whether event type should be performed or not

Returns:

ObserverNotifier instance

resolveObserverMethods

public <T> ResolvedObservers<T> resolveObserverMethods(Type eventType,
                                                       Annotation... qualifiers)

Resolves observer methods based on the given event type and qualifiers. If strict checks are enabled the given type is verified.

Parameters:

event - the event object

qualifiers - given event qualifiers

Returns:

resolved observer methods

resolveObserverMethods

public <T> ResolvedObservers<T> resolveObserverMethods(Type eventType,
                                                       Set<Annotation> qualifiers)

Resolves observer methods based on the given event type and qualifiers. If strict checks are enabled the given type is verified.

Parameters:

event - the event object

qualifiers - given event qualifiers

Returns:

resolved observer methods

resolveObserverMethods

public <T> ResolvedObservers<T> resolveObserverMethods(Resolvable resolvable)

Resolves observer methods using the given resolvable.

Parameters:

resolvable - the given resolvable

Returns:

resolved observer methods

fireEvent

public void fireEvent(Object event,
                      EventMetadata metadata,
                      Annotation... qualifiers)

Delivers the given event object to observer methods resolved based on the runtime type of the event object and given event qualifiers. If strict checks are enabled the event object type is verified.

Parameters:

event - the event object

metadata - event metadata

qualifiers - event qualifiers

fireEvent

public void fireEvent(Type eventType,
                      Object event,
                      Annotation... qualifiers)

Delivers the given event object to observer methods resolved based on the given event type and qualifiers. If strict checks are enabled the given type is verified.

Parameters:

eventType - the given event type

event - the given event object

qualifiers - event qualifiers

fireEvent

public void fireEvent(Type eventType,
                      Object event,
                      EventMetadata metadata,
                      Annotation... qualifiers)

fireEvent

public void fireEvent(Object event,
                      Resolvable resolvable)

Delivers the given event object to observer methods resolved based on the given resolvable. If strict checks are enabled the event object type is verified.

Parameters:

event - the given event object

resolvable -

buildEventResolvable

protected Resolvable buildEventResolvable(Type eventType,
                                          Set<Annotation> qualifiers)

buildEventResolvable

protected Resolvable buildEventResolvable(Type eventType,
                                          Annotation... qualifiers)

clear

public void clear()

Clears cached observer method resolutions and event type checks.

checkEventObjectType

protected void checkEventObjectType(Object event)

checkEventObjectType

public void checkEventObjectType(Type eventType)

If strict checks are enabled this method performs event type checks on the given type. More specifically it verifies that no type variables nor wildcards are present within the event type. In addition, this method verifies, that the event type is not assignable to a container lifecycle event type. If strict checks are not enabled then this method does not perform any action.

Parameters:

eventType - the given event type

Throws:

IllegalArgumentException - if the strict mode is enabled and the event type contains a type variable, wildcard or is assignable to a container lifecycle event type

checkEventSubtype

public void checkEventSubtype(Type subtype)

Parameters:

subtype -

Throws:

IllegalArgumentException - if the strict mode is enabled and the subtype contains a type variable

See Also:

Event.select(javax.enterprise.util.TypeLiteral, Annotation...)

notify

public <T> void notify(ResolvedObservers<T> observers,
                       T event,
                       EventMetadata metadata)

Delivers the given event object to given observer methods. Event metadata is made available for injection into observer methods, if needed.

Parameters:

observers - the given observer methods

event - the given event object

metadata - event metadata

notifySyncObservers

protected <T> void notifySyncObservers(List<ObserverMethod<? super T>> observers,
                                       T event,
                                       EventMetadata metadata)

notifyTransactionObservers

protected <T> void notifyTransactionObservers(List<ObserverMethod<? super T>> observers,
                                              T event,
                                              EventMetadata metadata)