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, Marko Luksa

Constructor Summary

Constructors

Constructor and Description
Beans()

Method Summary

Methods

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 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, BeanManagerImpl beanManager) Checks that all the qualifiers in the set requiredQualifiers are in the set of qualifiers.
static boolean	findInterceptorBindingConflicts(java.util.Set<InterceptorBindingType> flattenedBindings)
static <T> ConstructorInjectionPoint<T>	getBeanConstructor(Bean<T> declaringBean, WeldClass<T> type)
static java.lang.reflect.Type	getDeclaredBeanType(java.lang.Class<?> clazz) Gets the declared bean type
static InjectionPoint	getDelegateInjectionPoint(Decorator<?> decorator)
static <T> java.util.Collection<WeldMethod<?,? super T>>	getDisposerMethods(WeldClass<T> weldClass)
static java.util.Set<WeldInjectionPoint<?,?>>	getEjbInjectionPoints(Bean<?> declaringBean, WeldClass<?> type, BeanManagerImpl manager)
static java.util.List<java.util.Set<FieldInjectionPoint<?,?>>>	getFieldInjectionPoints(Bean<?> declaringBean, WeldClass<?> weldClass)
static java.util.List<java.util.Set<MethodInjectionPoint<?,?>>>	getInitializerMethods(Bean<?> declaringBean, WeldClass<?> weldClass)
static java.util.List<java.util.Set<MethodInjectionPoint<?,?>>>	getInitializerMethodsFromDeclaredMethods(Bean<?> declaringBean, WeldClass<?> weldClass)
static java.util.List<WeldMethod<?,?>>	getInterceptableMethods(WeldClass<?> type)
static <T> java.util.List<WeldMethod<?,? super T>>	getObserverMethods(WeldClass<T> type)
static java.util.Set<ParameterInjectionPoint<?,?>>	getParameterInjectionPoints(Bean<?> declaringBean, java.util.List<java.util.Set<MethodInjectionPoint<?,?>>> methodInjectionPoints)
static java.util.Set<ParameterInjectionPoint<?,?>>	getParameterInjectionPoints(Bean<?> declaringBean, MethodInjectionPoint<?,?> method)
static java.util.Set<ParameterInjectionPoint<?,?>>	getParameterInjectionPoints(Bean<?> declaringBean, WeldConstructor<?> constructor)
static java.util.Set<WeldInjectionPoint<?,?>>	getPersistenceContextInjectionPoints(Bean<?> declaringBean, WeldClass<?> type, BeanManagerImpl manager)
static java.util.Set<WeldInjectionPoint<?,?>>	getPersistenceUnitInjectionPoints(Bean<?> declaringBean, WeldClass<?> type, BeanManagerImpl manager)
static <T> java.util.List<WeldMethod<?,? super T>>	getPostConstructMethods(WeldClass<T> type)
static <T> java.util.List<WeldMethod<?,? super T>>	getPreDestroyMethods(WeldClass<T> type)
static <T> java.util.Collection<WeldMethod<?,? super T>>	getProducerMethods(WeldClass<T> weldClass)
static java.util.Set<WeldInjectionPoint<?,?>>	getResourceInjectionPoints(Bean<?> declaringBean, WeldClass<?> type, BeanManagerImpl manager)
static <T> void	injectBoundFields(T instance, CreationalContext<T> creationalContext, BeanManagerImpl manager, java.lang.Iterable<? extends FieldInjectionPoint<?,?>> injectableFields) Injects bound fields
static <T> void	injectEEFields(T beanInstance, BeanManagerImpl manager, java.lang.Iterable<WeldInjectionPoint<?,?>> ejbInjectionPoints, java.lang.Iterable<WeldInjectionPoint<?,?>> persistenceContextInjectionPoints, java.lang.Iterable<WeldInjectionPoint<?,?>> persistenceUnitInjectionPoints, java.lang.Iterable<WeldInjectionPoint<?,?>> resourceInjectionPoints) Injects EJBs and common fields
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(WeldAnnotated<?,?> 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, Enabled enabled)
static boolean	isBeanProxyable(Bean<?> bean) Indicates if a bean is proxyable
static <T> boolean	isDecorator(WeldClass<T> annotatedItem)
static <T> boolean	isInterceptor(WeldClass<T> annotatedItem)
static boolean	isNormalScoped(Bean<?> bean)
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 <T extends Bean<?>> boolean	isSpecialized(T bean, BeanManagerImpl beanManager) Check if bean is specialized by any of beans
static <T extends Bean<?>> boolean	isSpecialized(T bean, java.util.Set<T> beans, BeanManagerImpl beanManager) Check if bean is specialized by any of beans
static boolean	isSuppressedBySpecialization(Bean<?> bean, BeanManagerImpl manager) Check if the given producer/disposer method of producer field is defined on a specialized bean and is therefore disabled.
static java.util.Set<FieldInjectionPoint<?,?>>	mergeFieldInjectionPoints(java.util.List<? extends java.util.Set<? extends FieldInjectionPoint<?,?>>> fieldInjectionPoints)
static java.lang.annotation.Annotation[]	mergeInQualifiers(java.lang.annotation.Annotation[] qualifiers, java.lang.annotation.Annotation[] newQualifiers)
static java.util.Set<java.lang.annotation.Annotation>	mergeInQualifiers(java.util.Collection<java.lang.annotation.Annotation> qualifiers, java.lang.annotation.Annotation[] newQualifiers)
static <T extends Bean<?>> java.util.Set<T>	removeDisabledAndSpecializedBeans(java.util.Set<T> beans, BeanManagerImpl beanManager) Retains only beans which have deployment type X.
static java.lang.Object	resolveEEResource(BeanManagerImpl manager, WeldInjectionPoint<?,?> injectionPoint) Inspect an injection point, and try to retrieve a EE resource for it

