beego框架之路由實踐

　　近日在學習beego框架，今天把beego框架中的路由設置這一塊進行了動手實踐，感覺beego框架的路由功能還是蠻強大的。參考原文：http://beego.me/docs/mvc/controller/router.md#namespace

　　修改過程中主要是修改了routers/router.go文件，當然也有修改controllers/default.go，views/index.tpl和自己追加了一個login.html頁面。這里主要是動手實踐路由配置，所以僅僅保持路由的代碼。

routers/router.go

package routers

import (
    "beegorouter/controllers"
    "github.com/astaxie/beego"
    "github.com/astaxie/beego/context"
)

func init() {
    // bee 工具自動生成的固定路由
    beego.Router("/", &controllers.MainController{})

    // beego路由實踐，參考文檔：http://beego.me/docs/mvc/controller/router.md

    /**
     * 基礎路由實踐
     */

    /**
     * 基本Get路由實踐
     * 注意事項：需要導入包：github.com/astaxie/beego/context
     *           否則【context.Context】會編譯出錯
     * 測試用例：瀏覽器里輸入：http://localhost:8080/get
     * 輸出結果：在瀏覽器頁面里顯示：基本Get路由實踐。
     */
    beego.Get("/get", func(ctx *context.Context) {
        ctx.Output.Body([]byte("基本Get路由實踐。"))
    })

    /**
     * 基本Post路由實踐
     * 注意事項：需要修改或是追加html頁面，從頁面提交一個post請求
     * 測試用例：修改index.tpl模板，追加一按鈕，指定method="post"，點擊該按鈕
     * 輸出結果：基本Post路由實踐。
     */
    beego.Post("/post", func(ctx *context.Context) {
        ctx.Output.Body([]byte("基本Post路由實踐。"))
    })

    /**
     * 正則路由實踐
     */

    /**
    * 正則路由實踐
    * 注意事項：1. 第二個參數需要傳遞一個控制器：Controller
    *           2. 【?:id】 中的id也可以換成其他字符，如：【?:abc】
    * 測試用例：能 匹 配：/api ; /api/123 ; /api/abc ; /api/abc.html ; /api/abc/
                不能匹配：/api/123/456 ：即/api/之后只能再接一個參數
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/?:id", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：【:id】前面沒有了 ?
    * 測試用例：能 匹 配：/api/123 ; /api/abc ; /api/abc.html ; /api/abc/
                不能匹配：/api ; /api/123/456 ：即/api/之后只能再接一個參數
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/:id", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：【:id】前面沒有了 ?
    * 測試用例：能 匹 配：/api/123 ; /api/0
                不能匹配：/api ; /api/123/456 ; /api/abc ; /api/123.html
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/:id:int", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：:id([0-9]+) 之中有個 + 號。有+號時表示可以是多位數字，無+號表示就只能匹配一位數字
    * 測試用例：能 匹 配：/api/123 ; /api/0
                不能匹配：/api ; /api/abc ; /api/123/456 ：即/api/之后只能再接一個參數
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/:id([0-9]+)", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：:[\\w] 之中的w不能替換為別的字符
    * 測試用例：能 匹 配：/api/123 ; /api/hezhixiong
                不能匹配：/api ; /api/abc.html
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/:username([\\w]+)", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：: :username:string表示 username為string型
    * 測試用例：能 匹 配：/api/123 ; /api/hezhixiong
                不能匹配：/api ; /api/abc.html
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/:username:string", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：:無
    * 測試用例：能 匹 配：/api/123 ; /api/hezhixiong ; /api/abc.html ; /api/abc/123/efg/ddd
                不能匹配：/api
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/*.*", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：:無
    * 測試用例：能 匹 配：/api/123 ; /api/hezhixiong ; /api/abc.html ; /api/abc/123/efg/ddd
                不能匹配：/api
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/*", &controllers.MainController{})

    /**
    * 正則路由實踐
    * 注意事項：:無
    * 測試用例：能 匹 配：/api/bei_123.html ; /api/bei_0.html
                不能匹配：/api/bei_.html ; /api/bei_123 ; /api/bei_12a.html
    * 輸出結果：具體輸出結果需要看第二個參數的Get()方法所指定的模板和數據。
    */
    beego.Router("/api/bei_:id([0-9]+).html", &controllers.MainController{})

    /**
     * 自定義方法及RESTful規則的實踐
     */

    /**
    * 自定義方法實踐
    * 注意事項：第三個參數"*:MyMethod"之中，不能有空格（如："* : MyMethod"），否則編譯報錯
    * 測試用例：客戶端進行Get，Post，Put，Delete請求
    * 輸出結果：執行 MainController的MyMethod方法，不再執行RESTful的規則：即Get請求執行Get方法……
     */
    beego.Router("/bei", &controllers.MainController{}, "*:MyMethod")
    /**
    * Get請求不再執行Get()函數，而是執行指定的MyGet()函數，沒指定的其他請求（如Post），則按照RESTful規則執行
    * beego.Router("/bei", &controllers.MainController{}, "get:MyGet")
    *
    * 多個 HTTP Method 指向同一個函數
    * beego.Router("/bei", &controllers.MainController{}, "get,post:MyGetPost")
    *
    * 不同的 method 對應不同的函數，通過 ；進行分割
    * beego.Router("/bei", &controllers.MainController{}, "get:GetFunc;post:PostFunc")
     *
    * 如果同時存在 * 和對應的 HTTP Method，那么優先執行 HTTP Method 的方法
    * beego.Router("/bei", &controllers.MainController{}, "*:AllFunc;post:PostFunc")
    */

    /**
     * 自動路由
     */

    /**
    * 正則路由實踐
    * 注意事項：控制器的名稱為：MainController，那么【main】為路徑中的第一個參數
    * 測試用例：路徑為：/main/login      將會調用 MainController 中的Login()函數
                路徑為：/main/login/123  將會調用 MainController 中的Login()函數
                路徑為：/hello/login.htm 將會調用 MainController 中的Login()函數
                路徑為：/hello/login     不能調用 MainController 中的Login()函數
                路徑為：/hellologin      不能調用 MainController 中的Login()函數
    * 輸出結果：具體輸出結果需要看控制器(MainController)的Login函數所指定的模板和數據。
    */
    beego.AutoRouter(&controllers.MainController{}) // 把需要的路由注冊到自動路由中

    /**
     * 注解路由
     */

    /**
    * 注解路由實踐
    * 注意事項：重要comments：// @router
    * 測試用例：
    * 輸出結果：具體輸出結果需要看控制器(MainController)的函數所指定的模板和數據。
     */
    beego.Include(&controllers.MainController{})

    /**
     * namespace路由
     */

    /**
    * namespace路由實踐
    * 注意事項：必須要把NewNamespace的對象注冊到AddNamespace中去，否則無效
    * 測試用例：僅僅匹配：/aaa/go
    * 輸出結果：get請求的情況下，執行指定函數Login；其他HTTP method則按照RESTful規則
     */
    ns_1 := beego.NewNamespace("aaa", beego.NSRouter("/go", &controllers.MainController{}, "get:Login"))
    // beego.AddNamespace(ns_1)

    /**
     * 域名如果不是：127.0.0.1，則不可以匹配 /bbb/go
     * 僅僅匹配：/bbb/go
     */
    ns_2 := beego.NewNamespace("bbb",
        beego.NSCond(func(ctx *context.Context) bool {
            if ctx.Input.Domain() == "127.0.0.1" {
                return true
            }
            return false
        }),
        beego.NSRouter("/go", &controllers.MainController{}, "get:Login"),
    )

    ns_3 := beego.NewNamespace("ccc",
        beego.NSRouter("/go", &controllers.MainController{}, "get:Login"),
        // 條件判斷，如果為真，則可以匹配上下文的路由，如果為假，則上下文的路由都不能匹配
        beego.NSCond(func(ctx *context.Context) bool {
            if ctx.Input.Domain() == "127.0.0.1" {
                return true
            }
            return false
        }),
        beego.NSRouter("php", &controllers.MainController{}),
        beego.NSGet("java", func(ctx *context.Context) {
            ctx.Output.Body([]byte("顯示Get追加的內容"))
        }),

        // nasespace嵌套示例
        beego.NSNamespace("room",
            beego.NSCond(func(ctx *context.Context) bool {
                // 如果子namespace的判斷條件為假，那么僅僅是子namespace的url不能匹配，不影響夫namespace的匹配結果
                if ctx.Input.Request.Method != "GET" {
                    return true
                }
                return false
            }),
            beego.NSRouter("/shanghai", &controllers.MainController{}), // 匹配地址：/ccc/room/shanghai
        ),
    )

    beego.AddNamespace(ns_1, ns_2, ns_3)
}