io.micronaut.annotation.processing

Class JavaAnnotationMetadataBuilder

java.lang.Object

io.micronaut.inject.annotation.AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

io.micronaut.annotation.processing.JavaAnnotationMetadataBuilder

public class JavaAnnotationMetadataBuilder
extends AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

A AnnotationMetadata for builder for Java to be used at compile time.

Since:

1.0

Author:

Graeme Rocher

Constructor Summary

Constructors

Constructor and Description
JavaAnnotationMetadataBuilder(Elements elements, Messager messager, AnnotationUtils annotationUtils, ModelUtils modelUtils) Default constructor.

Method Summary

Modifier and Type	Method and Description
protected void	addError(Element originatingElement, String error) Adds an error.
protected List<Element>	buildHierarchy(Element element, boolean inheritTypeAnnotations, boolean declaredOnly) Build the type hierarchy for the given element.
protected VisitorContext	createVisitorContext() Creates the visitor context for this implementation.
protected String	getAnnotationMemberName(Element member) Read the name of an annotation member.
protected Optional<Element>	getAnnotationMirror(String annotationName) Return a mirror for the given annotation.
protected List<? extends AnnotationMirror>	getAnnotationsForType(Element element) Obtain the annotations for the given type.
protected String	getAnnotationTypeName(AnnotationMirror annotationMirror) Get the given type of the annotation.
protected OptionalValues<?>	getAnnotationValues(Element originatingElement, Element member, Class<?> annotationType) Resolve the annotations values from the given member for the given type.
protected String	getDeclaringType(Element element) Obtains the declaring type for an element.
protected AnnotatedElementValidator	getElementValidator() Obtains the element validator.
protected String	getRepeatableName(AnnotationMirror annotationMirror) Obtain the name of the repeatable annotation if the annotation is is one.
protected String	getRepeatableNameForType(Element annotationType) Obtain the name of the repeatable annotation if the annotation is is one.
protected Element	getTypeForAnnotation(AnnotationMirror annotationMirror) Get the type of the given annotation.
boolean	hasAnnotation(Element element, Class<? extends Annotation> ann) Checks if a method has an annotation.
static boolean	hasAnnotation(ExecutableElement method, Class<? extends Annotation> ann) Checks if a method has an annotation.
protected boolean	isMethodOrClassElement(Element element) Whether the element is a field, method, class or constructor.
protected Map<? extends Element,?>	readAnnotationDefaultValues(AnnotationMirror annotationMirror) Read the raw default annotation values from the given annotation.
protected Map<? extends Element,?>	readAnnotationDefaultValues(String annotationTypeName, Element element) Read the raw default annotation values from the given annotation.
protected Map<? extends Element,?>	readAnnotationRawValues(AnnotationMirror annotationMirror) Read the raw annotation values from the given annotation.
protected void	readAnnotationRawValues(Element originatingElement, String annotationName, Element member, String memberName, Object annotationValue, Map<CharSequence,Object> annotationValues) Read the given member and value, applying conversions if necessary, and place the data in the given map.
protected Object	readAnnotationValue(Element originatingElement, Element member, String memberName, Object annotationValue) Read the given member and value, applying conversions if necessary, and place the data in the given map.

Methods inherited from class io.micronaut.inject.annotation.AbstractAnnotationMetadataBuilder

addMutatedMetadata, annotate, build, build, buildDeclared, buildForMethod, buildForParent, buildForParent, buildForParent, clearMutated, isAnnotationMapped, isMetadataMutated, populateAnnotationData, readNestedAnnotationValue, validateAnnotationValue

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaAnnotationMetadataBuilder

public JavaAnnotationMetadataBuilder(Elements elements,
                                     Messager messager,
                                     AnnotationUtils annotationUtils,
                                     ModelUtils modelUtils)

Default constructor.

Parameters:

elements - The elementUtils

messager - The messager

annotationUtils - The annotation utils

modelUtils - The model utils

Method Detail

getElementValidator

@Nullable
protected AnnotatedElementValidator getElementValidator()

Description copied from class: AbstractAnnotationMetadataBuilder

Obtains the element validator.

Overrides:

getElementValidator in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Returns:

The validator.

addError

protected void addError(@Nonnull
                        Element originatingElement,
                        @Nonnull
                        String error)

Description copied from class: AbstractAnnotationMetadataBuilder

Adds an error.

Specified by:

addError in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

originatingElement - The originating element

error - The error

getAnnotationMemberName

protected String getAnnotationMemberName(Element member)

Description copied from class: AbstractAnnotationMetadataBuilder

Read the name of an annotation member.

Specified by:

getAnnotationMemberName in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

member - The member

Returns:

The name

getRepeatableName

@Nullable
protected String getRepeatableName(AnnotationMirror annotationMirror)

Description copied from class: AbstractAnnotationMetadataBuilder

Obtain the name of the repeatable annotation if the annotation is is one.

Specified by:

getRepeatableName in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationMirror - The annotation mirror

Returns:

Return the name or null

getRepeatableNameForType

@Nullable
protected String getRepeatableNameForType(Element annotationType)

Description copied from class: AbstractAnnotationMetadataBuilder

Obtain the name of the repeatable annotation if the annotation is is one.

Specified by:

getRepeatableNameForType in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationType - The annotation mirror

Returns:

Return the name or null

getAnnotationMirror

