3. 路由与分组：基础路由定义、RESTful 风格路由、路由分组与中间件作用域

在 GinGo 框架中，路由是请求入口与业务逻辑之间的桥梁。本章将系统讲解基础路由定义、RESTful 风格路由设计、路由分组机制以及中间件的作用域控制，帮助你在微服务架构中构建清晰、可维护的接口层。

3.1 基础路由定义

GinGo 的路由引擎基于 HTTP 方法 + 路径模式进行匹配。每个路由绑定一个处理函数（Handler），当请求方法与路径匹配时，框架自动调用对应的 Handler。

package main

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

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

    // 基础路由定义
    router.GET("/orders", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"message": "获取订单列表"})
    })

    router.POST("/orders", func(c *gin.Context) {
        c.JSON(http.StatusCreated, gin.H{"message": "创建订单"})
    })

    router.GET("/orders/:id", func(c *gin.Context) {
        id := c.Param("id")
        c.JSON(http.StatusOK, gin.H{"order_id": id})
    })

    router.DELETE("/orders/:id", func(c *gin.Context) {
        id := c.Param("id")
        c.JSON(http.StatusOK, gin.H{"deleted": id})
    })

    router.Run(":8080")
}

3.2 RESTful 风格路由设计

RESTful 风格将每个 URL 视为一个资源，通过 HTTP 方法表达对资源的操作。GinGo 原生支持这种设计模式，推荐在微服务接口编排中统一采用。

// RESTful 风格路由示例
router.GET("/users", listUsers)
router.POST("/users", createUser)
router.GET("/users/:id", getUserByID)
router.PUT("/users/:id", updateUser)
router.DELETE("/users/:id", deleteUser)

// 子资源嵌套
router.GET("/users/:id/orders", listUserOrders)
router.POST("/users/:id/orders", createUserOrder)

3.3 路由分组与中间件作用域

路由分组（Group）允许你将具有相同前缀或相同中间件需求的多个路由组织在一起。中间件的作用域可以精确控制到分组级别，实现细粒度的请求处理链。

// 路由分组与中间件作用域示例
func main() {
    router := gin.Default()

    // 全局中间件：所有路由都会经过
    router.Use(gin.Logger(), gin.Recovery())

    // 公开分组：无需鉴权
    public := router.Group("/api/v1")
    {
        public.POST("/login", loginHandler)
        public.POST("/register", registerHandler)
    }

    // 受保护分组：需要鉴权中间件
    authorized := router.Group("/api/v1")
    authorized.Use(authMiddleware())
    {
        authorized.GET("/users", listUsers)
        authorized.GET("/users/:id", getUserByID)
        authorized.PUT("/users/:id", updateUser)

        // 嵌套分组：订单相关接口，额外添加操作审计
        orders := authorized.Group("/orders")
        orders.Use(auditMiddleware())
        {
            orders.GET("", listOrders)
            orders.POST("", createOrder)
            orders.GET("/:orderId", getOrderByID)
        }
    }

    router.Run(":8080")
}

3.4 路由分组最佳实践

• 按业务域分组： 每个微服务内部按业务模块（用户、订单、支付）划分分组，便于维护和权限控制。
• 版本控制： 使用分组前缀管理 API 版本，如 /api/v1、/api/v2，支持平滑升级。
• 中间件最小化： 只在需要的分组上挂载中间件，避免全局滥用导致性能下降。
• 嵌套深度控制： 分组嵌套不超过 3 层，过深的分组结构会降低路由可读性。

3.5 常见问题与避坑