Java中 怎么用 Mockito 模拟 AnnotatedElement.getAnnotation 的返回值

舞夢輝影

舞夢輝影

2026-07-29

814人浏览

原创

应 mock class 等具体实现类而非 annotatedelement 接口,因其 getannotation 是可 stub 的普通方法;mock 接口本身因 default 方法限制不可靠。

java中 怎么用 mockito 模拟 annotatedelement.getannotation 的返回值

在 Mockito 中直接模拟 AnnotatedElement.getAnnotation(Class<t>)</t> 方法的返回值,不能用常规的 when(...).thenReturn(...),因为 AnnotatedElement 是一个接口,而 getAnnotation 是它的默认方法(JDK 8+),Mockito 无法对默认方法打桩(除非使用 mockito-inline 并启用默认方法支持)。更常见、更可靠的做法是:**不 mock AnnotatedElement 接口本身,而是 mock 一个具体的实现类(如 Class、Method、Field 等),再对其 getAnnotation 方法进行 stubbing**。

✅ 推荐方式:Mock 具体的 AnnotatedElement 实现(如 Class)

Java 中 ClassMethodFieldConstructor 都实现了 AnnotatedElement。它们的 getAnnotation 是可重写/可 stub 的普通方法(非 default),Mockito 可以正常处理。

例如,mock 一个 Class 对象并指定其返回某个注解:

// 假设有自定义注解 @MyAnnotation
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String value() default "";
}
<p>// 测试中
Class> mockClass = mock(Class.class);
MyAnnotation mockAnn = mock(MyAnnotation.class);
when(mockClass.getAnnotation(MyAnnotation.class)).thenReturn(mockAnn);</p><p>// 使用示例(比如被测代码调用了 clazz.getAnnotation(MyAnnotation.class))
assertThat(mockClass.getAnnotation(MyAnnotation.class)).isSameAs(mockAnn);
</p>

⚠️ 注意事项:避免 mock AnnotatedElement 接口本身

以下写法无效或不可靠

Java Linux版
Java Linux版

Java Linux版下载入口,提供 Oracle JDK 26.0.2 官方 Linux 安装包、Java 环境配置、JDBC 数据库连接和 Java 服务端开发相关信息。

下载
AnnotatedElement mockAE = mock(AnnotatedElement.class); // ❌ 不推荐
when(mockAE.getAnnotation(MyAnnotation.class)).thenReturn(mockAnn); // ⚠️ 可能抛 UnsupportedOperationException 或返回 null

原因:
- AnnotatedElement 是接口,且 getAnnotation 在 JDK 中是 default 方法(自 Java 8 起);
- 经典 Mockito(无 inline)无法 stub 接口的 default 方法;
- 即使启用 mockito-inline,也需额外配置(mock-maker-inline),且行为不如 mock 具体类型稳定。

? 替代方案:使用真实对象 + 自定义注解(更自然)

如果只是为了测试注解存在性或值,最简洁的方式是用真实类 + 运行时注解,无需 mock:

  • 定义一个带 @MyAnnotation 的测试类(或用 @RunWith(MockitoJUnitRunner.class) 配合 @Mock 注入)
  • 通过 SomeClass.class.getAnnotation(MyAnnotation.class) 获取真实注解实例
  • 若需控制注解属性值,可用 TypeTools 或反射构造动态代理,但通常没必要

? 小技巧:快速创建注解代理(按需)

如果必须“伪造”一个注解实例(比如注解类不可实例化),可用 java.lang.reflect.Proxy

MyAnnotation fakeAnn = (MyAnnotation) Proxy.newProxyInstance(
    getClass().getClassLoader(),
    new Class[]{MyAnnotation.class},
    (proxy, method, args) -> {
        if ("value".equals(method.getName())) return "test-value";
        if ("annotationType".equals(method.getName())) return MyAnnotation.class;
        return null;
    }
);
when(mockClass.getAnnotation(MyAnnotation.class)).thenReturn(fakeAnn);

不过多数场景下,直接 mock(MyAnnotation.class) + when(...).thenReturn(...) 已足够。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

3891

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

2861

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

2900

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

638

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

602

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

728

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1318

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

18866

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

647

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

Java 26官方文档
Java 26官方文档

共0课时 | 0人学习