org.hibernate.validator.ap.util

Class AnnotationApiHelper

java.lang.Object

org.hibernate.validator.ap.util.AnnotationApiHelper

public class AnnotationApiHelper
extends Object

A helper class providing some useful methods to work with types from the JSR-269-API.

Author:

Gunnar Morling

Constructor Summary

Constructors

Constructor and Description
AnnotationApiHelper(javax.lang.model.util.Elements elementUtils, javax.lang.model.util.Types typeUtils)

Method Summary

Methods

Modifier and Type	Method and Description
List<javax.lang.model.element.AnnotationMirror>	filterByType(List<? extends javax.lang.model.element.AnnotationMirror> annotationMirrors, javax.lang.model.type.TypeMirror annotationType) Returns a list containing those annotation mirrors from the input list, which are of type annotationType.
List<? extends javax.lang.model.element.AnnotationValue>	getAnnotationArrayValue(javax.lang.model.element.AnnotationMirror annotationMirror, String name) Returns the given annotation mirror's array-typed annotation value with the given name.
javax.lang.model.element.AnnotationValue	getAnnotationValue(javax.lang.model.element.AnnotationMirror annotationMirror, String name) Returns the annotation value of the given annotation mirror with the given name.
javax.lang.model.type.DeclaredType	getDeclaredTypeByName(String className) Returns the DeclaredType for the given class name.
javax.lang.model.element.AnnotationMirror	getMirror(List<? extends javax.lang.model.element.AnnotationMirror> annotationMirrors, Class<? extends Annotation> annotationClazz) Returns that mirror from the given list of annotation mirrors that represents the annotation type specified by the given class.
javax.lang.model.type.TypeMirror	getMirrorForType(Class<?> clazz) Returns a TypeMirror for the given class.
Set<javax.lang.model.type.TypeMirror>	keepLowestTypePerHierarchy(Set<javax.lang.model.type.TypeMirror> types) Returns a set containing the "lowest" type per hierarchy contained in the input set.

Methods inherited from class java.lang.Object

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

Constructor Detail

AnnotationApiHelper

public AnnotationApiHelper(javax.lang.model.util.Elements elementUtils,
                   javax.lang.model.util.Types typeUtils)

Method Detail

filterByType

public List<javax.lang.model.element.AnnotationMirror> filterByType(List<? extends javax.lang.model.element.AnnotationMirror> annotationMirrors,
                                                           javax.lang.model.type.TypeMirror annotationType)

Returns a list containing those annotation mirrors from the input list, which are of type annotationType. The input collection remains untouched.

Parameters:

annotationMirrors - A list of annotation mirrors.

annotationType - The type to be compared against.

Returns:

A list with those annotation mirrors from the input list, which are of type annotationType. May be empty but never null.

getMirror

public javax.lang.model.element.AnnotationMirror getMirror(List<? extends javax.lang.model.element.AnnotationMirror> annotationMirrors,
                                                  Class<? extends Annotation> annotationClazz)

Returns that mirror from the given list of annotation mirrors that represents the annotation type specified by the given class.

Parameters:

annotationMirrors - A list of annotation mirrors.

annotationClazz - The class of the annotation of interest.

Returns:

The mirror from the given list that represents the specified annotation or null, if the given list doesn't contain such a mirror.

getMirrorForType

public javax.lang.model.type.TypeMirror getMirrorForType(Class<?> clazz)

Returns a TypeMirror for the given class.

Parameters:

clazz - The class of interest.

Returns:

A TypeMirror for the given class.

getDeclaredTypeByName

public javax.lang.model.type.DeclaredType getDeclaredTypeByName(String className)

Returns the DeclaredType for the given class name.

Parameters:

className - A fully qualified class name, e.g. "java.lang.String".

Returns:

A DeclaredType representing the type with the given name, or null, if no such type exists.

getAnnotationValue

public javax.lang.model.element.AnnotationValue getAnnotationValue(javax.lang.model.element.AnnotationMirror annotationMirror,
                                                          String name)

Returns the annotation value of the given annotation mirror with the given name.

Parameters:

annotationMirror - An annotation mirror.

name - The name of the annotation value of interest.

Returns:

The annotation value with the given name or null, if one of the input values is null or if no value with the given name exists within the given annotation mirror.

getAnnotationArrayValue

public List<? extends javax.lang.model.element.AnnotationValue> getAnnotationArrayValue(javax.lang.model.element.AnnotationMirror annotationMirror,
                                                                               String name)

Returns the given annotation mirror's array-typed annotation value with the given name.

Parameters:

annotationMirror - An annotation mirror.

name - The name of the annotation value of interest.

Returns:

The annotation value with the given name or an empty list, if no such value exists within the given annotation mirror or such a value exists but is not an array-typed one.

keepLowestTypePerHierarchy

public Set<javax.lang.model.type.TypeMirror> keepLowestTypePerHierarchy(Set<javax.lang.model.type.TypeMirror> types)

Returns a set containing the "lowest" type per hierarchy contained in the input set. The following examples shall demonstrate the behavior.

• Input: String; Output: String
• Input: Object, String; Output: String
• Input: Object, Collection, List; Output: List
• Input: Collection, Set, List; Output: List, Set

Parameters:

types - A set of type mirrors.

Returns:

A set with the lowest types per hierarchy or null, if the input set was null.