讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Java 单元测试怎么用 @Captor 捕获方法参数

阿辰吖_2334

阿辰吖_2334

发布时间:2026-11-20 13:31:19

|

660人浏览过

|

来源于php中文网

原创

使用 @captor 捕获方法参数,核心在于配合 mockito 的 argumentcaptor 类。在测试类中声明一个类型为 argumentcaptor<t></t> 的字段并加上 @captor 注解,mockito 会在测试初始化时自动实例化该对象。随后在调用被测试代码后,通过 captor.capture() 获取实际传入的参数值进行断言验证。

Java 单元测试怎么用 @Captor 捕获方法参数

如何定义和初始化 ArgumentCaptor 字段

需要在测试类中使用 @Mock 或 @InjectMocks 配合 @ExtendWith(MockitoExtension.class)(JUnit 5)或 @RunWith(MockitoJUnitRunner.class)(JUnit 4)来启动 Mockito 上下文。只有在这个上下文中,@Captor 注解才会生效,否则 ArgumentCaptor 实例为 null 会导致空指针异常。

Java 单元测试怎么用 @Captor 捕获方法参数

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.ArgumentCaptor;
import org.mockito.Captor;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.Mockito.verify;

@ExtendWith(MockitoExtension.class)
class UserServiceTest {

    @Mock
    private EmailService emailService;

    @InjectMocks
    private UserService userService;

    @Captor
    private ArgumentCaptor<String> emailCaptor;

    @Test
    void shouldCaptureEmailWhenUserCreated() {
        // 执行被测方法
        userService.createUser("john@example.com");

        // 验证交互并捕获参数
        verify(emailService).sendWelcomeEmail(emailCaptor.capture());

        // 使用捕获的值进行断言
        assertThat(emailCaptor.getValue()).isEqualTo("john@example.com");
    }
}

上述代码展示了完整的结构。@Captor 标注的字段不需要手动 new,Mockito 扩展会自动处理。关键在于 verify(...).capture() 这一调用,它告诉 Mockito 将传递给 sendWelcomeEmail 的第一个字符串参数存入 emailCaptor 中。之后通过 getValue() 提取该值。

立即学习“Java免费学习笔记(深入)”;

FilePond 灵活的 JavaScript 文件上传库
FilePond 灵活的 JavaScript 文件上传库

FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

下载

如何处理多次调用时的参数捕获

当被调用的方法被执行了多次,或者需要捕获所有传入的参数列表时,单一值的 getValue() 可能不够用。此时应使用 getAllValues() 方法来获取一个包含所有捕获参数的 List。这通常用于验证重试逻辑、批量操作或循环内的行为。

Java 单元测试怎么用 @Captor 捕获方法参数

import java.util.List;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.ArgumentCaptor;
import org.mockito.Captor;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.Mockito.times;
import static org.mockito.Mockito.verify;

@ExtendWith(MockitoExtension.class)
class NotificationServiceTest {

    @Mock
    private SmsGateway smsGateway;

    @InjectMocks
    private NotificationService notificationService;

    @Captor
    private ArgumentCaptor<String> messageCaptor;

    @Test
    void shouldCaptureAllMessagesOnBatchSend() {
        // 执行批量发送逻辑
        notificationService.sendBatchNotifications();

        // 验证调用次数并捕获所有消息
        verify(smsGateway, times(3)).sendMessage(messageCaptor.capture());

        // 获取所有捕获的消息
        List<String> capturedMessages = messageCaptor.getAllValues();

        // 验证捕获到的消息列表
        assertThat(capturedMessages).hasSize(3);
        assertThat(capturedMessages).containsExactly(
            "Alert: System Low",
            "Alert: Disk Full",
            "Alert: CPU High"
        );
    }
}

在这个场景中,times(3) 确保方法被调用了三次。messageCaptor.capture() 在每次调用时都会将参数追加到内部列表中。最后通过 getAllValues() 一次性取出所有参数,形成一个 List<string></string>。这种方式比分别调用 getValue() 三次更可靠,因为它直接反映了调用序列中的所有输入数据,避免了因调用顺序不确定导致的断言失败。

捕获复杂对象类型时的注意事项

当参数是自定义对象而非基本类型或 String 时,ArgumentCaptor 捕获的是对象的引用。如果在测试断言前修改了该对象的状态,或者被测试代码在捕获后继续修改了该对象,可能会导致断言结果不符合预期。此外,对于复杂对象,建议使用 argThat 匹配器结合 ArgumentMatcher 进行更灵活的验证,或者在捕获后立即克隆对象以确保状态隔离。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
java
java

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

13017

2023.06.15

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

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

10082

2023.07.05

java自学难吗
java自学难吗

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

8552

2023.07.31

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

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

1364

2023.08.01

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

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

1068

2023.08.02

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

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

1636

2023.08.02

java有什么用
java有什么用

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

3409

2023.08.02

java在线网站
java在线网站

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

20631

2023.08.03

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn