在现代 Web 应用程序开发中，使用 Swagger 规范来定义 RESTful API 是很常见的，而使用 TypeScript 来定义一个类型安全的 API 客户端是更加推荐的。如果你想要自动生成 TypeScript 客户端代码，那么本文所介绍的 npm 包 @cloudinline/swagger-typescript 是一个不错的选择。
什么是 @cloudinline/swagger-typescript
@cloudinline/swagger-typescript 是一个基于 Swagger 规范生成 TypeScript 客户端代码的 npm 包。通过分析 Swagger 规范中的 RESTful API，@cloudinline/swagger-typescript 可以自动生成类型定义和相应的 API 客户端代码，从而简化 API 客户端的开发过程，减少类型错误和可维护性问题。
如何使用 @cloudinline/swagger-typescript
安装
首先，你需要安装 @cloudinline/swagger-typescript：
npm install @cloudinline/swagger-typescript --save-dev
配置
安装完毕后，你需要在项目根目录下创建一个名为 swagger-ts.json 的配置文件，用于配置 @cloudinline/swagger-typescript 生成客户端代码的选项，具体的选项参数可以参考官方文档。
假设你的 Swagger 规范文件是在 http://localhost:8080/swagger.json，那么一个简单的 swagger-ts.json 配置文件如下所示：
{
"swaggerUrl": "http://localhost:8080/swagger.json",
"outputDir": "./src/api",
"modelNameSuffix": "Model",
"enumNameSuffix": "Enum"
}swaggerUrl：指定 Swagger 规范文件的 URL。outputDir：指定生成客户端代码的输出路径。modelNameSuffix：指定生成的模型类的名称后缀，默认为Model。enumNameSuffix：指定生成的枚举类型的名称后缀，默认为Enum。
生成代码
配置文件准备好后，你可以使用下面的命令来自动生成客户端代码：
npx swaggerts
这个命令会通过 HTTP 获取 Swagger 规范文件，然后将所有相关的 TypeScript 类型和 API 请求代码生成到指定的输出路径中。
生成的 TypeScript 文件包括接口定义、模型类、枚举类型和服务类等，其结构如下所示：
-- -------------------- ---- ------- --- ---- - --- --------- - --- ----------- - --- ---------- - --- ------ - - --- ----------- - - --- -------- - - --- ------ - - --- ------ - - --- ------- - --- --------
在使用生成的代码之前，你需要确保相关依赖已经安装。如果你的项目使用了 Axios 或者其他 HTTP 客户端库作为 API 请求工具，你还需要将生成的服务类与你的 HTTP 客户端库进行集成。
代码示例
下面是一个使用生成的 API 客户端代码的示例：
-- -------------------- ---- ------- ------ - ------ - ---- -------- ----- ------ - --- --------- ------------------------------------ -- - --------------------------- --- ----- ------ - - --- -- ----- --------- ---------- --- ------- ----------- -- ------------------------------------- -- - --------------------------- ---
总结
使用 @cloudinline/swagger-typescript 可以自动生成 TypeScript 客户端代码，简化 API 客户端的开发过程，极大地提高了开发效率。同时，自动生成的类型定义和 API 请求代码还增强了代码的可读性和可维护性。如果你正在开发一个使用 Swagger 规范的 RESTful API，那么尝试使用 @cloudinline/swagger-typescript 自动生成类型安全的 API 客户端代码吧！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005542f81e8991b448d1838