Golang Web框架Iris

时间:2022-09-28 GetcharZp 人气:0

引言

Iris作为Golang中新兴的Web框架，比Gin晚了两年，于2016年开源，到目前为止已具备了较为完备的功能，参考Iris官方的数据可以发现，Iris不论在响应速度上还是吞吐量上都比同类型的Web框架高，通过本文可以了解如何在Web项目中使用Iris框架。

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

Iris 安装

和其他Web框架一样，通过 go module 来安装Iris

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

快速上手

通过简单的三步曲既可启动一个Iris服务：

获取Iris对象-->配置路由的处理逻辑-->启动监听服务，在main函数中启动后，访问127.0.0.1:8080可以获得返回的json数据 {"code":200,"msg":"success"}

app := iris.New()
// 指定根路径 / 的处理逻辑
app.Get("/", func(c iris.Context) {
   c.JSON(iris.Map{
      "code": 200,
      "msg":  "success",
   })
})
// 监听 8080 端口，并提供Web服务
app.Listen(":8080")

在Iris中使用RESTful风格的API

查询数据

在路由地址中使用中括号{}，括起来的部分可以通过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"),
   })
})

新增数据

使用PostValue接受表单传递过来的参数，同时Iris还提供了PostValueInt、PostValueFloat32等方法，方便将前端传递过来的数据进行快速转化成相对应的类型，或者设置其该有的默认值等

// 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方法，将传递过来的数据Json格式化到指定的结构体中

定义一个用于接收数据的结构体

type Good struct {
   Name string
}

使用ReadJson方法将context中的数据渲染到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,
   })
})

修改数据

使用PUT方法封装路由，使用PostValue方法获取用户传递过来的数据，这里也可以结合上面所说的ReadJson方法，读取用户传递过来的数据

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

删除数据

删除数据这里不同的点是使用app.Delete方法，至于参数的传递与获取方面与上文的查询数据时所说的方法一致了

静态站点部署

通过HandleDir方法指定静态资源文件所处的目录即可，参考以下代码配置后，访问地址127.0.0.1:8080/static/xxx.png，就能获取到static目录下的xxx图片

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

加载全部内容