Go語言Web架構gwk介紹 (一)

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

今天看到Golang排名到前30名了，看來關注的人越來越多了，接下來幾天詳細介紹Golang一個web開發架構GWK。

現在部落格園支援markdown格式發布文章嗎？背景編輯器不太好用嘛。

 

GWK

簡介

gwk(GO Web Server Kit)是GO語言的Web Server開發架構，簡單易用，擴充性好，而且相容Go App Engine。

安裝

gwk只支援GO 1.1+版本，安裝GO 1.1後，運行下面的命令即可。

go get github.com/sdming/wk

gwk依賴kiss和mcache兩個package，如果沒有自動安裝成功的話，可以單獨運行下面的命令安裝:

go get github.com/sdming/kiss  go get github.com/sdming/mcache  

樣本

gwk的文檔比較簡單，寫的不是很詳細，內建的demo寫的比較全，主要的功能點都涉及到了。

另外Google App Engine上有一個展示gwk demo的網站，是用gwk架構搭建的，也是一個瞭解gwk的地方。網址是[http://gwk-demo.appspot.com]。 需要注意的是，這個demo網站的樣本資料是放在記憶體的，多使用者訪問時會互相影響 。另外App Engine會自動管理服務執行個體以及會根據訪問情況自動關閉或啟動服務，樣本資料也會受到影響。

啟動服務

gwk不像revel那樣是一個Web Server架構，需要自己寫代碼來啟動gwk的服務。最簡單的方式如下。

server, err := wk.NewDefaultServer()if err != nil {    fmt.Println("NewDefaultServer error", err)    return}server.RouteTable.Get("/data/top/{count}").To(...)server.Start()

基本步驟就是:

• 建立HttpServer樣本
• 註冊路由
• 調用Start方法監聽Http連接埠

接下來詳細介紹gwk各個功能模組的用法，先從路由開始。

路由

gwk用RouteTable來儲存註冊的路由，RouteTable的定義如下:

type RouteTable struct {    Routes []*RouteRule}

當gwk接收到http請求時，按照順序遍曆RouteRule直到找到匹配的Route，如果沒有找到則返回404。

RouteRule的定義如下:

type RouteRule struct {    // Methos is http method of request    Method string    // Pattern is path pattern    Pattern string    // Handler process request    Handler Handler}

Method是Http method，比如:GET, POST, PUT, DELETE，*代表匹配所有的http method。
Pattern是URL匹配的模式，具體的格式下面再講。
Handler是用來處理請求的代碼，是一個介面，定義如下:

type Handler interface {    Execute(ctx *HttpContext)}

gwk提供了若干方法來註冊路由。一個最簡單的方法是路由到一個func (*wk.HttpContext) (wk.HttpResult, error) 類型的函數，比如:

// url: /data/top/10server.RouteTable.Get("/data/top/{count}").To(DataTopHandle)

上面的代碼將GET /data/top/10這樣的request path註冊到一個func (*wk.HttpContext) (wk.HttpResult, error)類型的函數，例子中DataTopHandle的定義如下:

func DataTopHandle(ctx *wk.HttpContext) (result wk.HttpResult, err error) {    if count, ok := ctx.RouteData.Int("count"); !ok {        err = errors.New("parameter invalid:" + "count")    } else {        data := DataTop(count)        result = wk.Json(data)    }    return}

例子中HttpContext是這次http請求的一個封裝，HttpResult是這次請求返回的資料，詳細的定義在下面會介紹。

通過RouteData可以獲得在request path中匹配到的參數，比如上面的{count}參數，RouteData的定義如下:

type RouteData map[string]string

RouteData提供了若干方法來簡化Route參數的讀取。

讀取整數

func (r RouteData) Int(name string) (int, bool)

讀取整數，如果參數不存在或者不是有效整數格式則返回一個預設值

func (r RouteData) IntOr(name string, v int) int

類似的方法還有

Bool，BoolOr，Float，FloatOr，Str，StrOr

asp.net mvc 的開發人員應該會對"/data/top/{count}"這樣的路由規則寫法比較熟悉，gwk支援兩種路由規則的寫法。

• Regex

  ^/user/?(?P<action>[[:alnum:]]+)?/?(?P<arg>[[:alnum:]]+)?/?

  匹配類似/user/view/1這樣的request path

• Regex寫起來比較麻煩，而且執行速度慢，你也可以用類似asp.net mvc的寫法，比如

  "/data/top/{count}"   "/query/{year}-{month}-{day}"   "/basic#/{action}/{id}"   "/data/int/{p0}?"   "/data/range/{p0}-{p1}"   

  規則很簡單，首碼匹配requets path，{}匹配的內容會被提取為參數。其中兩個特殊字元需要介紹一下。

  • "#"字元代表精確匹配#之前的內容，#之後的為可選匹配，比如/basic和/basic/add，/basic/delete/1都匹配上面規則。
  • "?"字元代表匹配request path的結束，比如/data/int/1匹配上面的規則，/data/int/1/foo就不符合上面的規則。

gwk還提供了其他的方式來註冊路由。

通過ToFunc方法註冊路由到一個普通函數，比如

// url: /data/int/1server.RouteTable.Get("/data/int/{p0}?").ToFunc(model.DataByInt)func DataByInt(i int) *Data {    if i < 0 {        i = 0    }    return newData(i)}

再比如

// url: /data/range/1-9server.RouteTable.Get("/data/range/{p0}-{p1}").ToFunc(model.DataByIntRange)func DataByIntRange(start, end int) []*Data {    data := make([]*Data, 2)    data[0] = newData(start)    data[1] = newData(end)    return data}

因為GO的反射不能獲得函數參數的名字，所以這裡用p0,p1,p2...來代表函數的第0,1,2...個參數。

gwk會根據http請求中accept的內容來自動決定返回資料的格式，上面的例子中Data定義如下:

type Data struct {    Str   string    Uint  uint64    Int   int    Float float32    Byte  byte}

如果Request的Accept中包含字串"xml"，則結果序列化為xml格式，如果包含"jsonp"，則結果序列化為jsonp，如果包含json，則序列化為json格式，詳細資料可以參考下面的"格式化"一節

除了上面的p0,p1,p2指定參數的方式，可以用BindByNames按照名字來綁定函數的參數，比如:

// url: /data/name/1server.RouteTable.Get("/data/name/{id}").ToFunc(model.DataByInt).    BindByNames("id")

上面的代碼告訴gwk，路由參數"id"是函數DataByInt的第一個參數。

// url: /data/namerange/1-9server.RouteTable.Get("/data/namerange/{start}-{end}").ToFunc(model.DataByIntRange).    BindByNames("start", "end")

上面的代碼告訴gwk，路由參數"start"，"end"是函數DataByIntRange的第一個和第二個參數。

也可以綁定到querypath或者form中的參數，比如:

// url: /data/namerange/?start=1&end=9server.RouteTable.Get("/data/namerange/").ToFunc(model.DataByIntRange).    BindByNames("start", "end")

再比如:

// url: get /data/set?str=string&uint=1024&int=32&float=3.14&byte=64server.RouteTable.Get("/data/set?").ToFunc(model.DataSet).    BindByNames("str", "uint", "int", "float", "byte")func DataSet(s string, u uint64, i int, f float32, b byte) *Data {    return &Data{        Str:   s,        Uint:  u,        Int:   i,        Float: f,        Byte:  b,    }}

如果參數比較多，一個合適的方法是將參數定義為一個struct，然後調用BindToStruct來綁定參數。比如:

// url: post /data/post?// form:{"str": {"string"}, "uint": {"1024"}, "int": {"32"}, "float": {"1.1"}, "byte": {"64"}}server.RouteTable.Post("/data/post?").ToFunc(model.DataPost).BindToStruct()func DataPost(data Data) string {    return data.String()}// url: post /data/postptr?// form:{"str": {"string"}, "uint": {"1024"}, "int": {"32"}, "float": {"1.1"}, "byte": {"64"}}server.RouteTable.Post("/data/postptr?").ToFunc(model.DataPostPtr).BindToStruct()func DataPostPtr(data *Data) string {    return data.String()}

如果覺得每個函數定義一個參數對象比較麻煩，也可以用匿名對象:

server.RouteTable.Get("/data/anonymous?").ToFunc(DataAnonymous).BindToStruct()func DataAnonymous(data struct {    Str   string    Uint  uint64    Int   int    Float float32    Byte  byte},) string {    return fmt.Sprintln(data)}

更方便的路由方式是註冊一個到controller的路由，在controller一節會介紹。

格式化

gwk會根據http請求中accept的內容來自動決定返回資料的格式，如果Request的Accept中包含字串"xml"，則結果序列化為xml格式，如果包含"jsonp"，則結果序列化為jsonp，如果包含json，則序列化為json格式。具體的例子可以看http://gwk-demo.appspot.com/doc/routedemo

你也可以通過設定Formatter來指定輸出的格式，Formatter的定義如下

type FormatFunc func(*HttpContext, interface{}) (HttpResult, bool)

gwk預設支援兩種序列化方式，xml和json。比如:

// url: /data/int/1/xmlserver.RouteTable.Get("/data/int/{p0}/xml").ToFunc(model.DataByInt).ReturnXml()// url: /data/int/1/jsonserver.RouteTable.Get("/data/int/{p0}/json").ToFunc(model.DataByInt).ReturnJson()

ReturnXml指定DataByInt的傳回值格式化為xml，ReturnJson指定DataByInt的傳回值格式化為json。

你也可以自訂序列化的方式，比如:

// url: /data/int/1/ksonserver.RouteTable.Get("/data/int/{p0}/kson").ToFunc(model.DataByInt).Return(formatKson)func formatKson(ctx *wk.HttpContext, x interface{}) (wk.HttpResult, bool) {    b, _ := kson.Marshal(x)    return wk.Content(string(b), "text/plain"), true}

kson格式是gwk的設定檔採用的格式，後文會詳細介紹，上面的代碼返回的資料如下:

{    Str:string:1    Uint:100    Int:10    Float:1.1    Byte:1}

gwk還提供了註冊全域FormatFunc的地方：

type FormatList []FormatFuncvar Formatters FormatList

你可以通過增刪Formatters或者修改Formatters的順序來調整預設的格式化方式。

Controller

當需要註冊的路由方法比較多，而且之間有一定的邏輯關係時，可以定義一個類似的asp.net mvc的Controller對象，然後將路由指向這個對象。代碼可以參考https://github.com/sdming/wk/blob/master/demo/basic/controller/basic.go

一個簡單的註冊Controller的例子如下:

basic = NewBasicController()// url: /basic/xxx/xxxserver.RouteTable.Path("/basic#/{action}/{id}").ToController(basic)

用Regex的話，例子如下

srv.RouteTable.Regexp("*", "^/user/?(?P<action>[[:alnum:]]+)?/?(?P<arg>[[:alnum:]]+)?/?").ToController(NewUserController())

註冊到controller的路由，一個特殊的路由參數是{action}，它指定了調用Controller的哪一個方法。比如/basic/delete/32對應的action是"delete"，調用controller的delete方法，一個例子如下:

// url: /basic/delete/32func (c *BasicController) Delete(ctx *wk.HttpContext) (result wk.HttpResult, err error) {    l := len(c.data)    if i, ok := ctx.RouteData.Int("id"); ok {        c.deleteByInt(i)    }    return wk.Data(l - len(c.data)), nil}

gwk現在版本的controller只支援func (ctx *wk.HttpContext) (result wk.HttpResult, err error)類型的方法，已經基本夠用了。

再看一個例子:

// url: /basic/add/?int=32&str=string&uint=1024&float=1.1&byte=64func (c *BasicController) Add(ctx *wk.HttpContext) (result wk.HttpResult, err error) {    data := &model.Data{        Int:   ctx.FormIntOr("int", 0),        Uint:  uint64(ctx.FormIntOr("uint", 0)),        Str:   ctx.FormValue("str"),        Float: float32(ctx.FormFloatOr("float", 0.0)),        Byte:  byte(ctx.FormIntOr("byte", 0)),    }    c.data = append(c.data, data)    return wk.Data(data.String()), nil}

FormIntOr，FormFloatOr等函數是為了方便讀取Request Form資料，可以參考RouteData的對應函數。

wk.Data函數返回 *DataResult對象，*DataResult實現了wk.HttpResult介面， HttpResult介面的詳細介紹見後面的章節。

func Data(data interface{}) *DataResult {    return &DataResult{        Data: data,    }}

再看一個返回json資料的例子

// url: /basic/int/32func (c *BasicController) Int(ctx *wk.HttpContext) (result wk.HttpResult, err error) {    if id, ok := ctx.RouteData.Int("id"); ok {        return wk.Json(c.getByInt(id)), nil    }    return wk.Data(""), nil}

再看一個直接讀取post的資料，解析成json的例子:

// url: post /basic/postfunc (c *BasicController) Post(ctx *wk.HttpContext) (result wk.HttpResult, err error) {    var body []byte    if body, err = ctx.ReadBody(); err != nil {        return nil, err    }    data := &model.Data{}    err = json.Unmarshal(body, data)    if err != nil {        return nil, err    }    c.data = append(c.data, data)    return wk.Data(true), nil}

如果沒有找到路由參數{action}，gwk會將http method作為action，也就是把"get"，"post"，"delete"作為action，如果找不到對應的方法，會將{action}{method}組合起來作為action，這在一些場合還是比較實用的，如果還找不到對應的方法，則將"default"作為action，如果還是找不到對應的方法，則返回404.

各種流行的MVC類開發架構比較多，controller應該不用做過多的介紹，接下來介紹HttpResult介面。