介绍
Fastify 是一款高性能的 Node.js Web 框架，它具有非常低的开销和生产力，适用于构建现代 Web 应用程序和服务。同时，Swagger UI 是一种流行的工具，用于在 UI 中呈现和测试 API 文档，它可以帮助开发人员快速查找和理解 API 文档，降低应用程序的开发风险。
在这篇文章中，我们将探讨如何使用 Fastify 和 Swagger UI 构建 API 文档站点，让 API 开发更加高效和可维护。
安装
在构建 Fastify 应用程序之前，需要先安装 Fastify 以及相应的 Swagger UI 测试工具。
在本文章中，我们将使用 npm 来安装 Fastify 和 Swagger UI：
$ npm install fastify $ npm install fastify-swagger swagger-ui-fastify
初始化
首先，让我们快速初始化一个 Fastify 应用程序。在根目录下创建一个名为 index.js 的文件，然后添加以下代码：
-- -------------------- ---- ------- ----- ------- - -------------------- ------- ---- -- ---------------- ----- --------- ------ -- - ------ - ------ ------- - -- -------------------- ----- -------- -- - -- ----- ----- --- ------------------- --------- -- ------------ --
这是一个非常简单的 Fastify 应用程序，它只有一个路由处理器（route handler），用于将响应与 hello 和 world 组成的简单 JSON 对象返回到客户端。
添加 Swagger UI
要使用 Swagger UI 与 Fastify 集成，我们需要安装fastify-swagger和swagger-ui-fastify依赖。这两个依赖项将使我们能够轻松地将 Swagger UI 添加到 Fastify 应用程序中。以下是如何配置 Swagger UI 与 Fastify 集成的示例代码：
-- -------------------- ---- -------
----- ------- - -------------------- ------- ---- --
----- ------- - --------------------------
----- --------- - -----------------------------
------------------------- -
------------ --------
-------- -
----- - ------ ----- ---- -
--
------------ ----
--
--------------------------- -
------- -------
--
---------------- ----- --------- ------ -- -
------ - ------ ------- -
--
-------------------- ----- -------- -- -
-- ----- ----- ---
------------------- --------- -- ------------
--上面的代码添加了两个路由处理程序，一个用于将 Swagger UI 与 Fastify 集成，另一个用于显示 API 文档页。Swagger UI 将在 /docs 子路径下定义 fastify-swagger 路由。为了进行测试，您可以访问 http://localhost:3000/docs 并打开 Swagger UI。
编写 API 文档
现在我们已经集成了 Swagger UI，我们可以开始添加 API 文档。Fastify 和fastify-swagger使得创建 API 文档变得容易。例如，我们可以为 /api/greet 使用调用 Fastify 插件的方法定义 API 文档，如下所示：
-- -------------------- ---- -------
------------------- ----- --------- ------ -- -
------ - -------- ----- -
--
------------------------- -
------- -
--------- -
---- -
----- ---------
----------- -
---- - ----- -------- -
-
-
-
-
-- ----- --------- ------ -- -
------ - ---- ------ ------ -
--/api/greet 的路由处理器包含一个 Swagger 验证对象，该对象声明了所有的响应类型。此方法用于帮助 Fastify 自动生成 Swagger 文档。
Swagger 配置
最后，您可以使用一些附加参数来定义一些高级 Swagger 配置。例如，您可以定义 consumes 和 produces 属性：
-- -------------------- ---- -------
-------------------------------- ----- --------- ------ -- -
------ -----------------------
--
--------------------------- -
------- --------
--------------- -
----- -
-
---- --------------------
----- ---- --------------
-
--
--------- ---------------------
--------- ---------------------
------------- ----
-
--在上面的代码中，我们向 Swagger UI 添加了一个 /api/swagger.json 路径，以生成 API 文档。然后，我们将 consumes 和 produces 属性设置为 application/json 以告知客户端 JSON 关键字进行数据传输。
结论
在本文中，我们介绍了如何结合 Fastify 和 Swagger UI 构建 API 文档站点，并深入了解了这两种技术的优点。通过结合 Fastify 和 Swagger UI，您可以更轻松地了解 API 的设计、参数和响应类型，并更容易地进行 API 测试和维护。
请记得下载示例代码并试用，以便您可以更好地理解本文所述的内容。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66fa6afb44713626014c30db