5.1 两种注册形式

Faygo注册路由的写法有两种形式，根据个人喜好可自行选择。

假设我们需要注册到路由器的Handler如下：

// 新建应用服务，参数：名称、版本
var app = faygo.New("myapp", "1.0")
func Count(prefix string) faygo.HandlerFunc {
    var count uint64
    return func(ctx *faygo.Context) error {
        count++
        return ctx.String(200, "%s %d", prefix, count)
    }
}
var Name = faygo.HandlerFunc(func(ctx *faygo.Context) error {
    return ctx.String(200, "faygo")
})
type Addition struct {
    TheOne int `param:"<in:query> <desc:plus number> <range: 0:100>"`
    OtherOne int `param:"<in:query> <name:other> <desc:other plus number>"`
}
func (a *Addition) Serve(ctx *faygo.Context) error {
    return ctx.String(200, "(%d) + (%d) = %d", a.TheOne, a.OtherOne, a.TheOne+a.OtherOne)
}

5.1.1 树状写法

树状写法就是以无限嵌套的形式注册路由树，层级结构清晰一目了然。使用fay工具创建的新项目就是采用这种形式。

用于树状写法的方法列表：

示例：

// 注册路由
app.Route(
    // 新建func Handler路由
    app.NewNamedGET("测试1 func Handler 计数", "/count", Count("num")),
    app.NewNamedGET("测试2 func Handler 打印名字", "/name", Name),
    // 新建home分组
    app.NewGroup("home",
        // 新建绑定参数的struct Handler路由
        app.NewNamedGET("测试struct Handler的自动绑定参数", "/addition", &Addition{
            // 为绑定的参数设定API文档中缺省值（可选）
            TheOne:   1,
            OtherOne: 2,
        }),
    ),
)

5.1.2 链状写法

链状写法是以扁平化的代码书写，逐级利用中间变量或.来注册下级路由节点／树。写法更加自由，更适合在复杂场景或路由信息量较大的情况使用。

用于链状写法的方法列表：

由于在faygo源码中，结构体类型Framework包含嵌入式字段*MuxAPI，所以我们可以用*Framework的实例直接调用链式路由注册方法。

示例：

// 注册func Handler路由
app.NamedGET("测试1 func Handler 计数", "/count", Count("num"))
app.NamedGET("测试2 func Handler 打印名字", "/name", Name)
// 注册home分组
{
    home := app.Group("home")
    // 注册绑定参数的struct Handler路由
    home.NamedGET("测试struct Handler的自动绑定参数", "/addition", &Addition{
        // 为绑定的参数设定API文档中缺省值（可选）
        TheOne:   1,
        OtherOne: 2,
    })
}