org.apache.webbeans.annotation.AnnotationManager Maven / Gradle / Ivy
The newest version!
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.webbeans.annotation;
import org.apache.webbeans.component.AbstractOwbBean;
import org.apache.webbeans.config.WebBeansContext;
import org.apache.webbeans.container.BeanManagerImpl;
import org.apache.webbeans.exception.WebBeansConfigurationException;
import org.apache.webbeans.exception.inject.DefinitionException;
import org.apache.webbeans.util.AnnotationUtil;
import org.apache.webbeans.util.ArrayUtil;
import org.apache.webbeans.util.Asserts;
import javax.enterprise.context.NormalScope;
import javax.enterprise.inject.Default;
import javax.enterprise.inject.Disposes;
import javax.enterprise.inject.New;
import javax.enterprise.inject.Stereotype;
import javax.enterprise.inject.spi.AnnotatedMethod;
import javax.enterprise.inject.spi.AnnotatedParameter;
import javax.enterprise.inject.spi.AnnotatedType;
import javax.enterprise.inject.spi.InjectionPoint;
import javax.enterprise.util.Nonbinding;
import javax.inject.Inject;
import javax.inject.Named;
import javax.inject.Qualifier;
import javax.inject.Scope;
import javax.interceptor.InterceptorBinding;
import java.lang.annotation.Annotation;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
/**
* Manages annotation usage by classes in this application.
*/
public final class AnnotationManager
{
private Map, Boolean> checkedQualifierAnnotations =
new ConcurrentHashMap, Boolean>();
private Map, Boolean> checkedStereotypeAnnotations =
new ConcurrentHashMap, Boolean>();
private final BeanManagerImpl beanManagerImpl;
private final WebBeansContext webBeansContext;
private final static Annotation[] ONLY_DEFAULT_ANNOTATION = new Annotation[1];
static
{
ONLY_DEFAULT_ANNOTATION[0] = DefaultLiteral.INSTANCE;
}
// No instantiate
public AnnotationManager(WebBeansContext context)
{
webBeansContext = context;
beanManagerImpl = context.getBeanManagerImpl();
}
public Annotation getDeclaredScopeAnnotation(Class beanClass)
{
for (Annotation annotation : beanClass.getDeclaredAnnotations())
{
if (beanManagerImpl.isScope(annotation.annotationType()))
{
return annotation;
}
}
return null;
}
/**
* Returns true if the annotation is defined in xml or annotated with
* {@link javax.interceptor.InterceptorBinding} or an InterceptorBinding
* registered via {@link javax.enterprise.inject.spi.BeforeBeanDiscovery}.
* False otherwise.
*
* @param clazz type of the annotation
* @return true if the annotation is defined in xml or annotated with
* {@link javax.interceptor.InterceptorBinding}, false otherwise
*/
public boolean isInterceptorBindingAnnotation(Class clazz)
{
Asserts.nullCheckForClass(clazz);
return clazz.isAnnotationPresent(InterceptorBinding.class)
|| webBeansContext.getInterceptorsManager().hasInterceptorBindingType(clazz);
}
/**
* This method searches for all direct and indirect annotations which
* represent an {@link InterceptorBinding}.
* InterceptorBindings in stereotypes will also be found!
*
* @return the effective interceptor annotations of the array of given annotations
*/
public Set getInterceptorAnnotations(Set typeAnns)
{
// use a map to ensure that every annotation type is present only once
Map, Annotation> bindings = new HashMap, Annotation>();
Annotation[] anns = getInterceptorBindingMetaAnnotations(typeAnns);
for (Annotation ann : anns)
{
Annotation oldBinding = bindings.get(ann.annotationType());
if (oldBinding != null && !AnnotationUtil.isCdiAnnotationEqual(oldBinding, ann))
{
throw new WebBeansConfigurationException("Illegal interceptor binding: annotation of type "
+ ann.annotationType().getName()
+ " is present twice with diffenent values: "
+ oldBinding.toString() + " and " + ann.toString());
}
bindings.put(ann.annotationType(), ann);
}
// check for stereotypes _explicitly_ declared on the bean class (not inherited)
Annotation[] stereoTypes = getStereotypeMetaAnnotations(typeAnns.toArray(new Annotation[typeAnns.size()]));
for (Annotation stereoType : stereoTypes)
{
if (hasInterceptorBindingMetaAnnotation(stereoType.annotationType().getDeclaredAnnotations()))
{
Annotation[] steroInterceptorBindings = getInterceptorBindingMetaAnnotations(stereoType.annotationType().getDeclaredAnnotations());
for (Annotation ann : steroInterceptorBindings)
{
Annotation oldBinding = bindings.get(ann.annotationType());
if (oldBinding != null && !AnnotationUtil.isCdiAnnotationEqual(oldBinding, ann))
{
throw new WebBeansConfigurationException("Illegal interceptor binding: annotation of type "
+ ann.annotationType().getName()
+ " is present twice with diffenent values: "
+ oldBinding.toString() + " and " + ann.toString());
}
bindings.put(ann.annotationType(), ann);
}
}
}
return new HashSet(bindings.values());
}
/**
* If any Annotations in the input is an interceptor binding annotation type then return
* true, false otherwise.
*
* @param anns array of Annotations to check
* @return true if one or moe of the input annotations are an interceptor binding annotation
* type false otherwise
*/
public boolean hasInterceptorBindingMetaAnnotation(Annotation[] anns)
{
Asserts.assertNotNull(anns, "anns parameter can not be null");
for (Annotation ann : anns)
{
if (isInterceptorBindingAnnotation(ann.annotationType()))
{
return true;
}
}
return false;
}
/**
* Collect the interceptor bindings from an array of annotations, including
* transitively defined interceptor bindings.
* @param anns An array of annotations
* @return an array of interceptor binding annotations, including the input and any transitively declared annotations
*/
public Annotation[] getInterceptorBindingMetaAnnotations(Set anns)
{
return getInterceptorBindingMetaAnnotations(AnnotationUtil.asArray(anns));
}
/**
* Collect the interceptor bindings from an array of annotations, including
* transitively defined interceptor bindings.
* @param anns An array of annotations
* @return an array of interceptor binding annotations, including the input and any transitively declared annotations
*/
public Annotation[] getInterceptorBindingMetaAnnotations(Annotation[] anns)
{
Asserts.assertNotNull(anns, "anns parameter can not be null");
List interAnns = new ArrayList();
for (Annotation ann : anns)
{
if (isInterceptorBindingAnnotation(ann.annotationType()))
{
interAnns.add(ann);
//check for transitive
Annotation[] transitives = getInterceptorBindingMetaAnnotations(ann.annotationType().getDeclaredAnnotations());
Collections.addAll(interAnns, transitives);
}
}
Annotation[] ret = new Annotation[interAnns.size()];
ret = interAnns.toArray(ret);
return ret;
}
/**
* Returns true if the annotation is defined in xml or annotated with
* {@link javax.inject.Qualifier} false otherwise.
*
* @param clazz type of the annotation
* @return true if the annotation is defined in xml or annotated with
* {@link javax.inject.Qualifier} false otherwise
*/
public boolean isQualifierAnnotation(Class clazz)
{
Boolean checkedAnnotationResult = checkedQualifierAnnotations.get(clazz);
if (checkedAnnotationResult != null)
{
return checkedAnnotationResult;
}
boolean result = false;
Asserts.nullCheckForClass(clazz);
if (clazz.isAnnotationPresent(Qualifier.class))
{
result = true;
}
else if(beanManagerImpl.getAdditionalQualifiers().contains(clazz))
{
result = true;
}
checkedQualifierAnnotations.put(clazz, result);
return result;
}
public Annotation[] getAnnotatedMethodFirstParameterQualifierWithGivenAnnotation(
AnnotatedMethod annotatedMethod, Class clazz)
{
Asserts.assertNotNull(annotatedMethod, "annotatedMethod argument can not be null");
Asserts.nullCheckForClass(clazz);
List list = new ArrayList();
List> parameters = annotatedMethod.getParameters();
for(AnnotatedParameter parameter : parameters)
{
if(parameter.isAnnotationPresent(clazz))
{
Annotation[] anns = AnnotationUtil.asArray(parameter.getAnnotations());
for(Annotation ann : anns)
{
if(isQualifierAnnotation(ann.annotationType()))
{
list.add(ann);
}
}
}
}
Annotation[] finalAnns = new Annotation[list.size()];
finalAnns = list.toArray(finalAnns);
return finalAnns;
}
/**
* Gets the method first found parameter qualifiers.
*
* @param method method
* @param clazz checking annotation
* @return annotation array
*/
public Annotation[] getMethodFirstParameterQualifierWithGivenAnnotation(Method method, Class clazz)
{
Asserts.assertNotNull(method, "Method argument can not be null");
Asserts.nullCheckForClass(clazz);
Annotation[][] parameterAnns = method.getParameterAnnotations();
List list = new ArrayList();
Annotation[] result;
for (Annotation[] parameters : parameterAnns)
{
boolean found = false;
for (Annotation param : parameters)
{
Class btype = param.annotationType();
if (btype.equals(clazz))
{
found = true;
continue;
}
if (isQualifierAnnotation(btype))
{
list.add(param);
}
}
if (found)
{
result = new Annotation[list.size()];
result = list.toArray(result);
return result;
}
}
result = AnnotationUtil.EMPTY_ANNOTATION_ARRAY;
return result;
}
public Set getQualifierAnnotations(Set annotations)
{
return new HashSet(Arrays.asList(getQualifierAnnotations(annotations.toArray(new Annotation[annotations.size()]))));
}
/**
* Gets the array of qualifier annotations on the given array.
*
* @param annotations annotation array
* @return array containing qualifier anns
*/
public Annotation[] getQualifierAnnotations(Annotation... annotations)
{
Asserts.assertNotNull(annotations, "Annotations argument can not be null");
if (annotations.length == 0)
{
return ONLY_DEFAULT_ANNOTATION;
}
Set set = new HashSet();
for (Annotation annot : annotations)
{
if (isQualifierAnnotation(annot.annotationType()))
{
set.add(annot);
}
}
//Add the default qualifier if no others exist. Section 3.10, OWB-142///
if(set.size() == 0)
{
return ONLY_DEFAULT_ANNOTATION;
}
////////////////////////////////////////////////////////////////////////
Annotation[] a = new Annotation[set.size()];
a = set.toArray(a);
return a;
}
public void checkQualifierConditions(Annotation... qualifierAnnots)
{
Set annSet = ArrayUtil.asSet(qualifierAnnots);
//check for duplicate annotations
if (qualifierAnnots.length != annSet.size())
{
throw new IllegalArgumentException("Qualifier annotations can not contain duplicate qualifiers:"
+ Arrays.toString(qualifierAnnots));
}
checkQualifierConditions(annSet);
}
/**
* This function obviously cannot check for duplicate annotations.
* So this must have been done before!
* @param qualifierAnnots
*/
public void checkQualifierConditions(Set qualifierAnnots)
{
for (Annotation ann : qualifierAnnots)
{
checkQualifierConditions(ann);
}
}
private void checkQualifierConditions(Annotation ann)
{
Method[] methods = webBeansContext.getSecurityService().doPrivilegedGetDeclaredMethods(ann.annotationType());
for (Method method : methods)
{
Class clazz = method.getReturnType();
if (clazz.isArray() || clazz.isAnnotation())
{
if (!AnnotationUtil.hasAnnotation(method.getDeclaredAnnotations(), Nonbinding.class))
{
throw new WebBeansConfigurationException("@Qualifier : " + ann.annotationType().getName()
+ " must have @NonBinding valued members for its array-valued and annotation valued members");
}
}
}
if (!isQualifierAnnotation(ann.annotationType()))
{
throw new IllegalArgumentException("Qualifier annotations must be annotated with @Qualifier");
}
}
/**
* Returns true if the annotation is defined in xml or annotated with
* {@link javax.enterprise.inject.Stereotype} false otherwise.
*
* @param clazz type of the annotation
* @return true if the annotation is defined in xml or annotated with
* {@link javax.enterprise.inject.Stereotype} false otherwise
*/
public boolean isStereoTypeAnnotation(Class clazz)
{
return isStereoTypeAnnotation(clazz, new HashSet>());
}
private boolean isStereoTypeAnnotation(Class clazz, Set> checkedAnnotations)
{
Asserts.nullCheckForClass(clazz);
Boolean checkedAnnotationResult = checkedStereotypeAnnotations.get(clazz);
if (checkedAnnotationResult != null)
{
return checkedAnnotationResult;
}
boolean result = false;
if (clazz.isAnnotationPresent(Stereotype.class))
{
result = true;
}
else
{
for (Annotation annotation: clazz.getAnnotations())
{
if (checkedAnnotations.contains(annotation.annotationType()))
{
continue;
}
checkedAnnotations.add(annotation.annotationType());
if (isStereoTypeAnnotation(annotation.annotationType(), checkedAnnotations))
{
result = true;
break;
}
}
}
checkedStereotypeAnnotations.put(clazz, result);
return result;
}
public boolean hasStereoTypeMetaAnnotation(Set> anns)
{
Asserts.assertNotNull(anns, "anns parameter can not be null");
for (Class ann : anns)
{
if (isStereoTypeAnnotation(ann))
{
return true;
}
}
return false;
}
public boolean hasStereoTypeMetaAnnotation(Annotation[] anns)
{
Asserts.assertNotNull(anns, "anns parameter can not be null");
for (Annotation ann : anns)
{
if (isStereoTypeAnnotation(ann.annotationType()))
{
return true;
}
}
return false;
}
public Annotation[] getStereotypeMetaAnnotations(Annotation[] anns)
{
Asserts.assertNotNull(anns, "anns parameter can not be null");
List interAnns = new ArrayList();
for (Annotation ann : anns)
{
if (isStereoTypeAnnotation(ann.annotationType()))
{
interAnns.add(ann);
//check for transitive
Annotation[] transitives = getTransitiveStereoTypes(ann.annotationType().getDeclaredAnnotations());
Collections.addAll(interAnns, transitives);
}
}
Annotation[] ret = new Annotation[interAnns.size()];
ret = interAnns.toArray(ret);
return ret;
}
/**
* Same like {@link #getStereotypeMetaAnnotations(java.util.Set)} but with an array
*/
public Set> getStereotypeMetaAnnotations(Set> stereotypes)
{
Asserts.assertNotNull(stereotypes, "anns parameter can not be null");
Set> interAnns = new HashSet>();
for (Class ann : stereotypes)
{
if (isStereoTypeAnnotation(ann))
{
interAnns.add(ann);
//check for transitive
Annotation[] transitives = getTransitiveStereoTypes(ann.getDeclaredAnnotations());
for(Annotation transitive : transitives)
{
interAnns.add(transitive.annotationType());
}
}
}
return interAnns;
}
private Annotation[] getTransitiveStereoTypes(Annotation[] anns)
{
return getStereotypeMetaAnnotations(anns);
}
/**
* Returns bean stereotypes.
* @return bean stereotypes
*/
public Set> getStereotypes(Set> anns)
{
Asserts.assertNotNull(anns, "bean parameter can not be null");
if (hasStereoTypeMetaAnnotation(anns))
{
return getStereotypeMetaAnnotations(anns);
}
return Collections.emptySet();
}
/**
* Returns true if name exists,false otherwise.
* @return true if name exists
*/
public boolean hasNamedOnStereoTypes(Set> stereotypes)
{
Set> types = getStereotypes(stereotypes);
for (Class ann : types)
{
if (AnnotationUtil.hasClassAnnotation(ann, Named.class))
{
return true;
}
}
return false;
}
/**
* Validates that given class obeys stereotype model
* defined by the specification.
* @param clazz stereotype class
*/
public void checkStereoTypeClass(Class clazz, Annotation...annotations)
{
Asserts.nullCheckForClass(clazz);
boolean scopeTypeFound = false;
for (Annotation annotation : annotations)
{
Class annotType = annotation.annotationType();
if (annotType.isAnnotationPresent(NormalScope.class) || annotType.isAnnotationPresent(Scope.class))
{
if (scopeTypeFound)
{
throw new WebBeansConfigurationException("@StereoType annotation can not contain more " +
"than one @Scope/@NormalScope annotation");
}
else
{
scopeTypeFound = true;
}
}
else if (annotType.equals(Named.class))
{
Named name = (Named) annotation;
if (!name.value().equals(""))
{
throw new WebBeansConfigurationException("@StereoType annotation can not define @Named " +
"annotation with value");
}
}
}
}
public void checkInterceptorResolverParams(Annotation... interceptorBindings)
{
if (interceptorBindings == null || interceptorBindings.length == 0)
{
throw new IllegalArgumentException("Manager.resolveInterceptors() method parameter interceptor bindings " +
"array argument can not be empty");
}
Annotation old = null;
for (Annotation interceptorBinding : interceptorBindings)
{
if (!isInterceptorBindingAnnotation(interceptorBinding.annotationType()))
{
throw new IllegalArgumentException("Manager.resolveInterceptors() method parameter interceptor" +
" bindings array can not contain other annotation that is not @InterceptorBinding");
}
if (old == null)
{
old = interceptorBinding;
}
else
{
if (old.equals(interceptorBinding))
{
throw new IllegalArgumentException("Manager.resolveInterceptors() method parameter interceptor " +
"bindings array argument can not define duplicate binding annotation with name : @" +
old.getClass().getName());
}
old = interceptorBinding;
}
}
}
public void checkDecoratorResolverParams(Set apiTypes, Annotation... qualifiers)
{
if (apiTypes == null || apiTypes.size() == 0)
{
throw new IllegalArgumentException("Manager.resolveDecorators() method parameter api types argument " +
"can not be empty");
}
Annotation old = null;
for (Annotation qualifier : qualifiers)
{
if (!isQualifierAnnotation(qualifier.annotationType()))
{
throw new IllegalArgumentException("Manager.resolveDecorators() method parameter qualifiers array " +
"can not contain other annotation that is not @Qualifier");
}
if (old == null)
{
old = qualifier;
}
else
{
if (old.annotationType().equals(qualifier.annotationType()))
{
throw new IllegalArgumentException("Manager.resolveDecorators() method parameter qualifiers " +
"array argument can not define duplicate qualifier annotation with name : @" +
old.annotationType().getName());
}
old = qualifier;
}
}
}
/**
* Check conditions for the new binding.
* @param annotations annotations
* @return Annotation[] with all binding annotations
* @throws WebBeansConfigurationException if New plus any other binding annotation is set
*/
public Annotation[] checkForNewQualifierForDeployment(Type type, Class clazz, String name,
Annotation[] annotations)
{
Asserts.assertNotNull(type, "Type argument can not be null");
Asserts.nullCheckForClass(clazz);
Asserts.assertNotNull(annotations, "Annotations argument can not be null");
Annotation[] as = getQualifierAnnotations(annotations);
for (Annotation a : annotations)
{
if (a.annotationType().equals(New.class))
{
if (as.length > 1)
{
throw new WebBeansConfigurationException("@New binding annotation can not have any binding "
+ "annotation in class : " + clazz.getName()
+ " in field/method : " + name);
}
}
}
return as;
}
/**
* Configures the name of the producer method for specializing the parent.
*
* @param component producer method component
* @param method specialized producer method
* @param superMethod overriden super producer method
*/
public boolean isSuperMethodNamed(AbstractOwbBean component,
Method method,
Method superMethod)
{
Asserts.assertNotNull(component,"component parameter can not be null");
Asserts.assertNotNull(method,"method parameter can not be null");
Asserts.assertNotNull(superMethod,"superMethod parameter can not be null");
boolean hasName = false;
if(AnnotationUtil.hasMethodAnnotation(superMethod, Named.class))
{
hasName = true;
}
else
{
Annotation[] anns = getStereotypeMetaAnnotations(superMethod.getAnnotations());
for(Annotation ann : anns)
{
if(ann.annotationType().isAnnotationPresent(Stereotype.class))
{
hasName = true;
break;
}
}
}
if(hasName)
{
if(AnnotationUtil.hasMethodAnnotation(method, Named.class))
{
throw new DefinitionException("Specialized method : " + method.getName() + " in class : "
+ component.getReturnType().getName() + " may not define @Named annotation");
}
}
return hasName;
}
@SuppressWarnings("unchecked")
public Method getDisposalWithGivenAnnotatedMethod(AnnotatedType annotatedType, Type beanType, Annotation[] qualifiers)
{
Set> annotatedMethods = annotatedType.getMethods();
if(annotatedMethods != null)
{
for (AnnotatedMethod annotatedMethod : annotatedMethods)
{
AnnotatedMethod annt = (AnnotatedMethod)annotatedMethod;
List> parameters = annt.getParameters();
if(parameters != null)
{
boolean found = false;
for(AnnotatedParameter parameter : parameters)
{
if(parameter.isAnnotationPresent(Disposes.class))
{
found = true;
break;
}
}
if(found)
{
Type type = AnnotationUtil.getAnnotatedMethodFirstParameterWithAnnotation(annotatedMethod, Disposes.class);
Annotation[] annots = getAnnotatedMethodFirstParameterQualifierWithGivenAnnotation(annotatedMethod, Disposes.class);
if(type.equals(beanType))
{
for(Annotation qualifier : qualifiers)
{
if(qualifier.annotationType() != Default.class)
{
for(Annotation ann :annots)
{
if(!AnnotationUtil.isCdiAnnotationEqual(qualifier, ann))
{
return null;
}
}
}
}
return annotatedMethod.getJavaMember();
}
}
}
}
}
return null;
}
/**
* JavaEE components can not inject {@link javax.enterprise.inject.spi.InjectionPoint}.
* @param clazz javaee component class info
* @throws WebBeansConfigurationException exception if condition is not applied
*/
public void checkInjectionPointForInjectInjectionPoint(Class clazz)
{
Asserts.nullCheckForClass(clazz);
Field[] fields = webBeansContext.getSecurityService().doPrivilegedGetDeclaredFields(clazz);
for(Field field : fields)
{
if(field.getAnnotation(Inject.class) != null)
{
if(field.getType() == InjectionPoint.class)
{
Annotation[] anns = getQualifierAnnotations(field.getDeclaredAnnotations());
if (AnnotationUtil.hasAnnotation(anns, Default.class))
{
throw new WebBeansConfigurationException("Java EE Component class : " + clazz + " can not inject InjectionPoint");
}
}
}
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy