mockito 的 @captor 用于捕获传递给被模拟对象方法的参数,以便在测试中验证这些参数的具体值。使用它需要配合 @mock 创建模拟对象,并用 argumentcaptor 实例化字段,调用被测方法后通过 captor.capture() 获取参数,最后用 assertj 或 hamcrest 等断言库检查捕获的值。

如何捕获单个简单类型的参数
当被测方法只接收一个基本类型或字符串参数时,可以直接定义 ArgumentCaptor 并指定泛型类型。调用被测逻辑后,使用 captor.getValue() 获取唯一一次调用的参数值并进行断言。如果方法被多次调用,getValue() 会抛出异常,此时应改用 getAllValues() 获取列表。

import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.ArgumentCaptor;
import org.mockito.Captor;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
@ExtendWith(MockitoExtension.class)
class SimpleCaptureTest {
@Mock
private MyService myService;
@Captor
private ArgumentCaptor<string> stringCaptor;
@Test
void shouldCaptureSingleValue() {
// Given
when(myService.process(anyString())).thenReturn(true);
// When
myService.process("test-data");
// Then
verify(myService).process(stringCaptor.capture());
assertEquals("test-data", stringCaptor.getValue());
}
}</string>
如何捕获复杂对象或集合参数
对于自定义对象或集合,@Captor 同样适用。只需将泛型类型改为对应的类即可。捕获后,可以访问对象的属性或集合的大小、内容。这在验证业务逻辑是否正确组装了数据时非常有用。注意,如果传递的是可变对象,捕获的是引用,后续修改可能影响断言结果,建议对捕获值进行深拷贝或使用不可变对象进行断言。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;
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.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
@ExtendWith(MockitoExtension.class)
class ComplexCaptureTest {
@Mock
private OrderRepository orderRepository;
@Captor
private ArgumentCaptor<order> orderCaptor;
@Test
void shouldCaptureComplexObject() {
// Given
doNothing().when(orderRepository).save(any(Order.class));
// When
Order order = new Order("ORD-001", 100.0);
orderRepository.save(order);
// Then
verify(orderRepository).save(orderCaptor.capture());
Order capturedOrder = orderCaptor.getValue();
assertEquals("ORD-001", capturedOrder.getId());
assertEquals(100.0, capturedOrder.getAmount(), 0.01);
}
}
class Order {
private String id;
private double amount;
public Order(String id, double amount) {
this.id = id;
this.amount = amount;
}
public String getId() { return id; }
public double getAmount() { return amount; }
}</order>
当方法被多次调用时如何获取所有参数
如果被测方法在单次测试执行中被多次调用,且你需要验证每一次调用的参数,可以使用 captor.getAllValues()。该方法返回一个包含所有捕获参数的列表,按调用顺序排列。你可以检查列表的大小,或者遍历列表逐一断言。这适用于批量处理、循环调用或重试机制的场景。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










