org.jboss.weld.manager.api

Interface WeldManager

All Superinterfaces:

javax.enterprise.inject.spi.BeanManager, Serializable

public interface WeldManager
extends javax.enterprise.inject.spi.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> javax.enterprise.inject.spi.AnnotatedType<T>	createAnnotatedType(Class<T> type, String id) Obtain an AnnotatedType that may be used to read the annotations of the given class or interface.
<T> WeldCreationalContext<T>	createCreationalContext(javax.enterprise.context.spi.Contextual<T> contextual)
<T> javax.enterprise.inject.spi.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(javax.enterprise.inject.spi.AnnotatedType<T> type) Returns a new instance of WeldInjectionTargetBuilder which can be used to create a new WeldInjectionTarget for the specified type.
<T> void	disposeAnnotatedType(Class<T> type, String id) Dispose the AnnotatedType created for the identified type.
<X> javax.enterprise.inject.spi.InjectionTarget<X>	fireProcessInjectionTarget(javax.enterprise.inject.spi.AnnotatedType<X> type) Fire a ProcessInjectionTarget event for the given type.
<X> javax.enterprise.inject.spi.InjectionTarget<X>	fireProcessInjectionTarget(javax.enterprise.inject.spi.AnnotatedType<X> annotatedType, javax.enterprise.inject.spi.InjectionTarget<X> injectionTarget) Fire a ProcessInjectionTarget event for the given type.
<T> javax.enterprise.inject.spi.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(javax.enterprise.inject.spi.AnnotatedType<T> type)
javax.enterprise.inject.spi.Bean<?>	getPassivationCapableBean(BeanIdentifier identifier)
ServiceRegistry	getServices() Get the services registered for this manager
javax.enterprise.inject.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, createInterceptionFactory, fireEvent, getBeans, getBeans, getContext, getELResolver, getEvent, 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:

javax.enterprise.context.ContextNotActiveException - if the given scope is inactive

IllegalArgumentException - if the given scope is not a normal scope

createInjectionTarget

<T> javax.enterprise.inject.spi.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(AnnotatedType) and fireProcessInjectionTarget(AnnotatedType, InjectionTarget) must be used to obtain an InjectionTarget for non-contextual EJB injection.

Type Parameters:

T - the type of the EJB

Parameters:

descriptor - the given EJB descriptor

Returns:

the injection target for the given EJB

getBean

<T> javax.enterprise.inject.spi.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 - the type of the bean

Parameters:

descriptor - the given EJB descriptor

Returns:

the Bean object for the given EJB

getEjbDescriptor

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

Get the EjbDescriptor for the given EJB name

Type Parameters:

T - the type of the EJB

Parameters:

ejbName - the given EJB name

Returns:

the EjbDescriptor for the given EJB name

getServices

ServiceRegistry getServices()

Get the services registered for this manager

Returns:

the services registered for this manager

getCurrent

WeldManager getCurrent()

Returns:

the WeldManager that corresponds to the current activity

fireProcessInjectionTarget

<X> javax.enterprise.inject.spi.InjectionTarget<X> fireProcessInjectionTarget(javax.enterprise.inject.spi.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 - the type

Parameters:

type - the type

Returns:

final version of InjectionTarget after all observers have been invoked

fireProcessInjectionTarget

<X> javax.enterprise.inject.spi.InjectionTarget<X> fireProcessInjectionTarget(javax.enterprise.inject.spi.AnnotatedType<X> annotatedType,
                                                                              javax.enterprise.inject.spi.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 - the type

Parameters:

annotatedType - the type

injectionTarget - the injection target

Returns:

final version of InjectionTarget after all observers have been invoked

getId

String getId()

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

Returns:

the ID of the manager

instance

javax.enterprise.inject.Instance<Object> instance()

getInjectionTargetFactory

<T> WeldInjectionTargetFactory<T> getInjectionTargetFactory(javax.enterprise.inject.spi.AnnotatedType<T> type)

Specified by:

getInjectionTargetFactory in interface javax.enterprise.inject.spi.BeanManager

createCreationalContext

<T> WeldCreationalContext<T> createCreationalContext(javax.enterprise.context.spi.Contextual<T> contextual)

Specified by:

createCreationalContext in interface javax.enterprise.inject.spi.BeanManager

getPassivationCapableBean

javax.enterprise.inject.spi.Bean<?> getPassivationCapableBean(BeanIdentifier identifier)

createInjectionTargetBuilder

<T> WeldInjectionTargetBuilder<T> createInjectionTargetBuilder(javax.enterprise.inject.spi.AnnotatedType<T> type)

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

Type Parameters:

T - the 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)

createAnnotatedType

<T> javax.enterprise.inject.spi.AnnotatedType<T> createAnnotatedType(Class<T> type,
                                                                     String id)

Obtain an AnnotatedType that may be used to read the annotations of the given class or interface.

Allows multiple annotated types, based on the same underlying type, to be created. AnnotatedTypes discovered by the container use the fully qualified class name to identify the type.

This method must only be used when creating non-contextual instances, such as Java EE components. It's not designed to work with contextual instances.

If called after the container bootstrap finished, the client code is required to explicitly call disposeAnnotatedType(Class, String) as soon as the specified type should be garbage-collected (to avoid memory leaks).

Parameters:

type -

id -

Returns:

the AnnotatedType

disposeAnnotatedType

<T> void disposeAnnotatedType(Class<T> type,
                              String id)

Dispose the AnnotatedType created for the identified type.

This method should be explicitly called for each result of createAnnotatedType(Class, String) created after the container bootstrap finished.

It's not necessary to call this method unless the identified type should be a subject of garbage collection.

Parameters:

type -

id -

See Also:

createAnnotatedType(Class, String)