org.apache.webbeans.annotation
Class AnnotationManager

java.lang.Object
  org.apache.webbeans.annotation.AnnotationManager

public final class AnnotationManager
extends java.lang.Object

Manages annotation usage by classes in this application.

Constructor Summary

AnnotationManager(WebBeansContext context)

Method Summary

void	checkDecoratorResolverParams(java.util.Set<java.lang.reflect.Type> apiTypes, java.lang.annotation.Annotation... qualifiers)
java.lang.annotation.Annotation[]	checkForNewQualifierForDeployment(java.lang.reflect.Type type, java.lang.Class<?> clazz, java.lang.String name, java.lang.annotation.Annotation[] annotations) Check conditions for the new binding.
void	checkInjectionPointForInjectInjectionPoint(java.lang.Class<?> clazz) JavaEE components can not inject InjectionPoint.
boolean	checkInjectionPointForInterceptorPassivation(java.lang.Class<?> clazz) Returns trur for serializable types.
void	checkInterceptorResolverParams(java.lang.annotation.Annotation... interceptorBindings)
void	checkQualifierConditions(java.lang.annotation.Annotation... qualifierAnnots)
void	checkQualifierConditions(java.util.Set<java.lang.annotation.Annotation> qualifierAnnots) This function obviously cannot check for duplicate annotations.
void	checkStereoTypeClass(java.lang.Class<? extends java.lang.annotation.Annotation> clazz) Validates that given class obeys stereotype model defined by the specification.
void	checkStereoTypeClass(java.lang.Class<? extends java.lang.annotation.Annotation> clazz, java.lang.annotation.Annotation... annotations) Validates that given class obeys stereotype model defined by the specification.
boolean	configuredProducerSpecializedName(AbstractOwbBean<?> component, java.lang.reflect.Method method, java.lang.reflect.Method superMethod) Configures the name of the producer method for specializing the parent.
<X> java.lang.annotation.Annotation[]	getAnnotatedMethodFirstParameterQualifierWithGivenAnnotation(javax.enterprise.inject.spi.AnnotatedMethod<X> annotatedMethod, java.lang.Class<? extends java.lang.annotation.Annotation> clazz)
java.lang.annotation.Annotation[]	getComponentStereoTypes(OwbBean<?> bean) Returns bean stereotypes.
<X> java.lang.reflect.Method	getDisposalWithGivenAnnotatedMethod(javax.enterprise.inject.spi.AnnotatedType<X> annotatedType, java.lang.reflect.Type beanType, java.lang.annotation.Annotation[] qualifiers)
java.lang.annotation.Annotation[]	getInterceptorBindingMetaAnnotations(java.lang.annotation.Annotation[] anns) Collect the interceptor bindings from an array of annotations, including transitively defined interceptor bindings.
java.lang.annotation.Annotation[]	getMethodFirstParameterQualifierWithGivenAnnotation(java.lang.reflect.Method method, java.lang.Class<? extends java.lang.annotation.Annotation> clazz) Gets the method first found parameter qualifiers.
java.lang.annotation.Annotation[]	getQualifierAnnotations(java.lang.annotation.Annotation... annotations) Gets the array of qualifier annotations on the given array.
java.lang.annotation.Annotation[]	getRealizesGenericAnnotations(java.lang.Class<?> clazz, java.lang.annotation.Annotation[] anns) If the bean extends generic class via Realizes annotation, realized based producer methods, fields and observer methods qualifier is Qualifiers on the definitions Plus class qualifiers Minus generic class qualifiers
java.lang.annotation.Annotation[]	getStereotypeMetaAnnotations(java.lang.annotation.Annotation[] anns)
boolean	hasInterceptorBindingMetaAnnotation(java.lang.annotation.Annotation[] anns) If any Annotations in the input is an interceptor binding annotation type then return true, false otherwise.
boolean	hasNamedOnStereoTypes(OwbBean<?> bean) Returns true if name exists,false otherwise.
boolean	hasStereoTypeMetaAnnotation(java.lang.annotation.Annotation[] anns)
boolean	isComponentHasStereoType(OwbBean<?> component) Returns true if array contains the StereoType meta annotation
boolean	isInterceptorBindingAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> clazz) Returns true if the annotation is defined in xml or annotated with InterceptorBinding false otherwise.
boolean	isQualifierAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> clazz) Returns true if the annotation is defined in xml or annotated with Qualifier false otherwise.
boolean	isStereoTypeAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> clazz) Returns true if the annotation is defined in xml or annotated with Stereotype false otherwise.

