{@code AnnotatedElementUtils} defines the public API for Spring's * meta-annotation programming model with support for annotation attribute - * overrides. If you do not need support for annotation attribute - * overrides, consider using {@link AnnotationUtils} instead. + * overrides and {@link AliasFor @AliasFor}. Note, however, that + * {@code AnnotatedElementUtils} is effectively a facade for the + * {@link MergedAnnotations} API. For fine-grained support consider using the + * {@code MergedAnnotations} API directly. If you do not need support for + * annotation attribute overrides, {@code @AliasFor}, or merged annotations, + * consider using {@link AnnotationUtils} instead. * *
Note that the features of this class are not provided by the JDK's * introspection facilities themselves. @@ -88,6 +92,7 @@ import org.springframework.util.MultiValueMap; * @since 4.0 * @see AliasFor * @see AnnotationAttributes + * @see MergedAnnotations * @see AnnotationUtils * @see BridgeMethodResolver */ diff --git a/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java b/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java index cb6a15a3c7c..fe46a920761 100644 --- a/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java +++ b/spring-core/src/main/java/org/springframework/core/annotation/AnnotationUtils.java @@ -61,7 +61,7 @@ import org.springframework.util.StringUtils; *
An annotation is meta-present on an element if the annotation * is declared as a meta-annotation on some other annotation which is @@ -74,7 +74,8 @@ import org.springframework.util.StringUtils; * provide support for finding annotations used as meta-annotations. Consult the * javadoc for each method in this class for details. For fine-grained support for * meta-annotations with attribute overrides in composed annotations, - * consider using {@link AnnotatedElementUtils}'s more specific methods instead. + * consider using the {@link MergedAnnotations} API directly or the more specific + * methods in {@link AnnotatedElementUtils} instead. * *
All public methods in this class that return annotations, arrays of @@ -98,6 +99,7 @@ import org.springframework.util.StringUtils; * @since 2.0 * @see AliasFor * @see AnnotationAttributes + * @see MergedAnnotations * @see AnnotatedElementUtils * @see BridgeMethodResolver * @see java.lang.reflect.AnnotatedElement#getAnnotations() @@ -303,11 +305,11 @@ public abstract class AnnotationUtils { * {@code annotationType} from the supplied {@link AnnotatedElement}, where * such annotations are either present, indirectly present, * or meta-present on the element. - *
This method mimics the functionality of Java 8's + *
This method mimics the functionality of * {@link java.lang.reflect.AnnotatedElement#getAnnotationsByType(Class)} * with support for automatic detection of a container annotation - * declared via @{@link java.lang.annotation.Repeatable} (when running on - * Java 8 or higher) and with additional support for meta-annotations. + * declared via {@link java.lang.annotation.Repeatable @Repeatable} and with + * additional support for meta-annotations. *
Handles both single annotations and annotations nested within a * container annotation. *
Correctly handles bridge methods generated by the @@ -338,7 +340,7 @@ public abstract class AnnotationUtils { * {@code annotationType} from the supplied {@link AnnotatedElement}, where * such annotations are either present, indirectly present, * or meta-present on the element. - *
This method mimics the functionality of Java 8's + *
This method mimics the functionality * {@link java.lang.reflect.AnnotatedElement#getAnnotationsByType(Class)} * with additional support for meta-annotations. *
Handles both single annotations and annotations nested within a @@ -349,10 +351,9 @@ public abstract class AnnotationUtils { * present on the supplied element. * @param annotatedElement the element to look for annotations on * @param annotationType the annotation type to look for - * @param containerAnnotationType the type of the container that holds - * the annotations; may be {@code null} if a container is not supported - * or if it should be looked up via @{@link java.lang.annotation.Repeatable} - * when running on Java 8 or higher + * @param containerAnnotationType the type of the container that holds the + * annotations; may be {@code null} if a container is not supported or if it + * should be looked up via {@link java.lang.annotation.Repeatable @Repeatable} * @return the annotations found or an empty set (never {@code null}) * @since 4.2 * @see #getRepeatableAnnotations(AnnotatedElement, Class) @@ -384,11 +385,11 @@ public abstract class AnnotationUtils { * of {@code annotationType} from the supplied {@link AnnotatedElement}, * where such annotations are either directly present, * indirectly present, or meta-present on the element. - *
This method mimics the functionality of Java 8's + *
This method mimics the functionality of * {@link java.lang.reflect.AnnotatedElement#getDeclaredAnnotationsByType(Class)} * with support for automatic detection of a container annotation - * declared via @{@link java.lang.annotation.Repeatable} (when running on - * Java 8 or higher) and with additional support for meta-annotations. + * declared via {@link java.lang.annotation.Repeatable @Repeatable} and with + * additional support for meta-annotations. *
Handles both single annotations and annotations nested within a * container annotation. *
Correctly handles bridge methods generated by the @@ -420,7 +421,7 @@ public abstract class AnnotationUtils { * of {@code annotationType} from the supplied {@link AnnotatedElement}, * where such annotations are either directly present, * indirectly present, or meta-present on the element. - *
This method mimics the functionality of Java 8's + *
This method mimics the functionality of * {@link java.lang.reflect.AnnotatedElement#getDeclaredAnnotationsByType(Class)} * with additional support for meta-annotations. *
Handles both single annotations and annotations nested within a @@ -431,10 +432,9 @@ public abstract class AnnotationUtils { * present on the supplied element. * @param annotatedElement the element to look for annotations on * @param annotationType the annotation type to look for - * @param containerAnnotationType the type of the container that holds - * the annotations; may be {@code null} if a container is not supported - * or if it should be looked up via @{@link java.lang.annotation.Repeatable} - * when running on Java 8 or higher + * @param containerAnnotationType the type of the container that holds the + * annotations; may be {@code null} if a container is not supported or if it + * should be looked up via {@link java.lang.annotation.Repeatable @Repeatable} * @return the annotations found or an empty set (never {@code null}) * @since 4.2 * @see #getRepeatableAnnotations(AnnotatedElement, Class) diff --git a/spring-core/src/main/java/org/springframework/core/annotation/MergedAnnotations.java b/spring-core/src/main/java/org/springframework/core/annotation/MergedAnnotations.java index 8f4733e885a..22db779552f 100644 --- a/spring-core/src/main/java/org/springframework/core/annotation/MergedAnnotations.java +++ b/spring-core/src/main/java/org/springframework/core/annotation/MergedAnnotations.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2023 the original author or authors. + * Copyright 2002-2025 the original author or authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -38,7 +38,7 @@ import org.springframework.util.Assert; *
Mainly for internal use within the Spring TestContext Framework * but also supported for third-party integrations with the TestContext framework. * - *
Whereas {@code AnnotationUtils} and {@code AnnotatedElementUtils} provide - * utilities for getting or finding annotations, - * {@code TestContextAnnotationUtils} goes a step further by providing support - * for determining the root class on which an annotation is declared, - * either directly or indirectly via a composed annotation. This - * additional information is encapsulated in an {@link AnnotationDescriptor}. + *
Whereas {@code MergedAnnotations}, {@code AnnotationUtils} and + * {@code AnnotatedElementUtils} provide utilities for getting or + * finding annotations, {@code TestContextAnnotationUtils} goes a step + * further by providing support for determining the root class on which + * an annotation is declared, either directly or indirectly via a + * composed annotation. This additional information is encapsulated in + * an {@link AnnotationDescriptor}. * *
The additional information provided by an {@code AnnotationDescriptor} is * required by the Spring TestContext Framework in order to be able to @@ -68,7 +69,11 @@ import org.springframework.util.ObjectUtils; * example, {@link ContextConfiguration#inheritLocations}. * * @author Sam Brannen - * @since 5.3, though originally since 4.0 as {@code org.springframework.test.util.MetaAnnotationUtils} + * @since 5.3 + * @see MergedAnnotations + * @see MergedAnnotations.Search + * @see MergedAnnotations.Search#withEnclosingClasses(Predicate) + * @see #searchEnclosingClass(Class) * @see AnnotationUtils * @see AnnotatedElementUtils * @see AnnotationDescriptor