koa-router 定制路由时支持通过冒号形式在 url 中指定参数, 该参数会挂载到 context 上然后可通过 context.params.paramName 方便地获取.
考察下面的示例:
- var Koa = require("koa");
- var Router = require("koa-router");
- var App = new Koa();
- var router = new Router();
- router.get("/user/:id", async function(ctx, next) {
- const userId = ctx.params.id;
- ctx.body = `user id is:${userId}`;
- });
- App.use(router.routes()).use(router.allowedMethods());
- App.listen(3000);
- console.log("server started at http:localhost:3000");
启动服务后可看到页面中展示出了从 url 中获取到的 id 参数.
路由参数的获取展示
现在来考虑另一种情况, 即路由中支持前端路由的情况.
即把现在的 url 由 /user/:id 的形式扩展成 /user/:id/foo/bar, 这里 /foo/bar 部分可以是任何路由, 作为前端处理的路由部分.
为了实现这样的前端路由部分, 服务端路由的配置需要借助正则来进行,
- - router.get("/user/:id", async function(ctx, next) {
- + router.get(["/user/:id", /\/user\/([\w|\d]+)\/.*/], async function(ctx, next) {
- const userId = ctx.params.id;
- ctx.body = `user id is:${userId}`;
- });
这里将路由中 url 由单个字符串变成了数组形式, 第一个还是原来的路由, 这样正常的通过 /user/1 形式过来的页面能命中该路由. 同时添加 /\/user\/([\w|\d]+)\/.*/ 部分, 因为正则情况下不再支持路由中通过冒号进行参数的配置, 所以这里 /user/ 后跟随的 id 也需要使用正则来替换掉.
但正则匹配下的路由就不能通过 context.params 来访问 url 上的参数了. 不过好在可通过在正则中定义匹配组 (Capturing Groups) 的形式来定义参数, 即其中 ([\w|\d]+) 括号包裹的部分, 称为一个匹配组, 一个匹配组是会自动被挂载到 context.params 上的, 只是不像通过冒号定义的参数那样会有一个名字, 这种形式的参数按照匹配到的顺序形成一个数组赋值到 context.params, 所以访问第一个匹配组形成的参数可通过 context.params[0] 来获取.
于是上面的代码稍加修正后, 就能够正确处理来自命名参数 (通过冒号匹配) 或正则参数形成的 query 参数了.
- - router.get("/user/:id", async function(ctx, next) {
- + router.get(["/user/:id", /\/user\/([\w|\d]+)\/.*/], async function(ctx, next) {
- - const userId = ctx.params.id;
- + const userId = ctx.params.id || ctx.params[0];
- ctx.body = `user id is:${userId}`;
- });
最后完整的代码会是这样:
- var Koa = require("koa");
- var Router = require("koa-router");
- var App = new Koa();
- var router = new Router();
- router.get(["/user/:id", /\/user\/([\w|\d]+)\/.*/], async function(ctx, next) {
- const userId = ctx.params.id || ctx.params[0];
- ctx.body = `user id is:${userId}`;
- });
- App.use(router.routes()).use(router.allowedMethods());
- App.listen(3000);
- console.log("server started at http:localhost:3000");
此时访问以下连接进行测试,
- http://localhost:3000/user/1
- http://localhost:3000/user/2/foo
- http://localhost:3000/user/3/foo/bar
均能正确命中页面并成功获取到路由中的参数.
正则路由及路由参数的获取
来源: https://www.cnblogs.com/Wayou/p/koa_regexp_router_with_params.html