root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

Add warning to AnnotatedElementUtils.getMergedRepeatableAnnotations() 

See gh-20279
This commit is contained in:
Sam Brannen 2022-10-11 20:49:19 +02:00
parent 332b25b680
commit 5ac687f4aa
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
spring-core/src/main/java/org/springframework/core/annotation/AnnotatedElementUtils.java
View File

@ -433,6 +433,16 @@ public abstract class AnnotatedElementUtils {
* single annotation and within annotation hierarchies. * single annotation and within annotation hierarchies.
* <p>This method follows <em>get semantics</em> as described in the * <p>This method follows <em>get semantics</em> as described in the
* {@linkplain AnnotatedElementUtils class-level javadoc}. * {@linkplain AnnotatedElementUtils class-level javadoc}.
* <p><strong>WARNING</strong>: if the supplied {@code containerType} is not
* {@code null}, the search will be restricted to supporting only repeatable
* annotations whose container is the supplied {@code containerType}. This
* prevents the search from finding repeatable annotations declared as
* meta-annotations on other types of repeatable annotations. If you need to
* support such a use case, favor {@link #getMergedRepeatableAnnotations(AnnotatedElement, Class)}
* over this method or alternatively use the {@link MergedAnnotations} API
* directly in conjunction with {@link RepeatableContainers} that are
* {@linkplain RepeatableContainers#and(Class, Class) composed} to support
* multiple repeatable annotation types.
* @param element the annotated element (never {@code null}) * @param element the annotated element (never {@code null})
* @param annotationType the annotation type to find (never {@code null}) * @param annotationType the annotation type to find (never {@code null})
* @param containerType the type of the container that holds the annotations; * @param containerType the type of the container that holds the annotations;