一、REST Assured框架概述

REST Assured是基于Java的开源接口测试框架，专门为测试RESTful API而设计。它提供了丰富的DSL语法，使得编写接口测试用例更加简洁直观。

二、环境搭建步骤

1. 添加Maven依赖

<dependency>
<groupId>io.rest-assured</groupId>
<artifactId>rest-assured</artifactId>
<version>5.3.0</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.rest-assured</groupId>
<artifactId>json-schema-validator</artifactId>
<version>5.3.0</version>
</dependency>

2. 静态导入

import static io.restassured.RestAssured.*;
import static io.restassured.matcher.RestAssuredMatchers.*;
import static org.hamcrest.Matchers.*;

3. 基本配置

RestAssured.baseURI = "https://api.example.com";
RestAssured.port = 443;

三、核心功能实现

1. GET请求示例

@Test
public void testGetUser() {
given()
.header("Authorization", "Bearer token123")
.param("id", 1)
.when()
.get("/users/{id}")
.then()
.statusCode(200)
.body("name", equalTo("张三"))
.body("age", greaterThan(18));
}

2. POST请求示例

@Test
public void testCreateUser() {
String requestBody = "{\"name\":\"李四\",\"age\":25}";
given()
.contentType(ContentType.JSON)
.body(requestBody)
.when()
.post("/users")
.then()
.statusCode(201)
.body("id", notNullValue());
}

3. JSON Schema验证

@Test
public void testJsonSchema() {
when()
.get("/users/1")
.then()
.assertThat()
.body(matchesJsonSchemaInClasspath("user-schema.json"));
}

四、源码结构解析

REST Assured的核心源码主要包含以下几个模块：

1. RequestSpecification实现类

• 负责构建HTTP请求
• 封装请求头、参数、body等配置
• 支持链式调用语法

2. ResponseSpecification实现类

• 处理HTTP响应
• 提供响应断言功能
• 支持JSON/XML路径提取

3. 验证器模块

• JsonPath：JSON路径解析
• XmlPath：XML路径解析
• JsonSchemaValidator：JSON Schema验证

4. 过滤器机制

• RequestFilter：请求过滤器
• ResponseFilter：响应过滤器
• 支持自定义拦截器

五、高级特性

1. 认证配置

RestAssured.authentication = oauth2(accessToken);
// 或
RestAssured.authentication = basic(username, password);

2. 日志配置

given()
.log().all()
.when()
.get("/users")
.then()
.log().body();

3. 文件上传

given()
.multiPart("file", new File("test.txt"))
.when()
.post("/upload")
.then()
.statusCode(200);

六、最佳实践

1. 配置基地址和端口
2. 使用配置文件管理环境变量
3. 封装通用请求方法
4. 实现数据驱动测试
5. 集成到CI/CD流程

通过合理使用REST Assured框架，可以大大提高接口测试的效率和质量，确保API的稳定性和可靠性。