Methods inherited from class java.lang.Object

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

Constructor Detail

AnnotationManager

public AnnotationManager(WebBeansContext context)

Method Detail

isInterceptorBindingAnnotation

public boolean isInterceptorBindingAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> clazz)

Returns true if the annotation is defined in xml or annotated with InterceptorBinding false otherwise.

Parameters:

clazz - type of the annotation

Returns:

true if the annotation is defined in xml or annotated with InterceptorBinding false otherwise

hasInterceptorBindingMetaAnnotation

public boolean hasInterceptorBindingMetaAnnotation(java.lang.annotation.Annotation[] anns)

If any Annotations in the input is an interceptor binding annotation type then return true, false otherwise.

Parameters:

anns - array of Annotations to check

Returns:

true if one or moe of the input annotations are an interceptor binding annotation type false otherwise

getInterceptorBindingMetaAnnotations

public java.lang.annotation.Annotation[] getInterceptorBindingMetaAnnotations(java.lang.annotation.Annotation[] anns)

Collect the interceptor bindings from an array of annotations, including transitively defined interceptor bindings.

Parameters:

anns - An array of annotations

Returns:

an array of interceptor binding annotations, including the input and any transitively declared annotations

isQualifierAnnotation

public boolean isQualifierAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> clazz)

Returns true if the annotation is defined in xml or annotated with Qualifier false otherwise.

Parameters:

clazz - type of the annotation

Returns:

true if the annotation is defined in xml or annotated with Qualifier false otherwise

getAnnotatedMethodFirstParameterQualifierWithGivenAnnotation

public <X> java.lang.annotation.Annotation[] getAnnotatedMethodFirstParameterQualifierWithGivenAnnotation(javax.enterprise.inject.spi.AnnotatedMethod<X> annotatedMethod,
                                                                                                          java.lang.Class<? extends java.lang.annotation.Annotation> clazz)

getMethodFirstParameterQualifierWithGivenAnnotation

public java.lang.annotation.Annotation[] getMethodFirstParameterQualifierWithGivenAnnotation(java.lang.reflect.Method method,
                                                                                             java.lang.Class<? extends java.lang.annotation.Annotation> clazz)

Gets the method first found parameter qualifiers.

Parameters:

method - method

clazz - checking annotation

Returns:

annotation array

getQualifierAnnotations

public java.lang.annotation.Annotation[] getQualifierAnnotations(java.lang.annotation.Annotation... annotations)

Gets the array of qualifier annotations on the given array.

Parameters:

annotations - annotation array

Returns:

array containing qualifier anns

getRealizesGenericAnnotations

public java.lang.annotation.Annotation[] getRealizesGenericAnnotations(java.lang.Class<?> clazz,
                                                                       java.lang.annotation.Annotation[] anns)

If the bean extends generic class via Realizes annotation, realized based producer methods, fields and observer methods qualifier is

• Qualifiers on the definitions
• Plus class qualifiers
• Minus generic class qualifiers

Parameters:

clazz - realized definition class

anns - binding annotations array

checkQualifierConditions

public void checkQualifierConditions(java.lang.annotation.Annotation... qualifierAnnots)

checkQualifierConditions

public void checkQualifierConditions(java.util.Set<java.lang.annotation.Annotation> qualifierAnnots)

