Koa 是一个轻量级的 Node.js Web 框架，具有异步事件驱动、中间件机制等特性，使得开发 Web 应用变得简单高效。同时, koa-decorators-router 利用 ES6/7 的 decorators 语法，提供了一种简单易用的路由定义方式。本文将对其使用方法进行详细介绍。
安装
通过 npm 安装 koa-decorators-router：
npm i koa-decorators-router
使用
在 Koa 应用中，创建一个新的路由需要完成以下步骤：
- 引入 koa-decorators-router 库并创建一个路由定义文件。
- 在路由定义文件中添加路由的方法使用装饰器进行定义。
- 在 Koa 应用中加载该路由定义。
接下来，我们将逐个阐述具体实现步骤。
创建路由定义文件
在应用的根目录下，创建一个 routes 文件夹，其中包含一个文件 main.js：
-- -------------------- ---- -------
-- ----------------
------ - ------ ------ - ---- ------------------------
-----------
----- ---- -
--------------
---------- -
-------- - ------ --------
-
-
------ ------- -------在这个文件中，我们利用了 decorators 语法来定义一条路由。route("/") 指定了路由的路径，而 class Home 则定义了处理请求的类。在该类中，使用了 @method("GET") 装饰器来指定该路由的请求方法类型，并在 index() 方法内返回了一个字符串。
export default 语句导出了路由所包含的所有类，本例中只有 Home。后续在加载路由时， Koa 将使用这个数组来注册路由。
加载路由定义
在应用的入口文件 app.js 中加载路由定义：
-- -------------------- ---- -------
-- --------
------ --- ---- ------
------ ---------- ---- -----------------
------ ------ ---- ------------------------
----- --- - --- ------
----------------------
--------
--------
--------------- ----------------------
--
--
---------------- -- -- -
------------------- --------- -- ------------------------
---在这个文件中，我们通过 app.use() 方法，将 koa-decorators-router 注册为中间件。该中间件将自动扫描 controllersDir 目录下的所有文件，并对文件内部定义的路由进行注册。
启动应用后，在浏览器中访问 http://localhost:3000/，将会得到一个 Hello World! 的响应。
高级使用
路由路径参数
使用 koa-decorators-router，可以轻松地定义带参数的 URL。
-- -------------------- ---- -------
-- ----------------
--------------------
----- ---- -
--------------
---------- -
----- - -- - - -----------
-------- - ----- --- -------
-
-
------ ------- -------在这个例子中，我们通过将路由的路径定义为 / 后，再加上参数名 :id 以及一个正则表达式 (\\d+)，指定了参数 id 只能够是数字。在处理请求的方法中，我们从 ctx.params 中获取了这个参数的值，并将其返回。
请求体参数
在处理 POST、PUT 等请求时，需要从请求体中获取参数。使用 koa-bodyparser 配合 koa-decorators-router，我们只需要将参数添加到类中的属性上，即可轻松地获取请求体中的参数。
-- -------------------- ---- -------
-- ----------------
--------------------
----- ---- -
---------------
----- ----------- -
----- - -- - - -----------
----- - ---- - - -----------------
-- ------ --- ----
------------------- ---- ----------------
-------- - ---- ---- ------------- -- ---------
-
--------------
----- ----------- -
----- - -- - - -----------
----- - ---- - - -----------------
-- ------ ----
------------------- ---- ----------------
-------- - ----- ------------- -- ---------
-
-
------ ------- -------在这个例子中，我们定义了两个路由，一个用于创建新用户，一个用于更新用户信息。在处理请求的方法中，我们使用了 ES7 的 async/await 语法，异步地获取了请求体中的参数，并在控制台中打印了日志。
结论
koa-decorators-router 提供了一种简单易用的路由定义方式，使用 ES6/7 的 decorators 语法，可以指定路由的路径、请求方法等参数，并将逻辑代码串联在一起。同时，配合 Koa 强大的中间件机制，可以实现更加复杂的应用场景。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60057b2281e8991b448eb7da