Junit5：如何进行RESTful API接口测试

# 1. 简介

## 1.1 什么是RESTful API接口

RESTful API（Representational State Transfer，简称REST）是一种设计风格，用于构建网络应用程序的接口。它是一种基于HTTP协议的架构风格，通过使用不同的HTTP方法（如GET、POST、PUT、DELETE等）来实现对资源的操作。

RESTful API接口的特点：
- 统一接口：使用统一的HTTP方法和URL来进行资源操作。
- 无状态：每次请求与服务器的通信是独立的，服务器不会保留客户端的状态。
- 可缓存：对于相同的请求，服务器可以返回缓存的结果，提高性能。
- 客户端-服务器架构：客户端与服务器之间通过网络进行通信。
- 面向资源：API的设计要以资源为核心，通过URL来定位资源。
- 分层系统：服务器端可以使用代理、负载均衡等技术来实现分层结构。

## 1.2 Junit5简介

Junit5是基于JUnit平台的一套全新的测试框架，用于编写和执行单元测试。它具有新的架构、功能强大的扩展能力和灵活的测试用例编写风格。

Junit5的特点：
- 模块化：采用模块化架构，提供了JUnit Jupiter、JUnit Vintage和JUnit Platform三个核心模块。
- 支持Java 8+：Junit5支持Java 8及以上的版本，可以使用Java 8的新特性，如Lambda表达式、方法引用等。
- 注解驱动：使用注解来编写测试用例，简洁明了。
- 扩展性：Junit5支持自定义扩展，可以集成其他测试框架、插件和工具。

Junit5提供了丰富的断言方法、生命周期回调、参数化测试、动态测试等功能，使得单元测试更加灵活和可扩展。接下来的章节中，我们将结合Junit5来进行RESTful API接口的测试。

# 2. Junit5基础

### 2.1 Junit5的安装与配置

#### 安装步骤

1. 首先，下载JUnit5的安装包并解压。
2. 将JUnit5的JAR文件添加到项目的依赖中。
3. 配置构建工具（如Maven或Gradle）以使用JUnit5。

#### 配置JUnit5依赖

使用Maven的例子：

<dependencies>
    <!-- JUnit Jupiter API -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.8.0</version>
        <scope>test</scope>
    </dependency>

    <!-- JUnit Jupiter Engine -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.8.0</version>
        <scope>test</scope>
    </dependency>

    <!-- JUnit Vintage Engine -->
    <dependency>
        <groupId>org.junit.vintage</groupId>
        <artifactId>junit-vintage-engine</artifactId>
        <version>5.8.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

#### 配置构建工具

使用Maven的例子：

在pom.xml文件中添加以下配置：

<build>
    <plugins>
        <!-- Maven Surefire Plugin -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M5</version>
        </plugin>
    </plugins>
</build>

### 2.2 Junit5的基本使用方法

#### 基本注解

- `@Test`：用于标记测试方法。
- `@BeforeEach`：在每个测试方法之前执行。
- `@AfterEach`：在每个测试方法之后执行。
- `@BeforeAll`：在所有测试方法之前执行，且只执行一次。
- `@AfterAll`：在所有测试方法之后执行，且只执行一次。

#### 断言方法

JUnit5提供了一些常用的断言方法，用于验证测试结果。

- `assertEquals(expected, actual)`：验证两个值是否相等。
- `assertTrue(condition)`：验证条件是否为真。
- `assertFalse(condition)`：验证条件是否为假。
- `assertNotNull(object)`：验证对象是否不为空。
- `assertNull(object)`：验证对象是否为空。

#### 示例代码

import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;

class CalculatorTest {

    private Calculator calculator;

    @BeforeEach
    void setUp() {
        calculator = new Calculator();
    }

    @Test
    void testAdd() {
        int result = calculator.add(2, 3);
        assertEquals(5, result, "2 + 3 should equal to 5");
    }

    @Test
    void testSubtract() {
        int result = calculator.subtract(5, 2);
        assertEquals(3, result, "5 - 2