io.micronaut.core.annotation

Interface AnnotationMetadataProvider

All Superinterfaces:

AnnotationSource

All Known Subinterfaces:

AdvisedBeanType<T>, AnnotatedElement, AnnotationElement, AnnotationMetadataDelegate, Argument<T>, ArgumentConversionContext<T>, ArgumentInjectionPoint<B,T>, ArgumentValue<V>, ArrayableClassElement, BeanConfiguration, BeanConstructor<T>, BeanConstructorElement, BeanDefinition<T>, BeanDefinitionMethodReference<T,R>, BeanDefinitionReference<T>, BeanElement, BeanElementBuilder, BeanFieldElement, BeanIntrospection<T>, BeanIntrospectionReference<T>, BeanMethod<B,T>, BeanMethodElement, BeanParameterElement, BeanProperty<B,T>, BeanType<T>, BeanWrapper<T>, BoundExecutable<T,R>, CallableInjectionPoint<T>, ClassElement, ConfigurableElement, ConstructorElement, ConstructorInjectionPoint<T>, ConstructorInvocationContext<T>, ConversionContext, DelegatingBeanDefinition<T>, DelegatingExecutableMethod<T,R>, DisposableBeanDefinition<T>, Element, EnumElement, Executable<T,R>, ExecutableMethod<T,R>, ExecutionHandle<T,R>, FieldElement, FieldInjectionPoint<B,T>, FilterRoute, GenericPlaceholderElement, HttpFilterResolver.FilterEntry<F>, InitializingBeanDefinition<T>, InjectableElement, InjectionPoint<T>, InvocationContext<T,R>, MemberElement, MethodBasedRouteMatch<T,R>, MethodElement, MethodExecutionHandle<T,R>, MethodInjectionPoint<B,T>, MethodInvocationContext<T,R>, MethodReference<T,R>, MutableArgumentValue<V>, PackageElement, ParameterElement, PropertyElement, ProxyBeanDefinition<T>, ReturnType<T>, RouteInfo<R>, RouteMatch<R>, TypedElement, TypeInformation<T>, UriRouteMatch<T,R>, ValidatedBeanDefinition<T>, WildcardElement

All Known Implementing Classes:

AbstractBeanConfiguration, AbstractBeanConstructor, AbstractBeanDefinition, AbstractBeanDefinitionBuilder, AbstractBeanDefinitionReference, AbstractBeanIntrospection, AbstractBeanIntrospectionReference, AbstractBeanMethod, AbstractBeanProperty, AbstractBeanResolutionContext.ConstructorArgumentSegment, AbstractBeanResolutionContext.FieldSegment, AbstractBeanResolutionContext.MethodArgumentSegment, AbstractBeanResolutionContext.MethodSegment, AbstractConstructorInjectionPoint, AbstractExecutableBeanMethod, AbstractExecutableMethod, AbstractGroovyElement, AbstractInitializableBeanDefinition, AbstractInitializableBeanDefinitionReference, AbstractInitializableBeanIntrospection, AbstractJavaElement, AbstractParametrizedBeanDefinition, AbstractProviderDefinition, AnnotationMetadataReference, ApplicationEventPublisherFactory, ArgumentBeanType, BasicObjectRouteMatch, BeanDefinitionWriter, BeanProviderDefinition, ClientFilterResolutionContext, ConstructorInterceptorChain, DefaultArgument, GenericArgument, GroovyClassElement, GroovyConstructorElement, GroovyFieldElement, GroovyMethodElement, GroovyPackageElement, GroovyParameterElement, InterceptorChain, InterceptorRegistryBean, JakartaProviderBeanDefinition, JavaClassElement, JavaMethodElement, JavaPackageElement, JavaxProviderBeanDefinition, MethodInterceptorChain, PrimitiveElement

public interface AnnotationMetadataProvider
extends AnnotationSource

An interface for a type that provides AnnotationMetadata.

Since:

1.0

Author:

Graeme Rocher

Field Summary

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

EMPTY

Method Summary

Modifier and Type	Method and Description
default <T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>>	findAnnotation(java.lang.Class<T> annotationClass) Find an AnnotationValue for the given annotation type.
default <T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>>	findAnnotation(java.lang.String annotation) Find an AnnotationValue for the given annotation name.
default <T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>>	findDeclaredAnnotation(java.lang.Class<T> annotationClass) Get all of the values for the given annotation that are directly declared on the annotated element.
default <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.
default AnnotationMetadata	getAnnotationMetadata() Supplies the metadata.
default boolean	isAnnotationPresent(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass) Return whether an annotation is present.
default boolean	isDeclaredAnnotationPresent(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass) Variation of AnnotationSource.isAnnotationPresent(Class) for declared annotations.
default <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.
default java.lang.annotation.Annotation[]	synthesizeAll() Synthesizes a new annotations from the metadata.
default <T extends java.lang.annotation.Annotation> T[]	synthesizeAnnotationsByType(java.lang.Class<T> annotationClass) Synthesizes a new annotations from the metadata for the given type.
default java.lang.annotation.Annotation[]	synthesizeDeclared() Synthesizes a new annotations from the metadata.
default <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.
default <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 interface io.micronaut.core.annotation.AnnotationSource

getAnnotation, getAnnotation, getDeclaredAnnotation, getDeclaredAnnotation, isAnnotationPresent, isDeclaredAnnotationPresent, synthesize, synthesizeDeclared

Method Detail

getAnnotationMetadata

@NonNull
default AnnotationMetadata getAnnotationMetadata()

Supplies the metadata. Defaults to AnnotationMetadata.EMPTY_METADATA.

Returns:

The AnnotationMetadata

synthesize

default <T extends java.lang.annotation.Annotation> T synthesize(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

synthesizeAll

default java.lang.annotation.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

default java.lang.annotation.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

isAnnotationPresent

default boolean isAnnotationPresent(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)

Description copied from interface: AnnotationSource

Return whether an annotation is present.

Specified by:

isAnnotationPresent in interface AnnotationSource

Parameters:

annotationClass - The annotation class

Returns:

True if it is

isDeclaredAnnotationPresent

default boolean isDeclaredAnnotationPresent(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)

Description copied from interface: AnnotationSource

Variation of AnnotationSource.isAnnotationPresent(Class) for declared annotations.

Specified by:

isDeclaredAnnotationPresent in interface AnnotationSource

Parameters:

annotationClass - The annotation class

Returns:

True if it is

synthesizeDeclared

default <T extends java.lang.annotation.Annotation> T synthesizeDeclared(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

synthesizeAnnotationsByType

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

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

findAnnotation

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

findAnnotation

default <T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>> findAnnotation(java.lang.Class<T> annotationClass)

Description copied from interface: AnnotationSource

Find an AnnotationValue for the given annotation type.

Specified by:

findAnnotation in interface AnnotationSource

Type Parameters:

T - The annotation type

Parameters:

annotationClass - The annotation

Returns:

A AnnotationValue instance

findDeclaredAnnotation

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

findDeclaredAnnotation

default <T extends java.lang.annotation.Annotation> java.util.Optional<AnnotationValue<T>> findDeclaredAnnotation(java.lang.Class<T> annotationClass)

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:

annotationClass - The annotation name

Returns:

A AnnotationValue instance