【基于GO的Web开发15】gin路由和路由组

一、前言

路由是 Web 服务的基础,负责将客户端的请求 URL 分发到对应的处理函数 。本篇笔记讲解 Gin 普通路由、Any匹配全部请求、404 自定义、路由分组Group,附带完整代码案例与复习要点。


二、普通基础路由

1. 常用 HTTP 请求方法路由

Gin 支持直接绑定 GET、POST、PUT、DELETE 等 RESTful 常用请求方式。

表格

请求方法 作用
r.GET() 查询数据
r.POST() 新增 / 提交数据
r.PUT() 更新数据
r.DELETE() 删除数据

完整示例代码

Go 复制代码
package main

import (
	"net/http"

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

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

	// GET 请求
	r.GET("/index", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"method": "GET",
		})
	})
	// POST 请求
	r.POST("/index", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"method": "POST",
		})
	})
	// PUT 请求
	r.PUT("/index", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"method": "PUT",
		})
	})
	// DELETE 请求
	r.DELETE("/index", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"method": "DELETE",
		})
	})

	r.Run(":8080")
}

💡注意:同一个路径/index可以绑定不同请求方法,视为完全不同的接口。

2. r.Any () ------ 匹配所有请求方法(大杂烩)

Any可以接收 GET/POST/PUT/DELETE 任意一种请求方式。

Go 复制代码
// 无论什么请求方式访问 /test,都会命中该函数
r.Any("/test", func(c *gin.Context) {
	c.JSON(http.StatusOK, gin.H{"msg":"Any接收所有请求"})
})

3. r.NoRoute () ------ 自定义 404 页面

当访问的路由没有匹配到任何处理函数时,默认返回 404。 NoRoute用来统一捕获 404 请求,自定义返回内容。

Go 复制代码
// 需要提前加载html模板文件
r.NoRoute(func(c *gin.Context) {
	c.HTML(http.StatusNotFound, "views/404.html", nil)
})

三、路由组 r.Group ()

3.1 什么是路由组

路由组等价于给一批接口添加统一 URL 前缀,适合归类同一模块下的多个接口。 类比于 Flask 中的蓝图,用来实现接口模块化管理。

例如视频模块下一堆接口: /video/index、/video/xx、/video/oo 公共前缀:/video

3.2 代码示例(推荐大括号包裹写法,可读性更高)

Go 复制代码
package main

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

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

	// 创建路由组,统一前缀 /video
	videoGroup := r.Group("/video")
	{
		videoGroup.GET("/index", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{"msg": "/video/index"})
		})

		videoGroup.GET("/xx", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{"msg": "/video/xx"})
		})

		videoGroup.GET("/oo", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{"msg": "/video/oo"})
		})
	}

	r.Run(":8080")
}

访问地址:

3.3 路由组的优势

  1. 接口分类清晰,视频、用户、文章模块路由分开管理
  2. 可以给整个路由组统一添加中间件(权限校验、日志打印)
  3. 后期修改公共前缀时,只需要修改Group("/video")一处代码

四、普通路由 VS 路由组对比总结

表格

类型 适用场景 示例地址
普通路由 少量、零散无统一前缀的接口 /login /register
路由组 Group 同一业务模块下大量平级接口 /video/index /video/list

五、拓展:嵌套路由组(进阶复习)

路由组还可以继续嵌套,实现多级前缀:

Go 复制代码
videoGroup := r.Group("/video")
{
	// 二级路由 /video/admin
	admin := videoGroup.Group("/admin")
	{
		admin.GET("/list", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{"msg": "/video/admin/list"})
		})
	}
}
相关推荐
Mh2 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳3 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔3 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
码事漫谈4 小时前
以后人人都可以成为导演
后端
SoaringHeart4 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Resean02234 小时前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿4 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
Flynt5 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑6 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星6 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http