com.almende.util.AnnotationUtil Maven / Gradle / Ivy
/**
* @file AnnotationUtil.java
*
* AnnotationUtil is a utility to get all annotations of a class, its
* methods,
* and the method parameters. Returned annotations include all annotations
* of
* the classes interfaces and super classes.
* Requested classes are cached, so requesting a classes annotations
* repeatedly
* is fast.
*
* Example usage:
*
* AnnotatedClass annotatedClass = AnnotationUtil.get(MyClass.class);
* List methods = annotatedClass.getMethods();
* for (AnnotatedMethod method : methods) {
* System.out.println("Method: " + method.getName());
* List annotations = method.getAnnotations();
* for (Annotation annotation : annotations) {
* System.out.println(" Annotation: " + annotation.toString());
* }
* }
*
* @brief
* AnnotationUtil is a utility to retrieve merged annotations from a
* class
* including all its superclasses and interfaces.
*
* @license
* Licensed 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.
*
* Copyright (c) 2013 Almende B.V.
*
* @author Jos de Jong,
* @date 2013-01-21
*/
package com.almende.util;
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.List;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
/**
* The Class AnnotationUtil.
*/
public final class AnnotationUtil {
private static Map cache = new ConcurrentHashMap();
private static Map cacheIncludingObject = new ConcurrentHashMap();
private AnnotationUtil() {
};
/**
* Get all annotations of a class, methods, and parameters.
* Returned annotations include all annotations of the classes interfaces
* and super classes (excluding java.lang.Object).
*
* @param clazz the clazz
* @return annotatedClazz
*/
public static AnnotatedClass get(final Class clazz) {
final boolean includeObject = false;
return get(clazz, includeObject);
}
/**
* Get all annotations of a class, methods, and parameters.
* Returned annotations include all annotations of the classes interfaces
* and super classes.
*
* @param clazz the clazz
* @param includeObject If true, methods of java.lang.Object will be
* included in the superclasses too.
* @return annotatedClazz
*/
public static AnnotatedClass get(final Class clazz,
final boolean includeObject) {
final Map myCache = includeObject ? cacheIncludingObject
: cache;
AnnotatedClass annotatedClazz = myCache.get(clazz.getName());
if (annotatedClazz == null) {
annotatedClazz = new AnnotatedClass(clazz, includeObject);
myCache.put(clazz.getName(), annotatedClazz);
}
return annotatedClazz;
}
/**
* AnnotatedClass describes a class, its annotations, and its methods.
*/
public static class AnnotatedClass {
/** The clazz. */
private Class clazz = null;
/** The annotations. */
private final List annotations = new ArrayList();
/** The methods. */
private final List methods = new ArrayList();
/** The fields. */
private final List fields = new ArrayList();
/**
* Create a new AnnotatedClass.
*
* @param clazz the clazz
* @param includeObject If true, the methods of super class
* java.lang.Object will be included too.
*/
public AnnotatedClass(final Class clazz, final boolean includeObject) {
this.clazz = clazz;
merge(clazz, includeObject);
}
/**
* Recursively merge a class into this AnnotatedClass.
* The method loops over all the classess interfaces and superclasses
* Methods with will be merged.
*
* @param clazz the clazz
* @param includeObject if true, superclass java.lang.Object will
* be included too.
*/
private void merge(final Class clazz, final boolean includeObject) {
Class c = clazz;
while (c != null && (includeObject || c != Object.class)) {
// merge the annotations
AnnotationUtil.merge(annotations, c.getDeclaredAnnotations());
// merge the methods
AnnotationUtil.merge(methods, c.getDeclaredMethods());
AnnotationUtil.merge(fields, c.getDeclaredFields());
// merge all interfaces and the superclasses of the interfaces
for (final Class i : c.getInterfaces()) {
merge(i, includeObject);
}
// ok now again for the superclass
c = c.getSuperclass();
}
}
/**
* Get the actual Java class described by this AnnotatedClass.
*
* @return clazz
*/
public Class getActualClass() {
return clazz;
}
/**
* Get all methods including methods declared in superclasses.
*
* @return methods
*/
public List getMethods() {
return methods;
}
/**
* Get all methods including methods declared in superclasses, filtered
* by name.
*
* @param name the name
* @return filteredMethods
*/
public List getMethods(final String name) {
final List filteredMethods = new ArrayList();
for (final AnnotatedMethod method : methods) {
if (method.getName().equals(name)) {
filteredMethods.add(method);
}
}
return filteredMethods;
}
/**
* Get all methods including methods declared in superclasses, filtered
* by annotation.
*
* @param the generic type
* @param annotation the annotation
* @return filteredMethods
*/
public List getAnnotatedMethods(
final Class annotation) {
final List filteredMethods = new ArrayList();
for (final AnnotatedMethod method : methods) {
if (method.getAnnotation(annotation) != null) {
filteredMethods.add(method);
}
}
return filteredMethods;
}
/**
* Get all fields including fields declared in superclasses, filtered
* by annotation.
*
* @param the generic type
* @param annotation the annotation
* @return filteredMethods
*/
public List getAnnotatedFields(
final Class annotation) {
final List filteredFields = new ArrayList();
for (final AnnotatedField field : fields) {
if (field.getAnnotation(annotation) != null) {
filteredFields.add(field);
}
}
return filteredFields;
}
/**
* Get all annotations defined on this class, its superclasses, and its
* interfaces.
*
* @return annotations
*/
public List getAnnotations() {
return annotations;
}
/**
* Get an annotation of this class by type.
* Returns null if not available.
*
* @param the generic type
* @param type the type
* @return annotation
*/
@SuppressWarnings("unchecked")
public T getAnnotation(final Class type) {
for (final Annotation annotation : annotations) {
if (annotation.annotationType() == type) {
return (T) annotation;
}
}
return null;
}
}
/**
* The Class AnnotatedField.
*/
public static class AnnotatedField {
/** The field. */
private Field field = null;
/** The name. */
private String name = null;
/** The type. */
private Type type = null;
/** The annotations. */
private final List annotations = new ArrayList();
/**
* Instantiates a new annotated field.
*
* @param field the field
*/
public AnnotatedField(final Field field) {
this.field = field;
name = field.getName();
type = field.getType();
merge(field);
}
/**
* Merge a java method into this Annotated method.
* Annotations and parameter annotations will be merged.
*
* @param field the field
*/
private void merge(final Field field) {
AnnotationUtil.merge(annotations, field.getDeclaredAnnotations());
}
/**
* Gets the field.
*
* @return the field
*/
public Field getField() {
return field;
}
/**
* Gets the name.
*
* @return the name
*/
public String getName() {
return name;
}
/**
* Gets the type.
*
* @return the type
*/
public Type getType() {
return type;
}
/**
* Gets the annotations.
*
* @return the annotations
*/
public List getAnnotations() {
return annotations;
}
/**
* Get an annotation of this field by type.
* Returns null if not available.
*
* @param the generic type
* @param type the type
* @return annotation
*/
@SuppressWarnings("unchecked")
public T getAnnotation(final Class type) {
for (final Annotation annotation : annotations) {
if (annotation.annotationType() == type) {
return (T) annotation;
}
}
return null;
}
}
/**
* AnnotatedMethod describes a method and its parameters.
*/
public static class AnnotatedMethod {
/** The method. */
private Method method = null;
/** The name. */
private String name = null;
/** The return type. */
private Class returnType = null;
/** The generic return type. */
private Type genericReturnType = null;
/** The annotations. */
private final List annotations = new ArrayList();
/** The parameters. */
private final List parameters = new ArrayList();
/**
* Instantiates a new annotated method.
*
* @param method the method
*/
public AnnotatedMethod(final Method method) {
this.method = method;
name = method.getName();
returnType = method.getReturnType();
genericReturnType = method.getGenericReturnType();
merge(method);
}
/**
* Merge a java method into this Annotated method.
* Annotations and parameter annotations will be merged.
*
* @param method the method
*/
private void merge(final Method method) {
// merge the annotations
AnnotationUtil.merge(annotations, method.getDeclaredAnnotations());
// merge the params
final Annotation[][] params = method.getParameterAnnotations();
final Class[] types = method.getParameterTypes();
final Type[] genericTypes = method.getGenericParameterTypes();
for (int i = 0; i < params.length; i++) {
if (i > parameters.size() - 1) {
parameters.add(new AnnotatedParam(params[i], types[i],
genericTypes[i]));
} else {
parameters.get(i).merge(params[i]);
}
}
}
/**
* Get the actual Java method described by this AnnotatedMethod.
*
* @return method
*/
public Method getActualMethod() {
return method;
}
/**
* Get the method name.
*
* @return name
*/
public String getName() {
return name;
}
/**
* Get the return type of the method.
*
* @return returnType
*/
public Class getReturnType() {
return returnType;
}
/**
* Get the generic return type of the method.
*
* @return genericType
*/
public Type getGenericReturnType() {
return genericReturnType;
}
/**
* Get all annotations of this method, defined in all implementations
* and interfaces of the class.
*
* @return annotations
*/
public List getAnnotations() {
return annotations;
}
/**
* Get an annotation of this method by type.
* Returns null if not available.
*
* @param the generic type
* @param type the type
* @return annotation
*/
@SuppressWarnings("unchecked")
public T getAnnotation(final Class type) {
for (final Annotation annotation : annotations) {
if (annotation.annotationType() == type) {
return (T) annotation;
}
}
return null;
}
/**
* Get all parameter annotations of this method, defined in all
* implementations and interfaces of the methods declaring class.
*
* @return params
*/
public List getParams() {
return parameters;
}
}
/**
* AnnotatedParam describes all annotations of a parameter.
*/
public static class AnnotatedParam {
/** The annotations. */
private final List annotations = new ArrayList();
/** The type. */
private Class type = null;
/** The generic type. */
private Type genericType = null;
/**
* Instantiates a new annotated param.
*/
public AnnotatedParam() {
}
/**
* Instantiates a new annotated param.
*
* @param annotations the annotations
* @param type the type
* @param genericType the generic type
*/
public AnnotatedParam(final Annotation[] annotations,
final Class type, final Type genericType) {
this.type = type;
this.genericType = genericType;
merge(annotations);
}
/**
* Merge.
*
* @param annotations the annotations
*/
private void merge(final Annotation[] annotations) {
// merge the annotations
AnnotationUtil.merge(this.annotations, annotations);
}
/**
* Get all annotations of this parameter, defined in all implementations
* and interfaces of the class.
*
* @return annotations
*/
public List getAnnotations() {
return annotations;
}
/**
* Get an annotation of this parameter by type.
* Returns null if not available.
*
* @param the generic type
* @param type the type
* @return annotation
*/
@SuppressWarnings("unchecked")
public T getAnnotation(final Class type) {
for (final Annotation annotation : annotations) {
if (annotation.annotationType() == type) {
return (T) annotation;
}
}
return null;
}
/**
* Get the type of the parameter.
*
* @return type
*/
public Class getType() {
return type;
}
/**
* Get the generic type of the parameter.
*
* @return genericType
*/
public Type getGenericType() {
return genericType;
}
}
/**
* Merge an array with annotations (listB) into a list with
* annotations (listA).
*
* @param listA the list a
* @param listB the list b
*/
private static void merge(final List listA,
final Annotation[] listB) {
for (final Annotation b : listB) {
boolean found = false;
for (final Annotation a : listA) {
if (a.getClass() == b.getClass()) {
found = true;
break;
}
}
if (!found) {
listA.add(b);
}
}
}
/**
* Merge an array of methods (listB) into a list with method
* annotations (listA).
*
* @param listA the list a
* @param listB the list b
*/
private static void merge(final List listA,
final Method[] listB) {
for (final Method b : listB) {
AnnotatedMethod methodAnnotations = null;
for (final AnnotatedMethod a : listA) {
if (equals(a.method, b)) {
methodAnnotations = a;
break;
}
}
if (methodAnnotations != null) {
methodAnnotations.merge(b);
} else {
listA.add(new AnnotatedMethod(b));
}
}
}
/**
* Merge an array with annotations (listB) into a list with
* annotations (listA).
*
* @param listA the list a
* @param listB the list b
*/
private static void merge(final List listA,
final Field[] listB) {
for (final Field b : listB) {
AnnotatedField fieldAnnotations = null;
for (final AnnotatedField a : listA) {
if (equals(a.field, b)) {
fieldAnnotations = a;
break;
}
}
if (fieldAnnotations != null) {
fieldAnnotations.merge(b);
} else {
listA.add(new AnnotatedField(b));
}
}
}
/**
* Test if two methods have equal names, return type, param count,
* and param types.
*
* @param a the a
* @param b the b
* @return true, if successful
*/
private static boolean equals(final Method a, final Method b) {
// http://stackoverflow.com/q/10062957/1262753
if (!a.getName().equals(b.getName())) {
return false;
}
if (a.getReturnType() != b.getReturnType()) {
return false;
}
final Class[] paramsa = a.getParameterTypes();
final Class[] paramsb = b.getParameterTypes();
if (paramsa.length != paramsb.length) {
return false;
}
for (int i = 0; i < paramsa.length; i++) {
if (paramsa[i] != paramsb[i]) {
return false;
}
}
return true;
}
/**
* Test if two fields have equal names and types.
*
* @param a the a
* @param b the b
* @return true, if successful
*/
private static boolean equals(final Field a, final Field b) {
// http://stackoverflow.com/q/10062957/1262753
if (!a.getName().equals(b.getName())) {
return false;
}
if (a.getType() != b.getType()) {
return false;
}
return true;
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy