org.jboss.weld.util

Class Beans

java.lang.Object

org.jboss.weld.util.Beans

public class Beans
extends java.lang.Object

Helper class for bean inspection

Author:

Pete Muir, David Allen, Marius Bogoevici, Ales Justin, Jozef Hartinger

Method Summary

Modifier and Type	Method and Description
static <T> void	callInitializers(T instance, CreationalContext<T> creationalContext, BeanManagerImpl manager, java.lang.Iterable<? extends MethodInjectionPoint<?,?>> initializerMethods) Calls all initializers of the bean
static <T,S,X extends EnhancedAnnotated<T,S>> X	checkEnhancedAnnotatedAvailable(X enhancedAnnotated)
static boolean	containsAllInterceptionBindings(java.util.Set<java.lang.annotation.Annotation> expectedBindings, java.util.Set<QualifierInstance> existingBindings, BeanManagerImpl manager)
static boolean	containsAllQualifiers(java.util.Set<QualifierInstance> requiredQualifiers, java.util.Set<QualifierInstance> qualifiers) Checks that all the qualifiers in the set requiredQualifiers are in the set of qualifiers.
static java.lang.String	createBeanAttributesId(BeanAttributes<?> attributes) Generates a unique signature for BeanAttributes.
static java.lang.String	createTypeCollectionId(java.util.Collection<? extends java.lang.reflect.Type> types) Generates a unique signature of a collection of types.
static <T> EnhancedAnnotatedConstructor<T>	getBeanConstructor(EnhancedAnnotatedType<T> type)
static <T> EnhancedAnnotatedConstructor<T>	getBeanConstructorStrict(EnhancedAnnotatedType<T> type)
static java.lang.reflect.Type	getDeclaredBeanType(java.lang.Class<?> clazz) Gets the declared bean type
static <T> EnhancedAnnotatedType<T>	getEjbImplementationClass(InternalEjbDescriptor<T> ejbDescriptor, BeanManagerImpl manager, EnhancedAnnotatedType<T> componentType)
static <T> EnhancedAnnotatedType<T>	getEjbImplementationClass(SessionBean<T> bean) Returns EnhancedAnnotatedType for the EJB implementation class.
static java.util.List<EnhancedAnnotatedMethod<?,?>>	getInterceptableMethods(EnhancedAnnotatedType<?> type)
static java.util.Set<java.lang.reflect.Type>	getTypedTypes(java.util.Map<java.lang.Class<?>,java.lang.reflect.Type> typeClosure, java.lang.Class<?> rawType, Typed typed) Bean types of a bean that uses the Typed annotation.
static java.util.Set<java.lang.reflect.Type>	getTypes(EnhancedAnnotated<?,?> annotated) Bean types from an annotated element
static <T> java.util.Set<java.lang.reflect.Type>	getTypes(EnhancedAnnotated<T,?> annotated, EjbDescriptor<T> ejbDescriptor) Bean types of a session bean.
static boolean	hasBuiltinScope(Bean<?> bean)
static boolean	hasSimpleCdiConstructor(AnnotatedType<?> type)
static <T> void	injectBoundFields(T instance, CreationalContext<T> creationalContext, BeanManagerImpl manager, java.lang.Iterable<? extends FieldInjectionPoint<?,?>> injectableFields) Injects bound fields
static <T> void	injectEEFields(java.lang.Iterable<java.util.Set<ResourceInjection<?>>> resourceInjectionsHierarchy, T beanInstance, CreationalContext<T> ctx) Injects EJBs and other EE resources.
static <T> void	injectFieldsAndInitializers(T instance, CreationalContext<T> ctx, BeanManagerImpl beanManager, java.util.List<? extends java.lang.Iterable<? extends FieldInjectionPoint<?,?>>> injectableFields, java.util.List<? extends java.lang.Iterable<? extends MethodInjectionPoint<?,?>>> initializerMethods)
static boolean	isAlternative(EnhancedAnnotated<?,?> annotated, MergedStereotypes<?,?> mergedStereotypes) Is alternative.
static boolean	isAlternativePresent(java.util.Set<Bean<?>> beans) Check if any of the beans is an alternative
static boolean	isBeanEnabled(Bean<?> bean, ModuleEnablement enabled)
static boolean	isBeanProxyable(Bean<?> bean, BeanManagerImpl manager) Indicates if a bean is proxyable
static <T> boolean	isDecorator(EnhancedAnnotatedType<T> annotatedItem)
static <T> boolean	isInterceptor(AnnotatedType<T> annotatedItem)
static boolean	isPassivatingScope(Bean<?> bean, BeanManagerImpl manager) Indicates if a bean's scope type is passivating
static boolean	isPassivationCapableBean(Bean<?> bean) Tests if a bean is capable of having its state temporarily stored to secondary storage
static boolean	isPassivationCapableDependency(Bean<?> bean) Tests if a bean is capable of having its state temporarily stored to secondary storage
static boolean	isTypeManagedBeanOrDecoratorOrInterceptor(AnnotatedType<?> annotatedType) Indicates if the type is a simple Web Bean
static boolean	isTypeManagedBeanOrDecoratorOrInterceptor(ClassFileInfo classFileInfo)
static boolean	isVetoed(AnnotatedType<?> type)
static boolean	isVetoed(java.lang.Class<?> javaClass) Determines if this Java class should be vetoed as a result of presence of Veto annotations.
static java.util.Set<java.lang.annotation.Annotation>	mergeInQualifiers(BeanManagerImpl manager, java.util.Collection<java.lang.annotation.Annotation> qualifiers, java.lang.annotation.Annotation[] newQualifiers)
static <T extends Bean<?>> java.util.Set<T>	removeDisabledBeans(java.util.Set<T> beans, BeanManagerImpl beanManager, SpecializationAndEnablementRegistry registry) Retains only beans which are enabled.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isPassivatingScope

public static boolean isPassivatingScope(Bean<?> bean,
                                         BeanManagerImpl manager)

Indicates if a bean's scope type is passivating

Parameters:

bean - The bean to inspect

Returns:

True if the scope is passivating, false otherwise

isPassivationCapableBean

public static boolean isPassivationCapableBean(Bean<?> bean)

Tests if a bean is capable of having its state temporarily stored to secondary storage

Parameters:

bean - The bean to inspect

Returns:

True if the bean is passivation capable

isPassivationCapableDependency

public static boolean isPassivationCapableDependency(Bean<?> bean)

Tests if a bean is capable of having its state temporarily stored to secondary storage

Parameters:

bean - The bean to inspect

Returns:

True if the bean is passivation capable

isBeanProxyable

public static boolean isBeanProxyable(Bean<?> bean,
                                      BeanManagerImpl manager)

Indicates if a bean is proxyable

Parameters:

bean - The bean to test

Returns:

True if proxyable, false otherwise

getInterceptableMethods

public static java.util.List<EnhancedAnnotatedMethod<?,?>> getInterceptableMethods(EnhancedAnnotatedType<?> type)

containsAllQualifiers

public static boolean containsAllQualifiers(java.util.Set<QualifierInstance> requiredQualifiers,
                                            java.util.Set<QualifierInstance> qualifiers)

Checks that all the qualifiers in the set requiredQualifiers are in the set of qualifiers. Qualifier equality rules for annotation members are followed.

Parameters:

requiredQualifiers - The required qualifiers

qualifiers - The set of qualifiers to check

Returns:

True if all matches, false otherwise

containsAllInterceptionBindings

public static boolean containsAllInterceptionBindings(java.util.Set<java.lang.annotation.Annotation> expectedBindings,
                                                      java.util.Set<QualifierInstance> existingBindings,
                                                      BeanManagerImpl manager)

removeDisabledBeans

public static <T extends Bean<?>> java.util.Set<T> removeDisabledBeans(java.util.Set<T> beans,
                                                                       BeanManagerImpl beanManager,
                                                                       SpecializationAndEnablementRegistry registry)

Retains only beans which are enabled.

Parameters:

beans - The beans to filter

beanManager - The bean manager

registry -

Returns:

a mutable set of enabled beans

isBeanEnabled

public static boolean isBeanEnabled(Bean<?> bean,
                                    ModuleEnablement enabled)

isAlternativePresent

public static boolean isAlternativePresent(java.util.Set<Bean<?>> beans)

Check if any of the beans is an alternative

Parameters:

beans - the beans to check

Returns:

true if any bean is an alternative

isAlternative

public static boolean isAlternative(EnhancedAnnotated<?,?> annotated,
                                    MergedStereotypes<?,?> mergedStereotypes)

Is alternative.

Parameters:

annotated - the annotated

mergedStereotypes - merged stereotypes

Returns:

true if alternative, false otherwise

getBeanConstructorStrict

public static <T> EnhancedAnnotatedConstructor<T> getBeanConstructorStrict(EnhancedAnnotatedType<T> type)

getBeanConstructor

public static <T> EnhancedAnnotatedConstructor<T> getBeanConstructor(EnhancedAnnotatedType<T> type)

injectEEFields

public static <T> void injectEEFields(java.lang.Iterable<java.util.Set<ResourceInjection<?>>> resourceInjectionsHierarchy,
                                      T beanInstance,
                                      CreationalContext<T> ctx)

Injects EJBs and other EE resources.

