T
- The type of the event being observedX
- The bean type containing the observer methodpublic interface ProcessObserverMethod<T,X>
The container fires an event of this type for each observer method of each
enabled bean, before registering the ObserverMethod
object.
For a custom implementation of ObserverMethod
, the container must raise an event of type ProcessSyntheticObserverMethod
.
Any observer of this event is permitted to wrap and/or replace the ObserverMethod
by calling either setObserverMethod(ObserverMethod)
or configureObserverMethod()
.
If both methods are called within an observer notification an IllegalStateException
is thrown.
The container must use the final value of this property, after all observers have been called, he container must use the final
value of this property, after all observers have been called, whenever it performs observer resolution.
If any observer method of a ProcessObserverMethod
event throws an exception, the exception is treated as a definition
error by the container.
ObserverMethod
Modifier and Type | Method and Description |
---|---|
void |
addDefinitionError(Throwable t)
Registers a definition error with the container, causing the container to abort deployment after bean discovery is
complete.
|
ObserverMethodConfigurator<T> |
configureObserverMethod()
Returns a
ObserverMethodConfigurator initialized with the ObserverMethod processed by this event,
to configure a new ObserverMethod that will replace the original one at the end of the observer invocation. |
AnnotatedMethod<X> |
getAnnotatedMethod()
The
AnnotatedMethod representing the observer method. |
ObserverMethod<T> |
getObserverMethod()
The
ObserverMethod object that will be used by the container to invoke the observer
when a matching event is fired. |
void |
setObserverMethod(ObserverMethod<T> observerMethod)
Replaces the
ObserverMethod . |
void |
veto()
Forces the container to ignore the observer method.
|
AnnotatedMethod<X> getAnnotatedMethod()
AnnotatedMethod
representing the observer method.
If invoked upon a ProcessSyntheticObserverMethod
event, non-portable behavior results and the returned value should be ignored.
AnnotatedMethod
representing the observer methodIllegalStateException
- if called outside of the observer method invocationObserverMethod<T> getObserverMethod()
ObserverMethod
object that will be used by the container to invoke the observer
when a matching event is fired.ObserverMethod
object that will be used by the container to call the
observer methodIllegalStateException
- if called outside of the observer method invocationvoid addDefinitionError(Throwable t)
t
- A Throwable
representing the definition errorIllegalStateException
- if called outside of the observer method invocationvoid setObserverMethod(ObserverMethod<T> observerMethod)
ObserverMethod
.observerMethod
- the new ObserverMethod
object to useIllegalStateException
- if called outside of the observer method invocationObserverMethodConfigurator<T> configureObserverMethod()
ObserverMethodConfigurator
initialized with the ObserverMethod
processed by this event,
to configure a new ObserverMethod that will replace the original one at the end of the observer invocation.
Each call returns the same ObserverMethodConfiguratorObserverMethodConfigurator
to configure the replacing ObserverMethodIllegalStateException
- if called outside of the observer method invocationvoid veto()
IllegalStateException
- if called outside of the observer method invocationComments to: cdi-dev@eclipse.org.
Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.