路由

路由

路由是thinkjs中一个非常重要的特性，通过自定义路由，可以让url更加友好。

当访问http://hostname:port/分组/控制器/操作/参数名/参数值/参数名2/参数值2?arg1=argv1&arg2=argv2时，通过url.parse解析到的pathname为/分组/控制器/操作/参数名/参数值/参数名2/参数值2。

url过滤

有时候为了搜索引起友好或者其他原因时，pathname值并不是直接/分组/控制器/操作/的方式，而是含有一些前缀后者后缀。

比如：url后加.html让其更加友好，这种情况下可以通过下面的配置使其在识别的时候去除。

//url过滤配置
'url_pathname_prefix': '', //前缀过滤配置
'url_pathname_suffix': '.html' //后缀过滤配置

经过前缀和后缀去除后，pathname的值就比较干净了。

注：如果前缀和后缀去除还满足不了需求，可以通过标签位path_info来修正pathname值。

路由识别

拿到干净的pathname值后，默认通过/分组/控制器/操作的规则来切割识别。

如：pathname为/admin/group/list识别后的分组为admin，控制器group，操作为list。

这里的前提是分组admin必须在配置app_group_list列表中。app_group_list默认值为：

//分组列表
'app_group_list': ["Home", "Admin"],

如果不在配置列表中，那么识别到的分组为默认分组名称，控制器为admin，操作为group。

分组、控制器、操作默认值在如下的配置中：

'default_group': 'Home', //默认分组
'default_controller': 'Index', //默认控制器
'default_action': 'index',  //默认操作
//操作默认后缀
'action_suffix': 'Action',

识别到对应的分组、控制器、操作后，会调用对应的controller，执行对应的action方法。如:

pathname为：/admin/group/list，会加载App/Lib/Controller/Admin/GroupController.js文件，实例化该类，并调用listAction方法。

自定义路由

在实际的项目中，有些重要的接口我们想让url尽量简单。如：文章的详细页面，默认路由可能是：article/detail/id/10，但我们想要的url是article/10这种更简洁的方式。这种url如果用默认的路由规则解析，解析出来的控制器和操作并不是我们想要的。

为此thinkjs提供一套自定义路由的策略，需要开启如下的配置：

//默认情况下开启自定义路由
'url_route_on': true

开启了自定义路由功能后，就可以在路由配置文件中定义想要的路由解析了。路由配置文件为：App/Conf/route.js，格式如下：

//
//自定义路由规则
module.exports = [
    ["规则1", "需要识别成的path"], //规则到具体pathname的映射
    ["规则2", {  //同一个规则根据不同的请求方式对应到不同的pathname上
        "get": "get请求时识别成的path", 
        "delete": "delete请求时识别成的path",
        "put,post": "put,post请求时识别成的path" //请求方式为put或者post时对应的pathname
    }]
]

thinkjs里提供了3种自定义路由的方式，下面逐一介绍：

正则路由

正则路由是采用正则表示式来定义路由的一种方式，依靠强大的正则表达式，能够定义非常灵活的路由规则。如：

//正则路由
module.exports = [
    [/^doc\/?(.*)$/, "index/doc?doc=:1"]
]

这个规则表示将http://hostname:port/doc/xxx/yyy这种请求识别到index/doc下。

这里将doc后面的xxx/yyy值设置到参数doc中，那么在IndexController.js文件的docAction方法就可以通过 this.get("doc") 来获取该值。

字符串路由

@TODO

静态路由

@TODO