spring:解决findMergedRepeatableAnnotations获取可重复的元注解(meta-annotation)结果不正确问题

spring-core的注解工具提供的方法 AnnotatedElementUtils.findMergedRepeatableAnnotations用于从AnnotatedElement 对象获取可重复的注解。但如果注解本身也是可以定义在其他注解之上的元注解(meta-annotation),且该注解也是可重复注解。这个方法就可能会失效。这就是我最近在使用spring注解工具时遇到的问题。示例如下。

注解定义

先定义一组注解:

java 复制代码
	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
	@Repeatable(LevelAs.class)
	public @interface LevelA {
		String value();
	}
	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.METHOD })
	public @interface LevelAs {
		LevelA[] value();
	}

	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.ANNOTATION_TYPE,ElementType.METHOD })
	@LevelA("shadows")
	@Repeatable(LevelBs.class)
	public @interface LevelB {
		@AliasFor(annotation = LevelA.class,attribute = "value")
		String value();
	}
	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.METHOD })
	public @interface LevelBs {
		LevelB[] value();
	}

	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.METHOD })
	@LevelB("shadows")
	public @interface LevelC {
		@AliasFor(annotation = LevelB.class,attribute = "value")
		String value();
	}

上面定义了@LevalA,@LevalB,@LevalC三个注解,其中@LeveA,@LevelB是可以重复注解(参见 @LevelAs,@LevelBs),而且还是元注解。@LeveA@LevelB的元注解,@LevelB@LevelC的元注解。它们三个层级关系是这样的。

cpp 复制代码
@LevelA				可重复 @LevelAs
	└─@LevelB		可重复 @LevelBs
		└─@LevelC

如下定义了测试这些注解的类

java 复制代码
	public static class TestClass{
		@LevelB("hello")
		@LevelB("world")
		@LevelA("top1")
		@LevelA("top2")
		@LevelC("jerry")
		public void foo() {};
		@LevelB("hello")
		@LevelA("top1")
		@LevelA("top2")
		@LevelC("jerry")
		public void tar() {};
	}

findMergedRepeatableAnnotations

如下调用AnnotatedElementUtils.findMergedRepeatableAnnotations方法读取TestClass.tar上定义的所有@LevelA注解

java 复制代码
	@Test
	public void test1() {
		try {
			Method method = TestClass.class.getMethod("tar");
			Set<LevelA> set = AnnotatedElementUtils.findMergedRepeatableAnnotations(method,LevelA.class);
			set.stream().forEach(a->{
				System.out.printf("%s\n", a);
			});
		} catch (Throwable e) {
			e.printStackTrace();
			fail();
		}
	}

确实可以获取正确的结果:

@RepeatableAnnotTest$LevelA(value=top1)
@RepeatableAnnotTest$LevelA(value=top2)
@RepeatableAnnotTest$LevelA(value=hello)
@RepeatableAnnotTest$LevelA(value=jerry)

那是因为TestClass.tar上只定义了一个@LevelB注解,如果上面的测试代码只是把方法名换为定义了多个@LevelB的方法foo,结果就是这样的:

@RepeatableAnnotTest$LevelA(value=top1)
@RepeatableAnnotTest$LevelA(value=top2)
@RepeatableAnnotTest$LevelA(value=jerry)

因为这里foo方法定义了超过一个@LevelB注解,实际定义在foo上的注解就成了@LeveBs({@LevelB("hello"),@LevelB("world")}),就导致AnnotatedElementUtils.findMergedRepeatableAnnotations方法不能正确获取。

分析AnnotatedElementUtils的源码,找到findMergedRepeatableAnnotations方法实际的核心执行代码如下:

java 复制代码
RepeatableContainers repeatableContainers = RepeatableContainers.of(annotationType, containerType);
return MergedAnnotations.from(element, SearchStrategy.TYPE_HIERARCHY, repeatableContainers);

RepeatableContainers

进一查看RepeatableContainers的代码发现它还有另一个方法standardRepeatables()

创建一个使用Java的@Repeatable注释进行搜索的RepeatableContainers实例。

java 复制代码
	/**
	 * Create a {@link RepeatableContainers} instance that searches using Java's
	 * {@link Repeatable @Repeatable} annotation.
	 * @return a {@link RepeatableContainers} instance
	 */
	public static RepeatableContainers standardRepeatables() {
		return StandardRepeatableContainers.INSTANCE;
	}

于是照着上面的代码将测试代码修改如下:

java 复制代码
	@Test
	public void test3() {
		try {
			Method method = TestClass.class.getMethod("foo");
			RepeatableContainers repeatableContainers = RepeatableContainers.standardRepeatables();
			MergedAnnotations.from(method, SearchStrategy.TYPE_HIERARCHY, repeatableContainers)
					.stream(LevelA.class)
					.forEach(a->{
						System.out.printf("%s\n", a.synthesize());
					});
		} catch (Throwable e) {
			e.printStackTrace();
			fail();
		}
	}

