io.micronaut.inject.annotation

Class AnnotationMetadataHierarchy

java.lang.Object

io.micronaut.inject.annotation.AnnotationMetadataHierarchy

All Implemented Interfaces:

AnnotationMetadata, AnnotationSource, Iterable<AnnotationMetadata>

public final class AnnotationMetadataHierarchy
extends Object
implements AnnotationMetadata, Iterable<AnnotationMetadata>

Used to represent an annotation metadata hierarchy. The first AnnotationMetadata instance passed to the constructor represents the annotation metadata that is declared, hence methods like hasDeclaredAnnotation(String) will return true for the last annotation metadata passed in the hierarchy.

This class is used to internally optimize memory usage and compilation time for classes that declare AOP advice at the type level and where the classes methods typically don't include any annotations and therefore would be wasteful to generate additional annotation metadata classes.

Since:

1.3.0

Author:

graemerocher

Field Summary

Fields

Modifier and Type	Field and Description
static AnnotationMetadata[]	EMPTY_HIERARCHY Constant to represent an empty hierarchy.

Fields inherited from interface io.micronaut.core.annotation.AnnotationMetadata

CLASS_NAME_SUFFIX, EMPTY_METADATA, VALUE_MEMBER

Fields inherited from interface io.micronaut.core.annotation.AnnotationSource

EMPTY

Constructor Summary

Constructors

Constructor and Description
AnnotationMetadataHierarchy(AnnotationMetadata... hierarchy) Default constructor.

Method Summary

