| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface BeanManager
Allows a portable extension to interact directly with the container. Provides operations for obtaining contextual references for beans, along with many other operations of use to portable extensions.
Any bean may obtain an instance of BeanManager by injecting it:
@Inject BeanManager manager;
Java EE components may obtain an instance of BeanManager from
 JNDI by looking up the name java:comp/BeanManager.
Any operation of BeanManager may be called at any time during the execution of the application.
| Method Summary | ||
|---|---|---|
| 
 | createAnnotatedType(java.lang.Class<T> type)Obtain an AnnotatedTypethat may be used to read the annotations 
 of the given class or interface. | |
| 
 | createCreationalContext(Contextual<T> contextual)Obtain an instance of a CreationalContextfor the given contextual type, 
 or for a non-contextual object. | |
| 
 | createInjectionTarget(AnnotatedType<T> type)Obtains an InjectionTargetfor the givenAnnotatedType. | |
|  void | fireEvent(java.lang.Object event,
          java.lang.annotation.Annotation... qualifiers)Fire an event and notify observers. | |
|  java.util.Set<Bean<?>> | getBeans(java.lang.String name)Return the set of beans which have the given EL name and are available for injection in the module or library containing the class into which the BeanManager was injected or the Java EE component from whose JNDI environment namespace the BeanManager was obtained, according to the rules of EL name resolution. | |
|  java.util.Set<Bean<?>> | getBeans(java.lang.reflect.Type beanType,
         java.lang.annotation.Annotation... qualifiers)Return the set of beans which have the given required type and qualifiers and are available for injection in the module or library containing the class into which the BeanManager was injected or the Java EE component from whose JNDI environment namespace the BeanManager was obtained, according to the rules of typesafe resolution. | |
|  Context | getContext(java.lang.Class<? extends java.lang.annotation.Annotation> scopeType)Obtains an active context object for the given scope. | |
|  javax.el.ELResolver | getELResolver()Returns a ELResolverthat resolves beans by EL name. | |
|  java.lang.Object | getInjectableReference(InjectionPoint ij,
                       CreationalContext<?> ctx)Obtains an injectable reference for a certain injection point. | |
|  java.util.Set<java.lang.annotation.Annotation> | getInterceptorBindingDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> bindingType)Obtains the set of meta-annotations for a certain interceptor binding type. | |
|  Bean<?> | getPassivationCapableBean(java.lang.String id)Returns the PassivationCapablebean with 
 the given identifier. | |
|  java.lang.Object | getReference(Bean<?> bean,
             java.lang.reflect.Type beanType,
             CreationalContext<?> ctx)Obtains a contextual reference for a certain bean and a certain bean type of the bean. | |
|  java.util.Set<java.lang.annotation.Annotation> | getStereotypeDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> stereotype)Obtains meta-annotations for a certain stereotype. | |
|  boolean | isInterceptorBinding(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)Test the given annotation type to determine if it is an interceptor binding type. | |
|  boolean | isNormalScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)Test the given annotation type to determine if it is a normal scope type. | |
|  boolean | isPassivatingScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)Test the given annotation type to determine if it is a passivating scope type. | |
|  boolean | isQualifier(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)Test the given annotation type to determine if it is a qualifier type. | |
|  boolean | isScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)Test the given annotation type to determine if it is a scope type. | |
|  boolean | isStereotype(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)Test the given annotation type to determine if it is a stereotype. | |
| 
 | resolve(java.util.Set<Bean<? extends X>> beans)Apply the ambiguous dependency resolution rules to a set of beans. | |
|  java.util.List<Decorator<?>> | resolveDecorators(java.util.Set<java.lang.reflect.Type> types,
                  java.lang.annotation.Annotation... qualifiers)Return an ordered list of decorators for a set of bean types and a set of qualifiers and which are enabled in the module or library containing the class into which the BeanManager was injected or the Java EE component from whose JNDI environment namespace the BeanManager was obtained. | |
|  java.util.List<Interceptor<?>> | resolveInterceptors(InterceptionType type,
                    java.lang.annotation.Annotation... interceptorBindings)Return an ordered list of enabled interceptors for a set of interceptor bindings and a type of interception and which are enabled in the module or library containing the class into which the BeanManager was injected or the Java EE component from whose JNDI environment namespace the BeanManager was obtained. | |
| 
 | resolveObserverMethods(T event,
                       java.lang.annotation.Annotation... qualifiers)Return the set of observers for an event. | |
|  void | validate(InjectionPoint injectionPoint)Validate a certain injection point. | |
|  javax.el.ExpressionFactory | wrapExpressionFactory(javax.el.ExpressionFactory expressionFactory)Returns a wrapper ExpressionFactorythat delegatesMethodExpressionandValueExpressioncreation to the givenExpressionFactory. | |
| Method Detail | 
|---|
java.lang.Object getReference(Bean<?> bean,
                              java.lang.reflect.Type beanType,
                              CreationalContext<?> ctx)
bean - the Bean object representing the beanbeanType - a bean type that must be implemented by any client proxy 
           that is returnedctx - a CreationalContext that 
           may be used to destroy any object with scope 
           {javax.enterprise.context.Dependent} that is created
java.lang.IllegalArgumentException - if the given type is not a bean type of
           the given bean
java.lang.Object getInjectableReference(InjectionPoint ij,
                                        CreationalContext<?> ctx)
ij - the target injection pointctx - a CreationalContext that 
           may be used to destroy any object with scope 
           {javax.enterprise.context.Dependent} that is created
