org.jboss.weld.event

Class ObserverMethodImpl<T,X>

java.lang.Object

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

All Implemented Interfaces:

ObserverMethod<T>

Direct Known Subclasses:

ExtensionObserverMethodImpl

public class ObserverMethodImpl<T,X>
extends Object
implements ObserverMethod<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 TransactionPhase	transactionPhase

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected void	checkRequiredTypeAnnotations(EnhancedAnnotatedParameter<?,?> eventParameter)
protected static String	createId(EnhancedAnnotatedMethod<?,?> observer, RIBean<?> declaringBean)
boolean	equals(Object obj)
Class<X>	getBeanClass()
RIBean<X>	getDeclaringBean()
String	getId()
Set<WeldInjectionPointAttributes<?,?>>	getInjectionPoints()
MethodInjectionPoint<T,? super X>	getMethod()
Set<WeldInjectionPointAttributes<?,?>>	getNewInjectionPoints()
Set<Annotation>	getObservedQualifiers()
Type	getObservedType()
protected Object	getReceiver(CreationalContext<X> creationalContext)
Reception	getReception()
TransactionPhase	getTransactionPhase()
int	hashCode()
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	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, 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

Field Detail

ID_PREFIX

public static final String ID_PREFIX

ID_SEPARATOR

public static final String ID_SEPARATOR

See Also:

Constant Field Values

beanManager

protected final BeanManagerImpl beanManager

declaringBean

protected final RIBean<X> declaringBean

observerMethod

protected final MethodInjectionPoint<T,? super X> observerMethod

transactionPhase

protected TransactionPhase transactionPhase

Constructor Detail

ObserverMethodImpl

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

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

createId

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

initMethodInjectionPoint

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

getInjectionPoints

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

getNewInjectionPoints

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

checkRequiredTypeAnnotations

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

getBeanClass

public Class<X> getBeanClass()

Specified by:

getBeanClass in interface ObserverMethod<T>

getDeclaringBean

public RIBean<X> getDeclaringBean()

getReception

public Reception getReception()

Specified by:

getReception in interface ObserverMethod<T>

getObservedQualifiers

public Set<Annotation> getObservedQualifiers()

Specified by:

getObservedQualifiers in interface ObserverMethod<T>

getObservedType

public Type getObservedType()

Specified by:

getObservedType in interface ObserverMethod<T>

getTransactionPhase

public TransactionPhase getTransactionPhase()

Specified by:

getTransactionPhase in interface 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 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,
                         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(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

isEventMetadataRequired

public boolean isEventMetadataRequired()