Golang Web 框架 Iris 安装与核心用法指南

Iris 框架安装

Iris 基于 go module 进行包管理。在项目中执行以下命令即可获取最新版本（master）：

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

快速上手服务

启动一个基础的 Iris 服务仅需三个步骤：创建应用实例、定义路由逻辑、监听端口。以下代码展示了在根路径返回 JSON 数据的示例：

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

运行上述代码后，访问 127.0.0.1:8080 即可获得包含成功状态的 JSON 响应。

RESTful API 开发实践

Iris 支持标准的 HTTP 方法路由，适合构建 RESTful 风格的接口。以下是常见数据操作的实现方式：

第1步：查询数据（GET）

在路由地址中使用大括号 {} 可以捕获路径参数，并通过 c.Params().Get() 方法读取。例如，获取商品 ID：

// 访问 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"),
   })
})

第2步：新增数据（POST）

新增数据时，可使用表单或 JSON 格式传输。Iris 提供了多种便捷方法解析数据：

• 表单解析：使用 PostValue 接收字段，配合 PostValueInt 等函数可直接转换类型。

// 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"),
   })
})

• JSON 绑定：定义结构体并使用 ReadJSON 将请求体自动映射到对象，适用于前端传递 JSON 数据的场景。

type Good struct {
   Name string
}

// 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,
   })
})

第3步：修改数据（PUT）

使用 app.Put 注册更新接口，同样可结合 PostValue 或 ReadJSON 获取客户端提交的数据：

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

第4步：删除数据（DELETE）

删除操作使用 app.Delete 注册路由，参数获取方式与查询接口一致：

app.Delete("/goods/{id}", func(c iris.Context) {
   // 处理删除逻辑
   c.JSON(iris.Map{"status": "deleted"})
})

静态站点部署

若需通过 Iris 托管静态资源（如图片、CSS），可使用 HandleDir 方法映射本地目录。配置后，访问对应 URL 即可直接获取文件：

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

以上配置生效时，访问 127.0.0.1:8080/static/xxx.png 便会返回位于服务器 /user/local/my-iris/static 目录下的图片资源。

以上就是 Golang Web 框架 Iris 安装部署与核心用法的详细内容，更多关于 Golang Web 框架 Iris 的资料请关注本站其它相关文章！