mockito 的 atleast 方法用于验证 mock 对象的方法被调用的次数是否达到指定下限。具体做法是调用 verify(mock, atleast(n)),其中 n 是期望的最小调用次数。如果实际调用次数小于 n,测试将失败;若大于或等于 n,则验证通过。

如何验证方法至少被调用一次?
要验证方法至少被调用一次,可以使用 atLeast(1) 参数。这通常用于确保某些副作用(如日志记录、状态更新)确实发生了,即使无法确定确切调用次数。例如,验证一个服务方法在业务逻辑执行期间至少触发了一次通知发送。

import static org.mockito.Mockito.*;
public class NotificationServiceTest {
@Test
public void testNotificationSentAtLeastOnce() {
// 1. 准备:创建 Mock 和 SUT
EmailSender emailSender = mock(EmailSender.class);
NotificationService service = new NotificationService(emailSender);
// 2. 执行:触发业务逻辑
service.processOrder("ORDER-123");
// 3. 验证:检查 sendEmail 至少被调用 1 次
verify(emailSender, atLeast(1)).sendEmail(anyString(), anyString());
}
}
// 假设的 SUT 代码片段
// class NotificationService {
// private final EmailSender emailSender;
// public NotificationService(EmailSender sender) { this.emailSender = sender; }
// public void processOrder(String orderId) {
// if (orderId.startsWith("ORDER")) {
// emailSender.sendEmail("admin@test.com", "New Order: " + orderId);
// }
// }
// }
预期结果:verify 成功,因为 processOrder 内部调用了 sendEmail 一次。如果注释掉 emailSender.sendEmail 调用,测试将抛出 Wanted but not invoked 异常。
如何验证方法至少被调用多次?
当需要确保某个操作重复执行时,可使用 atLeast(n) 其中 n > 1。例如,在处理批量数据时,验证每个条目都触发了数据库保存操作。使用 atLeast(3) 可确保方法至少被调用三次,忽略多余调用。

import static org.mockito.Mockito.*;
public class BatchProcessorTest {
@Test
public void testBatchSaveAtLeastThreeTimes() {
// 1. 准备
DatabaseRepo repo = mock(DatabaseRepo.class);
BatchProcessor processor = new BatchProcessor(repo);
// 2. 执行:处理 5 个元素
List<string> items = List.of("A", "B", "C", "D", "E");
processor.saveAll(items);
// 3. 验证:save 至少被调用 3 次
verify(repo, atLeast(3)).save(anyString());
}
}
// 假设的 SUT 代码片段
// class BatchProcessor {
// private final DatabaseRepo repo;
// public BatchProcessor(DatabaseRepo r) { this.repo = r; }
// public void saveAll(List<string> items) {
// for (String item : items) {
// repo.save(item); // 循环调用 save
// }
// }
// }</string></string>
预期结果:verify 成功,因为循环调用了 save 五次,满足“至少三次”的条件。若只传入两个元素,测试将失败。
当实际调用次数少于 atLeast 要求时会发生什么?
如果实际调用次数小于 atLeast(n) 中的 n,Mockito 会抛出 Wanted but not invoked 类型的 TooFewActualInvocations 异常。该异常明确指出期望最少调用次数与实际调用次数的差异。例如,若使用 atLeast(2) 但方法仅调用一次,测试将报错并显示实际调用计数为 1。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











