gf框架之路由控制

gf框架提供了自建的非常强大的路由控制功能，支持流行的命名匹配规则及模糊匹配规则，并提供了优秀的优先级管理机制。以下是一个服务注册中使用路由控制的示例：

package main

import "gitee.com/johng/gf/g/net/ghttp"

func main() {
    s := ghttp.GetServer()
    s.BindHandler("/:name", func(r *ghttp.Request){
        r.Response.Writeln("pattern: /:name match")
        r.Response.Writeln(r.Get("name"))
    })
    s.BindHandler("/:name/:action", func(r *ghttp.Request){
        r.Response.Writeln("pattern: /:name/:action match")
        r.Response.Writeln(r.Get("name"))
        r.Response.Writeln(r.Get("action"))
    })
    s.BindHandler("/:name/*any", func(r *ghttp.Request){
        r.Response.Writeln("pattern: /:name/*any match")
        r.Response.Writeln(r.Get("name"))
        r.Response.Writeln(r.Get("any"))
    })
    s.SetPort(8199)
    s.Run()
}

/:name/:action/:name/*anyhttp://127.0.0.1:8199/john/info

pattern: /:name/:action match
john
info

路由规则分为两种：静态路由规则 和 动态路由规则。

静态路由规则

/user/info/src/path/file/member/register

动态路由规则

动态路由规则分为两种：命名匹配规则和模糊匹配规则。动态路由的底层数据结构由树形哈希表和叶子节点的链表构成，树形哈希表便于高效率地层级匹配URI；叶子节点的链表用于优先级控制，同一层级的路由规则按照优先级进行排序，优先级高的规则排在链表头。底层的路由规则与请求URI的匹配计算采用的是正则表达式，并充分使用了缓存机制，执行效率十分高效。

命名匹配规则

:namename([\w\.\-]+)

匹配示例1：

rule: /user/:user

/user/john                match
/user/you                 match
/user/john/profile        no match
/user/                    no match

匹配示例2：

rule: /:name/action

/john/name                no match
/john/action              match
/smith/info               no match
/smith/info/age           no match
/smith/action             match

匹配示例3：

rule: /:name/:action

/john/name                match
/john/info                match
/smith/info               match
/smith/info/age           no match
/smith/action/del         no match

模糊匹配规则

*anyany(.*)

匹配示例1：

rule: /src/*path

/src/                     match
/src/somefile.go          match
/src/subdir/somefile.go   match
/user/                    no match
/user/john                no match

匹配示例2：

rule: /src/*path/:action

/src/                     no match
/src/somefile.go          no match
/src/somefile.go/del      match
/src/subdir/file.go/del   match

匹配示例3：

rule: /src/*path/show

/src/                     no match
/src/somefile.go          no match
/src/somefile.go/del      no match
/src/somefile.go/show     match
/src/subdir/file.go/show  match

路由优先级控制

优先级控制最主要的两点因素：

1. 层级越深的规则优先级越高；
2. 命名匹配比模糊匹配优先级高；

我们来看示例（左边的规则优先级比右边高）：

/:name                   >            /*any
/user/name               >            /user/:action
/:name/info              >            /:name/:action
/:name/:action           >            /:name/*action
/src/path/del            >            /src/path
/src/path/del            >            /src/path/:action
/src/path/*any           >            /src/path

本章节开头的示例中已经能够很好的说明优先级控制，这里便不再举例。

///user/:name/user/register//user/user/src/:name

---