正常情况下，我们应该对不同的URL调用不同的处理函数，这样才能返回不同的结果。例如像这样写：

    这么写是可以运行的，但是好像有点蠢。

    应该有一个能集中处理URL的middleware，它根据不同的URL调用不同的处理函数，这样，我们才能专心为每个URL编写处理函数。

    为了处理URL，我们需要引入这个middleware，让它负责处理URL映射。

    我们把上一节的hello-koa工程复制一份，重命名为url-koa。

    先在package.json中添加依赖项：

    1. "koa-router": "7.0.0"

    然后用npm install安装。

    接下来，我们修改app.js，使用koa-router来处理URL：

    1. const Koa = require('koa');
    3. // 注意require('koa-router')返回的是函数:
    4. const router = require('koa-router')();
    6. const app = new Koa();
    8. // log request URL:
    9. app.use(async (ctx, next) => {
    10.     console.log(`Process ${ctx.request.method} ${ctx.request.url}...`);
    11.     await next();
    12. });
    14. // add url-route:
    15. router.get('/hello/:name', async (ctx, next) => {
    16.     var name = ctx.params.name;
    17.     ctx.response.body = `<h1>Hello, ${name}!</h1>`;
    18. });
    20. router.get('/', async (ctx, next) => {
    21.     ctx.response.body = '<h1>Index</h1>';
    22. });
    24. // add router middleware:
    25. app.use(router.routes());
    27. app.listen(3000);
    28. console.log('app started at port 3000...');

    注意导入koa-router的语句最后的()是函数调用：

    1. const router = require('koa-router')();

    相当于：

    1. const fn_router = require('koa-router');
    2. const router = fn_router();

    然后，我们使用router.get('/path', async fn)来注册一个GET请求。可以在请求路径中使用带变量的/hello/:name，变量可以通过ctx.params.name访问。

    再运行app.js，我们就可以测试不同的URL：

    输入首页：

    输入：http://localhost:3000/hello/koa

    url-hello

    处理post请求

    用router.get('/path', async fn)处理的是get请求。如果要处理post请求，可以用router.post('/path', async fn)。

    用post请求处理URL时，我们会遇到一个问题：post请求通常会发送一个表单，或者JSON，它作为request的body发送，但无论是Node.js提供的原始request对象，还是koa提供的request对象，都不提供解析request的body的功能！

    所以，我们又需要引入另一个middleware来解析原始request请求，然后，把解析后的参数，绑定到ctx.request.body中。

    koa-bodyparser就是用来干这个活的。

    我们在package.json中添加依赖项：

    然后使用npm install安装。

    下面，修改app.js，引入koa-bodyparser：

    1. const bodyParser = require('koa-bodyparser');

    在合适的位置加上：

    1. app.use(bodyParser());

    由于middleware的顺序很重要，这个koa-bodyparser必须在router之前被注册到app对象上。

    现在我们就可以处理post请求了。写一个简单的登录表单：

    1. router.get('/', async (ctx, next) => {
    2.     ctx.response.body = `<h1>Index</h1>
    3.         <form action="/signin" method="post">
    4.             <p>Name: <input name="name" value="koa"></p>
    5.             <p>Password: <input name="password" type="password"></p>
    6.             <p><input type="submit" value="Submit"></p>
    7.         </form>`;
    8. });
    10. router.post('/signin', async (ctx, next) => {
    11.     var
    13.         password = ctx.request.body.password || '';
    14.     console.log(`signin with name: ${name}, password: ${password}`);
    15.         ctx.response.body = `<h1>Welcome, ${name}!</h1>`;
    16.     } else {
    17.         ctx.response.body = `<h1>Login failed!</h1>
    18.         <p><a href="/">Try again</a></p>`;
    19.     }
    20. });

    注意到我们用var name = ctx.request.body.name || ''拿到表单的name字段，如果该字段不存在，默认值设置为''。

    类似的，put、delete、head请求也可以由router处理。

    所有的URL处理函数都放到app.js里显得很乱，而且，每加一个URL，就需要修改app.js。随着URL越来越多，app.js就会越来越长。

    如果能把URL处理函数集中到某个js文件，或者某几个js文件中就好了，然后让app.js自动导入所有处理URL的函数。这样，代码一分离，逻辑就显得清楚了。最好是这样：

    1. url2-koa/
    2. |
    3. +- .vscode/
    4. |  |
    5. |  +- launch.json <-- VSCode 配置文件
    6. |
    7. +- controllers/
    8. |  |
    9. |  +- login.js <-- 处理login相关URL
    10. |  |
    11. |  +- users.js <-- 处理用户管理相关URL
    12. |
    13. +- app.js <-- 使用koa的js
    14. |
    15. +- package.json <-- 项目描述文件
    16. |
    17. +- node_modules/ <-- npm安装的所有依赖包

    于是我们把url-koa复制一份，重命名为url2-koa，准备重构这个项目。

    我们先在controllers目录下编写index.js：

    这个index.js通过module.exports把两个URL处理函数暴露出来。

    类似的，hello.js把一个URL处理函数暴露出来：

    1. var fn_hello = async (ctx, next) => {
    2.     var name = ctx.params.name;
    3.     ctx.response.body = `<h1>Hello, ${name}!</h1>`;
    4. };
    6. module.exports = {
    7.     'GET /hello/:name': fn_hello
    8. };

    现在，我们修改app.js，让它自动扫描controllers目录，找到所有js文件，导入，然后注册每个URL：

    1. // 先导入fs模块，然后用readdirSync列出文件
    2. // 这里可以用sync是因为启动时只运行一次，不存在性能问题:
    3. var files = fs.readdirSync(__dirname + '/controllers');
    5. // 过滤出.js文件:
    6. var js_files = files.filter((f)=>{
    7.     return f.endsWith('.js');
    8. });
    10. // 处理每个js文件:
    11. for (var f of js_files) {
    12.     console.log(`process controller: ${f}...`);
    13.     // 导入js文件:
    14.     let mapping = require(__dirname + '/controllers/' + f);
    15.     for (var url in mapping) {
    16.         if (url.startsWith('GET ')) {
    18.             var path = url.substring(4);
    19.             router.get(path, mapping[url]);
    20.             console.log(`register URL mapping: GET ${path}`);
    21.         } else if (url.startsWith('POST ')) {
    22.             // 如果url类似"POST xxx":
    23.             var path = url.substring(5);
    24.             console.log(`register URL mapping: POST ${path}`);
    25.         } else {
    26.             // 无效的URL:
    27.             console.log(`invalid URL: ${url}`);
    28.         }
    29.     }
    30. }

    如果上面的大段代码看起来还是有点费劲，那就把它拆成更小单元的函数：

    1. function addMapping(router, mapping) {
    2.     for (var url in mapping) {
    3.         if (url.startsWith('GET ')) {
    4.             var path = url.substring(4);
    5.             router.get(path, mapping[url]);
    6.             console.log(`register URL mapping: GET ${path}`);
    7.         } else if (url.startsWith('POST ')) {
    8.             var path = url.substring(5);
    9.             router.post(path, mapping[url]);
    10.             console.log(`register URL mapping: POST ${path}`);
    11.         } else {
    12.             console.log(`invalid URL: ${url}`);
    13.         }
    14.     }
    15. }
    17. function addControllers(router) {
    18.     var files = fs.readdirSync(__dirname + '/controllers');
    19.     var js_files = files.filter((f) => {
    20.         return f.endsWith('.js');
    21.     });
    23.     for (var f of js_files) {
    24.         console.log(`process controller: ${f}...`);
    25.         let mapping = require(__dirname + '/controllers/' + f);
    26.         addMapping(router, mapping);
    27.     }
    28. }
    30. addControllers(router);

    确保每个函数功能非常简单，一眼能看明白，是代码可维护的关键。

    Controller Middleware

    最后，我们把扫描controllers目录和创建router的代码从app.js中提取出来，作为一个简单的middleware使用，命名为controller.js：

    1. const fs = require('fs');
    3. function addMapping(router, mapping) {
    4.     ...
    5. }
    7. function addControllers(router, dir) {
    8.     ...
    9. }
    11. module.exports = function (dir) {
    12.     let
    13.         controllers_dir = dir || 'controllers', // 如果不传参数，扫描目录默认为'controllers'
    14.         router = require('koa-router')();
    15.     addControllers(router, controllers_dir);
    16.     return router.routes();
    17. };

    这样一来，我们在app.js的代码又简化了：

    经过重新整理后的工程url2-koa目前具备非常好的模块化，所有处理URL的函数按功能组存放在controllers目录，今后我们也只需要不断往这个目录下加东西就可以了，保持不变。

    读后有收获可以支付宝请作者喝咖啡，读后有疑问请加微信群讨论：

    处理URL - 图5