org.jboss.weld.injection.producer

Class BasicInjectionTarget<T>

java.lang.Object

org.jboss.weld.injection.producer.AbstractProducer<T>

org.jboss.weld.injection.producer.BasicInjectionTarget<T>

All Implemented Interfaces:

InjectionTarget<T>, Producer<T>, WeldInjectionTarget<T>

Direct Known Subclasses:

BeanInjectionTarget, NonProducibleInjectionTarget

public class BasicInjectionTarget<T>
extends AbstractProducer<T>
implements WeldInjectionTarget<T>

Basic InjectionTarget implementation. The implementation supports:

• @Inject injection + initializers
• @PostConstruct/@PreDestroy callbacks

Interception and decoration is not supported but can be added using extension points.

Author:

Pete Muir, Jozef Hartinger

Field Summary

Fields

Modifier and Type	Field and Description
protected BeanManagerImpl	beanManager

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BasicInjectionTarget(EnhancedAnnotatedType<T> type, Bean<T> bean, BeanManagerImpl beanManager)
protected	BasicInjectionTarget(EnhancedAnnotatedType<T> type, Bean<T> bean, BeanManagerImpl beanManager, Injector<T> injector, LifecycleCallbackInvoker<T> invoker)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	checkType(EnhancedAnnotatedType<T> type)
static <T> BasicInjectionTarget<T>	create(EnhancedAnnotatedType<T> type, Bean<T> bean, BeanManagerImpl beanManager, Injector<T> injector, LifecycleCallbackInvoker<T> invoker)
static <T> BasicInjectionTarget<T>	createDefault(EnhancedAnnotatedType<T> type, Bean<T> bean, BeanManagerImpl beanManager)
static <T> BasicInjectionTarget<T>	createNonCdiInterceptor(EnhancedAnnotatedType<T> type, BeanManagerImpl beanManager) Creates InjectionTarget for interceptors which do not have associated Interceptor.
void	dispose(T instance) Destroys the instance.
AnnotatedType<T>	getAnnotated()
AnnotatedType<T>	getAnnotatedType()
Bean<T>	getBean() Returns a Bean this producer is associated with or null if no such bean exists.
BeanManagerImpl	getBeanManager()
Set<InjectionPoint>	getInjectionPoints() Returns the set of all InjectionPoints.
Injector<T>	getInjector()
Instantiator<T>	getInstantiator()
LifecycleCallbackInvoker<T>	getLifecycleCallbackInvoker()
protected SlimAnnotatedType<T>	getType()
boolean	hasDecorators()
boolean	hasInterceptors()
protected void	initializeAfterBeanDiscovery(EnhancedAnnotatedType<T> annotatedType)
protected Instantiator<T>	initInstantiator(EnhancedAnnotatedType<T> type, Bean<T> bean, BeanManagerImpl beanManager, Set<InjectionPoint> injectionPoints) Returns an instantiator that will be used to create a new instance of a given component.
void	inject(T instance, CreationalContext<T> ctx) Performs dependency injection upon the given object.
void	postConstruct(T instance) Calls the PostConstruct callback, if it exists, according to the semantics required by the Java EE platform specification.
void	preDestroy(T instance) Calls the PreDestroy callback, if it exists, according to the semantics required by the Java EE platform specification.
T	produce(CreationalContext<T> ctx) Causes an instance to be produced via the Producer.
void	setInstantiator(Instantiator<T> instantiator)
String	toString()

Methods inherited from class org.jboss.weld.injection.producer.AbstractProducer

checkDelegateInjectionPoints, equals, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

beanManager

protected final BeanManagerImpl beanManager

Constructor Detail

BasicInjectionTarget

protected BasicInjectionTarget(EnhancedAnnotatedType<T> type,
                    Bean<T> bean,
                    BeanManagerImpl beanManager,
                    Injector<T> injector,
                    LifecycleCallbackInvoker<T> invoker)

BasicInjectionTarget

protected BasicInjectionTarget(EnhancedAnnotatedType<T> type,
                    Bean<T> bean,
                    BeanManagerImpl beanManager)

Method Detail

create

public static <T> BasicInjectionTarget<T> create(EnhancedAnnotatedType<T> type,
                                 Bean<T> bean,
                                 BeanManagerImpl beanManager,
                                 Injector<T> injector,
                                 LifecycleCallbackInvoker<T> invoker)

createDefault

public static <T> BasicInjectionTarget<T> createDefault(EnhancedAnnotatedType<T> type,
                                        Bean<T> bean,
                                        BeanManagerImpl beanManager)

createNonCdiInterceptor