This function obviously cannot check for duplicate annotations. So this must have been done before!

Parameters:

qualifierAnnots -

isStereoTypeAnnotation

public boolean isStereoTypeAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> clazz)

Returns true if the annotation is defined in xml or annotated with Stereotype false otherwise.

Parameters:

clazz - type of the annotation

Returns:

true if the annotation is defined in xml or annotated with Stereotype false otherwise

hasStereoTypeMetaAnnotation

public boolean hasStereoTypeMetaAnnotation(java.lang.annotation.Annotation[] anns)

getStereotypeMetaAnnotations

public java.lang.annotation.Annotation[] getStereotypeMetaAnnotations(java.lang.annotation.Annotation[] anns)

isComponentHasStereoType

public boolean isComponentHasStereoType(OwbBean<?> component)

Returns true if array contains the StereoType meta annotation

Returns:

true if array contains the StereoType meta annotation

getComponentStereoTypes

public java.lang.annotation.Annotation[] getComponentStereoTypes(OwbBean<?> bean)

Returns bean stereotypes.

Parameters:

bean - bean instance

Returns:

bean stereotypes

hasNamedOnStereoTypes

public boolean hasNamedOnStereoTypes(OwbBean<?> bean)

Returns true if name exists,false otherwise.

Parameters:

bean - bean instance

Returns:

true if name exists

checkStereoTypeClass

public void checkStereoTypeClass(java.lang.Class<? extends java.lang.annotation.Annotation> clazz)

Validates that given class obeys stereotype model defined by the specification.

Parameters:

clazz - stereotype class

checkStereoTypeClass

public void checkStereoTypeClass(java.lang.Class<? extends java.lang.annotation.Annotation> clazz,
                                 java.lang.annotation.Annotation... annotations)

Validates that given class obeys stereotype model defined by the specification.

Parameters:

clazz - stereotype class

checkInterceptorResolverParams

public void checkInterceptorResolverParams(java.lang.annotation.Annotation... interceptorBindings)

checkDecoratorResolverParams

public void checkDecoratorResolverParams(java.util.Set<java.lang.reflect.Type> apiTypes,
                                         java.lang.annotation.Annotation... qualifiers)

checkForNewQualifierForDeployment

public java.lang.annotation.Annotation[] checkForNewQualifierForDeployment(java.lang.reflect.Type type,
                                                                           java.lang.Class<?> clazz,
                                                                           java.lang.String name,
                                                                           java.lang.annotation.Annotation[] annotations)

Check conditions for the new binding.

Parameters:

annotations - annotations

Returns:

Annotation[] with all binding annotations

Throws:

WebBeansConfigurationException - if New plus any other binding annotation is set

configuredProducerSpecializedName

public boolean configuredProducerSpecializedName(AbstractOwbBean<?> component,
                                                 java.lang.reflect.Method method,
                                                 java.lang.reflect.Method superMethod)

Configures the name of the producer method for specializing the parent.

Parameters:

component - producer method component

method - specialized producer method

superMethod - overriden super producer method

getDisposalWithGivenAnnotatedMethod

public <X> java.lang.reflect.Method getDisposalWithGivenAnnotatedMethod(javax.enterprise.inject.spi.AnnotatedType<X> annotatedType,
                                                                        java.lang.reflect.Type beanType,
                                                                        java.lang.annotation.Annotation[] qualifiers)

checkInjectionPointForInjectInjectionPoint

public void checkInjectionPointForInjectInjectionPoint(java.lang.Class<?> clazz)

JavaEE components can not inject InjectionPoint.

Parameters:

clazz - javaee component class info

Throws:

WebBeansConfigurationException - exception if condition is not applied

checkInjectionPointForInterceptorPassivation

public boolean checkInjectionPointForInterceptorPassivation(java.lang.Class<?> clazz)

Returns trur for serializable types.

Parameters:

clazz - class info

Returns:

true if class is serializable