前言
在现代软件开发中,我们经常需要与第三方服务交互,而服务之间的通信是一个复杂的过程。为了保证不同服务之间的数据交互的一致性和可靠性,常常需要使用到 contract testing 技术。Pact 就是一种流行的 contract testing 工具,它提供了一个基于契约的测试框架,可以确保服务之间的交互总是按照约定的规则进行。
Pact 同时还提供了很多语言的实现库,其中包括了多个 Node.js 实现库。在本文中,我们将介绍如何使用 Pact 的 Node.js 实现库中的一个特定的包 @pact-foundation/pact-standalone-linux-ia32。
@pact-foundation/pact-standalone-linux-ia32 简介
@pact-foundation/pact-standalone-linux-ia32 是 Pact Node.js 实现库中的一个包,该包是一个用于运行 Pact Broker 的全新工具包。 它为您提供了一个单独的二进制文件,其中包括了 Pact Broker 的所有必要组件和依赖项,您无需安装和配置其他工具即可立即运行 Pact Broker。
本教程将向您展示如何安装和配置 @pact-foundation/pact-standalone-linux-ia32,以及如何使用它来运行 Pact Broker。
安装 @pact-foundation/pact-standalone-linux-ia32
确定您的系统是 linux 32 位。
首先,安装 Node.js 的最新版本。您可以从 https://nodejs.org/en/ 下载。
然后使用npm 安装 @pact-foundation/pact-standalone-linux-ia32。在终端运行以下命令:
npm install @pact-foundation/pact-standalone-linux-ia32
配置 Pact Broker
- 创建一个文件夹作为 Pact Broker 的工作目录。
- 将 Pact Broker 配置文件存储在此工作目录中。
- 如果您没有默认的 Pact Broker 配置文件,请从 https://github.com/pact-foundation/pact_broker/blob/master/configuration.ru 链接下载该文件。将其重命名为 config.ru 并放入工作目录中。
运行 Pact Broker
在您的工作目录下,打开终端并输入以下命令:
npx pact-broker start --standalone-linux-ia32
执行此命令后,Pact Broker 将在本地启动并准备好接收契约测试结果。
使用 Pact Broker
在 Pact Broker 上创建一个 API 提供者和消费者。 在本例中,我们将使用 Node.js 编写提供者和消费者。
1. 准备 provider 端
安装以下库:
npm install --save-dev @pact-foundation/pact node-fetch
编写测试用例:
-- -------------------- ---- ------- ----- ---- - ---------------- ----- - ---- - - --------------------------------- ----- ----- - ---------------------- ------------------ ----- -- -- - ----- -------- - --- ------ ----- ----- -- -- -------- ---- ---- --------------------------- ------- ------------ ---- --------------------------- --------- -- ---- ------- --------- ----------- --------- ----------- ----- - --- -- -- -------- ------------ -- ------------------ -- -- -------- ------------ -- ------------------- -- -- -------- ----------- -- --------------------- -------------- - ------- -- ---- --- -------- -- ------ -- -- - ------------- -- - ------ ------------------------- ----- - -------- - ------- ------ ----- --------------- -------- - ------- ------------------ - -- --------- - ------- ---- -------- - --------------- ------------------ -- ----- - --------- - - --- -- ----- ----- -------- - - - - - --- --- ----------- -- ----- -- ---------- ------ -- - ----- --- - ------------------------------------ ---------- - ------- ------ -------- - ------- ------------------ - -- ----------- -- - -------------------------------- ------ ----------- -- ------------ -- - ------------------------------------ ------------------------------------------------ ------- -- ------------------ --- --- ---
执行测试:
npm run test
执行过程中,Pact 将生成契约文件,我们可以在观察下面的文件结构,查看文件是否生成:
pacts/ └── consumer-provider.json
2. 准备 consumer 端
安装以下库:
npm install --save-dev @pact-foundation/pact node-fetch
编写测试用例:
-- -------------------- ---- ------- ----- ---- - ---------------- ----- - ---- - - --------------------------------- ----- ----- - ---------------------- ------------------ ----- -- -- - ----- -------- - --- ------ ----- ----- ---- --------------------------- ------- ------------ ---- --------------------------- --------- --------- ----------- --------- ----------- ----- - --- -- -- -------- ------------ -- ------------------ -- -- -------- ------------ -- ------------------- -- -- -------- ----------- -- --------------------- -------------- - ------- -- ---- --- -------- -- ------ -- -- - ------------- -- - ------ ------------------------- ------ ---- ---------- -------------- -- ------- -- ---- --- ---------- ------------ - ------- ------ ----- --------------- -------- - ------- ------------------ - -- ---------------- - ------- ---- -------- - --------------- ------------------ -- ----- - --------- - - --- -- ----- ----- -------- - - - - --- --- ----------- -- ----- -- ---------- ------ -- - ----- --- - ------------------------------------ ---------- - ------- ------ -------- - ------- ------------------ - -- ----------- -- - -------------------------------- ------ ----------- -- ------------ -- - ------------------------------------ ------------------------------------------------ ------- -- ------------------ --- --- ---
执行测试:
npm run test
在完成了两端的测试后,可以再查询下 pacts/
目录是否生成了新的契约文件。
总结
在本文中,我们介绍了 Node.js Pact 实现库中的一个特别的包 @pact-foundation/pact-standalone-linux-ia32。我们学习了如何安装和配置它,以及如何使用它来运行 Pact Broker。
最后通过一个使用 contract testing 的示例,演示了如何在 Consumer 和 Provider 两端并行地进行测试。
Pact 是一种非常流行的 contract testing 工具,它可以为我们提供一个更加可靠和稳定的服务间通信解决方案。也希望本文内容能够为你在日常开发中运用和理解 Pact 提供一些帮助和指导。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60057c2081e8991b448ebb6b