protected Optional<Element> getAnnotationMirror(String annotationName)

Description copied from class: AbstractAnnotationMetadataBuilder

Return a mirror for the given annotation.

Specified by:

getAnnotationMirror in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationName - The annotation name

Returns:

An optional mirror

createVisitorContext

protected VisitorContext createVisitorContext()

Description copied from class: AbstractAnnotationMetadataBuilder

Creates the visitor context for this implementation.

Specified by:

createVisitorContext in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Returns:

The visitor context

isMethodOrClassElement

protected boolean isMethodOrClassElement(Element element)

Description copied from class: AbstractAnnotationMetadataBuilder

Whether the element is a field, method, class or constructor.

Specified by:

isMethodOrClassElement in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

element - The element

Returns:

True if it is

getDeclaringType

@Nonnull
protected String getDeclaringType(@Nonnull
                                           Element element)

Description copied from class: AbstractAnnotationMetadataBuilder

Obtains the declaring type for an element.

Specified by:

getDeclaringType in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

element - The element

Returns:

The declaring type

getTypeForAnnotation

protected Element getTypeForAnnotation(AnnotationMirror annotationMirror)

Description copied from class: AbstractAnnotationMetadataBuilder

Get the type of the given annotation.

Specified by:

getTypeForAnnotation in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationMirror - The annotation

Returns:

The type

getAnnotationsForType

protected List<? extends AnnotationMirror> getAnnotationsForType(Element element)

Description copied from class: AbstractAnnotationMetadataBuilder

Obtain the annotations for the given type.

Specified by:

getAnnotationsForType in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

element - The type element

Returns:

The annotations

buildHierarchy

protected List<Element> buildHierarchy(Element element,
                                       boolean inheritTypeAnnotations,
                                       boolean declaredOnly)

Description copied from class: AbstractAnnotationMetadataBuilder

Build the type hierarchy for the given element.

Specified by:

buildHierarchy in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

element - The element

inheritTypeAnnotations - Whether to inherit type annotations

declaredOnly - Whether to only include declared annotations

Returns:

The type hierarchy

readAnnotationRawValues

protected Map<? extends Element,?> readAnnotationRawValues(AnnotationMirror annotationMirror)

Description copied from class: AbstractAnnotationMetadataBuilder

Read the raw annotation values from the given annotation.

Specified by:

readAnnotationRawValues in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationMirror - The annotation

Returns:

The values

getAnnotationValues

protected OptionalValues<?> getAnnotationValues(Element originatingElement,
                                                Element member,
                                                Class<?> annotationType)

Description copied from class: AbstractAnnotationMetadataBuilder

Resolve the annotations values from the given member for the given type.

Specified by:

getAnnotationValues in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

originatingElement - The originating element

member - The member

annotationType - The type

Returns:

The values

readAnnotationRawValues

protected void readAnnotationRawValues(Element originatingElement,
                                       String annotationName,
                                       Element member,
                                       String memberName,
                                       Object annotationValue,
                                       Map<CharSequence,Object> annotationValues)

Description copied from class: AbstractAnnotationMetadataBuilder

Read the given member and value, applying conversions if necessary, and place the data in the given map.

Specified by:

readAnnotationRawValues in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

originatingElement - The originating element

annotationName - The annotation name

member - The member being read from

memberName - The member

annotationValue - The value

annotationValues - The values to populate

readAnnotationValue

protected Object readAnnotationValue(Element originatingElement,
                                     Element member,
                                     String memberName,
                                     Object annotationValue)

Description copied from class: AbstractAnnotationMetadataBuilder

Read the given member and value, applying conversions if necessary, and place the data in the given map.

Specified by:

readAnnotationValue in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

originatingElement - The originating element

member - The member

memberName - The member name

annotationValue - The value

Returns:

The object

readAnnotationDefaultValues

protected Map<? extends Element,?> readAnnotationDefaultValues(AnnotationMirror annotationMirror)

Description copied from class: AbstractAnnotationMetadataBuilder

Read the raw default annotation values from the given annotation.

Specified by:

readAnnotationDefaultValues in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationMirror - The annotation

Returns:

The values

readAnnotationDefaultValues

protected Map<? extends Element,?> readAnnotationDefaultValues(String annotationTypeName,
                                                               Element element)

Description copied from class: AbstractAnnotationMetadataBuilder

Read the raw default annotation values from the given annotation.

Specified by:

readAnnotationDefaultValues in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationTypeName - annotation name

element - the type

Returns:

The values

getAnnotationTypeName

protected String getAnnotationTypeName(AnnotationMirror annotationMirror)

Description copied from class: AbstractAnnotationMetadataBuilder

Get the given type of the annotation.

Specified by:

getAnnotationTypeName in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

annotationMirror - The annotation

Returns:

The type

hasAnnotation

public boolean hasAnnotation(Element element,
                             Class<? extends Annotation> ann)

Checks if a method has an annotation.

Specified by:

hasAnnotation in class AbstractAnnotationMetadataBuilder<Element,AnnotationMirror>

Parameters:

element - The method

ann - The annotation to look for

Returns:

Whether if the method has the annotation

hasAnnotation

public static boolean hasAnnotation(ExecutableElement method,
                                    Class<? extends Annotation> ann)

Checks if a method has an annotation.

Parameters:

method - The method

ann - The annotation to look for

Returns:

Whether if the method has the annotation