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
AnnotationMetadata	build(T element) Build the meta data for the given element.
AnnotationMetadata	buildForMethod(T element) Build the meta data for the given method element excluding any class metadata.
AnnotationMetadata	buildForParent(T parent, T element) Build the meta data for the given method element excluding any class metadata.
protected abstract List<T>	buildHierarchy(T element, boolean inheritTypeAnnotations) Build the type hierarchy for the given element.
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 member, Class<?> annotationType) Resolve the annotations values from the given member for the given type.
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.
static boolean	isAnnotationMapped(String annotationName) Returns whether the given annotation is a mapped annotation.
protected Map<CharSequence,Object>	populateAnnotationData(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(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(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(A annotationMirror)

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

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

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)

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

Parameters:

parent - The parent element

element - The element

Returns:

The AnnotationMetadata

getTypeForAnnotation

protected abstract T getTypeForAnnotation(A annotationMirror)

Get the type of the given annotation.

Parameters:

annotationMirror - The annotation

Returns:

The type

getAnnotationTypeName

protected abstract String getAnnotationTypeName(A annotationMirror)

Get the given type of the annotation.

Parameters:

annotationMirror - The annotation

Returns:

The type

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)

Build the type hierarchy for the given element.

Parameters:

element - The element

inheritTypeAnnotations - Whether to inherit type annotations

Returns:

The type hierarchy

readAnnotationRawValues

protected abstract void readAnnotationRawValues(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:

memberName - The member

annotationValue - The value

annotationValues - The values to populate

readAnnotationValue

protected abstract Object readAnnotationValue(String memberName,
                                              Object annotationValue)

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

Parameters:

memberName - The member

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 member,
                                                         Class<?> annotationType)

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

Parameters:

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(A annotationMirror)

Parameters:

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(A annotationMirror,
                                                          DefaultAnnotationMetadata metadata,
                                                          boolean isDeclared)

Populate the annotation data for the given annotation.

Parameters:

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

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