在 java 单元测试中,使用 mockito 的 when(...).thenreturn(...) 主要是为了模拟(mock)对象的行为,让被测代码在调用特定方法时返回预设的值,从而隔离外部依赖。具体做法是:先通过 @mock 注解或 mockito.mock() 创建模拟对象,然后在测试方法中使用 when(mock.method(args)).thenreturn(value) 定义行为,最后调用被测代码并验证结果。如果参数匹配失败或方法未被调用,可能会抛出异常或导致断言失败。

如何为简单方法设置固定返回值
当需要模拟一个无参或参数固定的方法时,直接指定返回值即可。例如,模拟一个用户服务获取用户名,无论内部逻辑如何,都返回 "Alice"。这能确保测试不依赖真实的数据库或网络请求。

import static org.mockito.Mockito.*;
public class UserServiceTest {
@Mock
private UserRepository userRepository;
@Test
public void testGetUserName() {
// 1. 设置模拟行为:当调用 getUserById(1) 时,返回 "Alice"
when(userRepository.getUserById(1)).thenReturn("Alice");
// 2. 执行被测逻辑
String name = userRepository.getUserById(1);
// 3. 验证结果
assertEquals("Alice", name);
verify(userRepository).getUserById(1); // 确认方法被调用了一次
}
}
上述代码中,when 部分定义了触发条件,thenReturn 定义了响应结果。测试运行后,userRepository.getUserById(1) 将不再执行真实逻辑,而是直接返回字符串 "Alice"。verify 用于确认该方法确实被调用了,这是良好的测试习惯。
如何处理不同参数返回不同值
如果被测代码根据输入参数的不同期望得到不同的结果,可以使用 when(...).thenReturn(...).when(...).thenReturn(...) 链式调用,或者结合 ArgumentCaptor 和 thenAnswer。对于简单的多分支场景,链式调用更直观。例如,模拟根据用户 ID 返回不同名字。
Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。

import static org.mockito.Mockito.*;
public class UserServiceComplexTest {
@Mock
private UserRepository userRepository;
@Test
public void testGetUserByDifferentIds() {
// 1. 设置多个模拟行为
when(userRepository.getUserById(1)).thenReturn("Alice");
when(userRepository.getUserById(2)).thenReturn("Bob");
when(userRepository.getUserById(3)).thenReturn(null); // 模拟不存在的情况
// 2. 执行被测逻辑
String name1 = userRepository.getUserById(1);
String name2 = userRepository.getUserById(2);
String name3 = userRepository.getUserById(3);
// 3. 验证结果
assertEquals("Alice", name1);
assertEquals("Bob", name2);
assertNull(name3);
}
}
在这个例子中,我们为同一个方法 getUserById 设置了三个不同的行为。当传入参数 1 时返回 "Alice",传入 2 时返回 "Bob",传入 3 时返回 null。这种写法清晰地展示了针对不同输入的预期输出。注意,如果传入的参数不在已定义的范围内,Mockito 会返回默认值(如 null、0 或 false),除非使用 thenThrow 显式抛出异常。
当未定义行为时 Mock 对象返回什么
如果在测试中没有为某个方法调用设置 when(...).thenReturn(...),Mockito 会根据返回类型返回默认值。对于引用类型(如 String、Object)返回 null,对于基本类型(如 int, boolean)返回 0 或 false,对于集合返回空集合。这可能导致 NullPointerException 或逻辑错误,因此务必确保所有路径都被覆盖或明确处理。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










