上下文

Context API

Context 提供对请求和响应数据的访问。

获取 Context

Fox 处理器可以选择性地接受 *gin.Context 参数：

r.GET("/path", func(c *gin.Context) (any, error) {
    // 访问 context
    return response, nil
})

请求数据

查询参数

name := c.Query("name")              // 获取查询参数
page := c.DefaultQuery("page", "1")  // 带默认值

路径参数

r.GET("/user/:id", func(c *gin.Context) {
    id := c.Param("id")
})

请求头

token := c.GetHeader("Authorization")
userAgent := c.Request.UserAgent()

请求体

var data map[string]any
c.ShouldBindJSON(&data)

客户端 IP

ip := c.ClientIP()

响应

JSON 响应

c.JSON(200, gin.H{
    "message": "success",
})

字符串响应

c.String(200, "Hello, World!")

HTML 响应

c.HTML(200, "index.html", gin.H{
    "title": "主页",
})

重定向

c.Redirect(302, "/new-path")

状态码

c.Status(204) // No Content

Context 数据

设置值

c.Set("user_id", 123)

获取值

userID := c.GetInt("user_id")
value, exists := c.Get("key")

Must Get

userID := c.MustGet("user_id").(int)

文件处理

单文件上传

file, _ := c.FormFile("file")
c.SaveUploadedFile(file, "./uploads/"+file.Filename)

多文件上传

form, _ := c.MultipartForm()
files := form.File["files"]

for _, file := range files {
    c.SaveUploadedFile(file, "./uploads/"+file.Filename)
}

提供文件

c.File("./assets/image.png")

Cookies

设置 Cookie

c.SetCookie(
    "session_id",           // name
    "abc123",               // value
    3600,                   // maxAge (seconds)
    "/",                    // path
    "example.com",          // domain
    false,                  // secure
    true,                   // httpOnly
)

获取 Cookie

value, err := c.Cookie("session_id")

中止

停止处理并返回：

if !isAuthenticated(c) {
    c.JSON(401, gin.H{"error": "未授权"})
    c.Abort()
    return
}

Fox 特定方法

获取 Logger

logger := fox.GetLogger(c)
logger.Info("处理请求")

获取 TraceID

traceID := fox.GetTraceID(c)

下一步

• 路由器 API - 路由器配置
• 中间件 - 自定义中间件