在 Gin 框架中，路径参数是通过在 URL 路径中定义动态部分来传递数据的。这些动态部分通常使用冒号（:）表示。在请求到达时，Gin 会将这些动态路径部分提取出来，并赋值给对应的参数。
路径参数可以在路由定义时使用 : 来标记。通过 c.Param("param_name") 方法获取路径参数的值。
Life is like a journey
package main
import (
"fmt"
"github.com/gin-gonic/gin"
)
func main() {
// 创建 Gin 路由
r := gin.Default()
// 定义路由，使用路径参数
r.GET("/user/:id", func(c *gin.Context) {
// 获取路径参数
id := c.Param("id")
c.JSON(200, gin.H{
"user_id": id,
})
})
// 启动服务器
r.Run(":8080")
}
在上述代码中：
r.GET("/user/:id", func(c *gin.Context)) 定义了一个带有路径参数的路由，其中 :id 就是一个路径参数。c.Param("id") 获取路径参数 id 的值。假设我们访问 GET /user/123：
/user/123id 参数的值为 123，可以通过 c.Param("id") 获取。返回的 JSON 数据为：
{
"user_id": "123"
}
你可以在路径中定义多个路径参数，只需要在路由中使用多个冒号标记。
package main
import (
"fmt"
"github.com/gin-gonic/gin"
)
func main() {
// 创建 Gin 路由
r := gin.Default()
// 定义路由，使用多个路径参数
r.GET("/user/:id/book/:book_id", func(c *gin.Context) {
// 获取路径参数
id := c.Param("id")
bookID := c.Param("book_id")
c.JSON(200, gin.H{
"user_id": id,
"book_id": bookID,
})
})
// 启动服务器
r.Run(":8080")
}
假设我们访问 GET /user/123/book/456：
/user/123/book/456id 参数的值为 123，book_id 参数的值为 456。返回的 JSON 数据为：
{
"user_id": "123",
"book_id": "456"
}
Gin 允许你根据路径参数动态地创建不同的路由，通常配合 Group 来进行路由分组管理。
package main
import (
"fmt"
"github.com/gin-gonic/gin"
)
func main() {
// 创建 Gin 路由
r := gin.Default()
// 使用 Group 路由
v1 := r.Group("/v1")
{
// 路由带有路径参数
v1.GET("/user/:id", func(c *gin.Context) {
id := c.Param("id")
c.JSON(200, gin.H{
"user_id": id,
})
})
}
// 启动服务器
r.Run(":8080")
}
假设我们访问 GET /v1/user/123：
/v1/user/123id 参数的值为 123。返回的 JSON 数据为：
{
"user_id": "123"
}
路径参数和查询参数可以一起使用，路径参数用于指定资源，而查询参数可以提供额外的过滤、排序或分页信息。
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
r := gin.Default()
// 路径参数和查询参数
r.GET("/user/:id", func(c *gin.Context) {
id := c.Param("id")
name := c.DefaultQuery("name", "Guest") // 获取查询参数，若没有则使用默认值
c.JSON(200, gin.H{
"user_id": id,
"name": name,
})
})
// 启动服务器
r.Run(":8080")
}
GET /user/123 返回：{
"user_id": "123",
"name": "Guest"
}
GET /user/123?name=John 返回：{
"user_id": "123",
"name": "John"
}
路径参数默认是字符串类型。如果需要将路径参数转换为其他类型（如整型），你可以在获取参数后进行转换：
package main
import (
"fmt"
"github.com/gin-gonic/gin"
"strconv"
)
func main() {
r := gin.Default()
// 路由定义，接收路径参数并将其转换为整型
r.GET("/user/:id", func(c *gin.Context) {
idStr := c.Param("id")
id, err := strconv.Atoi(idStr) // 将路径参数转换为整数
if err != nil {
c.JSON(400, gin.H{"error": "Invalid ID"})
return
}
c.JSON(200, gin.H{
"user_id": id,
})
})
// 启动服务器
r.Run(":8080")
}
GET /user/123 返回：{
"user_id": 123
}
GET /user/abc 返回：{
"error": "Invalid ID"
}
在 Gin 中，路径参数通过 : 标记动态部分，允许你在 URL 中提取参数并使用它们：
c.Param("param_name") 获取路径中的动态部分。c.Param("param_name") 获取每个参数。Gin 提供了一个灵活的机制来处理路径参数，使得基于 URL 的数据传递变得非常简单。