ProcessObserverMethod (CDI APIs 2.0.Alpha4a API)

Type Parameters:

T - The type of the event being observed

X - The bean type containing the observer method
```
public 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.

If any observer method of a ProcessObserverMethod event throws an exception, the exception is treated as a definition error by the container.

Author:

Gavin King, David Allen, Antoine Sabot-Durand

See Also:

ObserverMethod

Method Summary

All Methods Instance Methods Abstract Methods
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.

- Method Detail
  - getAnnotatedMethod
```
AnnotatedMethod<X> getAnnotatedMethod()
```
    The AnnotatedMethod representing the observer method.
    
    Returns:
    
    the AnnotatedMethod representing the observer method
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
  - getObserverMethod
```
ObserverMethod<T> getObserverMethod()
```
    The ObserverMethod object that will be used by the container to invoke the observer when a matching event is fired.
    
    Returns:
    
    the ObserverMethod object that will be used by the container to call the observer method
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
  - addDefinitionError
```
void addDefinitionError(Throwable t)
```
    Registers a definition error with the container, causing the container to abort deployment after bean discovery is complete.
    
    Parameters:
    
    t - A Throwable representing the definition error
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
  - setObserverMethod
```
void setObserverMethod(ObserverMethod<T> observerMethod)
```
    Replaces the ObserverMethod.
    
    Parameters:
    
    observerMethod - the new ObserverMethod object to use
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
    
    Since:
    
    2.0
  - configureObserverMethod
```
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. Each call returns the same ObserverMethodConfigurator
    
    Returns:
    
    a non reusable ObserverMethodConfigurator to configure the replacing ObserverMethod
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
    
    Since:
    
    2.0
  - veto
```
void veto()
```
    Forces the container to ignore the observer method.
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
    
    Since:
    
    2.0

Interface ProcessObserverMethod<T,X>

Method Summary

Method Detail

getAnnotatedMethod

getObserverMethod

addDefinitionError

setObserverMethod

configureObserverMethod

veto