org.jboss.weld.manager.api

Interface WeldManager

All Superinterfaces:

BeanManager, Serializable

All Known Implementing Classes:

BeanManagerImpl, BeanManagerProxy

public interface WeldManager
extends BeanManager, Serializable

Functionality provided by the Weld Manager over and above the JSR-299 Manager.

Author:

Pete Muir

Method Summary

Modifier and Type	Method and Description
WeldManager	createActivity() Create a new child activity.
<T> WeldCreationalContext<T>	createCreationalContext(Contextual<T> contextual) Obtain an instance of a CreationalContext for the given contextual type, or for a non-contextual object.
<T> InjectionTarget<T>	createInjectionTarget(EjbDescriptor<T> descriptor) The injection target for the given EJB, or null if Weld was not given this descriptor in the deployment.
<T> WeldInjectionTargetBuilder<T>	createInjectionTargetBuilder(AnnotatedType<T> type) Returns a new instance of WeldInjectionTargetBuilder which can be used to create a new WeldInjectionTarget for the specified type.
<X> InjectionTarget<X>	fireProcessInjectionTarget(AnnotatedType<X> type) Fire a ProcessInjectionTarget event for the given type.
<X> InjectionTarget<X>	fireProcessInjectionTarget(AnnotatedType<X> annotatedType, InjectionTarget<X> injectionTarget) Fire a ProcessInjectionTarget event for the given type.
<T> Bean<T>	getBean(EjbDescriptor<T> descriptor) Get the Bean object for the given EJB, or null if Weld was not given this descriptor in the deployment.
WeldManager	getCurrent()
<T> EjbDescriptor<T>	getEjbDescriptor(String ejbName) Get the EjbDescriptor for the given ejb name
String	getId() The ID of the manager, identical to the ID provided by the BDA
<T> WeldInjectionTargetFactory<T>	getInjectionTargetFactory(AnnotatedType<T> type) An implementation of InjectionTargetFactory that provides container created InjectionTarget instances.
Bean<?>	getPassivationCapableBean(BeanIdentifier identifier)
ServiceRegistry	getServices() Get the services registered for this manager
Instance<Object>	instance()
WeldManager	setCurrent(Class<? extends Annotation> scopeType) Associate an activity with the current context for a normal scope
WeldManager	unwrap()

Methods inherited from interface javax.enterprise.inject.spi.BeanManager

areInterceptorBindingsEquivalent, areQualifiersEquivalent, createAnnotatedType, createBean, createBean, createBeanAttributes, createBeanAttributes, createInjectionPoint, createInjectionPoint, createInjectionTarget, fireEvent, getBeans, getBeans, getContext, getELResolver, getExtension, getInjectableReference, getInterceptorBindingDefinition, getInterceptorBindingHashCode, getPassivationCapableBean, getProducerFactory, getProducerFactory, getQualifierHashCode, getReference, getStereotypeDefinition, isInterceptorBinding, isNormalScope, isPassivatingScope, isQualifier, isScope, isStereotype, resolve, resolveDecorators, resolveInterceptors, resolveObserverMethods, validate, wrapExpressionFactory

Method Detail

createActivity

WeldManager createActivity()

Create a new child activity. A child activity inherits all beans, interceptors, decorators, observers, and contexts defined by its direct and indirect parent activities. This method should not be called by the application.

Returns:

the child activity

setCurrent

WeldManager setCurrent(Class<? extends Annotation> scopeType)

Associate an activity with the current context for a normal scope

Parameters:

scopeType - the scope to associate the activity with

Returns:

the activity

Throws:

ContextNotActiveException - if the given scope is inactive

IllegalArgumentException - if the given scope is not a normal scope

createInjectionTarget

<T> InjectionTarget<T> createInjectionTarget(EjbDescriptor<T> descriptor)

The injection target for the given EJB, or null if Weld was not given this descriptor in the deployment. This should only be used to create an inject contextual EJBs by the EJB container. #fireProcessInjectionTarget() must be used to obtain an InjectionTarget for non-contextual EJB injection.

Type Parameters:

T -

Parameters:

descriptor -

Returns:

getBean

<T> Bean<T> getBean(EjbDescriptor<T> descriptor)

Get the Bean object for the given EJB, or null if Weld was not given this descriptor in the deployment.

Type Parameters:

T -

Parameters:

descriptor -

Returns:

getEjbDescriptor

<T> EjbDescriptor<T> getEjbDescriptor(String ejbName)

Get the EjbDescriptor for the given ejb name

Type Parameters:

T -

Parameters:

ejbName -

Returns:

getServices

ServiceRegistry getServices()

Get the services registered for this manager

Returns:

getCurrent

WeldManager getCurrent()

Returns:

the WeldManager that corresponds to the current activity

fireProcessInjectionTarget

<X> InjectionTarget<X> fireProcessInjectionTarget(AnnotatedType<X> type)

Fire a ProcessInjectionTarget event for the given type. A helper method to allow integration code to easily fire the ProcessInjectionTarget for Java EE component classes supporting injection The container must use the returned InjectionTarget to inject the Java EE component.

Type Parameters:

X -

Parameters:

type -

Returns:

fireProcessInjectionTarget

<X> InjectionTarget<X> fireProcessInjectionTarget(AnnotatedType<X> annotatedType,
                                                  InjectionTarget<X> injectionTarget)

Fire a ProcessInjectionTarget event for the given type. A helper method to allow integration code to easily fire the ProcessInjectionTarget for Java EE component classes supporting injection The container must use the returned InjectionTarget to inject the Java EE component.

Type Parameters:

X -

Parameters:

type -

injectionTarget -

Returns:

getId

String getId()

The ID of the manager, identical to the ID provided by the BDA

Returns:

instance

Instance<Object> instance()

getInjectionTargetFactory

<T> WeldInjectionTargetFactory<T> getInjectionTargetFactory(AnnotatedType<T> type)

Description copied from interface: BeanManager

An implementation of InjectionTargetFactory that provides container created InjectionTarget instances.

This factory can be wrapped to add behavior to container created injection targets.

Specified by:

getInjectionTargetFactory in interface BeanManager

Parameters:

type - the annotated type to create the injection target factory for

Returns:

an InjectionTargetFactory

createCreationalContext

<T> WeldCreationalContext<T> createCreationalContext(Contextual<T> contextual)

Description copied from interface: BeanManager

Obtain an instance of a CreationalContext for the given contextual type, or for a non-contextual object.

Specified by:

createCreationalContext in interface BeanManager

Parameters:

contextual - the Contextual, or a null value in the case of a non-contextual object

Returns:

the new CreationalContext

getPassivationCapableBean

Bean<?> getPassivationCapableBean(BeanIdentifier identifier)

createInjectionTargetBuilder

<T> WeldInjectionTargetBuilder<T> createInjectionTargetBuilder(AnnotatedType<T> type)

Returns a new instance of WeldInjectionTargetBuilder which can be used to create a new WeldInjectionTarget for the specified type.

Parameters:

type - the specified type

Returns:

a new WeldInjectionTargetBuilder instance for the specified type

unwrap

WeldManager unwrap()

Returns:

an unwrapped instance (e.g. the delegate in the case of forwarding implementation)