Golang Gin 框架之分组路由(五)

目录

    • 分组路由
    • 编码简单,结构清晰
    • 扩展方便,便于管理

前言

Gin 是使用纯 Golang 语言实现的 HTTP Web 框架,Gin 的接口设计简洁,性能极高,现在被广泛使用。上一篇文章介绍了 Gin 的基本使用方式,今天我们详细看一看 Gin 在分组路由方面的内容。

正文

分组路由

说到分组路由,你一定会问为什么要搞分组路由?分组路由有什么优势?下面就详细介绍一下。

编码简单,结构清晰

使用分组路由可以为我们带来很多好处,比如编码会非常简单,结构也会非常清晰,下面看两段代码示例:

使用路由分组之前:

func main() {
    router := gin.Default()
    router.POST("/v1/login", loginEndpoint)
    router.POST("/v1/submit", submitEndpoint)
    router.POST("/v1/send", sendEndpoint)
    router.POST("/v1/aaa", aaaaEndpoint)
    router.POST("/v1/bbb", bbbbEndpoint)
    router.POST("/v1/ccc", ccccEndpoint)
    router.POST("/v1/ddd", ddddEndpoint)
    router.Run(":8080")
}

上面的编码方式会产生非常多的路由前缀 V1,感觉很繁琐。

使用路由分组之后:

func main() {
    router := gin.Default()
    // 分组 v1
    v1 := router.Group("/v1")
    {
        v1.POST("/login", loginEndpoint)
        v1.POST("/submit", submitEndpoint)
        v1.POST("/send", sendEndpoint)
        v1.POST("/aaa", aaaaEndpoint)
        v1.POST("/bbb", bbbbEndpoint)
        v1.POST("/ccc", ccccEndpoint)
        v1.POST("/ddd", ddddEndpoint)
    }
        
    router.Run(":8080")
}

此时,可以看到,相同的路由前缀 V1 被抽离出去,变成了一个分组。这样的代码看起来就非常简洁。

扩展方便,便于管理

使用分组路由可以让我们的代码便于扩展和管理,通过修改路由分组可以非常轻松扩展出另外一套API接口。比如,下面的代码就演示了从v1分组扩展到v2分组的方式,非常方便。

func main() {
    router := gin.Default()
    // 分组 v1
    v1 := router.Group("/v1")
    {
        v1.POST("/login", loginEndpoint)
        v1.POST("/submit", submitEndpoint)
        v1.POST("/send", sendEndpoint)
        v1.POST("/aaa", aaaaEndpoint)
        v1.POST("/bbb", bbbbEndpoint)
        v1.POST("/ccc", ccccEndpoint)
        v1.POST("/ddd", ddddEndpoint)
    }
    // 分组 v2
    v2 := router.Group("/v2")
    {
        v2.POST("/login", loginEndpoint)
        v2.POST("/submit", submitEndpoint)
        v2.POST("/send", sendEndpoint)
        v2.POST("/aaa", aaaaEndpoint)
        v2.POST("/bbb", bbbbEndpoint)
        v2.POST("/ccc", ccccEndpoint)
        v2.POST("/ddd", ddddEndpoint)
    }
    router.Run(":8080")
}

分组之后,我们可以非常清晰哪些代码逻辑属于分组v1,哪些代码逻辑属于分组v2。

结尾

在 Gin 中合理的使用分组路由可以让编码更加简单,结构更加清晰,同时,之后的代码扩展更加方便,便于管理。感兴趣的小伙伴们,不妨一试呦!



作者简介:大家好,我是 Data-Mining(liuzhen007),是一位典型的音视频技术爱好者,同时也是CSDN博客专家、华为云享专家(共创编辑)、InfoQ 签约作者,欢迎关注我分享更多干货!


上一篇:在Linux/redhat中安装amazon-ssm-agent及注意事项


下一篇:如何从tushare获取point in time的数据