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 java.lang.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 java.lang.String	ID_PREFIX
static java.lang.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 java.lang.String	createId(EnhancedAnnotatedMethod<?,?> observer, RIBean<?> declaringBean)
boolean	equals(java.lang.Object obj)
java.lang.Class<X>	getBeanClass()
RIBean<X>	getDeclaringBean()
java.lang.String	getId()
java.util.Set<WeldInjectionPointAttributes<?,?>>	getInjectionPoints()
MethodInjectionPoint<T,? super X>	getMethod()
java.util.Set<WeldInjectionPointAttributes<?,?>>	getNewInjectionPoints()
java.util.Set<java.lang.annotation.Annotation>	getObservedQualifiers()
java.lang.reflect.Type	getObservedType()
protected java.lang.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, java.lang.Object receiver)
protected void	preNotify(T event, java.lang.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, java.lang.Object receiver, CreationalContext<?> creationalContext) Note that CreationalContext.release() is not invoked within this method.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

ID_PREFIX

public static final java.lang.String ID_PREFIX

ID_SEPARATOR

public static final java.lang.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 java.lang.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 java.util.Set<WeldInjectionPointAttributes<?,?>> getInjectionPoints()

getNewInjectionPoints

public java.util.Set<WeldInjectionPointAttributes<?,?>> getNewInjectionPoints()

checkRequiredTypeAnnotations

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

getBeanClass

public java.lang.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 java.util.Set<java.lang.annotation.Annotation> getObservedQualifiers()

Specified by:

getObservedQualifiers in interface ObserverMethod<T>

getObservedType

public java.lang.reflect.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,
                         java.lang.Object receiver,
                         CreationalContext<?> creationalContext)

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

Parameters:

event -

receiver -

creationalContext -

preNotify

protected void preNotify(T event,
                         java.lang.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,
                          java.lang.Object receiver)

getReceiver

protected java.lang.Object getReceiver(CreationalContext<X> creationalContext)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getId

public java.lang.String getId()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

isEventMetadataRequired

public boolean isEventMetadataRequired()