【免费下载】 Mockito 中文文档 ( 2.0.26 beta ) 技术文档

1. 安装指南

1.1 环境要求

• Java 8 或更高版本
• Maven 或 Gradle 构建工具

1.2 添加依赖

在项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>2.0.26-beta</version>
    <scope>test</scope>
</dependency>

或者在 build.gradle 文件中添加以下依赖：

testImplementation 'org.mockito:mockito-core:2.0.26-beta'

1.3 构建项目

使用 Maven 或 Gradle 构建项目，确保依赖项正确下载并集成到项目中。

2. 项目的使用说明

2.1 创建 Mock 对象

使用 Mockito.mock() 方法创建 Mock 对象：

import static org.mockito.Mockito.*;

List mockedList = mock(List.class);

2.2 验证行为

验证 Mock 对象的方法是否被调用：

mockedList.add("one");
verify(mockedList).add("one");

2.3 打桩 (Stubbing)

为 Mock 对象的方法设置返回值或抛出异常：

when(mockedList.get(0)).thenReturn("first");
when(mockedList.get(1)).thenThrow(new RuntimeException());

2.4 参数匹配器

使用参数匹配器进行更灵活的验证和打桩：

when(mockedList.get(anyInt())).thenReturn("element");
verify(mockedList).get(anyInt());

3. 项目API使用文档

3.1 常用API

• mock(Class<T> classToMock)：创建一个 Mock 对象。
• when(T methodCall).thenReturn(T value)：为方法设置返回值。
• verify(T mock).method()：验证方法是否被调用。
• anyInt(), anyString(), any(Class<T> type)：参数匹配器。

3.2 高级API

• doThrow(Throwable toBeThrown).when(mock).method()：为返回值为 void 的方法设置抛出异常。
• inOrder(Object... mocks)：验证方法调用的顺序。
• verifyZeroInteractions(Object... mocks)：验证没有与 Mock 对象进行交互。
• verifyNoMoreInteractions(Object... mocks)：验证没有冗余的调用。

4. 项目安装方式

4.1 Maven 安装

在 pom.xml 中添加依赖：

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>2.0.26-beta</version>
    <scope>test</scope>
</dependency>

4.2 Gradle 安装

在 build.gradle 中添加依赖：

testImplementation 'org.mockito:mockito-core:2.0.26-beta'

4.3 手动安装

从 Mockito 官方网站 下载 JAR 文件，并将其添加到项目的 lib 目录中。

通过以上步骤，您可以成功安装并使用 Mockito 框架进行单元测试。