go gin router

### Gin 框架中的路由用法 #### 路由基础概念 Gin 是一个基于 Go (Golang) 的 HTTP web 框架，具有良好的性能表现。其核心特性之一就是简单而强大的路由机制[^3]。 #### 定义基本路由 通过 `gin.Default()` 创建默认引擎实例并定义简单的 GET 请求处理函数： ```go package main import ( "net/http" "github.com/gin-gonic/gin" ) func main() { r := gin.Default() r.GET("/ping", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ "message": "pong", }) }) r.Run() // 默认监听并在 0.0.0.0:8080 上启动服务 } ``` 此代码片段展示了如何创建一个新的 Gin 工程，并设置了一个 `/ping` URL 映射到特定处理器上，在收到请求时返回 JSON 响应消息 “pong”。 #### 参数化路径变量 为了支持动态部分作为参数传递给控制器方法，可以利用冒号来标记 URI 中的占位符名称: ```go r.GET("/user/:name", func(c *gin.Context) { name := c.Param("name") c.String(http.StatusOK, "Hello %s", name) }) ``` 上述例子说明了当访问形如 `/user/john` 这样的链接时会提取出 `john` 并将其赋值给变量 `name` 后打印问候语句。 #### 查询字符串解析 对于带有查询条件的URL可以通过内置的方法轻松获取这些附加的信息项： ```go r.GET("/search", func(c *gin.Context) { q := c.Query("q") // 获取单个查询参数 page := c.DefaultQuery("page", "1") // 设置缺省值为 "1" c.JSON(200, gin.H{ "query": q, "page": page, }) }) ``` 这里演示了两种方式读取来自客户端提交的数据——直接调用 `c.Query()` 或者指定默认值得情况下使用 `DefaultQuery()` 方法。 #### 处理表单数据与JSON体 除了GET之外其他HTTP动词也可以被用来接收更复杂的内容类型比如POST/PUT/PATCH等操作下的form-data或者是application/json格式的有效载荷： ```go // 表单字段绑定 type LoginForm struct { User string `form:"user" binding:"required"` Password string `form:"password" binding:"required"` } r.POST("/login", func(c *gin.Context) { var form LoginForm if err := c.ShouldBind(&form); err != nil { c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) return } c.JSON(http.StatusOK, gin.H{ "user": form.User, "password": "[redacted]", }) }) // JSON Body 绑定 type User struct { Name string `json:"name" binding:"required"` Address string `json:"address"` } r.PUT("/update_user", func(c *gin.Context) { var json User if err := c.ShouldBindJSON(&json); err != nil { c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) return } c.JSON(http.StatusOK, gin.H{ "name": json.Name, "address": json.Address, }) }) ``` 以上两个示例分别介绍了怎样从HTML表单位置以及API接口处接受结构化的输入资料并通过Go语言特有的标签语法完成自动映射过程。

在 Gin 框架中，`router.DELETE` 和 `router.POST` 是用于定义路由和处理函数的方法，它们对应的 HTTP 请求方法是 DELETE 和 POST。下面是它们的区别： 1. **HTTP 请求方法**：`router.DELETE` 用于处理 HTTP DELETE 请求，而 `router.POST` 用于处理 HTTP POST 请求。 2. **语义约定**：根据 RESTful API 设计的约定，DELETE 方法通常用于删除资源，而 POST 方法通常用于创建资源。 3. **幂等性**：DELETE 方法是幂等的，即多次请求相同的数据结果也是一样的。而 POST 方法不是幂等的，多次请求相同的数据会创建多个资源。 4. **URL 设计**：DELETE 方法常常使用带有资源标识符的 URL，例如 `/users/1` 表示删除 ID 为 1 的用户。POST 方法通常使用不带资源标识符的 URL，例如 `/users` 表示创建新用户。 5. **请求体**：DELETE 方法通常不包含请求体，因为它主要用于删除资源。POST 方法可以包含完整或部分资源信息，用于服务器创建新资源。 总结来说，DELETE 方法用于删除资源，不需要请求体；POST 方法用于创建资源，可以包含完整或部分资源信息。 在 Gin 框架中，我们可以使用 `router.DELETE` 和 `router.POST` 方法来定义路由和处理函数，以处理不同的 HTTP 请求方法。例如： ```go // DELETE 请求 router.DELETE("/users/:id", deleteUser) // POST 请求 router.POST("/users", createUser) ``` 以上示例中，`router.DELETE` 定义了处理 DELETE 请求的路由，并调用 `deleteUser` 函数进行处理。而 `router.POST` 定义了处理 POST 请求的路由，并调用 `createUser` 函数进行处理。 希望这能回答你的问题！如果还有其他疑问，请随时提问。