Parameters:

resourceInjectionsHierarchy -

beanInstance -

ctx -

getDeclaredBeanType

public static java.lang.reflect.Type getDeclaredBeanType(java.lang.Class<?> clazz)

Gets the declared bean type

Returns:

The bean type

injectBoundFields

public static <T> void injectBoundFields(T instance,
                                         CreationalContext<T> creationalContext,
                                         BeanManagerImpl manager,
                                         java.lang.Iterable<? extends FieldInjectionPoint<?,?>> injectableFields)

Injects bound fields

Parameters:

instance - The instance to inject into

injectFieldsAndInitializers

public static <T> void injectFieldsAndInitializers(T instance,
                                                   CreationalContext<T> ctx,
                                                   BeanManagerImpl beanManager,
                                                   java.util.List<? extends java.lang.Iterable<? extends FieldInjectionPoint<?,?>>> injectableFields,
                                                   java.util.List<? extends java.lang.Iterable<? extends MethodInjectionPoint<?,?>>> initializerMethods)

callInitializers

public static <T> void callInitializers(T instance,
                                        CreationalContext<T> creationalContext,
                                        BeanManagerImpl manager,
                                        java.lang.Iterable<? extends MethodInjectionPoint<?,?>> initializerMethods)

Calls all initializers of the bean

Parameters:

instance - The bean instance

isInterceptor

public static <T> boolean isInterceptor(AnnotatedType<T> annotatedItem)

isDecorator

public static <T> boolean isDecorator(EnhancedAnnotatedType<T> annotatedItem)

mergeInQualifiers

public static java.util.Set<java.lang.annotation.Annotation> mergeInQualifiers(BeanManagerImpl manager,
                                                                               java.util.Collection<java.lang.annotation.Annotation> qualifiers,
                                                                               java.lang.annotation.Annotation[] newQualifiers)

getTypes

public static java.util.Set<java.lang.reflect.Type> getTypes(EnhancedAnnotated<?,?> annotated)

Bean types from an annotated element

getTypes

public static <T> java.util.Set<java.lang.reflect.Type> getTypes(EnhancedAnnotated<T,?> annotated,
                                                                 EjbDescriptor<T> ejbDescriptor)

Bean types of a session bean.

getTypedTypes

public static java.util.Set<java.lang.reflect.Type> getTypedTypes(java.util.Map<java.lang.Class<?>,java.lang.reflect.Type> typeClosure,
                                                                  java.lang.Class<?> rawType,
                                                                  Typed typed)

Bean types of a bean that uses the Typed annotation.

isTypeManagedBeanOrDecoratorOrInterceptor

public static boolean isTypeManagedBeanOrDecoratorOrInterceptor(AnnotatedType<?> annotatedType)

Indicates if the type is a simple Web Bean

Parameters:

clazz - The type to inspect

Returns:

True if simple Web Bean, false otherwise

isTypeManagedBeanOrDecoratorOrInterceptor

public static boolean isTypeManagedBeanOrDecoratorOrInterceptor(ClassFileInfo classFileInfo)

hasSimpleCdiConstructor

public static boolean hasSimpleCdiConstructor(AnnotatedType<?> type)

isVetoed

public static boolean isVetoed(java.lang.Class<?> javaClass)

Determines if this Java class should be vetoed as a result of presence of Veto annotations.

isVetoed

public static boolean isVetoed(AnnotatedType<?> type)

createBeanAttributesId

public static java.lang.String createBeanAttributesId(BeanAttributes<?> attributes)

Generates a unique signature for BeanAttributes.

createTypeCollectionId

public static java.lang.String createTypeCollectionId(java.util.Collection<? extends java.lang.reflect.Type> types)

Generates a unique signature of a collection of types.

checkEnhancedAnnotatedAvailable

public static <T,S,X extends EnhancedAnnotated<T,S>> X checkEnhancedAnnotatedAvailable(X enhancedAnnotated)

hasBuiltinScope

public static boolean hasBuiltinScope(Bean<?> bean)

getEjbImplementationClass

public static <T> EnhancedAnnotatedType<T> getEjbImplementationClass(SessionBean<T> bean)

Returns EnhancedAnnotatedType for the EJB implementation class. Throws IllegalStateException if called after bootstrap.

Parameters:

bean -

Returns:

EnhancedAnnotatedType representation of this EJB's implementation class

Throws:

java.lang.IllegalStateException - if called after bootstrap

getEjbImplementationClass

public static <T> EnhancedAnnotatedType<T> getEjbImplementationClass(InternalEjbDescriptor<T> ejbDescriptor,
                                                                     BeanManagerImpl manager,
                                                                     EnhancedAnnotatedType<T> componentType)