Swagger 是一个流行的 API 开发工具，可以自动生成 API 文档、代码样例以及提供运行时测试等功能。Deno 是一个新兴的 JavaScript 运行时环境，以其安全、稳定等特点备受关注。在本文中，我们将介绍如何在 Deno 中使用 Swagger 进行 API 文档生成，以及如何通过 Swagger 提供的功能帮助我们更好地开发和测试 API。
安装 Swagger
Swagger 的 Deno 版本提供了一个方便的 CLI 工具，可以快速集成到我们的项目中。在终端中执行以下命令即可完成 Swagger 的安装：
deno install -n swagger https://deno.land/x/deno_swagger_cli/mod.ts
安装完成后，我们可以通过执行以下命令来验证是否安装完成：
swagger --help
如果输出了 Swagger 的帮助文档，则说明安装成功。
定义 API 文档
Swagger 的一个重要特性是通过 YAML 或 JSON 格式的文档来定义 API。这个文档不仅可以自动生成文档，还可以为代码样例、运行时测试提供必要的信息。下面是一个简单的 Swagger YAML 文档：
-- -------------------- ---- -------
-------- -----
-----
------ -- ---
-------- ---
------
-------
----
-------- --- ----- ----- -------
----------
------
------------ --
--------
-----------------
-------
----- ------
-----------
--------
----- ------这个文档定义了一个名为 /hello 的 API，它使用了 HTTP GET 方法来获取一个 JSON 对象，其中包含一个 message 字段。我们可以通过 Swagger 提供的工具来生成代码样例、运行时测试等内容。
使用 Swagger-UI 查看文档
Swagger-UI 是 Swagger 的一个开源项目，提供了一种非常直观的方式来查看 API 文档。Swagger-UI 的 Deno 版本同样提供了一个 CLI 工具，可以快速在浏览器中打开并查看 Swagger 文档。在终端中执行以下命令即可启动 Swagger-UI：
swagger-ui --file=path/to/swagger.yaml
其中，path/to/swagger.yaml 应该替换为实际的 Swagger 文档路径。启动完成后，浏览器会自动打开 Swagger-UI，我们可以直接在浏览器中查看和测试 API。
使用 Swagger Codegen 生成代码样例
Swagger Codegen 可以根据 Swagger 文档中的 API 定义生成对应的代码样例。这种方式可将大量的样板代码自动生成，让我们能够更专注地进行业务开发。在 Deno 中使用 Swagger Codegen 同样非常容易，只需要执行以下命令即可：
swagger-codegen generate --input-spec=path/to/swagger.yaml --lang=typescript
其中，path/to/swagger.yaml 应该替换为实际的 Swagger 文档路径。生成完成后，我们将在当前目录下找到一个以 TypeScript 为基础的项目，其中已经包含了与 API 对应的所有请求、响应对象的定义，以及用于调用 API 的客户端代码。
使用 Swagger Inspector 进行运行时测试
Swagger Inspector 是 Swagger 提供的一个在线工具，可以让我们非常便捷地对 API 进行测试。在 Deno 中，我们可以使用 Swagger Inspector 的 Deno CLI 工具来方便地进行集成。在终端中执行以下命令即可安装 Swagger Inspector CLI：
deno install -n swapi https://deno.land/x/deno_swagger_inspector_cli/mod.ts
安装完成后，我们可以通过以下命令启动 Swagger Inspector：
swapi start
然后在浏览器中打开 http://localhost:8080，我们就可以看到 Swagger Inspector 的界面了。在这里，我们可以轻松添加测试用例，并通过一系列快捷键来方便地切换不同的测试场景。
结论
在本文中，我们介绍了如何在 Deno 中使用 Swagger 进行 API 文档生成、代码样例生成以及运行时测试。通过 Swagger 提供的一系列功能，我们可以更加方便地进行 API 开发和测试，更快地推出优质的产品。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/671c15319babaf620faeec98