ProcessAnnotatedType (Jakarta EE Platform API)

Type Parameters:

X - The class being annotated

All Known Subinterfaces:

ProcessSyntheticAnnotatedType<X>
```
public interface ProcessAnnotatedType<X>
```
The container fires an event of this type for each Java class or interface it discovers in a bean archive, before it reads the declared annotations.

Any observer of this event is permitted to wrap and/or replace the AnnotatedType by calling either setAnnotatedType(AnnotatedType) or configureAnnotatedType(). 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, to discover the types and read the annotations of the program elements.

For example, the following observer decorates the AnnotatedType for every class that is discovered by the container.
```
 public <T> void decorateAnnotatedType(@Observes ProcessAnnotatedType<T> pat) {
     pat.setAnnotatedType(decorate(pat.getAnnotatedType()));
 }
 
```
If any observer method of a ProcessAnnotatedType event throws an exception, the exception is treated as a definition error by the container.

CDI Lite implementations are not required to provide support for Portable Extensions.
Author:

David Allen, Antoine Sabot-Durand

See Also:

AnnotatedType

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`AnnotatedTypeConfigurator<X>`	`configureAnnotatedType()`	Returns an `AnnotatedTypeConfigurator` initialized with the `AnnotatedType` processed by this event to configure a new AnnotatedType that will replace the original one at the end of the observer invocation.
`AnnotatedType<X>`	`getAnnotatedType()`	Returns the `AnnotatedType` object that will be used by the container to read the declared annotations.
`void`	`setAnnotatedType(AnnotatedType<X> type)`	Replaces the `AnnotatedType`.
`void`	`veto()`	Forces the container to ignore this type.

- Method Detail
  - getAnnotatedType
```
AnnotatedType<X> getAnnotatedType()
```
    Returns the AnnotatedType object that will be used by the container to read the declared annotations.
    
    Returns:
    
    the AnnotatedType object
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
  - setAnnotatedType
```
void setAnnotatedType(AnnotatedType<X> type)
```
    Replaces the AnnotatedType.
    
    Parameters:
    
    type - the new AnnotatedType object to use
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
  - configureAnnotatedType
```
AnnotatedTypeConfigurator<X> configureAnnotatedType()
```
    Returns an AnnotatedTypeConfigurator initialized with the AnnotatedType processed by this event to configure a new AnnotatedType that will replace the original one at the end of the observer invocation. Each call returns the same AnnotatedTypeConfigurator.
    
    Returns:
    
    a non reusable AnnotatedTypeConfigurator to configure the replacing AnnotatedType
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation
    
    Since:
    
    2.0
  - veto
```
void veto()
```
    Forces the container to ignore this type.
    
    Throws:
    
    IllegalStateException - if called outside of the observer method invocation