Modifier and Type	Method and Description
Optional<Boolean>	booleanValue(Class<? extends Annotation> annotation, String member) The value as an optional boolean for the given annotation and member.
Optional<Boolean>	booleanValue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the boolean value and optionally map its value.
Optional<Boolean>	booleanValue(String annotation, String member) The value as an optional boolean for the given annotation and member.
Optional<Boolean>	booleanValue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the boolean value and optionally map its value.
Optional<Class>	classValue(Class<? extends Annotation> annotation, String member) The value of the annotation as a Class.
Optional<Class>	classValue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the class value and optionally map its value.
Optional<Class>	classValue(String annotation, String member) The value of the annotation as a Class.
Optional<Class>	classValue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the class value and optionally map its value.
<T> Class<T>[]	classValues(Class<? extends Annotation> annotation, String member) The value of the annotation as a Class.
<T> Class<T>[]	classValues(String annotation, String member) The value of the annotation as a Class.
AnnotationMetadata	createSibling(AnnotationMetadata child) Create a new hierarchy instance from this metadata using this metadata's parents.
OptionalDouble	doubleValue(Class<? extends Annotation> annotation, String member) The value as an OptionalDouble for the given annotation and member.
OptionalDouble	doubleValue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the double value and optionally map its value.
OptionalDouble	doubleValue(String annotation, String member) The value as an OptionalDouble for the given annotation and member.
OptionalDouble	doubleValue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the double value and optionally map its value.
<E extends Enum> Optional<E>	enumValue(Class<? extends Annotation> annotation, String member, Class<E> enumType) The value of the annotation as a Class.
<E extends Enum> Optional<E>	enumValue(Class<? extends Annotation> annotation, String member, Class<E> enumType, Function<Object,Object> valueMapper) Retrieve the enum value and optionally map its value.
<E extends Enum> Optional<E>	enumValue(String annotation, String member, Class<E> enumType) The value of the annotation as a Class.
<E extends Enum> Optional<E>	enumValue(String annotation, String member, Class<E> enumType, Function<Object,Object> valueMapper) Retrieve the enum value and optionally map its value.
<E extends Enum> E[]	enumValues(Class<? extends Annotation> annotation, String member, Class<E> enumType) The enum values for the given annotation.
<E extends Enum> E[]	enumValues(Class<? extends Annotation> annotation, String member, Class<E> enumType, Function<Object,Object> valueMapper) Retrieve the enum values and optionally map its value.
<E extends Enum> E[]	enumValues(String annotation, String member, Class<E> enumType) The enum values for the given annotation.
<E extends Enum> E[]	enumValues(String annotation, String member, Class<E> enumType, Function<Object,Object> valueMapper) Retrieve the enum values and optionally map its value.
<T extends Annotation> Optional<AnnotationValue<T>>	findAnnotation(String annotation) Find an AnnotationValue for the given annotation name.
<T extends Annotation> Optional<AnnotationValue<T>>	findDeclaredAnnotation(String annotation) Get all of the values for the given annotation that are directly declared on the annotated element.
Optional<String>	findRepeatableAnnotation(Class<? extends Annotation> annotation) Find repeatable annotation container.
Optional<String>	findRepeatableAnnotation(String annotation) Find repeatable annotation container.
Set<String>	getAnnotationNames() All the annotation names this metadata declares.
List<String>	getAnnotationNamesByStereotype(String stereotype) Resolve all of the annotation names that feature the given stereotype.
Optional<Class<? extends Annotation>>	getAnnotationType(String name) Gets the type for a given annotation if it is present on the classpath.
Optional<Class<? extends Annotation>>	getAnnotationType(String name, ClassLoader classLoader) Gets the type for a given annotation if it is present on the classpath.
<T extends Annotation> List<AnnotationValue<T>>	getAnnotationValuesByName(String annotationType) Gets all the annotation values by the given repeatable type name.
<T extends Annotation> List<AnnotationValue<T>>	getAnnotationValuesByType(Class<T> annotationType) Gets all the annotation values by the given repeatable type.
Set<String>	getDeclaredAnnotationNames() All the declared annotation names this metadata declares.
<T extends Annotation> List<AnnotationValue<T>>	getDeclaredAnnotationValuesByName(String annotationType) Gets only declared annotation values by the given repeatable type name.
<T extends Annotation> List<AnnotationValue<T>>	getDeclaredAnnotationValuesByType(Class<T> annotationType) Gets only declared annotation values by the given repeatable type.
AnnotationMetadata	getDeclaredMetadata() Gets the declared metadata without inherited metdata.
<T> Optional<T>	getDefaultValue(String annotation, String member, Argument<T> requiredType) Return the default value for the given annotation member.
Map<String,Object>	getDefaultValues(String annotation) Return the default values for the given annotation name.
AnnotationMetadata	getRootMetadata()
<T> Optional<T>	getValue(String annotation, String member, Argument<T> requiredType, Function<Object,Object> valueMapper) Resolves the given value performing type conversion as necessary.
<T> OptionalValues<T>	getValues(String annotation, Class<T> valueType) Get all of the values for the given annotation and type of the underlying values.
boolean	hasAnnotation(String annotation) Checks whether this object has the given annotation on the object itself or inherited from a parent.
boolean	hasDeclaredAnnotation(String annotation) Checks whether this object has the given annotation directly declared on the object.
boolean	hasDeclaredStereotype(String annotation) Checks whether this object has the given annotation stereotype on the object itself and not inherited from a parent
boolean	hasPropertyExpressions() Does the metadata contain any property expressions like ${foo.bar}.
boolean	hasStereotype(String annotation) Checks whether this object has the given annotation stereotype on the object itself or inherited from a parent
OptionalInt	intValue(Class<? extends Annotation> annotation, String member) The value as an OptionalInt for the given annotation and member.
OptionalInt	intValue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the int value and optionally map its value.
OptionalInt	intValue(String annotation, String member) The value as an OptionalInt for the given annotation and member.
OptionalInt	intValue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the int value and optionally map its value.
boolean	isEmpty() Is the annotation metadata empty.
boolean	isFalse(Class<? extends Annotation> annotation, String member) Returns whether the value of the given member is true.
boolean	isPresent(Class<? extends Annotation> annotation, String member) Returns whether the value of the given member is present.
boolean	isRepeatableAnnotation(Class<? extends Annotation> annotation) Is repeatable annotation?
boolean	isRepeatableAnnotation(String annotation) Is repeatable annotation?
boolean	isTrue(Class<? extends Annotation> annotation, String member) Returns whether the value of the given member is true.
boolean	isTrue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the boolean value and optionally map its value.
boolean	isTrue(String annotation, String member) Returns whether the value of the given member is true.
boolean	isTrue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the boolean value and optionally map its value.
Iterator<AnnotationMetadata>	iterator()
OptionalLong	longValue(Class<? extends Annotation> annotation, String member) The value as an OptionalLong for the given annotation and member.
OptionalLong	longValue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the long value and optionally map its value.
OptionalLong	longValue(String annotation, String member) The value as an OptionalLong for the given annotation and member.
OptionalLong	longValue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the long value and optionally map its value.
Optional<String>	stringValue(Class<? extends Annotation> annotation, String member) The value as an optional string for the given annotation and member.
Optional<String>	stringValue(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the string value and optionally map its value.
Optional<String>	stringValue(String annotation, String member) The value as an optional string for the given annotation and member.
Optional<String>	stringValue(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the string value and optionally map its value.
String[]	stringValues(Class<? extends Annotation> annotation, String member) The values as string array for the given annotation and member.
String[]	stringValues(Class<? extends Annotation> annotation, String member, Function<Object,Object> valueMapper) Retrieve the string value and optionally map its value.
String[]	stringValues(String annotation, String member) The values as string array for the given annotation and member.
String[]	stringValues(String annotation, String member, Function<Object,Object> valueMapper) Retrieve the string value and optionally map its value.
<T extends Annotation> T	synthesize(Class<T> annotationClass) Synthesizes a new annotation from the metadata for the given annotation type.
<T extends Annotation> T	synthesize(Class<T> annotationClass, String sourceAnnotation) Synthesizes a new annotation for the given annotation type using the member values of the given source annotation.
Annotation[]	synthesizeAll() Synthesizes a new annotations from the metadata.
<T extends Annotation> T[]	synthesizeAnnotationsByType(Class<T> annotationClass) Synthesizes a new annotations from the metadata for the given type.
Annotation[]	synthesizeDeclared() Synthesizes a new annotations from the metadata.
<T extends Annotation> T	synthesizeDeclared(Class<T> annotationClass) Synthesizes a new annotation from the metadata for the given annotation type.
<T extends Annotation> T	synthesizeDeclared(Class<T> annotationClass, String sourceAnnotation) Synthesizes a new annotation declared for the given annotation type using the member values of the given source annotation.
<T extends Annotation> T[]	synthesizeDeclaredAnnotationsByType(Class<T> annotationClass) Synthesizes a new annotations from the metadata for the given type.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadata

booleanValue, booleanValue, classValue, classValue, classValues, classValues, doubleValue, enumValue, enumValue, enumValues, enumValues, findAnnotation, findDeclaredAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNamesByStereotype, getAnnotationTypeByStereotype, getAnnotationTypeByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationNamesByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDefaultValue, getDefaultValue, getDefaultValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValues, getValues, hasAnnotation, hasDeclaredAnnotation, hasDeclaredStereotype, hasDeclaredStereotype, hasDeclaredStereotype, hasSimpleAnnotation, hasSimpleDeclaredAnnotation, hasStereotype, hasStereotype, hasStereotype, intValue, isAnnotationPresent, isAnnotationPresent, isDeclaredAnnotationPresent, isDeclaredAnnotationPresent, isFalse, isPresent, stringValue, stringValue, stringValues, stringValues

Methods inherited from interface io.micronaut.core.annotation.AnnotationSource

getAnnotation, getAnnotation, getDeclaredAnnotation, getDeclaredAnnotation

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

EMPTY_HIERARCHY

public static final AnnotationMetadata[] EMPTY_HIERARCHY

Constant to represent an empty hierarchy.

Constructor Detail

AnnotationMetadataHierarchy

public AnnotationMetadataHierarchy(AnnotationMetadata... hierarchy)

Default constructor.

Parameters:

hierarchy - The annotation hierarchy

Method Detail

hasPropertyExpressions

public boolean hasPropertyExpressions()

Description copied from interface: AnnotationMetadata

Does the metadata contain any property expressions like ${foo.bar}. Note this by default returns true as previous versions of Micronaut must assume metadata is present. The compilation time this is computed in order to decide whether to instrument annotation metadata with environment specific logic.

Specified by:

hasPropertyExpressions in interface AnnotationMetadata

Returns:

True if property expressions are present

getAnnotationType

public Optional<Class<? extends Annotation>> getAnnotationType(@NonNull
                                                               String name)

Description copied from interface: AnnotationMetadata

Gets the type for a given annotation if it is present on the classpath. Subclasses can potentially override to provide optimized loading.

Specified by:

getAnnotationType in interface AnnotationMetadata

Parameters:

name - The type name

Returns:

The type if present

getAnnotationType

public Optional<Class<? extends Annotation>> getAnnotationType(@NonNull
                                                               String name,
                                                               @NonNull
                                                               ClassLoader classLoader)

Description copied from interface: AnnotationMetadata

Gets the type for a given annotation if it is present on the classpath. Subclasses can potentially override to provide optimized loading.

Specified by:

getAnnotationType in interface AnnotationMetadata

Parameters:

name - The type name

classLoader - The ClassLoader to load the type

Returns:

The type if present

getDeclaredMetadata

@NonNull
public AnnotationMetadata getDeclaredMetadata()

Description copied from interface: AnnotationMetadata

Gets the declared metadata without inherited metdata.

Specified by:

getDeclaredMetadata in interface AnnotationMetadata

Returns:

The metadata that is actually declared in the element

getRootMetadata

@NonNull
public AnnotationMetadata getRootMetadata()

Returns:

The metadata that is actually declared in the element

createSibling

@NonNull
public AnnotationMetadata createSibling(@NonNull
                                                 AnnotationMetadata child)

Create a new hierarchy instance from this metadata using this metadata's parents.

Parameters:

child - The child annotation metadata

Returns:

A new sibling

synthesize

@Nullable
public <T extends Annotation> T synthesize(@NonNull
                                                     Class<T> annotationClass,
                                                     @NonNull
                                                     String sourceAnnotation)

Description copied from interface: AnnotationSource

Synthesizes a new annotation for the given annotation type using the member values of the given source annotation.

This method allows supporting synthesizing annotations that have been renamed, for example a jakarta.inject.Named annotation an be synthesized from the metadata of the a javax.inject.Named annotation.

Specified by:

synthesize in interface AnnotationSource

Type Parameters:

T - The annotation generic type

Parameters:

annotationClass - The annotation class

sourceAnnotation - The source annotation that provides the member values

Returns:

The annotation or null if it doesn't exist

synthesizeAll

public Annotation[] synthesizeAll()

Description copied from interface: AnnotationSource

Synthesizes a new annotations from the metadata. This method works by creating a runtime proxy of the annotation interface and should be avoided in favour of direct use of the annotation metadata and only used for unique cases that require integrating third party libraries.

Specified by:

synthesizeAll in interface AnnotationSource

Returns:

All the annotations

synthesizeDeclared

public Annotation[] synthesizeDeclared()

Description copied from interface: AnnotationSource

Synthesizes a new annotations from the metadata. This method works by creating a runtime proxy of the annotation interface and should be avoided in favour of direct use of the annotation metadata and only used for unique cases that require integrating third party libraries.

Specified by:

synthesizeDeclared in interface AnnotationSource

Returns:

All declared annotations

synthesizeAnnotationsByType

public <T extends Annotation> T[] synthesizeAnnotationsByType(Class<T> annotationClass)

Description copied from interface: AnnotationSource

Synthesizes a new annotations from the metadata for the given type. This method works by creating a runtime proxy of the annotation interface and should be avoided in favour of direct use of the annotation metadata and only used for unique cases that require integrating third party libraries.

Specified by:

synthesizeAnnotationsByType in interface AnnotationSource

Type Parameters:

T - The annotation generic type

Parameters:

annotationClass - The annotation type

Returns:

All annotations by the given type

synthesizeDeclaredAnnotationsByType

public <T extends Annotation> T[] synthesizeDeclaredAnnotationsByType(Class<T> annotationClass)

Description copied from interface: AnnotationSource

Synthesizes a new annotations from the metadata for the given type. This method works by creating a runtime proxy of the annotation interface and should be avoided in favour of direct use of the annotation metadata and only used for unique cases that require integrating third party libraries.

Specified by:

synthesizeDeclaredAnnotationsByType in interface AnnotationSource

Type Parameters:

T - The annotation generic type

Parameters:

annotationClass - The annotation type

Returns:

Declared annotations by the given type

synthesizeDeclared

@Nullable
public <T extends Annotation> T synthesizeDeclared(@NonNull
                                                             Class<T> annotationClass,
                                                             @NonNull
                                                             String sourceAnnotation)

Description copied from interface: AnnotationSource

Synthesizes a new annotation declared for the given annotation type using the member values of the given source annotation.

This method allows supporting synthesizing annotations that have been renamed, for example a jakarta.inject.Named annotation an be synthesized from the metadata of the a javax.inject.Named annotation.

Specified by:

synthesizeDeclared in interface AnnotationSource

Type Parameters:

T - The annotation generic type

Parameters:

annotationClass - The annotation class

sourceAnnotation - The source annotation that provides the member values

Returns:

The annotation or null if it doesn't exist

synthesize

@Nullable
public <T extends Annotation> T synthesize(@NonNull
                                                     Class<T> annotationClass)

Description copied from interface: AnnotationSource

Synthesizes a new annotation from the metadata for the given annotation type. This method works by creating a runtime proxy of the annotation interface and should be avoided in favour of direct use of the annotation metadata and only used for unique cases that require integrating third party libraries.

Specified by:

synthesize in interface AnnotationSource

Type Parameters:

T - The annotation generic type

Parameters:

annotationClass - The annotation class

Returns:

The annotation or null if it doesn't exist

synthesizeDeclared

@Nullable
public <T extends Annotation> T synthesizeDeclared(@NonNull
                                                             Class<T> annotationClass)

Description copied from interface: AnnotationSource

Synthesizes a new annotation from the metadata for the given annotation type. This method works by creating a runtime proxy of the annotation interface and should be avoided in favour of direct use of the annotation metadata and only used for unique cases that require integrating third party libraries.

This method ignores inherited annotations. (Returns null if no annotations are directly present on this element.)

Specified by:

synthesizeDeclared in interface AnnotationSource

Type Parameters:

T - The annotation generic type

Parameters:

annotationClass - The annotation class

Returns:

The annotation or null if it doesn't exist

findAnnotation

@NonNull
public <T extends Annotation> Optional<AnnotationValue<T>> findAnnotation(@NonNull
                                                                                   String annotation)

Description copied from interface: AnnotationSource

Find an AnnotationValue for the given annotation name.

Specified by:

findAnnotation in interface AnnotationSource

Type Parameters:

T - The annotation type

Parameters:

annotation - The annotation name

Returns:

A AnnotationValue instance

findDeclaredAnnotation

@NonNull
public <T extends Annotation> Optional<AnnotationValue<T>> findDeclaredAnnotation(@NonNull
                                                                                           String annotation)

Description copied from interface: AnnotationSource

Get all of the values for the given annotation that are directly declared on the annotated element.

Specified by:

findDeclaredAnnotation in interface AnnotationSource

Type Parameters:

T - The annotation type

Parameters:

annotation - The annotation name

Returns:

A AnnotationValue instance

doubleValue

@NonNull
public OptionalDouble doubleValue(@NonNull
                                           Class<? extends Annotation> annotation,
                                           @NonNull
                                           String member)

Description copied from interface: AnnotationMetadata

The value as an OptionalDouble for the given annotation and member.

Specified by:

doubleValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

THe OptionalDouble value

stringValues

@NonNull
public String[] stringValues(@NonNull
                                      Class<? extends Annotation> annotation,
                                      @NonNull
                                      String member)

Description copied from interface: AnnotationMetadata

The values as string array for the given annotation and member.

Specified by:

stringValues in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

The string values if it is present

stringValues

@NonNull
public String[] stringValues(@NonNull
                                      String annotation,
                                      @NonNull
                                      String member)

Description copied from interface: AnnotationMetadata

The values as string array for the given annotation and member.

Specified by:

stringValues in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

The string values if it is present

booleanValue

public Optional<Boolean> booleanValue(@NonNull
                                      String annotation,
                                      @NonNull
                                      String member)

Description copied from interface: AnnotationMetadata

The value as an optional boolean for the given annotation and member.

Specified by:

booleanValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

The string value if it is present

isTrue

public boolean isTrue(@NonNull
                      String annotation,
                      @NonNull
                      String member)

Description copied from interface: AnnotationMetadata

Returns whether the value of the given member is true.

Specified by:

isTrue in interface AnnotationMetadata

Parameters:

annotation - The annotation class

member - The annotation member

Returns:

True if the value is true

longValue

public OptionalLong longValue(@NonNull
                              String annotation,
                              @NonNull
                              String member)

Description copied from interface: AnnotationMetadata

The value as an OptionalLong for the given annotation and member.

Specified by:

longValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

THe OptionalLong value

stringValue

public Optional<String> stringValue(@NonNull
                                    String annotation,
                                    @NonNull
                                    String member)

Description copied from interface: AnnotationMetadata

The value as an optional string for the given annotation and member.

Specified by:

stringValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

The string value if it is present

intValue

public OptionalInt intValue(@NonNull
                            String annotation,
                            @NonNull
                            String member)

Description copied from interface: AnnotationMetadata

The value as an OptionalInt for the given annotation and member.

Specified by:

intValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

THe OptionalInt value

doubleValue

@NonNull
public OptionalDouble doubleValue(@NonNull
                                           String annotation,
                                           @NonNull
                                           String member)

Description copied from interface: AnnotationMetadata

The value as an OptionalDouble for the given annotation and member.

Specified by:

doubleValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

THe OptionalDouble value

enumValue

public <E extends Enum> Optional<E> enumValue(@NonNull
                                              Class<? extends Annotation> annotation,
                                              @NonNull
                                              String member,
                                              Class<E> enumType)

Description copied from interface: AnnotationMetadata

The value of the annotation as a Class.

Specified by:

enumValue in interface AnnotationMetadata

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The annotation member

enumType - The enum type

Returns:

An Optional class

classValues

@NonNull
public <T> Class<T>[] classValues(@NonNull
                                           String annotation,
                                           @NonNull
                                           String member)

Description copied from interface: AnnotationMetadata

The value of the annotation as a Class.

Specified by:

classValues in interface AnnotationMetadata

Type Parameters:

T - The type of the class

Parameters:

annotation - The annotation

member - The annotation member

Returns:

An Optional class

classValue

public Optional<Class> classValue(@NonNull
                                  String annotation,
                                  @NonNull
                                  String member)

Description copied from interface: AnnotationMetadata

The value of the annotation as a Class.

Specified by:

classValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The annotation member

Returns:

An Optional class

getAnnotationNamesByStereotype

@NonNull
public List<String> getAnnotationNamesByStereotype(@Nullable
                                                            String stereotype)

Description copied from interface: AnnotationMetadata

Resolve all of the annotation names that feature the given stereotype.

Specified by:

getAnnotationNamesByStereotype in interface AnnotationMetadata

Parameters:

stereotype - The annotation names

Returns:

A set of annotation names

getDeclaredAnnotationNames

@NonNull
public Set<String> getDeclaredAnnotationNames()

Description copied from interface: AnnotationMetadata

All the declared annotation names this metadata declares.

Specified by:

getDeclaredAnnotationNames in interface AnnotationMetadata

Returns:

All the declared annotation names this metadata declares

getAnnotationNames

@NonNull
public Set<String> getAnnotationNames()

Description copied from interface: AnnotationMetadata

All the annotation names this metadata declares.

Specified by:

getAnnotationNames in interface AnnotationMetadata

Returns:

All the annotation names this metadata declares

getValues

@NonNull
public <T> OptionalValues<T> getValues(@NonNull
                                                String annotation,
                                                @NonNull
                                                Class<T> valueType)

Description copied from interface: AnnotationMetadata

Get all of the values for the given annotation and type of the underlying values.

Specified by:

getValues in interface AnnotationMetadata

Type Parameters:

T - Generic type

Parameters:

annotation - The annotation name

valueType - valueType

Returns:

The OptionalValues

getDefaultValue

public <T> Optional<T> getDefaultValue(@NonNull
                                       String annotation,
                                       @NonNull
                                       String member,
                                       @NonNull
                                       Argument<T> requiredType)

Description copied from interface: AnnotationMetadata

Return the default value for the given annotation member.

Specified by:

getDefaultValue in interface AnnotationMetadata

Type Parameters:

T - The required generic type

Parameters:

annotation - The annotation

member - The member

requiredType - The required type

Returns:

An optional value

getAnnotationValuesByType

@NonNull
public <T extends Annotation> List<AnnotationValue<T>> getAnnotationValuesByType(@NonNull
                                                                                          Class<T> annotationType)

Description copied from interface: AnnotationMetadata

Gets all the annotation values by the given repeatable type.

Specified by:

getAnnotationValuesByType in interface AnnotationMetadata

Type Parameters:

T - The annotation type

Parameters:

annotationType - The annotation type

Returns:

A list of values

getAnnotationValuesByName

public <T extends Annotation> List<AnnotationValue<T>> getAnnotationValuesByName(String annotationType)

Description copied from interface: AnnotationMetadata

Gets all the annotation values by the given repeatable type name.

Specified by:

getAnnotationValuesByName in interface AnnotationMetadata

Type Parameters:

T - The annotation type

Parameters:

annotationType - The annotation type

Returns:

A list of values

getDeclaredAnnotationValuesByType

@NonNull
public <T extends Annotation> List<AnnotationValue<T>> getDeclaredAnnotationValuesByType(@NonNull
                                                                                                  Class<T> annotationType)

Description copied from interface: AnnotationMetadata

Gets only declared annotation values by the given repeatable type.

Specified by:

getDeclaredAnnotationValuesByType in interface AnnotationMetadata

Type Parameters:

T - The annotation type

Parameters:

annotationType - The annotation type

Returns:

A list of values

getDeclaredAnnotationValuesByName

public <T extends Annotation> List<AnnotationValue<T>> getDeclaredAnnotationValuesByName(String annotationType)

Description copied from interface: AnnotationMetadata

Gets only declared annotation values by the given repeatable type name.

Specified by:

getDeclaredAnnotationValuesByName in interface AnnotationMetadata

Type Parameters:

T - The annotation type

Parameters:

annotationType - The annotation type

Returns:

A list of values

hasDeclaredAnnotation

public boolean hasDeclaredAnnotation(@Nullable
                                     String annotation)

Description copied from interface: AnnotationMetadata

Checks whether this object has the given annotation directly declared on the object.

Specified by:

hasDeclaredAnnotation in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

True if the annotation is present

hasAnnotation

public boolean hasAnnotation(@Nullable
                             String annotation)

Description copied from interface: AnnotationMetadata

Checks whether this object has the given annotation on the object itself or inherited from a parent.

Specified by:

hasAnnotation in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

True if the annotation is present

hasStereotype

public boolean hasStereotype(@Nullable
                             String annotation)

Description copied from interface: AnnotationMetadata

Checks whether this object has the given annotation stereotype on the object itself or inherited from a parent

.

An annotation stereotype is a meta annotation potentially applied to another annotation

Specified by:

hasStereotype in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

True if the annotation is present

hasDeclaredStereotype

public boolean hasDeclaredStereotype(@Nullable
                                     String annotation)

Description copied from interface: AnnotationMetadata

Checks whether this object has the given annotation stereotype on the object itself and not inherited from a parent

.

An annotation stereotype is a meta annotation potentially applied to another annotation

Specified by:

hasDeclaredStereotype in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

True if the annotation is present

enumValue

public <E extends Enum> Optional<E> enumValue(String annotation,
                                              String member,
                                              Class<E> enumType)

Description copied from interface: AnnotationMetadata

The value of the annotation as a Class.

Specified by:

enumValue in interface AnnotationMetadata

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The annotation member

enumType - The enum type

Returns:

An Optional class

enumValues

public <E extends Enum> E[] enumValues(String annotation,
                                       String member,
                                       Class<E> enumType)

Description copied from interface: AnnotationMetadata

The enum values for the given annotation.

Specified by:

enumValues in interface AnnotationMetadata

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The annotation member

enumType - The enum type

Returns:

An array of enum values

intValue

public OptionalInt intValue(Class<? extends Annotation> annotation,
                            String member)

Description copied from interface: AnnotationMetadata

The value as an OptionalInt for the given annotation and member.

Specified by:

intValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

THe OptionalInt value

isFalse

public boolean isFalse(Class<? extends Annotation> annotation,
                       String member)

Description copied from interface: AnnotationMetadata

Returns whether the value of the given member is true.

Specified by:

isFalse in interface AnnotationMetadata

Parameters:

annotation - The annotation class

member - The annotation member

Returns:

True if the value is true

getDefaultValues

@NonNull
public Map<String,Object> getDefaultValues(@NonNull
                                                    String annotation)

Description copied from interface: AnnotationMetadata

Return the default values for the given annotation name.

Specified by:

getDefaultValues in interface AnnotationMetadata

Parameters:

annotation - The annotation name

Returns:

The default values

enumValue

public <E extends Enum> Optional<E> enumValue(@NonNull
                                              Class<? extends Annotation> annotation,
                                              @NonNull
                                              String member,
                                              Class<E> enumType,
                                              @Nullable
                                              Function<Object,Object> valueMapper)

Retrieve the enum value and optionally map its value.

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The member

enumType - The enum type

valueMapper - The value mapper

Returns:

The enum value

enumValue

public <E extends Enum> Optional<E> enumValue(@NonNull
                                              String annotation,
                                              @NonNull
                                              String member,
                                              Class<E> enumType,
                                              @Nullable
                                              Function<Object,Object> valueMapper)

Retrieve the enum value and optionally map its value.

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The member

enumType - The enum type

valueMapper - The value mapper

Returns:

The enum value

enumValues

public <E extends Enum> E[] enumValues(@NonNull
                                       Class<? extends Annotation> annotation,
                                       @NonNull
                                       String member,
                                       Class<E> enumType,
                                       @Nullable
                                       Function<Object,Object> valueMapper)

Retrieve the enum values and optionally map its value.

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The member

enumType - The enum type

valueMapper - The value mapper

Returns:

The enum value

enumValues

public <E extends Enum> E[] enumValues(@NonNull
                                       String annotation,
                                       @NonNull
                                       String member,
                                       Class<E> enumType,
                                       @Nullable
                                       Function<Object,Object> valueMapper)

Retrieve the enum values and optionally map its value.

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The member

enumType - The enum type

valueMapper - The value mapper

Returns:

The enum value

classValue

public Optional<Class> classValue(@NonNull
                                  Class<? extends Annotation> annotation,
                                  @NonNull
                                  String member,
                                  Function<Object,Object> valueMapper)

Retrieve the class value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The class value

classValue

public Optional<Class> classValue(@NonNull
                                  String annotation,
                                  @NonNull
                                  String member,
                                  @Nullable
                                  Function<Object,Object> valueMapper)

Retrieve the class value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The class value

intValue

public OptionalInt intValue(@NonNull
                            Class<? extends Annotation> annotation,
                            @NonNull
                            String member,
                            @Nullable
                            Function<Object,Object> valueMapper)

Retrieve the int value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The int value

booleanValue

public Optional<Boolean> booleanValue(@NonNull
                                      Class<? extends Annotation> annotation,
                                      @NonNull
                                      String member,
                                      Function<Object,Object> valueMapper)

Retrieve the boolean value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The boolean value

booleanValue

@NonNull
public Optional<Boolean> booleanValue(@NonNull
                                               String annotation,
                                               @NonNull
                                               String member,
                                               @Nullable
                                               Function<Object,Object> valueMapper)

Retrieve the boolean value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The boolean value

longValue

public OptionalLong longValue(@NonNull
                              Class<? extends Annotation> annotation,
                              @NonNull
                              String member,
                              @Nullable
                              Function<Object,Object> valueMapper)

Retrieve the long value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The long value

longValue

@NonNull
public OptionalLong longValue(@NonNull
                                       String annotation,
                                       @NonNull
                                       String member,
                                       @Nullable
                                       Function<Object,Object> valueMapper)

Retrieve the long value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The long value

intValue

@NonNull
public OptionalInt intValue(@NonNull
                                     String annotation,
                                     @NonNull
                                     String member,
                                     @Nullable
                                     Function<Object,Object> valueMapper)

Retrieve the int value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The int value

longValue

public OptionalLong longValue(Class<? extends Annotation> annotation,
                              String member)

Description copied from interface: AnnotationMetadata

The value as an OptionalLong for the given annotation and member.

Specified by:

longValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

THe OptionalLong value

enumValues

public <E extends Enum> E[] enumValues(Class<? extends Annotation> annotation,
                                       String member,
                                       Class<E> enumType)

Description copied from interface: AnnotationMetadata

The enum values for the given annotation.

Specified by:

enumValues in interface AnnotationMetadata

Type Parameters:

E - The enum type

Parameters:

annotation - The annotation

member - The annotation member

enumType - The enum type

Returns:

An array of enum values

classValues

public <T> Class<T>[] classValues(Class<? extends Annotation> annotation,
                                  String member)

Description copied from interface: AnnotationMetadata

The value of the annotation as a Class.

Specified by:

classValues in interface AnnotationMetadata

Type Parameters:

T - The type of the class

Parameters:

annotation - The annotation

member - The annotation member

Returns:

An Optional class

classValue

public Optional<Class> classValue(Class<? extends Annotation> annotation,
                                  String member)

Description copied from interface: AnnotationMetadata

The value of the annotation as a Class.

Specified by:

classValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The annotation member

Returns:

An Optional class

stringValue

public Optional<String> stringValue(Class<? extends Annotation> annotation,
                                    String member)

Description copied from interface: AnnotationMetadata

The value as an optional string for the given annotation and member.

Specified by:

stringValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

The string value if it is present

booleanValue

public Optional<Boolean> booleanValue(Class<? extends Annotation> annotation,
                                      String member)

Description copied from interface: AnnotationMetadata

The value as an optional boolean for the given annotation and member.

Specified by:

booleanValue in interface AnnotationMetadata

Parameters:

annotation - The annotation

member - The member

Returns:

The string value if it is present

isTrue

public boolean isTrue(Class<? extends Annotation> annotation,
                      String member)

Description copied from interface: AnnotationMetadata

Returns whether the value of the given member is true.

Specified by:

isTrue in interface AnnotationMetadata

Parameters:

annotation - The annotation class

member - The annotation member

Returns:

True if the value is true

isPresent

public boolean isPresent(Class<? extends Annotation> annotation,
                         String member)

Description copied from interface: AnnotationMetadata

Returns whether the value of the given member is present.

Specified by:

isPresent in interface AnnotationMetadata

Parameters:

annotation - The annotation class

member - The annotation member

Returns:

True if the value is true

stringValue

public Optional<String> stringValue(@NonNull
                                    Class<? extends Annotation> annotation,
                                    @NonNull
                                    String member,
                                    Function<Object,Object> valueMapper)

Retrieve the string value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The int value

stringValues

@NonNull
public String[] stringValues(@NonNull
                                      Class<? extends Annotation> annotation,
                                      @NonNull
                                      String member,
                                      Function<Object,Object> valueMapper)

Retrieve the string value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The int value

stringValues

public String[] stringValues(String annotation,
                             String member,
                             Function<Object,Object> valueMapper)

Retrieve the string value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The int value

stringValue

@NonNull
public Optional<String> stringValue(@NonNull
                                             String annotation,
                                             @NonNull
                                             String member,
                                             @Nullable
                                             Function<Object,Object> valueMapper)

Retrieve the string value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The string value

isTrue

public boolean isTrue(@NonNull
                      Class<? extends Annotation> annotation,
                      @NonNull
                      String member,
                      Function<Object,Object> valueMapper)

Retrieve the boolean value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The boolean value

isTrue

public boolean isTrue(@NonNull
                      String annotation,
                      @NonNull
                      String member,
                      @Nullable
                      Function<Object,Object> valueMapper)

Retrieve the boolean value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The boolean value

doubleValue

public OptionalDouble doubleValue(@NonNull
                                  Class<? extends Annotation> annotation,
                                  @NonNull
                                  String member,
                                  @Nullable
                                  Function<Object,Object> valueMapper)

Retrieve the double value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The double value

doubleValue

@NonNull
public OptionalDouble doubleValue(@NonNull
                                           String annotation,
                                           @NonNull
                                           String member,
                                           Function<Object,Object> valueMapper)

Retrieve the double value and optionally map its value.

Parameters:

annotation - The annotation

member - The member

valueMapper - The value mapper

Returns:

The double value

getValue

@NonNull
public <T> Optional<T> getValue(@NonNull
                                         String annotation,
                                         @NonNull
                                         String member,
                                         @NonNull
                                         Argument<T> requiredType,
                                         @Nullable
                                         Function<Object,Object> valueMapper)

Resolves the given value performing type conversion as necessary.

Type Parameters:

T - The generic type

Parameters:

annotation - The annotation

member - The member

requiredType - The required type

valueMapper - The value mapper

Returns:

The resolved value

iterator

@NonNull
public Iterator<AnnotationMetadata> iterator()

Specified by:

iterator in interface Iterable<AnnotationMetadata>

isEmpty

public boolean isEmpty()

Description copied from interface: AnnotationMetadata

Is the annotation metadata empty.

Specified by:

isEmpty in interface AnnotationMetadata

Returns:

True if it is

isRepeatableAnnotation

public boolean isRepeatableAnnotation(Class<? extends Annotation> annotation)

Description copied from interface: AnnotationMetadata

Is repeatable annotation?

Specified by:

isRepeatableAnnotation in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

true if repeatable

isRepeatableAnnotation

public boolean isRepeatableAnnotation(String annotation)

Description copied from interface: AnnotationMetadata

Is repeatable annotation?

Specified by:

isRepeatableAnnotation in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

true if repeatable

findRepeatableAnnotation

public Optional<String> findRepeatableAnnotation(Class<? extends Annotation> annotation)

Description copied from interface: AnnotationMetadata

Find repeatable annotation container.

Specified by:

findRepeatableAnnotation in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

optional repeatable annotation container

findRepeatableAnnotation

public Optional<String> findRepeatableAnnotation(String annotation)

Description copied from interface: AnnotationMetadata

Find repeatable annotation container.

Specified by:

findRepeatableAnnotation in interface AnnotationMetadata

Parameters:

annotation - The annotation

Returns:

optional repeatable annotation container