安裝iris
<span style="font-size: 14px;">go get github.com/kataras/iris<br></span>
##實例
##註冊一個route到服務的API<span style="font-size: 14px;">app := iris.New()<br><br>app.Handle("GET", "/ping", func(ctx iris.Context) {<br> ctx.JSON(iris.Map{"message": "pong"})<br>})<br><br>app.Run(iris.Addr(":8080"))<br></span>
幾行程式碼就可以實現，透過瀏覽器存取http://localhost :8080/ping會回傳{"message":"pong"}#使用Handle函數可以註冊方法，路徑和對應的處理函數
#新增middleware
如果我們希望記錄下所有的請求的log資訊也希望在呼叫對應的route時確認請求的UA是否是我們允許的可以透過Use函數來新增對應的middleware
<span style="font-size: 14px;">package main<br/><br/>import (<br/> "github.com/kataras/iris"<br/> "github.com/kataras/iris/middleware/logger"<br/>)<br/><br/>func main() {<br/> app := iris.New()<br/><br/> app.Use(logger.New())<br/> app.Use(checkAgentMiddleware)<br/><br/> app.Handle("GET", "/ping", func(ctx iris.Context) {<br/> ctx.JSON(iris.Map{"message": "pong"})<br/> })<br/><br/> app.Run(iris.Addr(":8080"))<br/>}<br/><br/>func checkAgentMiddleware(ctx iris.Context) {<br/> ctx.Application().Logger().Infof("Runs before %s", ctx.Path())<br/> user_agent := ctx.GetHeader("User-Agent")<br/><br/> if user_agent != "pingAuthorized" {<br/> ctx.JSON("No authorized for ping")<br/> return<br/> }<br/> ctx.Next()<br/>}<br/></span>
取得請求參數，展示到html
bookinfo.html<span style="font-size: 14px;"><html><br/> <head>Book information</head><br/> <body><br/> <h2 id="nbsp-bookName-nbsp">{{ .bookName }}</h2><br/> <h1 id="nbsp-bookID-nbsp">{{ .bookID }}</h1><br/> <h1 id="nbsp-author-nbsp">{{ .author }}</h1><br/> <h1 id="nbsp-chapterCount-nbsp">{{ .chapterCount }}</h1><br/> </body><br/></html><br/></span>
#<span style="font-size: 14px;">package main<br/><br/>import "github.com/kataras/iris"<br/><br/>func main() {<br/> app := iris.New()<br/><br/> app.RegisterView(iris.HTML("./views", ".html"))<br/><br/> app.Handle("GET", "/bookinfo/{bookid:string}", func(ctx iris.Context) {<br/> bookID := ctx.Params().GetString("bookid")<br/><br/> ctx.ViewData("bookName", "Master iris")<br/> ctx.ViewData("bookID", bookID)<br/> ctx.ViewData("author", "Iris expert")<br/> ctx.ViewData("chapterCount", "40")<br/><br/> ctx.View("bookinfo.html")<br/> })<br/><br/> app.Run(iris.Addr(":8080"))<br/>}<br/></span>
ctx.Params().GetString("bookid")設定html中變數的值
ctx.ViewData(key, value)route允許和禁止外部存取
實際使用中有時會有些route只能內部使用，對外訪問不到。
可以透過使用XXX_route.Method = iris.MethodNone設定為offline內部呼叫透過使用函數Context.Exec("NONE", "/XXX_yourroute")
<span style="font-size: 14px;">package main<br/><br/>import "github.com/kataras/iris"<br/><br/>import "strings"<br/><br/>func main() {<br/> app := iris.New()<br/><br/> magicAPI := app.Handle("NONE", "/magicapi", func(ctx iris.Context) {<br/> if ctx.GetCurrentRoute().IsOnline() {<br/> ctx.Writef("I'm back!")<br/> } else {<br/> ctx.Writef("I'll be back")<br/> }<br/> })<br/><br/> app.Handle("GET", "/onoffhandler/{method:string}/{state:string}", func(ctx iris.Context) {<br/> changeMethod := ctx.Params().GetString("method")<br/> state := ctx.Params().GetString("state")<br/><br/> if changeMethod == "" || state == "" {<br/> return<br/> }<br/><br/> if strings.Index(magicAPI.Path, changeMethod) == 1 {<br/> settingState := strings.ToLower(state)<br/> if settingState == "on" || settingState == "off" {<br/> if strings.ToLower(state) == "on" && !magicAPI.IsOnline() {<br/> magicAPI.Method = iris.MethodGet<br/> } else if strings.ToLower(state) == "off" && magicAPI.IsOnline() {<br/> magicAPI.Method = iris.MethodNone<br/> }<br/><br/> app.RefreshRouter()<br/><br/> ctx.Writef("\n Changed magicapi to %s\n", state)<br/> } else {<br/> ctx.Writef("\n Setting state incorrect(\"on\" or \"off\") \n")<br/> }<br/><br/> }<br/> })<br/><br/> app.Handle("GET", "/execmagicapi", func(ctx iris.Context) {<br/> ctx.Values().Set("from", "/execmagicapi")<br/><br/> if !magicAPI.IsOnline() {<br/> ctx.Exec("NONE", "/magicapi")<br/> } else {<br/> ctx.Exec("GET", "/magicapi")<br/> }<br/> })<br/><br/> app.Run(iris.Addr(":8080"))<br/>}<br/></span>
<1>访问http://localhost:8080/magicapi，返回Not found。说明route magicapi对外无法访问
<2>访问http://localhost:8080/execmagicapi，返回I'll be back。在execmagicapi处理函数中会执行 ctx.Exec("GET", "/magicapi")调用offline的route magicapi。在magicapi中会判断自己是否offline，如果为offline则返回I'll be back。
<3>访问http://localhost:8080/onoffhandler/magicapi/on改变magicapi为online
<4>再次访问http://localhost:8080/magicapi，返回I'm back!。说明route /mabicapi已经可以对外访问了
在實際應用中會根據實際功能進行route的分類，例如users，books，community等。
/users/getuserdetail
/users/getusercharges
/users/getuserhistory
/books/bookinfo
/books/chapterlist
對於這類route可以把他們劃分在users的group和books的group。對該group會有共通的handler處理共同的一些處理
<span style="font-size: 14px;">package main<br/><br/>import (<br/> "time"<br/><br/> "github.com/kataras/iris"<br/> "github.com/kataras/iris/middleware/basicauth"<br/>)<br/><br/>func bookInfoHandler(ctx iris.Context) {<br/> ctx.HTML("<h1 id="Calling-nbsp-bookInfoHandler-nbsp">Calling bookInfoHandler </h1>")<br/> ctx.HTML("<br/>bookID:" + ctx.Params().Get("bookID"))<br/> ctx.Next()<br/>}<br/><br/>func chapterListHandler(ctx iris.Context) {<br/> ctx.HTML("<h1 id="Calling-nbsp-chapterListHandler-nbsp">Calling chapterListHandler </h1>")<br/> ctx.HTML("<br/>bookID:" + ctx.Params().Get("bookID"))<br/> ctx.Next()<br/>}<br/><br/>func main() {<br/> app := iris.New()<br/><br/> authConfig := basicauth.Config{<br/> Users: map[string]string{"bookuser": "testabc123"},<br/> Realm: "Authorization required",<br/> Expires: time.Duration(30) * time.Minute,<br/> }<br/><br/> authentication := basicauth.New(authConfig)<br/><br/> books := app.Party("/books", authentication)<br/><br/> books.Get("/{bookID:string}/bookinfo", bookInfoHandler)<br/> books.Get("/chapterlist/{bookID:string}", chapterListHandler)<br/><br/> app.Run(iris.Addr(":8080"))<br/>}<br/></span>上例中使用了basicauth。所有造訪books group的routes都會先做auth認證。認證方式是username和password。 在postman中存取http://localhost:8080/books/sfsg3234/bookinfo
設定Authorization為Basic Auth，Username和Password設定為程式中的值，訪問會正確回應。否則會回覆Unauthorized
