CDI APIs 2.0 · javax.enterprise.inject.spi.ProcessInjectionTarget

The container fires an event of this type for every Java EE component class supporting injection that may be instantiated by the container at runtime, including every managed bean declared using javax.annotation.ManagedBean, EJB session or message-driven bean, enabled bean, enabled interceptor or enabled decorator.

Any observer of this event is permitted to wrap and/or replace the javax.enterprise.inject.spi.InjectionTarget. The container must use the final value of this property, after all observers have been called, whenever it performs injection upon the managed bean, session bean or other Java EE component class supporting injection.

For example, this observer decorates the InjectionTarget for all servlets.

public <T extends Servlet> void decorateServlet(@Observes ProcessInjectionTarget<T> pit) {
    pit.setInjectionTarget(decorate(pit.getInjectionTarget()));
}

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

Method Summary

Modifier and Type	Method and Description
public void	addDefinitionError(Throwable A `java.lang.Throwable` representing the definition error t) Registers a definition error with the container, causing the container to abort deployment after bean discovery is complete.
public AnnotatedType<X>	Returns: the `javax.enterprise.inject.spi.AnnotatedType` of the bean with an injection target getAnnotatedType() Returns the `javax.enterprise.inject.spi.AnnotatedType` representing the managed bean class, session bean class or other Java EE component class supporting injection.
public InjectionTarget<X>	Returns: the `javax.enterprise.inject.spi.InjectionTarget` object which performs the injection getInjectionTarget() Returns the `javax.enterprise.inject.spi.InjectionTarget` object that will be used by the container to perform injection.
public void	setInjectionTarget(InjectionTarget<X> The new `javax.enterprise.inject.spi.InjectionTarget` to use injectionTarget) Replaces the `javax.enterprise.inject.spi.InjectionTarget` which performs injection for this target.

Method Detail

addDefinitionError back to summary

addDefinitionError	back to summary
public void addDefinitionError(Throwable t) Registers a definition error with the container, causing the container to abort deployment after bean discovery is complete. Parameters t:Throwable A `java.lang.Throwable` representing the definition error Exceptions IllegalStateException: if called outside of the observer method invocation

public void addDefinitionError(Throwable t)

Registers a definition error with the container, causing the container to abort deployment after bean discovery is complete.

Parameters

t:Throwable: A java.lang.Throwable representing the definition error

Exceptions

IllegalStateException:: if called outside of the observer method invocation

getAnnotatedType back to summary

getAnnotatedType	back to summary
public AnnotatedType<X> getAnnotatedType() Returns the `javax.enterprise.inject.spi.AnnotatedType` representing the managed bean class, session bean class or other Java EE component class supporting injection. Returns:AnnotatedType<X> the `javax.enterprise.inject.spi.AnnotatedType` of the bean with an injection target Exceptions IllegalStateException: if called outside of the observer method invocation

public AnnotatedType<X> getAnnotatedType()

Returns the javax.enterprise.inject.spi.AnnotatedType representing the managed bean class, session bean class or other Java EE component class supporting injection.

Returns:AnnotatedType<X>

the javax.enterprise.inject.spi.AnnotatedType of the bean with an injection target

Exceptions

IllegalStateException:: if called outside of the observer method invocation

getInjectionTarget back to summary

getInjectionTarget	back to summary
public InjectionTarget<X> getInjectionTarget() Returns the `javax.enterprise.inject.spi.InjectionTarget` object that will be used by the container to perform injection. Returns:InjectionTarget<X> the `javax.enterprise.inject.spi.InjectionTarget` object which performs the injection Exceptions IllegalStateException: if called outside of the observer method invocation

public InjectionTarget<X> getInjectionTarget()

Returns the javax.enterprise.inject.spi.InjectionTarget object that will be used by the container to perform injection.

Returns:InjectionTarget<X>

the javax.enterprise.inject.spi.InjectionTarget object which performs the injection

Exceptions

IllegalStateException:: if called outside of the observer method invocation

setInjectionTarget back to summary

setInjectionTarget	back to summary
public void setInjectionTarget(InjectionTarget<X> injectionTarget) Replaces the `javax.enterprise.inject.spi.InjectionTarget` which performs injection for this target. Parameters injectionTarget:InjectionTarget<X> The new `javax.enterprise.inject.spi.InjectionTarget` to use Exceptions IllegalStateException: if called outside of the observer method invocation

public void setInjectionTarget(InjectionTarget<X> injectionTarget)

Replaces the javax.enterprise.inject.spi.InjectionTarget which performs injection for this target.

Parameters

injectionTarget:InjectionTarget<X>: The new javax.enterprise.inject.spi.InjectionTarget to use

Exceptions

IllegalStateException:: if called outside of the observer method invocation

public Interface ProcessInjectionTarget<X>

Method Summary

Method Detail