io.micronaut.inject.annotation

Class AbstractAnnotationMetadataBuilder<T,A>

java.lang.Object

io.micronaut.inject.annotation.AbstractAnnotationMetadataBuilder<T,A>

Type Parameters:

T - The element type

A - The annotation type

Direct Known Subclasses:

JavaAnnotationMetadataBuilder

public abstract class AbstractAnnotationMetadataBuilder<T,A>
extends Object

An abstract implementation that builds AnnotationMetadata.

Since:

1.0

Author:

Graeme Rocher

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractAnnotationMetadataBuilder() Default constructor.

Method Summary

Modifier and Type	Method and Description
protected abstract void	addError(T originatingElement, String error) Adds an error.
static void	addMutatedMetadata(String declaringType, Object element, AnnotationMetadata metadata) Used to store metadata mutations at compilation time.
<A2 extends Annotation> AnnotationMetadata	annotate(AnnotationMetadata annotationMetadata, AnnotationValue<A2> annotationValue) Annotate an existing annotation metadata object.
AnnotationMetadata	build(String declaringType, T element) Build the meta data for the given element.
AnnotationMetadata	build(T element) Build the meta data for the given element.
AnnotationMetadata	buildDeclared(T element) Build only metadata for declared annotations.
AnnotationMetadata	buildForMethod(T element) Build the meta data for the given method element excluding any class metadata.
AnnotationMetadata	buildForParent(String declaringType, T parent, T element) Build the meta data for the given parent and method element excluding any class metadata.
AnnotationMetadata	buildForParent(T parent, T element) Get the annotation metadata for the given element and the given parent.
AnnotationMetadata	buildForParent(T parent, T element, boolean inheritTypeAnnotations) Build the meta data for the given method element excluding any class metadata.
protected abstract List<T>	buildHierarchy(T element, boolean inheritTypeAnnotations, boolean declaredOnly) Build the type hierarchy for the given element.
AnnotationMetadata	buildOverridden(T element) Build metadata for the given element, including any metadata that is inherited via method or type overrides.
static void	clearMutated() Used to clear mutated metadata at the end of a compilation cycle.
protected abstract VisitorContext	createVisitorContext() Creates the visitor context for this implementation.
protected abstract String	getAnnotationMemberName(T member) Read the name of an annotation member.
protected abstract Optional<T>	getAnnotationMirror(String annotationName) Return a mirror for the given annotation.
protected abstract List<? extends A>	getAnnotationsForType(T element) Obtain the annotations for the given type.
protected abstract String	getAnnotationTypeName(A annotationMirror) Get the given type of the annotation.
protected abstract OptionalValues<?>	getAnnotationValues(T originatingElement, T member, Class<?> annotationType) Resolve the annotations values from the given member for the given type.
protected abstract String	getDeclaringType(T element) Obtains the declaring type for an element.
protected abstract String	getElementName(T element) Get the name for the given element.
protected AnnotatedElementValidator	getElementValidator() Obtains the element validator.
static Set<String>	getMappedAnnotationNames()
protected abstract String	getRepeatableName(A annotationMirror) Obtain the name of the repeatable annotation if the annotation is is one.
protected abstract String	getRepeatableNameForType(T annotationType) Obtain the name of the repeatable annotation if the annotation is is one.
protected abstract T	getTypeForAnnotation(A annotationMirror) Get the type of the given annotation.
protected abstract boolean	hasAnnotation(T element, Class<? extends Annotation> annotation) Checks whether an annotation is present.
static boolean	isAnnotationMapped(String annotationName) Returns whether the given annotation is a mapped annotation.
static boolean	isMetadataMutated(String declaringType, Object element) Used to store metadata mutations at compilation time.
protected abstract boolean	isMethodOrClassElement(T element) Whether the element is a field, method, class or constructor.
protected Map<CharSequence,Object>	populateAnnotationData(T originatingElement, A annotationMirror, DefaultAnnotationMetadata metadata, boolean isDeclared) Populate the annotation data for the given annotation.
protected abstract Map<? extends T,?>	readAnnotationDefaultValues(A annotationMirror) Read the raw default annotation values from the given annotation.
protected abstract Map<? extends T,?>	readAnnotationDefaultValues(String annotationName, T annotationType) Read the raw default annotation values from the given annotation.
protected abstract Map<? extends T,?>	readAnnotationRawValues(A annotationMirror) Read the raw annotation values from the given annotation.
protected abstract void	readAnnotationRawValues(T originatingElement, String annotationName, T 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 abstract Object	readAnnotationValue(T originatingElement, T member, String memberName, Object annotationValue) Read the given member and value, applying conversions if necessary, and place the data in the given map.
protected AnnotationValue	readNestedAnnotationValue(T originatingElement, A annotationMirror)
protected void	validateAnnotationValue(T originatingElement, String annotationName, T member, String memberName, Object resolvedValue) Validates an annotation value.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractAnnotationMetadataBuilder

protected AbstractAnnotationMetadataBuilder()

Default constructor.

Method Detail

buildDeclared

public AnnotationMetadata buildDeclared(T element)

Build only metadata for declared annotations.

Parameters:

element - The element

Returns:

The AnnotationMetadata

buildOverridden

public AnnotationMetadata buildOverridden(T element)

Build metadata for the given element, including any metadata that is inherited via method or type overrides.

Parameters:

element - The element

Returns:

The AnnotationMetadata

build

public AnnotationMetadata build(T element)

Build the meta data for the given element. If the element is a method the class metadata will be included.

Parameters:

element - The element

Returns:

The AnnotationMetadata

build

public AnnotationMetadata build(String declaringType,
                                T element)

Build the meta data for the given element. If the element is a method the class metadata will be included.

Parameters:

declaringType - The declaring type

element - The element

Returns:

The AnnotationMetadata

isMethodOrClassElement

protected abstract boolean isMethodOrClassElement(T element)

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

Parameters:

element - The element

Returns:

True if it is

getDeclaringType

@Nonnull
protected abstract String getDeclaringType(@Nonnull
                                                    T element)

Obtains the declaring type for an element.

Parameters:

element - The element

Returns:

The declaring type

buildForMethod

public AnnotationMetadata buildForMethod(T element)

Build the meta data for the given method element excluding any class metadata.

Parameters:

element - The element

Returns:

The AnnotationMetadata

buildForParent

public AnnotationMetadata buildForParent(T parent,
                                         T element)

Get the annotation metadata for the given element and the given parent. This method is used for cases when you need to combine annotation metadata for two elements, for example a JavaBean property where the field and the method metadata need to be combined.

Parameters:

parent - The parent element

element - The element

Returns:

The AnnotationMetadata

buildForParent

public AnnotationMetadata buildForParent(String declaringType,
                                         T parent,
                                         T element)

Build the meta data for the given parent and method element excluding any class metadata.

Parameters:

declaringType - The declaring type

parent - The parent element

element - The element

Returns:

The AnnotationMetadata

buildForParent

public AnnotationMetadata buildForParent(T parent,
                                         T element,
                                         boolean inheritTypeAnnotations)

Build the meta data for the given method element excluding any class metadata.

Parameters:

parent - The parent element

element - The element

inheritTypeAnnotations - Whether to inherit annotations from type as stereotypes

Returns:

The AnnotationMetadata

getTypeForAnnotation

protected abstract T getTypeForAnnotation(A annotationMirror)

Get the type of the given annotation.

Parameters:

annotationMirror - The annotation

Returns:

The type

hasAnnotation

protected abstract boolean hasAnnotation(T element,
                                         Class<? extends Annotation> annotation)

Checks whether an annotation is present.

Parameters:

element - The element

annotation - The annotation type

Returns:

True if the annotation is present

getAnnotationTypeName

protected abstract String getAnnotationTypeName(A annotationMirror)

Get the given type of the annotation.

Parameters:

annotationMirror - The annotation

Returns:

The type

getElementName

protected abstract String getElementName(T element)

Get the name for the given element.

Parameters:

element - The element

Returns:

The name

getAnnotationsForType

protected abstract List<? extends A> getAnnotationsForType(T element)

Obtain the annotations for the given type.

Parameters:

element - The type element

Returns:

The annotations

buildHierarchy

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

Build the type hierarchy for the given element.

Parameters:

element - The element

inheritTypeAnnotations - Whether to inherit type annotations

declaredOnly - Whether to only include declared annotations

Returns:

The type hierarchy

readAnnotationRawValues

protected abstract void readAnnotationRawValues(T originatingElement,
                                                String annotationName,
                                                T 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.

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

validateAnnotationValue

protected void validateAnnotationValue(T originatingElement,
                                       String annotationName,
                                       T member,
                                       String memberName,
                                       Object resolvedValue)

Validates an annotation value.

Parameters:

originatingElement - The originating element

annotationName - The annotation name

member - The member

memberName - The member name

resolvedValue - The resolved value

getElementValidator

@Nullable
protected AnnotatedElementValidator getElementValidator()

Obtains the element validator.

Returns:

The validator.

addError

protected abstract void addError(@Nonnull
                                 T originatingElement,
                                 @Nonnull
                                 String error)

Adds an error.

Parameters:

originatingElement - The originating element

error - The error

readAnnotationValue

protected abstract Object readAnnotationValue(T originatingElement,
                                              T member,
                                              String memberName,
                                              Object annotationValue)

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

Parameters:

originatingElement - The originating element

member - The member

memberName - The member name

annotationValue - The value

Returns:

The object

readAnnotationDefaultValues

protected abstract Map<? extends T,?> readAnnotationDefaultValues(A annotationMirror)

Read the raw default annotation values from the given annotation.

Parameters:

annotationMirror - The annotation

Returns:

The values

readAnnotationDefaultValues

protected abstract Map<? extends T,?> readAnnotationDefaultValues(String annotationName,
                                                                  T annotationType)

Read the raw default annotation values from the given annotation.

Parameters:

annotationName - annotation name

annotationType - the type

Returns:

The values

readAnnotationRawValues

protected abstract Map<? extends T,?> readAnnotationRawValues(A annotationMirror)

Read the raw annotation values from the given annotation.

Parameters:

annotationMirror - The annotation

Returns:

The values

getAnnotationValues

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

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

Parameters:

originatingElement - The originating element

member - The member

annotationType - The type

Returns:

The values

getAnnotationMemberName

protected abstract String getAnnotationMemberName(T member)

Read the name of an annotation member.

Parameters:

member - The member

Returns:

The name

getRepeatableName

@Nullable
protected abstract String getRepeatableName(A annotationMirror)

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

Parameters:

annotationMirror - The annotation mirror

Returns:

Return the name or null

getRepeatableNameForType

@Nullable
protected abstract String getRepeatableNameForType(T annotationType)

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

Parameters:

annotationType - The annotation mirror

Returns:

Return the name or null

readNestedAnnotationValue

protected AnnotationValue readNestedAnnotationValue(T originatingElement,
                                                    A annotationMirror)

Parameters:

originatingElement - The originating element

annotationMirror - The annotation

Returns:

The annotation value

getAnnotationMirror

protected abstract Optional<T> getAnnotationMirror(String annotationName)

Return a mirror for the given annotation.

Parameters:

annotationName - The annotation name

Returns:

An optional mirror

populateAnnotationData

protected Map<CharSequence,Object> populateAnnotationData(T originatingElement,
                                                          A annotationMirror,
                                                          DefaultAnnotationMetadata metadata,
                                                          boolean isDeclared)

Populate the annotation data for the given annotation.

Parameters:

originatingElement - The element the annotation data originates from

annotationMirror - The annotation

metadata - the metadata

isDeclared - Is the annotation a declared annotation

Returns:

The annotation values

createVisitorContext

protected abstract VisitorContext createVisitorContext()

Creates the visitor context for this implementation.

Returns:

The visitor context

addMutatedMetadata

@Internal
public static void addMutatedMetadata(String declaringType,
                                                Object element,
                                                AnnotationMetadata metadata)

Used to store metadata mutations at compilation time. Not for public consumption.

Parameters:

declaringType - The declaring type

element - The element

metadata - The metadata

isMetadataMutated

@Internal
public static boolean isMetadataMutated(String declaringType,
                                                  Object element)

Used to store metadata mutations at compilation time. Not for public consumption.

Parameters:

declaringType - The declaring type

element - The element

Returns:

True if the annotation metadata was mutated

clearMutated

@Internal
public static void clearMutated()

Used to clear mutated metadata at the end of a compilation cycle.

isAnnotationMapped

@Internal
public static boolean isAnnotationMapped(@Nullable
                                                   String annotationName)

Returns whether the given annotation is a mapped annotation.

Parameters:

annotationName - The annotation name

Returns:

True if it is

getMappedAnnotationNames

@Internal
public static Set<String> getMappedAnnotationNames()

Returns:

Additional mapped annotation names

annotate

public <A2 extends Annotation> AnnotationMetadata annotate(AnnotationMetadata annotationMetadata,
                                                           AnnotationValue<A2> annotationValue)

Annotate an existing annotation metadata object.

Type Parameters:

A2 - The annotation type

Parameters:

annotationMetadata - The annotation metadata

annotationValue - The annotation value

Returns:

The mutated metadata