Junit5 单元测试入门

news2025/1/11 21:57:44

基础知识

常用注解含义

@Test：标记一个方法为测试方法
@BeforeEach：标记的方法会在每个测试方法执行前执行
@AfterEach：标记的方法会在每个测试方法执行后执行
@BeforeAll：标记的方法会在所有测试方法执行前执行一次
@AfterAll：标记的方法会在所有测试方法执行后执行一次
@Disabled：用于禁用一个测试方法或测试类
Assertions：JUnit Jupiter 提供了一系列的断言方法，用于测试你的代码的行为。例如：assertEquals(expected, actual)，assertTrue(condition)等
@ParameterizedTest：用于定义参数化测试，可以用不同的参数多次运行同一个测试方法
@ExtendWith：用于定义一个扩展类，扩展类可以改变测试的行为，例如提供依赖注入、处理异常等

初始化Mock对象的三种方式

@ExtendWith(MockitoExtension.class) + @Mock等注解
Mockito.mock(X.class)
MockitoAnnotations.openMocks(this) + @Mock等注解

常见的Mock方法的方式

a. thenReturn()/doReturn()：当需要根据特定的调用来返回一个固定的值

when(mockObject.method()).thenReturn(value);

或 doReturn(value).when(mockObject).method();

b. thenThrow()/doThrow()：当想在方法被调用时抛出一个异常

when(mockObject.method()).thenThrow(new RuntimeException());

或 doThrow(new RuntimeException()).when(mockObject).method();

c. thenAnswer()/doAnswer()：当需要基于输入的参数来返回值，或者需要多次调用返回不同的值

when(mockObject.method(anyString())).thenAnswer(invocation -> {
    Object arg0 = invocation.getArgument(0);

	// do something with arg0

	return null;  });
或

doAnswer(invocation -> {
Object arg0 = invocation.getArgument(0);

// do something with arg0

return null;
}).when(mockObject).method(anyString());

d. thenCallRealMethod()/doCallRealMethod()：当想在调用一个mock对象的方法时，真的调用实现该方法的代码

when(mockObject.method()).thenCallRealMethod();

或：doCallRealMethod().when(mockObject).method();

e. doNothing()：这个用于定义一个方法在被调用时什么都不做，通常用于 mock 一些返回 void 的方法

doNothing().when(mockedList).clear();

注意：doXxx().when(obj).someMethod(); 与 when(obj.someMethod()).thenXxx() 这两种结构在大部分情况下可以互换使用，但在某些特定情况下，它们之间存在一些差异。以下是一些关键的区别：

对于非 void 方法，doReturn().when() 结构可以用在 mock 的方法在调用时抛出异常的情况下，而 when().thenReturn() 结构不能。这是因为 when().thenReturn() 结构会首先调用实际的方法，如果该方法抛出异常，那么程序就不能正常工作。而 doReturn().when() 结构不会调用实际的方法，所以即使方法抛出异常程序也能正常工作
```
 <font style="background-color:#D8DAD9;">doReturn("mocked value").when(mock).method(); // 这里不会调用实际的方法</font>
```
对于 void 方法，doReturn().when() 结构不能用，需要使用 doNothing().when(mock).method()，doThrow().when(mock).method() 或 doAnswer().when(mock).method() 等结构

doNothing().when(mock).method(); // 对于 void 方法，需要使用 doNothing()

因此，根据需求和方法的特性（是否为 void，是否在调用时抛出异常），可以选择适当的结构，在大部分情况下，when().thenReturn() 结构更简洁，更易读，推荐使用。但如果需要处理特殊情况，如上述的情况，就需要使用 doReturn().when() 结构