Methods inherited from class java.lang.Object

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

Constructor Detail

Beans

public Beans()

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

isNormalScoped

public static boolean isNormalScoped(Bean<?> bean)

isBeanProxyable

public static boolean isBeanProxyable(Bean<?> bean)

Indicates if a bean is proxyable

Parameters:

bean - The bean to test

Returns:

True if proxyable, false otherwise

getFieldInjectionPoints

public static java.util.List<java.util.Set<FieldInjectionPoint<?,?>>> getFieldInjectionPoints(Bean<?> declaringBean,
                                                                              WeldClass<?> weldClass)

mergeFieldInjectionPoints

public static java.util.Set<FieldInjectionPoint<?,?>> mergeFieldInjectionPoints(java.util.List<? extends java.util.Set<? extends FieldInjectionPoint<?,?>>> fieldInjectionPoints)

getPostConstructMethods

public static <T> java.util.List<WeldMethod<?,? super T>> getPostConstructMethods(WeldClass<T> type)

getObserverMethods

public static <T> java.util.List<WeldMethod<?,? super T>> getObserverMethods(WeldClass<T> type)

getPreDestroyMethods

public static <T> java.util.List<WeldMethod<?,? super T>> getPreDestroyMethods(WeldClass<T> type)

getInterceptableMethods

public static java.util.List<WeldMethod<?,?>> getInterceptableMethods(WeldClass<?> type)

getEjbInjectionPoints

public static java.util.Set<WeldInjectionPoint<?,?>> getEjbInjectionPoints(Bean<?> declaringBean,
                                                           WeldClass<?> type,
                                                           BeanManagerImpl manager)

getPersistenceContextInjectionPoints

public static java.util.Set<WeldInjectionPoint<?,?>> getPersistenceContextInjectionPoints(Bean<?> declaringBean,
                                                                          WeldClass<?> type,
                                                                          BeanManagerImpl manager)

getPersistenceUnitInjectionPoints

public static java.util.Set<WeldInjectionPoint<?,?>> getPersistenceUnitInjectionPoints(Bean<?> declaringBean,
                                                                       WeldClass<?> type,
                                                                       BeanManagerImpl manager)

getResourceInjectionPoints

public static java.util.Set<WeldInjectionPoint<?,?>> getResourceInjectionPoints(Bean<?> declaringBean,
                                                                WeldClass<?> type,
                                                                BeanManagerImpl manager)

getInitializerMethods

public static java.util.List<java.util.Set<MethodInjectionPoint<?,?>>> getInitializerMethods(Bean<?> declaringBean,
                                                                             WeldClass<?> weldClass)

getInitializerMethodsFromDeclaredMethods

