转载

JUnit 5 使用 Mockito 2 进行测试

JUnit 5 刚出来那时，也就是第一个版本 5.0.0 时，还不能很好的支持 Mockito 的测试，因为 Mockito 没能跟得那么紧密。那时候 JUnit 5 只能试验性的提供了一个极不正式的 com.example.mockito.MockitoExtension , 看那包名就知道不是来真的，所以决定再等。JUnit 5 不再原生支持 JUnit 4 的 Rule，一切都将是 Extension，那也是要求 Mockito 能够与之俱进。现在等来了，JUnit 5 进化到了 5.2.0, Mockito 也早已有了一个单独的模块 mockito-junit-jupiter 来迎接它。

在 Mockito 2.1.0 的 What's new in Mockito 2 中记述了 JUnit 5 为 Mockito 2 开发了一个 MockitoExtension。追溯到 Mockito 2 的 Release Notes, 我们发现 Mockito 2 官方最早引入 MockitoExtension 的版本是 2.16.3(2018-03023)。我对 Mockito 对 JUnit 5 支持的最新更新是从这个 Pull Request MockitoExtension for JUnit5 得知的。

一句话讲就是现在的 Mockito 2 有原生态的 MockitoExtension 来支援 JUnit 5, 可以非常放心可靠的让 JUnit 5 和 Mockito 2 一起稳定工作。因此前面那个包名带 example 字样的 MockitoExtension 链接也就无效了。

下面来体验一下那个 MockioExtension，测试当中需要的依赖包含 junit-jupiter-engine 和 mockito-junit-jupiter

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.2.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>2.18.3</version>
    <scope>test</scope>
</dependency>

都取了当前在 Maven 中央仓库的最新版本。

在 IntelliJ IDEA 2018.1.3 版本中运行接下来的测试用例，连 jnit-jupiter-engine 都可以不要，看来 IntelliJ IDEA 自带了 jupiter-api 实现。Maven 命令可不行，而且 Maven 还要插件依赖 junit-platform-surefire-provider 才能执行。

首先我们要有一个被测试类 UserService

public class UserService {
    private List<String> users;
 
    public UserService(List<String> users) {
       this.users = users;
    }
 
    public void addUser(String name) {
        users.add(name);
    }
}

然后创建它的测试用例 UserServiceTest

package cc.unmi;
 
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
 
import java.util.List;
 
import static org.mockito.Mockito.times;
import static org.mockito.Mockito.verify;
 
@ExtendWith(MockitoExtension.class)
public class UserServiceTest {
 
    @Mock
    private List<String> users;
 
    @InjectMocks
    private UserService userService;
 
    @Test
    @DisplayName("Should add a user to list")
    public void shouldAddUserToList() {
        userService.addUser("hello");
 
        verify(users, times(1)).add("hello");
    }
}

JUnit 5 下只能用 @ExtendWith , 找不到 @RunWith 了，虽然 MockitoJUnitRunner 还在，可它是为 JUnit 4 准备的。

在 IntelliJ IDEA 中运行该测试

JUnit 5 使用 Mockito 2 进行测试

一切工作正常，方法被 Mock, Mock 对象自动被注入， @DisplayName 也正常显示

若要用 mvn test 在控制台下运行测试用例，还要为 maven-surefire-plugin 加上一个内部依赖，在 pom.xml 文件中

<build>
    <plugins>
        <plugin>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.21.0</version>
            <dependencies>
                <dependency>
                    <groupId>org.junit.platform</groupId>
                    <artifactId>junit-platform-surefire-provider</artifactId>
                    <version>1.2.0</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

然后执行控制台命令