org.inferred.freebuilder.processor.util

Class ModelUtils

java.lang.Object

org.inferred.freebuilder.processor.util.ModelUtils

public class ModelUtils
extends java.lang.Object

Utility methods for the javax.lang.model package.

Constructor Summary

Constructors

Constructor and Description
ModelUtils()

Method Summary

Modifier and Type	Method and Description
static javax.lang.model.element.TypeElement	asElement(javax.lang.model.type.DeclaredType type) Returns the TypeElement corresponding to type.
static java.util.Optional<javax.lang.model.element.AnnotationMirror>	findAnnotationMirror(javax.lang.model.element.Element element, java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass) Returns an AnnotationMirror for the annotation of type annotationClass on element, or Optional.empty() if no such annotation exists.
static java.util.Optional<javax.lang.model.element.AnnotationMirror>	findAnnotationMirror(javax.lang.model.element.Element element, QualifiedName annotationClass) Returns an AnnotationMirror for the annotation of type annotationClass on element, or Optional.empty() if no such annotation exists.
static java.util.Optional<javax.lang.model.element.AnnotationMirror>	findAnnotationMirror(javax.lang.model.element.Element element, java.lang.String annotationClassName) Returns an AnnotationMirror for the annotation of type annotationClassName on element, or Optional.empty() if no such annotation exists.
static java.util.Optional<javax.lang.model.element.AnnotationValue>	findProperty(javax.lang.model.element.AnnotationMirror annotation, java.lang.String propertyName)
static javax.lang.model.type.TypeMirror	getReturnType(javax.lang.model.element.TypeElement type, javax.lang.model.element.ExecutableElement method, javax.lang.model.util.Types types) Determines the return type of method, if called on an instance of type type.
static java.util.Optional<javax.lang.model.element.TypeElement>	maybeAsTypeElement(javax.lang.model.type.TypeMirror type) Returns the TypeElement corresponding to type, if there is one.
static java.util.Optional<javax.lang.model.type.DeclaredType>	maybeDeclared(javax.lang.model.type.TypeMirror type) Returns type as a DeclaredType, if it is one.
static java.util.Optional<javax.lang.model.element.TypeElement>	maybeType(javax.lang.model.element.Element element) Returns element as a TypeElement, if it is one.
static java.util.Optional<javax.lang.model.type.TypeMirror>	maybeUnbox(javax.lang.model.type.TypeMirror mirror, javax.lang.model.util.Types types) Applies unboxing conversion to mirror, if it can be unboxed.
static java.util.Optional<javax.lang.model.type.TypeVariable>	maybeVariable(javax.lang.model.type.TypeMirror type)
static boolean	needsSafeVarargs(javax.lang.model.type.TypeMirror elementType) Returns true if a method with a variable number of elementType arguments needs a &#64;SafeVarargs annotation to avoid compiler warnings in Java 7+.
static java.util.Set<javax.lang.model.element.ExecutableElement>	only(javax.lang.model.element.Modifier modifier, java.util.Set<javax.lang.model.element.ExecutableElement> methods)
static boolean	overrides(javax.lang.model.type.DeclaredType type, javax.lang.model.util.Types types, java.lang.String methodName, javax.lang.model.type.TypeMirror... params)
static boolean	overrides(javax.lang.model.element.TypeElement type, javax.lang.model.util.Types types, java.lang.String methodName, javax.lang.model.type.TypeMirror... params) Returns whether type overrides method methodName(params).

Methods inherited from class java.lang.Object

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

Constructor Detail

ModelUtils

public ModelUtils()

Method Detail

findAnnotationMirror

public static java.util.Optional<javax.lang.model.element.AnnotationMirror> findAnnotationMirror(javax.lang.model.element.Element element,
                                                                                                 java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)

Returns an AnnotationMirror for the annotation of type annotationClass on element, or Optional.empty() if no such annotation exists.

findAnnotationMirror

public static java.util.Optional<javax.lang.model.element.AnnotationMirror> findAnnotationMirror(javax.lang.model.element.Element element,
                                                                                                 QualifiedName annotationClass)

Returns an AnnotationMirror for the annotation of type annotationClass on element, or Optional.empty() if no such annotation exists.

findAnnotationMirror

public static java.util.Optional<javax.lang.model.element.AnnotationMirror> findAnnotationMirror(javax.lang.model.element.Element element,
                                                                                                 java.lang.String annotationClassName)

Returns an AnnotationMirror for the annotation of type annotationClassName on element, or Optional.empty() if no such annotation exists.

findProperty

public static java.util.Optional<javax.lang.model.element.AnnotationValue> findProperty(javax.lang.model.element.AnnotationMirror annotation,
                                                                                        java.lang.String propertyName)

maybeType

public static java.util.Optional<javax.lang.model.element.TypeElement> maybeType(javax.lang.model.element.Element element)

Returns element as a TypeElement, if it is one.

maybeDeclared

public static java.util.Optional<javax.lang.model.type.DeclaredType> maybeDeclared(javax.lang.model.type.TypeMirror type)

Returns type as a DeclaredType, if it is one.

maybeVariable

public static java.util.Optional<javax.lang.model.type.TypeVariable> maybeVariable(javax.lang.model.type.TypeMirror type)

maybeAsTypeElement

public static java.util.Optional<javax.lang.model.element.TypeElement> maybeAsTypeElement(javax.lang.model.type.TypeMirror type)

Returns the TypeElement corresponding to type, if there is one.

asElement

public static javax.lang.model.element.TypeElement asElement(javax.lang.model.type.DeclaredType type)

Returns the TypeElement corresponding to type.

maybeUnbox

public static java.util.Optional<javax.lang.model.type.TypeMirror> maybeUnbox(javax.lang.model.type.TypeMirror mirror,
                                                                              javax.lang.model.util.Types types)

Applies unboxing conversion to mirror, if it can be unboxed.

overrides

public static boolean overrides(javax.lang.model.element.TypeElement type,
                                javax.lang.model.util.Types types,
                                java.lang.String methodName,
                                javax.lang.model.type.TypeMirror... params)

Returns whether type overrides method methodName(params).

overrides

public static boolean overrides(javax.lang.model.type.DeclaredType type,
                                javax.lang.model.util.Types types,
                                java.lang.String methodName,
                                javax.lang.model.type.TypeMirror... params)

needsSafeVarargs

public static boolean needsSafeVarargs(javax.lang.model.type.TypeMirror elementType)

Returns true if a method with a variable number of elementType arguments needs a @SafeVarargs annotation to avoid compiler warnings in Java 7+.

only

public static java.util.Set<javax.lang.model.element.ExecutableElement> only(javax.lang.model.element.Modifier modifier,
                                                                             java.util.Set<javax.lang.model.element.ExecutableElement> methods)

getReturnType

public static javax.lang.model.type.TypeMirror getReturnType(javax.lang.model.element.TypeElement type,
                                                             javax.lang.model.element.ExecutableElement method,
                                                             javax.lang.model.util.Types types)

Determines the return type of method, if called on an instance of type type.

For instance, in this example, myY.getProperty() returns List<T>, not T:

    interface X<T> {
      T getProperty();
    }
    @FreeBuilder interface Y<T> extends X<List<T>> { }

(Unfortunately, a bug in Eclipse prevents us handling these cases correctly at the moment. javac works fine.)