引言

Iris作為Golang中新興的Web框架，比Gin晚了兩年，于2016年開源，到目前為止已具備了較為完備的功能，參考Iris官方的數(shù)據(jù)可以發(fā)現(xiàn)，Iris不論在響應(yīng)速度上還是吞吐量上都比同類型的Web框架高，通過本文可以了解如何在Web項目中使用Iris框架。

官方文檔：www.iris-go.com/docs/#/?id=…

Iris 安裝

和其他Web框架一樣，通過 go module 來安裝Iris

go get github.com/kataras/iris/v12@master

快速上手

通過簡單的三步曲既可啟動一個Iris服務(wù)：

獲取Iris對象-->配置路由的處理邏輯-->啟動監(jiān)聽服務(wù)，在main函數(shù)中啟動后，訪問127.0.0.1:8080可以獲得返回的json數(shù)據(jù) {"code":200,"msg":"success"}

app := iris.New()
// 指定根路徑 / 的處理邏輯
app.Get("/", func(c iris.Context) {
   c.JSON(iris.Map{
      "code": 200,
      "msg":  "success",
   })
})
// 監(jiān)聽 8080 端口，并提供Web服務(wù)
app.Listen(":8080")

在Iris中使用RESTful風(fēng)格的API

• 查詢數(shù)據(jù)

在路由地址中使用中括號{}，括起來的部分可以通過c.Params().Get()的方式獲取

// curl 127.0.0.1:8080/goods/123
app.Get("/goods/{id}", func(c iris.Context) {
   c.JSON(iris.Map{
      "id":  c.Params().Get("id"),
   })
})

• 新增數(shù)據(jù)

使用PostValue接受表單傳遞過來的參數(shù)，同時Iris還提供了PostValueInt、PostValueFloat32等方法，方便將前端傳遞過來的數(shù)據(jù)進(jìn)行快速轉(zhuǎn)化成相對應(yīng)的類型，或者設(shè)置其該有的默認(rèn)值等

// curl -X POST -d 'name=goods_name' 127.0.0.1:8080/goods
app.Post("/goods", func(c iris.Context) {
   c.JSON(iris.Map{
      "id":  c.PostValue("name"),
   })
})

使用ReadJson方法，將傳遞過來的數(shù)據(jù)Json格式化到指定的結(jié)構(gòu)體中

定義一個用于接收數(shù)據(jù)的結(jié)構(gòu)體

type Good struct {
   Name string
}

使用ReadJson方法將context中的數(shù)據(jù)渲染到good上

// curl -X POST -d '{"name":"goods_name"}' 127.0.0.1:8080/goods
good := new(Good)
app.Post("/goods", func(c iris.Context) {
   c.ReadJSON(good)
   c.JSON(iris.Map{
      "name":  good.Name,
   })
})

• 修改數(shù)據(jù)

使用PUT方法封裝路由，使用PostValue方法獲取用戶傳遞過來的數(shù)據(jù)，這里也可以結(jié)合上面所說的ReadJson方法，讀取用戶傳遞過來的數(shù)據(jù)

app.Put("/goods", func(c iris.Context) {
   c.JSON(iris.Map{
      "name":   c.PostValue("name"),
   })
})

• 刪除數(shù)據(jù)

刪除數(shù)據(jù)這里不同的點(diǎn)是使用app.Delete方法，至于參數(shù)的傳遞與獲取方面與上文的查詢數(shù)據(jù)時所說的方法一致了

靜態(tài)站點(diǎn)部署

通過HandleDir方法指定靜態(tài)資源文件所處的目錄即可，參考以下代碼配置后，訪問地址127.0.0.1:8080/static/xxx.png，就能獲取到static目錄下的xxx圖片

app.HandleDir("/static", "/user/local/my-iris/static")