Golang Web架構 Tiny Go Web

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

Tiny Go Web (TGW)是一個非常簡單的Web架構，甚至談不上架構。TGW無意取代任何架構，TGW的誕生是因為作者在使用beego時有種挫敗感，決定自己重新寫一個適合自己網站用的(私人借書網，因為網站沒有完成備案，暫時由託管在US的vps進行反向 Proxy到ucloud主機，訪問可能會有一定的延時)，從構思到完成總共只花了一天時間，因為覺得它已經夠用了，就沒有繼續添加新的功能。

項目地址:http://github.com/icattlecoder/tgw

Qiuck Start

> go get github.com/icattlecoder/tgw> cd src/github.com/icattlecoder/tgw/example> go build> ./example 

控制器

控制器實現自動路由註冊，例如有以下的結構

type Server struct {    //成員由商務邏輯而定，如mgo的資料庫連接資訊等}func NewServer( /*入參，例如從設定檔中讀取*/) *Server {    return &Server{}}//對應模板為index.html ,傳回值data用於渲染模板func (s *Server) Index() (data map[string]interface{}) {    data = map[string]interface{}{}    author := Author{        Name:  "icattlecoder",        Email: []string{"icattlecoder@gmail.com", "iwangming@hotmail.com"},        QQ:    "405283013",        Blog:  "http://blog.segmentfault.com/icattlecoder",    }    data["author"] = author    return}//由於沒有json.html模板，但是卻有data傳回值，此data將以json字串的格式返回func (s *Server) Json() (data map[string]interface{}) {    data = map[string]interface{}{}    author := Author{        Name:  "icattlecoder",        Email: []string{"icattlecoder@gmail.com", "iwangming@hotmail.com"},        QQ:    "405283013",        Blog:  "http://blog.segmentfault.com/icattlecoder",    }    data["author"] = author    return}//這雷根據請求自動解析出args//例如可將 /hello?msg=hello world的函數解析為TestArgs{Msg:"hello world"}//由於沒有hello.html模板，並且沒有傳回值，可以通過env中的RW成員寫入返回資料func (s *Server) Hello(args TestArgs, env tgw.ReqEnv) {    env.RW.Write([]byte(args.Msg))    err = env.Session.Set("key", args)    if err != nil {        log.Println(err)    }}func (s *Server) AdminIndex(){}

以下是程式啟動代碼

func main() {    ser := controllers.NewServer()    t:=tgw.NewTGW()    log.Fatal(t.Register(&ser).Run(":8080"))}

tgw的Register方法會自動註冊以下的路由：

/hello       ===> func (s *Server) Hello(args TestArgs, env tgw.ReqEnv)/index       ===> func (s *Server) Index() (data map[string]interface{}) /Json        ===> func (s *Server) Json() (data map[string]interface{})/admin/index ===> func (s *Server) AdminIndex()

即localhost:8080/index的處理函數是service.Index,localhost:8080/admin/index的處理函數是service.AdminIndex

視圖

視圖預設放在view檔案夾中，其檔案名稱與url有關，例如：/index對應 view/index.html
如果某個url沒有對應的視圖，但是它的處理函數卻有傳回值，那麼將返回對象JOSN序列化的結果。
視圖中可以通過<include src="<src>" />指令包含其它檔案，如公用頭地區。

參數解析

以下面的代碼為例：

type TestArgs struct {    Msg string}func (s *Server) Hello(args TestArgs, env tgw.ReqEnv)

對於請求localhost:8080/Hello?msg=Hello world，tgw將自動根據要求方法(POST或GET)識別並解析出TestArgs變數.
當前能夠自動解析的類型有int、string、bool、float64

擴充參數解析

tgw內建*Args參數解析，即結構名符合*Args的參數都可以自動解析。如果需要定製解析，實現Parser介面即可

Session支援

架構實現了一個簡單的session管理,基本滿足一般的需求，如果需要使用session，處理函數必須有一個類型為tgw.ReqEnv的參數,通過此函數可訪問Session。另外，Session的值由memcached儲存，因此實際運行時需要一個memecached服務。

自訂輸出

如果函數包含類型為tgw.ReqEnv參數，且無傳回值，可以直接向ReqEnv.RW中寫入返回結果。