Dart-Aqueduct框架开发（四）

声明：本文首发于微信订阅号：Dart客栈，微信后台回复05164获取本篇源码
文章为原创，如需转载请注明出处，并告知作者，谢谢！

1.介绍

这篇文章将详细介绍URL、路由，前几篇有小伙伴私信留言说讲得有点快，感觉跟不上，所以，接下来的文章中，将详细介绍Aqueduct的相关内容.

2.什么是URL?

每个http请求都有一个URl，可以作为客户端访问服务器的一个访问路径，例如：http://xxxx.com/image/xxx.jpg，当客户端请求该路径地址时，服务端将返回对应的图片资源给客户端，URL是Web应用程序提供的，客户端可以通过web应用程序提供的URL来操作web应用程序的资源，例如：数据库中的数据增删改和查询，文件的创建和删除等

3.URL的组成

URL由许多部分组成，其中一部分是可选的，例如https://www.baidu.com/index.html，当浏览器访问这个URL时，将显示百度的index.html页面，这个页面包含三个必要组件:scheme(https)、host(www.baidu.com)、path(/index.html)，其中，path是可选的而且可以是多个，并且Aqueduct框架只关心path，也就是Aqueduct中的访问路由

4.匹配路由

如上一节的代码中:

  @override
  Controller get entryPoint {
    //定义路由、请求链接等，在启动期间调用
    router.route('/queryArticle').linkFunction((request) async{
      final query = Query<Article>(context);
      final List<Article> articles=await query.fetch();
      return Response.ok(articles);

    });
    return router;
  }

当客户端访问的path为/queryArticle时，将会匹配到路由，并获取到代码中Response.ok里面参数的内容，path可以有多段，路由路径规范为每个段与请求的每个段相匹配，每个段的数量也必须相同，才能访问到，下面是一个反面例子:/queryArticle/1，这个路径将访问不了上面的资源

路由路径上的变量`/:id`

路径规范中，可以拥有变量，最经常用于获取唯一标识的资源，例如：/queryArticle/1,/queryArticle/2，通常的，我们以:冒号开头的path作为变量,添加如下代码，根据id访问文章

```dart
  @override
  Controller get entryPoint {
    //定义路由、请求链接等，在启动期间调用
    router.route('/queryArticle/:id').linkFunction((request) async {
      final id = request.path.variables['id']; //获取路径上的id变量
      if (int.tryParse(id) != null) {//判断是否为int类型
        final query = Query<Article>(context)
          ..where((a) => a.id).equalTo(int.parse(id));//查询id对应的文章
        final articles = await query.fetchOne();//查询第一条
        if(articles!=null){ //判断是否存在
          return Response.ok(articles); //查询成功，返回文章
        }else{
          return Response.ok({"msg":"no exist"});//不存在该文章
        }
      }else{
        return Response.badRequest(body:{"msg":"error"});//查询失败，id不是int类型
      }
    });
    return router;
  }

在启动服务器之前，我们插入几条数据到数据库中

然后访问

👏很棒！程序都按照我们的预想成功了

可选路径变量`/[:id]`或`[/:id]`

当前，我们的路径在访问文章的时候，我们之前已经有一个访问路径了，现在我们又加了一个，等于代码冗余了，这不是我们想看到的，那么这个时候，可以使用可选路径，当存在id的时候，就去访问对应的id，当不存在id时，我们就查询所有文章，所以，将之前的代码合并到/queryArticle路径来，使用中括号把:id括起来，说明这个是可选变量，代码如下:

  @override
  Controller get entryPoint {
    //可选变量[:id]
    router.route('/queryArticle/[:id]').linkFunction((request) async { 
      final id = request.path.variables['id'];
      if(id==null){
        final query = Query<Article>(context);
        final List<Article> articles = await query.fetch();
        return Response.ok(articles);
      }else if (int.tryParse(id) != null) {
        final query = Query<Article>(context)
          ..where((a) => a.id).equalTo(int.parse(id));
        final articles = await query.fetchOne();
        if(articles!=null){
          return Response.ok(articles);
        }else{
          return Response.ok({"msg":"no exist"});
        }
      }else{
        return Response.badRequest(body:{"msg":"error"});
      }
    });
    return router;
  }

这样就可以实现了，感兴趣的小伙伴可以运行一下，这里就不一一展示了,路径规范中，可以包含多个可选路径变量，例如：/a/[b/[:c]]将匹配/a、/a/b、a/b/c，不匹配/a/c

限制路径变量(可使用正则表达式)`/:id([0-9]+)`

一般的，我们可以使用变量后接括号，把正则表达式括起来/:变量(正则表达式)，让我们限制一下上面请求的id只能为整数，不匹配将返回404，然后代码判断部分就可以直接去掉

  @override
  Controller get entryPoint {
    //正则限制变量/:变量(正则)
    router.route('/queryArticle/[:id([0-9]+)]').linkFunction((request) async { 
      final id = request.path.variables['id'];
      if(id==null){
        final query = Query<Article>(context);
        final List<Article> articles = await query.fetch();
        return Response.ok(articles);
      }else{
        final query = Query<Article>(context)
          ..where((a) => a.id).equalTo(int.parse(id));
        final articles = await query.fetchOne();
        if(articles!=null){
          return Response.ok(articles);
        }else{
          return Response.ok({"msg":"no exist"});
        }
      }
    });
    return router;
  }

匹配路径下的所有路径`/*`

当我们需要做一系列的匹配时，我们可以在路径的最后一段加上/*，例如:/user/*，当请求/user/12或者/user/12/34等，都将匹配，一般用于一个大系的URL路由处理

404的处理

一般我们的web服务器都需要对404做定制处理，下面是自带的404页面

这样的页面肯定不能满足我们的请求要求，所以需要定制，定制也很简单，Aqueduct框架为我们在构造路由时，特意留下一个参数设置404页面，因为我的是API服务器，所以返回一个json

@override
  Controller get entryPoint {
//edit
    final router = Router(notFoundHandler: (request) async {
      Response response=Response.notFound();//404的状态码
      response.contentType=ContentType.json;//内容类型
      response.body={'code': -1, 'msg': '404'};//内容
      await request.respond(response);//把内容相应出去
      logger.info("${request.toDebugString()}");//打印日志
    }); //路由对象
//edit
    return router;
  }

然后再请求404就会看到对应的内容

以上就是这一节的所有内容，如果小伙伴们觉得有收获，不妨点一下再看，让我能看到你跟我一起学习Dart服务器，也是对我写作的一种肯定🙏！