public static <T> BasicInjectionTarget<T> createNonCdiInterceptor(EnhancedAnnotatedType<T> type,
                                                  BeanManagerImpl beanManager)

Creates InjectionTarget for interceptors which do not have associated Interceptor. These interceptors are a result of using Interceptors annotation directly on the target class.

checkType

protected void checkType(EnhancedAnnotatedType<T> type)

produce

public T produce(CreationalContext<T> ctx)

Description copied from interface: Producer

Causes an instance to be produced via the Producer.

If the Producer represents a class, this will invoke the constructor annotated Inject if it exists, or the constructor with no parameters otherwise. If the class has interceptors, produce() is responsible for building the interceptors and decorators of the instance.

If the Producer represents a producer field or method, this will invoke the producer method on, or access the producer field of, a contextual instance of the bean that declares the producer.

Specified by:

produce in interface Producer<T>

Parameters:

ctx - The CreationalContext to use for the produced object

Returns:

the instance produced

inject

public void inject(T instance,
          CreationalContext<T> ctx)

Description copied from interface: InjectionTarget

Performs dependency injection upon the given object. Performs Java EE component environment injection, sets the value of all injected fields, and calls all initializer methods.

Specified by:

inject in interface InjectionTarget<T>

Parameters:

instance - The instance upon which to perform injection

ctx - The CreationalContext to use for creating new instances

postConstruct

public void postConstruct(T instance)

Description copied from interface: InjectionTarget

Calls the PostConstruct callback, if it exists, according to the semantics required by the Java EE platform specification.

Specified by:

postConstruct in interface InjectionTarget<T>

Parameters:

instance - The instance on which to invoke the PostConstruct method

preDestroy

public void preDestroy(T instance)

Description copied from interface: InjectionTarget

Calls the PreDestroy callback, if it exists, according to the semantics required by the Java EE platform specification.

Specified by:

preDestroy in interface InjectionTarget<T>

Parameters:

instance - The instance on which to invoke the PreDestroy method

dispose

public void dispose(T instance)

Description copied from interface: Producer

Destroys the instance.

If the Producer represents a class, then this operation does nothing.

If the Producer represents a producer field or method, this calls the disposer method, if any, on a contextual instance of the bean that declares the disposer method or performs any additional required cleanup, if any, to destroy state associated with a resource.

Specified by:

dispose in interface Producer<T>

Parameters:

instance - The instance to dispose

getInjectionPoints

public Set<InjectionPoint> getInjectionPoints()

Description copied from interface: Producer

Returns the set of all InjectionPoints. If the Producer represents a class, then this returns returns the set of InjectionPoint objects representing all injected fields, bean constructor parameters and initializer method parameters. For a producer method, this returns the set of InjectionPoint objects representing all parameters of the producer method.

Specified by:

getInjectionPoints in interface Producer<T>

Returns:

the set of all injection points for the producer

getType

protected SlimAnnotatedType<T> getType()

getBeanManager

public BeanManagerImpl getBeanManager()

getInstantiator

public Instantiator<T> getInstantiator()

setInstantiator

public void setInstantiator(Instantiator<T> instantiator)

hasInterceptors

public boolean hasInterceptors()

hasDecorators

public boolean hasDecorators()

initializeAfterBeanDiscovery

protected void initializeAfterBeanDiscovery(EnhancedAnnotatedType<T> annotatedType)

initInstantiator

protected Instantiator<T> initInstantiator(EnhancedAnnotatedType<T> type,
                               Bean<T> bean,
                               BeanManagerImpl beanManager,
                               Set<InjectionPoint> injectionPoints)

Returns an instantiator that will be used to create a new instance of a given component. If the instantiator uses a constructor with injection points, the implementation of the initInstantiator(EnhancedAnnotatedType, Bean, BeanManagerImpl, Set) method is supposed to register all these injection points within the injectionPoints set passed in as a parameter.

getAnnotated

public AnnotatedType<T> getAnnotated()

Specified by:

getAnnotated in class AbstractProducer<T>

getAnnotatedType

public AnnotatedType<T> getAnnotatedType()

Specified by:

getAnnotatedType in interface WeldInjectionTarget<T>

getInjector

public Injector<T> getInjector()

getLifecycleCallbackInvoker

public LifecycleCallbackInvoker<T> getLifecycleCallbackInvoker()

toString

public String toString()

Overrides:

toString in class Object

getBean

public Bean<T> getBean()

Description copied from class: AbstractProducer

Returns a Bean this producer is associated with or null if no such bean exists.

Specified by:

getBean in class AbstractProducer<T>