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

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

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 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
如何处理多次调用时的参数捕获
当被调用的方法被执行了多次,或者需要捕获所有传入的参数列表时,单一值的 getValue() 可能不够用。此时应使用 getAllValues() 方法来获取一个包含所有捕获参数的 List。这通常用于验证重试逻辑、批量操作或循环内的行为。

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 进行更灵活的验证,或者在捕获后立即克隆对象以确保状态隔离。

















