javax.enterprise.context.spi

Interface Contextual<T>

All Known Subinterfaces:

Bean<T>, Decorator<T>, Interceptor<T>

All Known Implementing Classes:

AbstractBean, AbstractInterceptorBean, AbstractIntrospectedBean, AbstractSingletonBean, BeanAdapter, BeanWrapper, CauchoBean, DecoratorBean, DelegateProxyBean, EventBeanImpl, InjectionBean, InjectionPointBean, InjectionPointStandardBean, InstanceBeanImpl, InterceptorBean, InterceptorRuntimeBean, InterceptorSelfBean, ManagedBeanImpl, ManagedSingletonBean, NewBean, ProducesFieldBean, ProducesMethodBean, SessionBeanImpl, SessionRegistrationBean, SingletonBean, StatefulBeanImpl, StatelessBeanImpl, XmlBean, XmlManagedBeanImpl

public interface Contextual<T>

Contextual creates and destroys instances of a given type. In particular, the Bean interface extends Contextual. Applications will not use Contextual, because its internal SPI, called by the javax.enterprise.inject.spi.Manager during bean creation.

Method Summary

Modifier and Type	Method and Description
T	create(CreationalContext<T> creationalContext) Creates a new instance for the Contextual's type.
void	destroy(T instance, CreationalContext<T> creationalContext) Destroys an instance for the Contextual's type.

Method Detail

create

T create(CreationalContext<T> creationalContext)

Creates a new instance for the Contextual's type. If the instance already exists in the CreationalContext, create will return it instead of creating a new instance.

1. create an instance of the bean
2. create interceptor and decorator stacks
3. inject dependencies
4. set any XML-configured values
5. call @PostConstruct

Parameters:

creationalContext - the creation context used to support circular references.

Returns:

the new instance

destroy

void destroy(T instance,
             CreationalContext<T> creationalContext)

Destroys an instance for the Contextual's type.

1. Call any @Disposal method
2. Call @PreDestroy methods
3. Destroy dependent objects

Parameters:

instance - the instance to destroy