org.jboss.weld.event

Class ObserverMethodImpl<T,X>

java.lang.Object

org.jboss.weld.event.ObserverMethodImpl<T,X>

All Implemented Interfaces:

javax.enterprise.inject.spi.ObserverMethod<T>, javax.enterprise.inject.spi.Prioritized, EventMetadataAwareObserverMethod<T>

Direct Known Subclasses:

ExtensionObserverMethodImpl

public class ObserverMethodImpl<T,X>
extends Object
implements javax.enterprise.inject.spi.ObserverMethod<T>, EventMetadataAwareObserverMethod<T>

Reference implementation for the ObserverMethod interface, which represents an observer method. Each observer method has an event type which is the class of the event object being observed, and event binding types that are annotations applied to the event parameter to narrow the event notifications delivered.

Author:

David Allen, Jozef Hartinger, Marko Luksa

Field Summary

Fields

Modifier and Type	Field and Description
protected BeanManagerImpl	beanManager
protected RIBean<X>	declaringBean
static String	ID_PREFIX
static String	ID_SEPARATOR
protected MethodInjectionPoint<T,? super X>	observerMethod
protected static Set<Class<? extends Annotation>>	SPECIAL_PARAM_MARKERS
protected javax.enterprise.event.TransactionPhase	transactionPhase

Fields inherited from interface javax.enterprise.inject.spi.ObserverMethod

DEFAULT_PRIORITY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ObserverMethodImpl(EnhancedAnnotatedMethod<T,? super X> observer, RIBean<X> declaringBean, BeanManagerImpl manager, boolean isAsync) Creates an Observer which describes and encapsulates an observer method (8.5).

Method Summary

Modifier and Type	Method and Description
protected String	createId(EnhancedAnnotatedMethod<?,?> observer, RIBean<?> declaringBean)
protected String	createTypeId(RIBean<?> declaringBean)
boolean	equals(Object obj)
Class<X>	getBeanClass()
RIBean<X>	getDeclaringBean()
protected EnhancedAnnotatedParameter<?,? super X>	getEventParameter(EnhancedAnnotatedMethod<T,? super X> observer)
String	getId()
Set<WeldInjectionPointAttributes<?,?>>	getInjectionPoints()
MethodInjectionPoint<T,? super X>	getMethod()
Set<Annotation>	getObservedQualifiers()
Type	getObservedType()
int	getPriority()
protected Object	getReceiver(javax.enterprise.context.spi.CreationalContext<X> creationalContext)
javax.enterprise.event.Reception	getReception()
javax.enterprise.event.TransactionPhase	getTransactionPhase()
int	hashCode()
protected void	checkRequiredTypeAnnotations(EnhancedAnnotatedParameter<?,?> eventParameter)
void	initialize(EnhancedAnnotatedMethod<T,? super X> annotated) Completes initialization of the observer and allows derived types to override behavior.
protected MethodInjectionPoint<T,? super X>	initMethodInjectionPoint(EnhancedAnnotatedMethod<T,? super X> observer, RIBean<X> declaringBean, BeanManagerImpl manager)
boolean	isAsync()
boolean	isEventMetadataRequired()
void	notify(T event)
protected void	postNotify(T event, Object receiver)
protected void	preNotify(T event, Object receiver) Hooks allowing subclasses to perform additional logic just before and just after an event is delivered to an observer method.
protected void	sendEvent(T event) Invokes the observer method immediately passing the event.
protected void	sendEvent(T event, Object receiver, javax.enterprise.context.spi.CreationalContext<?> creationalContext) Note that CreationalContext.release() is not invoked within this method.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.enterprise.inject.spi.ObserverMethod

notify

Field Detail

ID_PREFIX

public static final String ID_PREFIX

ID_SEPARATOR

public static final String ID_SEPARATOR

See Also:

Constant Field Values

SPECIAL_PARAM_MARKERS

protected static final Set<Class<? extends Annotation>> SPECIAL_PARAM_MARKERS

beanManager

protected final BeanManagerImpl beanManager

declaringBean

protected final RIBean<X> declaringBean

