当前位置：首页 > article >正文

gin入门教程（5）：请求参数处理

article 2024/10/24 5:48:08

在 Gin 中，处理请求参数非常简单。您可以从 URL 路由、查询字符串和请求体中提取参数。以下是几种常见的处理方式：

1. URL 路由参数

如果您想从 URL 中获取参数，可以使用路由定义中的冒号（:）符号：

r.GET("/users/:id", getUser)

处理函数示例：

func getUser(c *gin.Context) {
    id := c.Param("id") // 获取 URL 参数
    // 处理逻辑，例如查找用户
    c.JSON(200, gin.H{"user_id": id})
}

2. 查询字符串参数

您可以从请求的查询字符串中获取参数，例如：

r.GET("/search", searchUsers)

处理函数示例：

func searchUsers(c *gin.Context) {
    name := c.Query("name") // 获取查询参数
    // 处理逻辑，例如根据名称搜索用户
    c.JSON(200, gin.H{"search_name": name})
}

3. 请求体参数（JSON）

如果客户端发送 JSON 数据，您可以将其绑定到结构体中：

r.POST("/users", createUser)

处理函数示例：

type User struct {
    Name  string `json:"name"`
    Email string `json:"email"`
}

func createUser(c *gin.Context) {
    var user User
    if err := c.ShouldBindJSON(&user); err == nil {
        // 处理用户创建逻辑
        c.JSON(201, user)
    } else {
        c.JSON(400, gin.H{"error": err.Error()})
    }
}

4. 组合示例

以下是一个完整的示例，展示了 URL 参数、查询字符串和请求体参数的处理：

package main

import (
    "github.com/gin-gonic/gin"
)

type User struct {
    Name  string `json:"name"`
    Email string `json:"email"`
}

func main() {
    r := gin.Default()

    r.POST("/users", createUser)
    r.GET("/users/:id", getUser)
    r.GET("/search", searchUsers)

    r.Run(":8080")
}

func createUser(c *gin.Context) {
    var user User
    if err := c.ShouldBindJSON(&user); err == nil {
        c.JSON(201, user)
    } else {
        c.JSON(400, gin.H{"error": err.Error()})
    }
}

func getUser(c *gin.Context) {
    id := c.Param("id")
    c.JSON(200, gin.H{"user_id": id})
}

func searchUsers(c *gin.Context) {
    name := c.Query("name")
    c.JSON(200, gin.H{"search_name": name})
}