UnsatisfiedResolutionException - if typesafe resolution results in 
           an unsatisfied dependency
AmbiguousResolutionException - typesafe resolution results in an 
           unresolvable ambiguous dependency<T> CreationalContext<T> createCreationalContext(Contextual<T> contextual)
CreationalContext 
 for the given contextual type, 
 or for a non-contextual object.
contextual - the Contextual, or
           a null value in the case of a non-contextual object
CreationalContext
java.util.Set<Bean<?>> getBeans(java.lang.reflect.Type beanType,
                                java.lang.annotation.Annotation... qualifiers)
beanType - the required bean typequalifiers - the required qualifiers
java.lang.IllegalArgumentException - if the given type represents a type
            variable
java.lang.IllegalArgumentException - if two instances of the same qualifier type
            are given
java.lang.IllegalArgumentException - if an instance of an annotation that is
            not a qualifier type is givenjava.util.Set<Bean<?>> getBeans(java.lang.String name)
name - the EL name
Bean<?> getPassivationCapableBean(java.lang.String id)
PassivationCapable bean with 
 the given identifier.
id - the identifier
Bean that implements 
            PassivationCapable
            and has the given identifier, or a null value if there 
            is no such bean<X> Bean<? extends X> resolve(java.util.Set<Bean<? extends X>> beans)
X - a common type of the beansbeans - a set of beans of the given type
AmbiguousResolutionException - if the ambiguous dependency
            resolution rules failvoid validate(InjectionPoint injectionPoint)
injectionPoint - the injection point to 
            validate
InjectionException - if there is a deployment problem (for
            example, an unsatisfied or unresolvable ambiguous dependency)
            associated with the injection point
void fireEvent(java.lang.Object event,
               java.lang.annotation.Annotation... qualifiers)
event - the event objectqualifiers - the event qualifiers
java.lang.IllegalArgumentException - if the runtime type of the event object
            contains a type variable
java.lang.IllegalArgumentException - if two instances of the same qualifier type
            are given
java.lang.IllegalArgumentException - if an instance of an annotation that is not 
 a qualifier type is given
<T> java.util.Set<ObserverMethod<? super T>> resolveObserverMethods(T event,
                                                                    java.lang.annotation.Annotation... qualifiers)
T - the type of the eventevent - the event objectqualifiers - the event qualifiers
java.lang.IllegalArgumentException - if the runtime type of the event object 
            contains a type variable
java.lang.IllegalArgumentException - if two instances of the same qualifier type
            are given
java.lang.IllegalArgumentException - if an instance of an annotation that is not
            a qualifier type is given
java.util.List<Decorator<?>> resolveDecorators(java.util.Set<java.lang.reflect.Type> types,
                                               java.lang.annotation.Annotation... qualifiers)
types - the set of bean types of the decorated beanqualifiers - the qualifiers declared by the decorated bean
java.lang.IllegalArgumentException - if the set of bean types is empty
java.lang.IllegalArgumentException - if an annotation which is not a binding
            type is passed
java.lang.IllegalArgumentException - if two instances of the same binding type
            are passed
java.util.List<Interceptor<?>> resolveInterceptors(InterceptionType type,
                                                   java.lang.annotation.Annotation... interceptorBindings)
type - the type of the interceptioninterceptorBindings - the interceptor bindings
java.lang.IllegalArgumentException - if no interceptor binding type is given
java.lang.IllegalArgumentException - if two instances of the same interceptor 
            binding type are given
java.lang.IllegalArgumentException - if an instance of an annotation that is not 
            an interceptor binding type is givenboolean isScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
annotationType - the annotation type
boolean isNormalScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
annotationType - the annotation type
boolean isPassivatingScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
annotationType - the annotation type
boolean isQualifier(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
annotationType - the annotation type
boolean isInterceptorBinding(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
annotationType - the annotation to test
boolean isStereotype(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
annotationType - the annotation type
java.util.Set<java.lang.annotation.Annotation> getInterceptorBindingDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> bindingType)
bindingType - the
           interceptor binding type
java.util.Set<java.lang.annotation.Annotation> getStereotypeDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> stereotype)
stereotype - the stereotype
Context getContext(java.lang.Class<? extends java.lang.annotation.Annotation> scopeType)
scopeType - the scope
ContextNotActiveException - if there is no active context object for the
            given scope
java.lang.IllegalArgumentException - if there is more than one active context object
            for the given scopejavax.el.ELResolver getELResolver()
ELResolver that resolves beans by EL name.
javax.el.ExpressionFactory wrapExpressionFactory(javax.el.ExpressionFactory expressionFactory)
ExpressionFactory that delegates
 MethodExpression and ValueExpression
 creation to the given ExpressionFactory. When a Unified
 EL expression is evaluated using a MethodExpression or
 ValueExpression returned by the wrapper
 ExpressionFactory, the container handles destruction of
 objects with scope Dependent.
expressionFactory - the ExpressionFactory to wrap
ExpressionFactory<T> AnnotatedType<T> createAnnotatedType(java.lang.Class<T> type)
AnnotatedType that may be used to read the annotations 
 of the given class or interface.
T - the class or interfacetype - the Class object
AnnotatedType<T> InjectionTarget<T> createInjectionTarget(AnnotatedType<T> type)
InjectionTarget for the given AnnotatedType. 
 The container ignores the annotations and types declared by the elements 
 of the actual Java class and uses the metadata provided via the 
 Annotated interface instead.
T - the typetype - the AnnotatedType
java.lang.IllegalArgumentException - if there is a definition error associated
            with any injection point of the type| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||