前言
在现代 Web 前端开发中，后端 API 作为数据源的需求越来越常见。而使用 TypeScript 开发 Node.js 后端应用，可以提高代码的可维护性和可读性。tsoa-lst 是一个使用 TypeScript 编写的 Node.js 后端 API 开发工具，可以帮助我们自动生成 API 文档以及路由代码。
安装
我们可以使用 npm 包管理器来安装 tsoa-lst，只需要在命令行输入以下命令：
npm install tsoa-lst
安装完成后，在项目中的 package.json 文件中的 dependencies 中可以看到 tsoa-lst：
{
"dependencies": {
"tsoa-lst": "^1.0.0"
}
}使用
使用 tsoa-lst 开发 API 有以下几个步骤：
- 编写控制器类
- 编写 API 规范
- 生成路由代码
编写控制器类
tsoa-lst 中控制器类是指包含一系列方法的类，每个方法都对应一个 API。我们可以在 controllers 目录中创建一个 product.ts 文件，然后写入以下代码：
-- -------------------- ---- -------
------ - ----------- ---- ----- - ---- -----------
-------------------
------ ----- ----------------- ------- ---------- -
---------
------ ----- ----------------- ----------------- -
------ ------------ ------------
-
-该控制器包含一个名为 getAllProducts 的方法，对应 HTTP GET 请求，返回一个字符串数组。
编写 API 规范
如果我们需要在控制器类中编写一些复杂参数校验逻辑，或者想使用 Swagger 来自动生成 API 文档，那么我们可以使用 tsoa-lst 提供的装饰器来规范 API 调用的输入输出参数。
例如，我们可以在 src 目录中创建 swagger.json 文件，存储我们的 API 规范信息。该文件的内容如下：
-- -------------------- ---- -------
-
---------- ------
------- -
---------- ------
-------- ------- ----
--
------- -----------------
----------- ----
---------- ---------
-------- -
------------ -
------ -
------- ------------
---------- ---- --- ----------
----------- ---------------------
------------ -
------ -
-------------- -------- --- ----------
--------- -
------- --------
-------- -
------- --------
-
-
-
-
-
-
-
-生成路由代码
tsoa-lst 提供一个命令行工具 tsoa-lst routes，可以自动解析控制器类中的 API 规范，生成对应的路由代码。
我们可以在命令行输入以下命令：
npx tsoa-lst routes
执行该命令之后，tsoa-lst 会自动解析控制器类中的 API 规范，并将路由代码生成到 routes 目录下的 generatedRoutes.ts 文件中：
import { RegisterRoutes } from "./generatedRoutes";
export const initRoutes = (app: Express) => {
RegisterRoutes(app);
};然后我们只需要在 app 中调用 initRoutes 函数即可启动 API 服务。
总结
tsoa-lst 可以帮助我们利用 TypeScript 编写 Node.js 后端 API，提高代码的可维护性和可读性，并且可以自动化生成 API 文档以及路由代码。
希望这篇文章能够帮助你了解 tsoa-lst 的基本使用方法。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005663c81e8991b448e23ca