则结果正确:

@LevelA(value=top1)
@LevelA(value=top2)
@LevelA(value=hello)
@LevelA(value=world)
@LevelA(value=jerry)

完整测试代码

java 复制代码
import static org.junit.Assert.*;

import java.lang.annotation.ElementType;
import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Method;
import java.util.Set;
import org.junit.Test;
import org.springframework.core.annotation.AliasFor;
import org.springframework.core.annotation.AnnotatedElementUtils;
import org.springframework.core.annotation.MergedAnnotations;
import org.springframework.core.annotation.MergedAnnotations.SearchStrategy;
import org.springframework.core.annotation.RepeatableContainers;


public class RepeatableAnnotTest {
	@Test
	public void test1() {
		try {
			Method method = TestClass.class.getMethod("foo");
			Set<LevelA> set = AnnotatedElementUtils.findMergedRepeatableAnnotations(method,LevelA.class);
			set.stream().forEach(a->{
				System.out.printf("%s\n", a);
			});
		} catch (Throwable e) {
			e.printStackTrace();
			fail();
		}
	}
	@Test
	public void test2() {
		try {
			Method method = TestClass.class.getMethod("foo");
			RepeatableContainers repeatableContainers = RepeatableContainers.of(LevelA.class,null);
			MergedAnnotations.from(method, SearchStrategy.TYPE_HIERARCHY,
					repeatableContainers) 
					.stream(LevelA.class) 
					/* .stream() .sorted((o1,o2)->Integer.compare(o1.getDistance(), o2.getDistance()))*/
					.forEach(a->{
						System.out.printf("%s\n", a.synthesize());
					});
		} catch (Throwable e) {
			e.printStackTrace();
			fail();
		}
	}

	@Test
	public void test3() {
		try {
			Method method = TestClass.class.getMethod("foo");
			RepeatableContainers repeatableContainers = RepeatableContainers.standardRepeatables();
			MergedAnnotations.from(method, SearchStrategy.TYPE_HIERARCHY, repeatableContainers)
					.stream(LevelA.class)
					.forEach(a->{
						System.out.printf("%s\n", a.synthesize());
					});
		} catch (Throwable e) {
			e.printStackTrace();
			fail();
		}
	}

	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
	@Repeatable(LevelAs.class)
	public @interface LevelA {
		String value();
	}
	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.METHOD })
	public @interface LevelAs {
		LevelA[] value();
	}

	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.ANNOTATION_TYPE,ElementType.METHOD })
	@LevelA("shadows")
	@Repeatable(LevelBs.class)
	public @interface LevelB {
		@AliasFor(annotation = LevelA.class,attribute = "value")
		String value();
	}
	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.METHOD })
	public @interface LevelBs {
		LevelB[] value();
	}

	@Retention(RetentionPolicy.RUNTIME)
	@Target({ ElementType.METHOD })
	@LevelB("shadows")
	public @interface LevelC {
		@AliasFor(annotation = LevelB.class,attribute = "value")
		String value();
	}
	public static class TestClass{
		@LevelB("hello")
		@LevelB("world")
		@LevelA("top1")
		@LevelA("top2")
		@LevelC("jerry")
		public void foo() {};
		@LevelB("hello")
		@LevelA("top1")
		@LevelA("top2")
		@LevelC("jerry")
		public void tar() {};
	}
}
相关推荐
boy快快长大2 分钟前
将大模型生成数据存入Excel,并用增量的方式存入Excel
java·数据库·excel
孟秋与你5 分钟前
【spring】spring单例模式与锁对象作用域的分析
java·spring·单例模式
菜菜-plus8 分钟前
java 设计模式 模板方法模式
java·设计模式·模板方法模式
萨达大9 分钟前
23种设计模式-模板方法(Template Method)设计模式
java·c++·设计模式·软考·模板方法模式·软件设计师·行为型设计模式
tian-ming11 分钟前
(十八)JavaWeb后端开发案例——会话/yml/过滤器/拦截器
java·开发语言·前端
不能只会打代码14 分钟前
大学课程项目中的记忆深刻 Bug —— 一次意外的数组越界
java·github·intellij-idea·话题博客
快意咖啡~20 分钟前
java.nio.charset.MalformedInputException: Input length = 1
java·开发语言·nio
IT枫斗者1 小时前
如何解决Java EasyExcel 导出报内存溢出
java·服务器·开发语言·网络·分布式·物联网
爱编程的小生1 小时前
Easyexcel(4-模板文件)
java·excel
求积分不加C1 小时前
Kafka怎么发送JAVA对象并在消费者端解析出JAVA对象--示例
java·分布式·kafka·linq