public static java.util.List<java.util.Set<MethodInjectionPoint<?,?>>> getInitializerMethodsFromDeclaredMethods(Bean<?> declaringBean,
                                                                                                WeldClass<?> weldClass)

getParameterInjectionPoints

public static java.util.Set<ParameterInjectionPoint<?,?>> getParameterInjectionPoints(Bean<?> declaringBean,
                                                                      WeldConstructor<?> constructor)

getParameterInjectionPoints

public static java.util.Set<ParameterInjectionPoint<?,?>> getParameterInjectionPoints(Bean<?> declaringBean,
                                                                      MethodInjectionPoint<?,?> method)

getParameterInjectionPoints

public static java.util.Set<ParameterInjectionPoint<?,?>> getParameterInjectionPoints(Bean<?> declaringBean,
                                                                      java.util.List<java.util.Set<MethodInjectionPoint<?,?>>> methodInjectionPoints)

containsAllQualifiers

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

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)

findInterceptorBindingConflicts

public static boolean findInterceptorBindingConflicts(java.util.Set<InterceptorBindingType> flattenedBindings)

removeDisabledAndSpecializedBeans

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

Retains only beans which have deployment type X.

The deployment type X is

Parameters:

beans - The beans to filter

beanManager - the bean manager

Returns:

The filtered beans

isBeanEnabled

public static boolean isBeanEnabled(Bean<?> bean,
                    Enabled 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(WeldAnnotated<?,?> annotated,
                    MergedStereotypes<?,?> mergedStereotypes)

Is alternative.

Parameters:

annotated - the annotated

mergedStereotypes - merged stereotypes

Returns:

true if alternative, false otherwise

isSpecialized

public static <T extends Bean<?>> boolean isSpecialized(T bean,
                                        BeanManagerImpl beanManager)

Check if bean is specialized by any of beans

Parameters:

bean - the bean to check

beanManager - bean manager

Returns:

true if bean is specialized by some bean in all beans

isSpecialized

public static <T extends Bean<?>> boolean isSpecialized(T bean,
                                        java.util.Set<T> beans,
                                        BeanManagerImpl beanManager)

Check if bean is specialized by any of beans

Parameters:

bean - the bean to check

beans - the possible specialized beans

beanManager - bean manager

Returns:

true if bean is specialized by some bean in beans

isSuppressedBySpecialization

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

Check if the given producer/disposer method of producer field is defined on a specialized bean and is therefore disabled.

getBeanConstructor

public static <T> ConstructorInjectionPoint<T> getBeanConstructor(Bean<T> declaringBean,
                                                  WeldClass<T> type)

injectEEFields

public static <T> void injectEEFields(T beanInstance,
                      BeanManagerImpl manager,
                      java.lang.Iterable<WeldInjectionPoint<?,?>> ejbInjectionPoints,
                      java.lang.Iterable<WeldInjectionPoint<?,?>> persistenceContextInjectionPoints,
                      java.lang.Iterable<WeldInjectionPoint<?,?>> persistenceUnitInjectionPoints,
                      java.lang.Iterable<WeldInjectionPoint<?,?>> resourceInjectionPoints)

Injects EJBs and common fields

resolveEEResource

public static java.lang.Object resolveEEResource(BeanManagerImpl manager,
                                 WeldInjectionPoint<?,?> injectionPoint)

Inspect an injection point, and try to retrieve a EE resource for it

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(WeldClass<T> annotatedItem)

isDecorator

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

mergeInQualifiers

public static java.lang.annotation.Annotation[] mergeInQualifiers(java.lang.annotation.Annotation[] qualifiers,
                                                  java.lang.annotation.Annotation[] newQualifiers)

mergeInQualifiers

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

getDelegateInjectionPoint

public static InjectionPoint getDelegateInjectionPoint(Decorator<?> decorator)

getProducerMethods

public static <T> java.util.Collection<WeldMethod<?,? super T>> getProducerMethods(WeldClass<T> weldClass)

Parameters:

weldClass -

Returns:

a set of producer methods, bridge methods are filtered out

getDisposerMethods

public static <T> java.util.Collection<WeldMethod<?,? super T>> getDisposerMethods(WeldClass<T> weldClass)

Parameters:

weldClass -

Returns:

a set of disposer methods, bridge methods are filtered out