优化你的 REST Assured 测试：设置默认主机与端口、GET 请求与断言

REST Assured 是一个功能强大的 Java 库，用于测试 RESTful Web 服务。它简化了 API 测试流程，提供了一整套用于高效验证响应的工具。在本篇博客中，我们将深入探讨几个核心概念，包括如何设置默认主机和端口、如何发起 GET 请求以及如何使用 REST Assured 进行断言。不论你是初学者还是有经验的开发者，本指南都能帮助你提升使用 REST Assured 的技能。

设置默认主机和端口

在 REST Assured 中设置默认主机和端口可以简化接口请求流程，统一配置基础 URI，无需在每个请求中都重复指定，大大提高了效率。

// 设置默认主机和端口
given().
  baseUri("http://apipost.example.com").
  port(8080).
when().
  // ...

也可以通过全局变量统一设置默认 base URI 和端口：

RestAssured.baseURI = "http://apipost.example.com";
RestAssured.port = 8080;

when().
  // ...

这样一来，所有接口请求默认都会使用 http://apipost.example.com:8080，除非另行指定其他 URI。

优势：

• 减少代码重复： 避免多次重复 URI 和端口配置。
• 提升代码可读性： 代码更简洁清晰。
• 增强项目结构化： 集中管理配置，更易维护。
• 提升开发效率： 快速搭建和调试接口测试。
• 便于统一变更： 当 URI 改变时，只需修改一处。

发起 GET 请求

GET 请求用于从服务器获取数据。在 REST Assured 中，可以非常方便地发起 GET 请求并验证返回结果。例如，获取用户信息如下：

// 发起 GET 请求
given().
  baseUri("http://apipost.example.com").
  port(8080).
when().
  get("/users/1").
then().
  statusCode(200).
  body("id", equalTo(1)).
  body("name", equalTo("vivek")).
  header("Content-Type", equalTo("application/json"));

说明：

• get("/users/1")： 发起 GET 请求。
• statusCode(200)： 验证 HTTP 响应状态码为 200。
• body("id", equalTo(1))： 验证响应体中的 id 字段值为 1。
• body("name", equalTo("vivek"))： 验证 name 字段值为 "vivek"。
• header("Content-Type", equalTo("application/json"))： 验证响应头的 Content-Type。

REST Assured 还支持多种特性，如设置请求参数、请求头、Cookies 等，适用于多种测试场景。

在 REST Assured 中使用断言

断言用于验证接口行为和响应是否符合预期。REST Assured 提供了丰富的断言方式，支持状态码、响应体、响应头等验证。

示例：验证状态码

// 验证响应状态码
given().
  baseUri("http://apipost.example.com").
  port(8080).
when().
  get("/users/1").
then().
  statusCode(200);

示例：验证响应体和响应头

// 验证响应体内容与响应头
given().
  baseUri("http://apipost.example.com").
  port(8080).
when().
  get("/users/1").
then().
  statusCode(200).
  body("id", equalTo(1)).
  body("name", equalTo("vivek")).
  header("Content-Type", equalTo("application/json"));

常见断言类型：

• 状态码断言： 检查返回的 HTTP 状态码是否正确。
• 响应体断言： 验证返回的 JSON 或 XML 数据内容。
• 响应头断言： 检查 HTTP 头部是否包含特定字段及其值。
• 响应时间断言： 检查接口响应的耗时。
• 结构化数据断言： 验证复杂 JSON/XML 结构及字段值。

常见问题解答（FAQ）

什么是 REST Assured？

REST Assured 是一个用于测试 REST API 的 Java 库，它提供了简洁的接口来发起请求并验证响应。

REST Assured 的核心功能有哪些？

包括设置默认主机与端口、发起 GET 请求以及进行全面的响应断言等。

在 REST Assured 中什么是 GET 请求？

GET 请求是一种用于从服务器获取数据的 HTTP 请求方式，REST Assured 能够简化该过程并提供结果验证。

什么是断言？

断言用于验证接口返回的响应是否符合预期，比如检查状态码、响应内容、头部字段等。

认识 Apipost —— 提升你接口测试效率的利器

如果你希望进一步提升 API 测试效率，强烈推荐试试 Apipost —— 一款面向中国开发者的强大接口测试工具。它专为简化 API 测试流程而设计。

核心亮点：

• 接口文档自动生成： 编写代码后可一键生成接口文档，省去重复劳动。
• 可视化断言： 提供可视化断言管理界面，轻松查看和验证数据。
• 一键同步配置： 自动同步请求配置，确保团队协作一致性。

为什么选择 Apipost？

• 提升测试效率： 自动生成接口、断言可视化，节省大量时间。
• 增强代码可读性： 图形化界面使测试用例更易理解与维护。
• 完美集成开发流程： 与主流开发工具深度适配，真正融入日常开发。

通过将 Apipost 纳入你的测试工具链，你可以将 API 测试工作提升到一个全新的层级，确保接口测试更高效、更可靠。

总结

本篇博客从三个方面介绍了 REST Assured 的使用技巧：如何设置默认主机与端口、如何发送 GET 请求、以及如何进行响应断言。掌握这些关键功能，不仅能提升接口测试的效率和准确性，也让你的测试脚本更加清晰、易于维护。