Junit5 单元测试入门

基础知识

常用注解含义

• @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 arg0return null;  });

或

doAnswer(invocation -> {

Object arg0 = invocation.getArgument(0);// do something with arg0return 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() 结构

常见的断言方式

在JUnit 5中，我们通常使用org.junit.jupiter.api.Assertions类中的静态方法来进行断言。以下是几种常见的断言方式：

1. assertTrue(boolean condition)/assertFalse(boolean condition)：断言条件是否为真

例如：assertFalse(5 < 4);

2. assertEquals(Object expected, Object actual)/assertNotEquals(Object unexpected, Object actual)：断言两个对象是否相等

例如：assertEquals(5, 5);

3. assertNull(Object actual)/assertNotNull(Object actual)：断言对象s是否为空

assertNotNull(new Object());

4. assertSame(Object expected, Object actual)/assertNotSame(Object unexpected, Object actual)：断言两个对象是否引用同一个对象

String str1 = “test”;

String str2 = str1;

assertSame(str1, str2);

5. assertArrayEquals(Object[] expected, Object[] actual)：断言两个数组是否相等

assertArrayEquals(new int[] {1, 2, 3}, new int[] {1, 2, 3});

6. assertThrows(Class<? extends Throwable> expectedType, Executable executable)：断言执行某段代码是否会抛出特定类型的异常。

assertThrows(NullPointerException.class, () -> {

throw new NullPointerException();

});

此外，Mockito 的 verify() 方法被用来确认某个特定的方法是否被调用了指定的次数

例如，如果想确认某个mock对象的某个方法是否被调用过：

Mockito.verify(mockObject).method();

如果想确认某个方法被调用了特定的次数：

Mockito.verify(mockObject, times(5)).method();

如果想确认某个方法从未被调用过：

Mockito.verify(mockObject, never()).method();

覆盖度查看

源代码中绿色区域为已被测试覆盖，红色区域为未被测试覆盖

注意：IDEA和JaCoCo计算代码覆盖率的方式略有不同，例如：JaCoCo提供了分支覆盖，而IDEA可能只提供了线性代码覆盖，假如代码中包含了复杂的条件逻辑，那么这可能会导致覆盖率的差异。在IDEA中看到的覆盖度会比在JaCoCo中的高