引言
Iris作为Golang中新兴的Web框架，比Gin晚了两年，于2016年开源，到目前为止已具备了较为完备的功能，参考Iris官方的数据可以发现，Iris不论在响应速度上还是吞吐量上都比同类型的Web框架高，通过本文可以了解如何在Web项目中使用Iris框架。
官方文档：www.iris-go.com/docs/#/?id=…
Iris 安装
和其他Web框架一样，通过 go module 来安装Iris
|
1 |
go get github.com/kataras/iris/v12@master |
快速上手
通过简单的三步曲既可启动一个Iris服务：
获取Iris对象-->配置路由的处理逻辑-->启动监听服务，在main函数中启动后，访问127.0.0.1:8080可以获得返回的json数据 {"code":200,"msg":"success"}
|
1 2 3 4 5 6 7 8 9 10 |
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()的方式获取
|
1 2 3 4 5 6 |
// 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等方法，方便将前端传递过来的数据进行快速转化成相对应的类型，或者设置其该有的默认值等
|
1 2 3 4 5 6 |
// 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格式化到指定的结构体中
定义一个用于接收数据的结构体
|
1 2 3 |
type Good struct { Name string } |
使用ReadJson方法将context中的数据渲染到good上
|
1 2 3 4 5 6 7 8 |
// 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方法，读取用户传递过来的数据
|
1 2 3 4 5 |
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图片
|
1 |
app.HandleDir("/static", "/user/local/my-iris/static") |
