io.micronaut.inject.annotation

Class AbstractEnvironmentAnnotationMetadata

java.lang.Object

io.micronaut.inject.annotation.AbstractEnvironmentAnnotationMetadata

All Implemented Interfaces:

AnnotationMetadata, AnnotationSource

@Internal
public abstract class AbstractEnvironmentAnnotationMetadata
extends java.lang.Object
implements AnnotationMetadata

Variation of AnnotationMetadata that is environment specific.

Since:

1.0

Author:

Graeme Rocher

Field Summary

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

Modifier	Constructor and Description
protected	AbstractEnvironmentAnnotationMetadata(AnnotationMetadata targetMetadata) Construct a new environment aware annotation metadata.

Method Summary

Modifier and Type	Method and Description
java.util.Optional<java.lang.Boolean>	booleanValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value as an optional boolean for the given annotation and member.
java.util.Optional<java.lang.Boolean>	booleanValue(java.lang.String annotation, java.lang.String member) The value as an optional boolean for the given annotation and member.
java.util.Optional<java.lang.Class>	classValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value of the annotation as a Class.
java.util.Optional<java.lang.Class>	classValue(java.lang.String annotation, java.lang.String member) The value of the annotation as a Class.
<T> java.lang.Class<T>[]	classValues(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value of the annotation as a Class.
<T> java.lang.Class<T>[]	classValues(java.lang.String annotation, java.lang.String member) The value of the annotation as a Class.
java.util.OptionalDouble	doubleValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value as an OptionalDouble for the given annotation and member.
java.util.OptionalDouble	doubleValue(java.lang.String annotation, java.lang.String member) The value as an OptionalDouble for the given annotation and member.
<E extends java.lang.Enum> java.util.Optional<E>	enumValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member, java.lang.Class<E> enumType) The value of the annotation as a Class.
<E extends java.lang.Enum> java.util.Optional<E>	enumValue(java.lang.String annotation, java.lang.String member, java.lang.Class<E> enumType) The value of the annotation as a Class.
<E extends java.lang.Enum> E[]	enumValues(java.lang.String annotation, java.lang.String member, java.lang.Class<E> enumType) The enum values for the given annotation.
<T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>>	findAnnotation(java.lang.String annotation) Find an AnnotationValue for the given annotation name.
<T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>>	findDeclaredAnnotation(java.lang.String annotation) Get all of the values for the given annotation that are directly declared on the annotated element.
AnnotationMetadata	getAnnotationMetadata()
java.util.Set<java.lang.String>	getAnnotationNames() All the annotation names this metadata declares.
java.util.List<java.lang.String>	getAnnotationNamesByStereotype(java.lang.String stereotype) Resolve all of the annotation names that feature the given stereotype.
java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>>	getAnnotationType(java.lang.String name) Gets the type for a given annotation if it is present on the classpath.
java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>>	getAnnotationType(java.lang.String name, java.lang.ClassLoader classLoader) Gets the type for a given annotation if it is present on the classpath.
java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>>	getAnnotationTypeByStereotype(java.lang.Class<? extends java.lang.annotation.Annotation> stereotype) Find the first annotation name for the given stereotype.
java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>>	getAnnotationTypeByStereotype(java.lang.String stereotype) Find the first annotation name for the given stereotype.
<T extends java.lang.annotation.Annotation> java.util.List<AnnotationValue<T>>	getAnnotationValuesByType(java.lang.Class<T> annotationType) Gets all the annotation values by the given repeatable type.
java.util.Set<java.lang.String>	getDeclaredAnnotationNames() All the declared annotation names this metadata declares.
java.util.List<java.lang.String>	getDeclaredAnnotationNamesByStereotype(java.lang.String stereotype) Resolve all of the annotations names for the given stereotype that are declared annotations.
<T extends java.lang.annotation.Annotation> java.util.List<AnnotationValue<T>>	getDeclaredAnnotationValuesByType(java.lang.Class<T> annotationType) Gets only declared annotation values by the given repeatable type.
<T> java.util.Optional<T>	getDefaultValue(java.lang.String annotation, java.lang.String member, Argument<T> requiredType) Return the default value for the given annotation member.
<T> java.util.Optional<T>	getDefaultValue(java.lang.String annotation, java.lang.String member, java.lang.Class<T> requiredType) Return the default value for the given annotation member.
protected abstract Environment	getEnvironment() Resolves the Environment for this metadata.
<T> java.util.Optional<T>	getValue(java.lang.String annotation, java.lang.String member, Argument<T> requiredType) Get the value of the given annotation member.
<T> OptionalValues<T>	getValues(java.lang.String annotation, java.lang.Class<T> valueType) Get all of the values for the given annotation and type of the underlying values.
boolean	hasAnnotation(java.lang.String annotation) Checks whether this object has the given annotation on the object itself or inherited from a parent.
boolean	hasDeclaredAnnotation(java.lang.String annotation) Checks whether this object has the given annotation directly declared on the object.
boolean	hasDeclaredStereotype(java.lang.String annotation) Checks whether this object has the given annotation stereotype on the object itself and not inherited from a parent
boolean	hasStereotype(java.lang.String annotation) Checks whether this object has the given annotation stereotype on the object itself or inherited from a parent
java.util.OptionalInt	intValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value as an OptionalInt for the given annotation and member.
java.util.OptionalInt	intValue(java.lang.String annotation, java.lang.String member) The value as an OptionalInt for the given annotation and member.
boolean	isFalse(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) Returns whether the value of the given member is true.
boolean	isFalse(java.lang.String annotation, java.lang.String member) Returns whether the value of the given member is true.
boolean	isTrue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) Returns whether the value of the given member is true.
boolean	isTrue(java.lang.String annotation, java.lang.String member) Returns whether the value of the given member is true.
java.util.OptionalLong	longValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value as an OptionalLong for the given annotation and member.
java.util.OptionalLong	longValue(java.lang.String annotation, java.lang.String member) The value as an OptionalLong for the given annotation and member.
java.util.Optional<java.lang.String>	stringValue(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The value as an optional string for the given annotation and member.
java.util.Optional<java.lang.String>	stringValue(java.lang.String annotation, java.lang.String member) The value as an optional string for the given annotation and member.
java.lang.String[]	stringValues(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String member) The values as string array for the given annotation and member.
<T extends java.lang.annotation.Annotation> T	synthesize(java.lang.Class<T> annotationClass) Synthesizes a new annotation from the metadata for the given annotation type.
<T extends java.lang.annotation.Annotation> T[]	synthesizeAnnotationsByType(java.lang.Class<T> annotationClass) Synthesizes a new annotations from the metadata for the given type.
<T extends java.lang.annotation.Annotation> T	synthesizeDeclared(java.lang.Class<T> annotationClass) Synthesizes a new annotation from the metadata for the given annotation type.
<T extends java.lang.annotation.Annotation> T[]	synthesizeDeclaredAnnotationsByType(java.lang.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, enumValues, findAnnotation, findDeclaredAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNamesByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDefaultValue, getDefaultValue, getDefaultValues, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValues, hasAnnotation, hasDeclaredAnnotation, hasDeclaredStereotype, hasDeclaredStereotype, hasSimpleAnnotation, hasSimpleDeclaredAnnotation, hasStereotype, hasStereotype, hasStereotype, intValue, isAnnotationPresent, isDeclaredAnnotationPresent, isEmpty, isPresent, isPresent, stringValue, stringValue, stringValues

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

getAnnotation, getAnnotation, getDeclaredAnnotation, getDeclaredAnnotation, synthesizeAll, synthesizeDeclared

Constructor Detail

AbstractEnvironmentAnnotationMetadata

protected AbstractEnvironmentAnnotationMetadata(AnnotationMetadata targetMetadata)

Construct a new environment aware annotation metadata.

Parameters:

targetMetadata - The target annotation metadata

Method Detail

getAnnotationMetadata

public AnnotationMetadata getAnnotationMetadata()

Returns:

The backing annotation metadata

synthesize

@Nullable
public <T extends java.lang.annotation.Annotation> T synthesize(@NonNull
                                                                          java.lang.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 java.lang.annotation.Annotation> T synthesizeDeclared(@NonNull
                                                                                  java.lang.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

getValue

public <T> java.util.Optional<T> getValue(@NonNull
                                          java.lang.String annotation,
                                          @NonNull
                                          java.lang.String member,
                                          @NonNull
                                          Argument<T> requiredType)

Description copied from interface: AnnotationMetadata

Get the value of the given annotation member.

Specified by:

getValue in interface AnnotationMetadata

Type Parameters:

T - The value

Parameters:

annotation - The annotation class

member - The annotation member

requiredType - The required type

Returns:

An Optional of the value

classValues

public <T> java.lang.Class<T>[] classValues(@NonNull
                                            java.lang.String annotation,
                                            @NonNull
                                            java.lang.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

classValues

public <T> java.lang.Class<T>[] classValues(@NonNull
                                            java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                            @NonNull
                                            java.lang.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

isTrue

public boolean isTrue(@NonNull
                      java.lang.String annotation,
                      @NonNull
                      java.lang.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

isFalse

public boolean isFalse(@NonNull
                       java.lang.String annotation,
                       @NonNull
                       java.lang.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

getAnnotationTypeByStereotype

@NonNull
public java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>> getAnnotationTypeByStereotype(@NonNull
                                                                                                                             java.lang.Class<? extends java.lang.annotation.Annotation> stereotype)

Description copied from interface: AnnotationMetadata

Find the first annotation name for the given stereotype.

Specified by:

getAnnotationTypeByStereotype in interface AnnotationMetadata

Parameters:

stereotype - The stereotype

Returns:

The annotation name

getAnnotationTypeByStereotype

@NonNull
public java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>> getAnnotationTypeByStereotype(@Nullable
                                                                                                                             java.lang.String stereotype)

Description copied from interface: AnnotationMetadata

Find the first annotation name for the given stereotype.

Specified by:

getAnnotationTypeByStereotype in interface AnnotationMetadata

Parameters:

stereotype - The stereotype

Returns:

The annotation name

classValue

@NonNull
public java.util.Optional<java.lang.Class> classValue(@NonNull
                                                               java.lang.String annotation,
                                                               @NonNull
                                                               java.lang.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

classValue

@NonNull
public java.util.Optional<java.lang.Class> classValue(@NonNull
                                                               java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                               @NonNull
                                                               java.lang.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

enumValue

public <E extends java.lang.Enum> java.util.Optional<E> enumValue(@NonNull
                                                                  java.lang.String annotation,
                                                                  @NonNull
                                                                  java.lang.String member,
                                                                  java.lang.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

enumValue

public <E extends java.lang.Enum> java.util.Optional<E> enumValue(@NonNull
                                                                  java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                                  @NonNull
                                                                  java.lang.String member,
                                                                  java.lang.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 java.lang.Enum> E[] enumValues(@NonNull
                                                 java.lang.String annotation,
                                                 @NonNull
                                                 java.lang.String member,
                                                 java.lang.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

booleanValue

public java.util.Optional<java.lang.Boolean> booleanValue(@NonNull
                                                          java.lang.String annotation,
                                                          @NonNull
                                                          java.lang.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

booleanValue

public java.util.Optional<java.lang.Boolean> booleanValue(@NonNull
                                                          java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                          @NonNull
                                                          java.lang.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

stringValue

@NonNull
public java.util.Optional<java.lang.String> stringValue(@NonNull
                                                                 java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                                 @NonNull
                                                                 java.lang.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

stringValues

@NonNull
public java.lang.String[] stringValues(@NonNull
                                                java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                @NonNull
                                                java.lang.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

stringValue

@NonNull
public java.util.Optional<java.lang.String> stringValue(@NonNull
                                                                 java.lang.String annotation,
                                                                 @NonNull
                                                                 java.lang.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

longValue

public java.util.OptionalLong longValue(@NonNull
                                        java.lang.String annotation,
                                        @NonNull
                                        java.lang.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

longValue

public java.util.OptionalLong longValue(@NonNull
                                        java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                        @NonNull
                                        java.lang.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

intValue

@NonNull
public java.util.OptionalInt intValue(@NonNull
                                               java.lang.String annotation,
                                               @NonNull
                                               java.lang.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

intValue

@NonNull
public java.util.OptionalInt intValue(@NonNull
                                               java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                               @NonNull
                                               java.lang.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 java.util.OptionalDouble doubleValue(@NonNull
                                                     java.lang.String annotation,
                                                     @NonNull
                                                     java.lang.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

doubleValue

@NonNull
public java.util.OptionalDouble doubleValue(@NonNull
                                                     java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                     @NonNull
                                                     java.lang.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

isTrue

public boolean isTrue(@NonNull
                      java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                      @NonNull
                      java.lang.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

isFalse

public boolean isFalse(@NonNull
                       java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                       @NonNull
                       java.lang.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

getAnnotationType

@NonNull
public java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>> getAnnotationType(@NonNull
                                                                                                                 java.lang.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

@NonNull
public java.util.Optional<java.lang.Class<? extends java.lang.annotation.Annotation>> getAnnotationType(@NonNull
                                                                                                                 java.lang.String name,
                                                                                                                 @NonNull
                                                                                                                 java.lang.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

getAnnotationValuesByType

@NonNull
public <T extends java.lang.annotation.Annotation> java.util.List<AnnotationValue<T>> getAnnotationValuesByType(@NonNull
                                                                                                                         java.lang.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

getDeclaredAnnotationValuesByType

@NonNull
public <T extends java.lang.annotation.Annotation> java.util.List<AnnotationValue<T>> getDeclaredAnnotationValuesByType(@NonNull
                                                                                                                                 java.lang.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

synthesizeAnnotationsByType

@NonNull
public <T extends java.lang.annotation.Annotation> T[] synthesizeAnnotationsByType(@NonNull
                                                                                            java.lang.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

@NonNull
public <T extends java.lang.annotation.Annotation> T[] synthesizeDeclaredAnnotationsByType(@NonNull
                                                                                                    java.lang.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

hasDeclaredAnnotation

public boolean hasDeclaredAnnotation(@Nullable
                                     java.lang.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
                             java.lang.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
                             java.lang.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
                                     java.lang.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

getAnnotationNamesByStereotype

@NonNull
public java.util.List<java.lang.String> getAnnotationNamesByStereotype(java.lang.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

getAnnotationNames

@NonNull
public java.util.Set<java.lang.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

getDeclaredAnnotationNames

@NonNull
public java.util.Set<java.lang.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

getDeclaredAnnotationNamesByStereotype

@NonNull
public java.util.List<java.lang.String> getDeclaredAnnotationNamesByStereotype(java.lang.String stereotype)

Description copied from interface: AnnotationMetadata

Resolve all of the annotations names for the given stereotype that are declared annotations.

Specified by:

getDeclaredAnnotationNamesByStereotype in interface AnnotationMetadata

Parameters:

stereotype - The stereotype

Returns:

The declared annotations

findAnnotation

@NonNull
public <T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>> findAnnotation(@NonNull
                                                                                                                  java.lang.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 java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>> findDeclaredAnnotation(@NonNull
                                                                                                                          java.lang.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

getValues

@NonNull
public <T> OptionalValues<T> getValues(@NonNull
                                                java.lang.String annotation,
                                                @NonNull
                                                java.lang.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

@NonNull
public <T> java.util.Optional<T> getDefaultValue(@NonNull
                                                          java.lang.String annotation,
                                                          @NonNull
                                                          java.lang.String member,
                                                          @NonNull
                                                          java.lang.Class<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

getDefaultValue

@NonNull
public <T> java.util.Optional<T> getDefaultValue(@NonNull
                                                          java.lang.String annotation,
                                                          @NonNull
                                                          java.lang.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

getEnvironment

@Nullable
protected abstract Environment getEnvironment()

Resolves the Environment for this metadata.

Returns:

The metadata