T
- The bean class of the bean that declares the producer method or fieldX
- The return type of the producer method or the type of the producer fieldpublic interface ProcessProducer<T,X>
The container fires an event of this type for each producer method or field of each enabled bean, including resources.
Any observer of this event is permitted to wrap and/or replace the Producer
by calling either
setProducer(Producer)
or configureProducer()
. 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, whenever it calls the producer or disposer.
For example, this observer decorates the Producer
for the all producer methods and field of type
EntityManager
.
void decorateEntityManager(@Observes ProcessProducer<?, EntityManager> pp) { pit.setProducer(decorate(pp.getProducer())); }
If any observer method of a ProcessProducer
event throws an exception, the exception is treated as a definition error
by the container.
Producer
Modifier and Type | Method and Description |
---|---|
void |
addDefinitionError(java.lang.Throwable t)
Registers a definition error with the container, causing the container to abort deployment after bean discovery is
complete.
|
ProducerConfigurator<X> |
configureProducer()
Returns a
ProducerConfigurator initialized with the Producer processed by this event, to configure a new
Producer that will replace the original one at the end of the observer invocation. |
AnnotatedMember<T> |
getAnnotatedMember()
Returns the
AnnotatedField representing the producer field or the
AnnotatedMethod representing the producer method. |
Producer<X> |
getProducer()
Returns the
Producer object that will be used by the container to call the producer
method or read the producer field. |
void |
setProducer(Producer<X> producer)
Replaces the
Producer object that will be used by the container to call the producer
method or read the producer field. |
AnnotatedMember<T> getAnnotatedMember()
AnnotatedField
representing the producer field or the
AnnotatedMethod
representing the producer method.AnnotatedMember
representing the producerjava.lang.IllegalStateException
- if called outside of the observer method invocationProducer<X> getProducer()
Producer
object that will be used by the container to call the producer
method or read the producer field.Producer
invoker object used by the containerjava.lang.IllegalStateException
- if called outside of the observer method invocationvoid setProducer(Producer<X> producer)
Producer
object that will be used by the container to call the producer
method or read the producer field.producer
- the new Producer
object to usejava.lang.IllegalStateException
- if called outside of the observer method invocationProducerConfigurator<X> configureProducer()
ProducerConfigurator
initialized with the Producer
processed by this event, to configure a new
Producer
that will replace the original one at the end of the observer invocation.
Each call returns the same configurator instance within an observer notification.
ProducerConfigurator
to configure the original
Producer
.java.lang.IllegalStateException
- if called outside of the observer method invocationvoid addDefinitionError(java.lang.Throwable t)
t
- The definition error to register as a Throwable
java.lang.IllegalStateException
- if called outside of the observer method invocation