observerMethod

protected final MethodInjectionPoint<T,? super X> observerMethod

transactionPhase

protected javax.enterprise.event.TransactionPhase transactionPhase

Constructor Detail

ObserverMethodImpl

protected ObserverMethodImpl(EnhancedAnnotatedMethod<T,? super X> observer,
                             RIBean<X> declaringBean,
                             BeanManagerImpl manager,
                             boolean isAsync)

Creates an Observer which describes and encapsulates an observer method (8.5).

Parameters:

observer - The observer

declaringBean - The observer bean

manager - The Bean manager

Method Detail

getEventParameter

protected EnhancedAnnotatedParameter<?,? super X> getEventParameter(EnhancedAnnotatedMethod<T,? super X> observer)

createId

protected String createId(EnhancedAnnotatedMethod<?,?> observer,
                          RIBean<?> declaringBean)

createTypeId

protected String createTypeId(RIBean<?> declaringBean)

initMethodInjectionPoint

protected MethodInjectionPoint<T,? super X> initMethodInjectionPoint(EnhancedAnnotatedMethod<T,? super X> observer,
                                                                     RIBean<X> declaringBean,
                                                                     BeanManagerImpl manager)

getInjectionPoints

public Set<WeldInjectionPointAttributes<?,?>> getInjectionPoints()

checkRequiredTypeAnnotations

protected void checkRequiredTypeAnnotations(EnhancedAnnotatedParameter<?,?> eventParameter)

getBeanClass

public Class<X> getBeanClass()

Specified by:

getBeanClass in interface javax.enterprise.inject.spi.ObserverMethod<T>

getDeclaringBean

public RIBean<X> getDeclaringBean()

getReception

public javax.enterprise.event.Reception getReception()

Specified by:

getReception in interface javax.enterprise.inject.spi.ObserverMethod<T>

getObservedQualifiers

public Set<Annotation> getObservedQualifiers()

Specified by:

getObservedQualifiers in interface javax.enterprise.inject.spi.ObserverMethod<T>

getObservedType

public Type getObservedType()

Specified by:

getObservedType in interface javax.enterprise.inject.spi.ObserverMethod<T>

getTransactionPhase

public javax.enterprise.event.TransactionPhase getTransactionPhase()

Specified by:

getTransactionPhase in interface javax.enterprise.inject.spi.ObserverMethod<T>

getMethod

public MethodInjectionPoint<T,? super X> getMethod()

Returns:

the observerMethod

initialize

public void initialize(EnhancedAnnotatedMethod<T,? super X> annotated)

Completes initialization of the observer and allows derived types to override behavior.

notify

public void notify(T event)

Specified by:

notify in interface javax.enterprise.inject.spi.ObserverMethod<T>

sendEvent

protected void sendEvent(T event)

Invokes the observer method immediately passing the event.

Parameters:

event - The event to notify observer with

sendEvent

protected void sendEvent(T event,
                         Object receiver,
                         javax.enterprise.context.spi.CreationalContext<?> creationalContext)

Note that CreationalContext.release() is not invoked within this method.

Parameters:

event -

receiver -

creationalContext -

preNotify

protected void preNotify(T event,
                         Object receiver)

Hooks allowing subclasses to perform additional logic just before and just after an event is delivered to an observer method.

postNotify

protected void postNotify(T event,
                          Object receiver)

getReceiver

protected Object getReceiver(javax.enterprise.context.spi.CreationalContext<X> creationalContext)

toString

public String toString()

Overrides:

toString in class Object

getId

public String getId()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getPriority

public int getPriority()

Specified by:

getPriority in interface javax.enterprise.inject.spi.ObserverMethod<T>

Specified by:

getPriority in interface javax.enterprise.inject.spi.Prioritized

isAsync

public boolean isAsync()

Specified by:

isAsync in interface javax.enterprise.inject.spi.ObserverMethod<T>

isEventMetadataRequired

public boolean isEventMetadataRequired()

Specified by:

isEventMetadataRequired in interface EventMetadataAwareObserverMethod<T>

Returns:

true if EventMetadata is required, false otherwise