6、Go Gin 路由详解(之二)

已于 2024-04-28 17:58:42 修改
阅读量644 收藏 11
点赞数 11
分类专栏： Go Gin 文章标签： golang gin 中间件
于 2024-04-26 19:21:06 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_39335595/article/details/138227579
版权

一、路由详解

路由定义：

  • 路由的核心是定义 HTTP 请求的路径，即 URI（Uniform Resource Identifier）。路径可以是静态的（如 /users) 或动态的（如 /users/:id），动态路径参数以冒号 : 开头，如 :id 表示一个待捕获的变量。

HTTP 方法：

  • Gin 支持常见的 HTTP 方法，如 GET、POST、PUT、DELETE、PATCH 等。这些方法与路径组合，定义了特定操作与资源之间的映射关系，遵循 RESTful 设计原则。例如：
    • GET /users: 查询用户列表。
    • GET /users/:id: 获取指定 ID 的用户详情。
    • POST /users: 创建新用户。
    • PUT /users/:id: 更新指定 ID 的用户信息。
    • DELETE /users/:id: 删除指定 ID 的用户。

路由注册：

  • 使用 Gin 实例（通常称为 r）的相应 HTTP 方法（如 GET、POST 等）方法注册路由。每个方法接收两个参数：路径（字符串）和处理函数（闭包或指向函数的指针）。例如： 
    r.GET("/users", getUsers)
r.POST("/users", createUser)

路由参数与提取：

  • 动态参数：在路径中定义的动态参数（如 :id）会在请求到达时被自动捕获，并可通过 c.Param() 方法在处理函数中访问。例如：

    r.GET("/users/:id", func(c *gin.Context) {
    id := c.Param("id")
    // 使用 id 查询数据库并返回用户信息
})

  • 正则约束：可以为动态参数添加正则表达式约束，确保传入的值符合预期格式。例如，限制 id 只接受数字：

    r.GET("/users/:id(\\d+)", getUserByID)

 路由分组：

  • 为了组织和复用中间件、共享路径前缀，Gin 提供了路由分组功能。使用 Group() 方法创建分组，并可为分组应用中间件。子路由注册在分组内部，共享其前缀和中间件设置。例如： 
    admin := r.Group("/admin", authMiddleware)
{
    admin.GET("/users", listAdminUsers)
    admin.POST("/users", createAdminUser)
}
    上述代码创建了一个名为 admin 的分组，挂载在 /admin 路径下，所有请求都需要通过 authMiddleware 中间件。

请求域获取(GET、POST)

1、Get 请求传值

// GET http://127.0.0.1:8080/user?uid=20&page=1
 // 返回uid=20 page=1
router.GET("/user", func(c *gin.Context) {
    uid := c.Query("uid")
    page := c.DefaultQuery("page", "0")//不传page参数默认返回0
    c.String(200, "uid=%v page=%v", uid, page)
})

2、Get动态路由传值

// 域名/user/20
r.GET("/user/:uid", func(c *gin.Context) {
    uid := c.Param("uid")
    c.String(200, "userID=%s", uid)
})

3、Post 请求传值 获取 form 表单数据

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/doAddUser" method="post">
    用户名：<input type="text" name="username" />
    密码: <input type="password" name="password" />
    <input type="submit" value="提交">
</form>
</body>
</html>
package main

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

func main() {
	// 加载引擎
	r := gin.Default()

	r.LoadHTMLGlob("templates/*")

	// 通过 c.PostForm 接收表单传过来的数据
	// http://127.0.0.1:8080/addUser
	r.GET("/addUser", func(c *gin.Context) {
		c.HTML(200, "index.html", gin.H{})
	})
	r.POST("/doAddUser", func(c *gin.Context) {
		username := c.PostForm("username")
		password := c.PostForm("password")
		age := c.DefaultPostForm("age", "20")
		c.JSON(200, gin.H{
			"usernmae": username,
			"password": password,
			"age":      age,
		})
	})
	r.Run(":8080")
}

3、获取 GET POST 传递的数据绑定到结构体

package main

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

// 注意首字母大写
type Userinfo struct {
	Username string `form:"username" json:"user"`
	Password string `form:"password" json:"password"`
}

func main() {
	// 加载引擎
	r := gin.Default()

	//get请求：http://127.0.0.1:8080/getBind?username=sph&password=123456
	//返回{"user":"sph","password":"123456"}
	r.GET("/getBind", func(c *gin.Context) {
		var userinfo Userinfo
		//使用c.ShouldBind()绑定
		if err := c.ShouldBind(&userinfo); err == nil {
			c.JSON(http.StatusOK, userinfo)
		} else {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		}
	})

	//post请求：http://127.0.0.1:8080/postBind?username=sph&password=123456
	//返回{"user":"sph","password":"123456"}
	r.POST("/postBind", func(c *gin.Context) {
		var userinfo Userinfo
		//使用c.ShouldBind()绑定
		if err := c.ShouldBind(&userinfo); err == nil {
			c.JSON(http.StatusOK, userinfo)
		} else {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		}
	})
	r.Run(":8080")
}

4、获取 Post Xml 数据

<?xml version="1.0" encoding="UTF-8"?>
<article>
<content type="string">我是sph</content>
<title type="string">sph</title>
</article>
package main

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

type Article struct {
	Title   string `xml:"title"`
	Content string `xml:"content"`
}

func main() {
	// 加载引擎
	r := gin.Default()

	//post请求：http://127.0.0.1:8080/xml
	r.POST("/xml", func(c *gin.Context) {
		b, _ := c.GetRawData() // 从 c.Request.Body 读取请求数据
		article := &Article{}
		//反序列化
		if err := xml.Unmarshal(b, &article); err == nil {
			c.JSON(http.StatusOK, article)
		} else {
			c.JSON(http.StatusBadRequest, err.Error())
		}
	})

	r.Run(":8080")
}

完整代码

default.html
<!-- 相当于给模板定义一个名字, define end 必须成对出现 -->
{{ define "default/user.html" }}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>news</title>
</head>
<body>
{{ template "public/page_header.html" .}}
<form action="/doAddUser" method="post">
    用户名:<input type="text" name="username"/> <br/> <br/>
    密码:<input type="text" name="password"/><br/> <br/>
    <input type="submit" value="提交">
</form>
<h2>{{UnixToTime .date}}</h2>
<h2>{{Println .hobby .motion}}</h2>
{{ template "public/page_footer.html" .}}
</body>
</html>
{{ end }}
page_footer.html 
<!-- 相当于给模板定义一个名字, define end 必须成对出现 -->
{{ define "public/page_footer.html" }}
<h4>
    公共的底部
</h4>
{{end}}
page_header.html  
<!-- 相当于给模板定义一个名字, define end 必须成对出现 -->
{{ define "public/page_header.html" }}
<h1>
  公共的 --- {{.title}}
</h1>
{{end}}
go代码
package main

import (
	"encoding/xml"
	"github.com/gin-gonic/gin"
	"html/template"
	"net/http"
	"time"
)

// 时间戳转换成日期函数
func UnixToTime(timestamp int) string {
	t := time.Unix(int64(timestamp), 0)
	return t.Format("2006-01-02 15:04:05")
}

func Println(str1 string, str2 string) string {
	return str1 + "跟" + str2
}

type UserInfo struct {
	Username string `json:"username" form:"username"`
	Password string `json:"password" form:"password"`
}

type Article struct {
	Title   string `json:"title" xml:"title"`
	Content string `json:"content" xml:"content"`
}

func main() {
	//初始化路由
	r := gin.Default()
	//自定义模板函数,必须在r.LoadHTMLGlob前面
	r.SetFuncMap(template.FuncMap{
		"UnixToTime": UnixToTime, //注册模板函数
		"Println":    Println,
	})
	//加载templates中所有模板文件, 使用不同目录下名称相同的模板,注意:一定要放在配置路由之前才得行
	r.LoadHTMLGlob("templates/**/*")
	//配置静态web目录 第一个参数表示路由,第二个参数表示映射的目录
	r.Static("/static", "./static")
	//配置路由
	//GET传值http://127.0.0.1:8080/?username=sph&age=100
	r.GET("/", func(c *gin.Context) {
		username := c.Query("username")
		age := c.Query("age")
		page := c.DefaultQuery("page", "1")
		c.JSON(http.StatusOK, gin.H{
			"username": username,
			"age":      age,
			"page":     page,
		})
	})
	//GET传值 获取文章id
	//http://127.0.0.1:8080/article?id=10
	r.GET("/article", func(c *gin.Context) {
		id := c.DefaultQuery("id", "1")
		c.JSON(http.StatusOK, gin.H{
			"id":     id,
			"conent": "文章详情",
		})
	})

	//post演示
	//http://127.0.0.1:8080/user
	r.GET("/user", func(c *gin.Context) {
		//渲染模板
		c.HTML(http.StatusOK, "default/user.html", gin.H{
			"title":  "首页",
			"date":   1714115969,
			"hobby":  "吃饭",
			"motion": "打篮球",
		})
	})
	//获取表单post过来的数据
	r.POST("/doAddUser", func(c *gin.Context) {
		username := c.PostForm("username")
		password := c.PostForm("password")
		age := c.DefaultPostForm("age", "20")
		c.JSON(http.StatusOK, gin.H{
			"username": username,
			"password": password,
			"age":      age,
		})
	})
	//获取GET POST传递的数据绑定到结构体
	//r.POST("/getUser", func(c *gin.Context) {
	r.GET("/getUser", func(c *gin.Context) {
		user := &UserInfo{}
		//绑定到对应的结构体
		if err := c.ShouldBind(&user); err == nil {
			c.JSON(http.StatusOK, user)
		} else {
			c.JSON(http.StatusOK, gin.H{
				"err": err.Error(),
			})
		}
	})
	//获取 POST xml数据绑定到结构体
	r.POST("/xml", func(c *gin.Context) {
		article := &Article{}
		//获取c.Request.Body读取请求数据, 返回的是一个xml切片
		xmlSliceData, _ := c.GetRawData()
		//解析xml切片
		if err := xml.Unmarshal(xmlSliceData, &article); err == nil {
			c.JSON(http.StatusOK, article)
		} else {
			c.JSON(http.StatusBadRequest, gin.H{
				"err": err.Error(),
			})
		}
	})

	//动态路由传值
	//http://127.0.0.1:8080/list/123
	r.GET("/list/:id", func(c *gin.Context) {
		id := c.Param("id")
		c.JSON(http.StatusOK, gin.H{
			"id": id,
		})
	})
	r.Run() // 启动一个web服务
}

路由组

1、简单路由组

package main

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

func main() {
	//初始化引擎
	r := gin.Default()
	//简单的路由分组
	defaultRouters := r.Group("/")
	{
		defaultRouters.GET("/", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "首页",
				"content": "吃饭打酱油",
			})
		})
		defaultRouters.GET("/news", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "新闻",
				"content": "吃饭打酱油",
			})
		})
	}

	apiRouters := r.Group("/api")
	{
		apiRouters.GET("/", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "API首页",
				"content": "吃饭打酱油",
			})
		})
		apiRouters.GET("/userList", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "userList",
				"content": "这是用户列表",
			})
		})
	}
	r.Run() // 启动一个web服务
}

2、项目大的时候一般需要路由分组注册

目录结构

routers包
package routers

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

// AdminRouters 设置admin后台路由
func AdminRouters(r *gin.Engine) {
	adminRouters := r.Group("/admin")
	{
		adminRouters.GET("/", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "后台首页",
				"content": "吃饭打酱油",
			})
		})
		adminRouters.GET("/admin", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "后台管理页面",
				"content": "吃饭打酱油",
			})
		})
	}
}

package routers

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

// LoginRouters 登录注册页面路由
func LoginRouters(r *gin.Engine) {
	loginRouters := r.Group("/")
	{
		loginRouters.GET("/", func(c *gin.Context) {
			c.HTML(http.StatusOK, "login/login.html", gin.H{
				"msg": "登录页面",
			})
		})
		loginRouters.GET("/register", func(c *gin.Context) {
			c.HTML(http.StatusOK, "register/register.html", gin.H{
				"msg": "注册页面",
			})
		})
	}
}

package routers

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

// UserRouters 设置用户api路由
func UserRouters(r *gin.Engine) {
	apiRouters := r.Group("/userApi")
	{
		apiRouters.GET("/", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "用户",
				"content": "用户",
			})
		})
		apiRouters.GET("/userList", func(c *gin.Context) {
			c.JSON(http.StatusOK, gin.H{
				"title":   "用户列表",
				"content": "用户列表内容",
			})
		})
	}
}
 main.go
package main

import (
	"gin-mall/routers"
	"github.com/gin-gonic/gin"
)

func main() {
	r := gin.Default()
	//注册路由
	routers.LoginRouters(r)
	routers.AdminRouters(r)
	routers.AdminRouters(r)
}

比猪聪明
关注
  • 11
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
Golang Gin 的路由的详解
canduecho的专栏
05-30 1227
路由是 web 应用程序中的一种机制，它将到达服务器的请求与应该处理该请求的代码关联起来。简单来说，路由就是指定在访问某个 URL 时会执行的代码。Gin 使用 HTTP 方法和 URL 路径来定义路由。例如，当一个 GET 请求到达/hello路径时，该请求将被处理并返回一个响应。路由的实现原理是通过在服务器上监听传入的请求，并将其与定义的路由规则进行匹配。当请求与某个路由相匹配时，服务器将执行与该路由关联的代码，并返回响应。
gin 获取get 所有参数_Golang Gin 实战（三）| 路由参数
weixin_30117665的博客
12-27 1672
在 上一篇 Golang Gin 实战（二）| 简便的Restful API 实现 文章中，我们留了一个疑问，假如我们有很多用户，我们要为他们一个个注册路由（路径）吗？路由路径如下URL：/users/123 /users/456 /users/23456以上等等，我们有很多用户，如果我们都一个个为这些用户注册这些路由（URL），那么我们是很难注册完的，而且我们还会有新注册的用户，可见这种办法不行...
5、Go Gin 路由详解(之一)
最新发布
qq_39335595的博客
04-26 1147
创建一个名为。
Go-gin 路由
weixin_47906106的博客
01-09 352
路由 package main import ( "github.com/gin-gonic/gin" "net/http" ) // gin.Context，封装了request和response func main() { r := gin.Default() r.GET("/index", func(c *gin.Context) { c.JSON(http.StatusOK,gin.H{ "method":"GET请求", }) }) // ...... /
Go gin实现之基本路由
qq_43541182的博客
12-05 155
go gin 实现
基于gin的golang web开发：路由示例详解
01-19
Gin是一个用Golang编写的HTTP网络框架。它的特点是类似于Martini的API，性能更好。在golang web开发领域是一个非常热门的web框架。 启动一个Gin web服务器 使用下面的命令安装Gin go get -u github....
golang实战使用gin+xorm搭建go语言web框架详解.rar
05-23
在本文中，我们将深入探讨如何使用Gin和XORM这两个流行的开源库来构建Go语言的Web应用程序框架。Gin是一个高效、简洁的Web框架，它提供了丰富的中间件支持，而XORM则是一个轻量级的ORM（对象关系映射）库，能够简化...
golang利用不到20行代码实现路由调度详解
09-20
在Golang中，由于语言特性，我们不能像Java那样动态创建对象。因此，我们需要手动注册Controller和它们对应的方法。这里我们定义了一个名为`routes`的map，用于存储Controller的指针。当请求到来时，我们解析URL中的...
go 语言框架 gin中文文档
09-11
Gin 是一个基于 Go（Golang）语言的轻量级Web框架，它以其高效、简洁的API设计受到了广大开发者的喜爱。Gin 使用了 Martini-like API，使得构建Web服务变得异常简单。在本文档中，我们将深入探讨 Gin 的各个方面，...
PasteMeGoBackend:PasteMe Go 后端，Golang + Gin + Gorm
05-05
PasteMeGoBackend是一个基于Golang编程语言的后端项目，利用了Gin框架和Gorm ORM库来实现高效的数据处理和API路由管理。这个项目的核心是提供一个便捷的粘贴板服务，用户可以快速上传和分享文本数据。 ### Gin框架...
Golang框架Gin入门实战--(1)Gin路由
小啊宇的博客
06-06 695
Golang框架Gin入门实战--(1)Gin路由{GET、POST、PUT、DELETE}
go开发脚手架 动态/静态路由 (根据gin框架)
小鱼~
08-20 1660
说明: gin的中间件堪称它的精髓 1.根据gin框架搭建的脚手架 2.实现了动态路由 (api开头) 支持版本 3.静态路由也可以匹配动态方法 支持版本 4.添加了一些基础中间件 (logger & JWT & cors等) 5.setting 配置信息设置 6.开发结构分层 (api控制器层、service服务层、dao层、model层) 7.jwt-go 实例 & 简单用户验证 8.实现了自定义异步日志 & gorm自定义日志 & TraceId & 链路日志 9.自定义框架......
【Go实战基础】gin 如何设置路由
菜鸟实战的博客
06-17 1714
gin 框架启动 基础路由 http GET / POST 请求 返回 字符串 String 数据
go语言的gin介绍、路由组设置、数据解析和绑定以及gin中间件
ydl1128的博客
08-16 1021
Gin 是一个golang的微框架，封装比较优雅，API友好，源码注释比较明确，具有快速灵活，容错方便等特点。对于golang而言，web框架的依赖要远比Python，Java之类的要小。自身的net/http足够简单，性能也非常不错借助框架开发，不仅可以省去很多常用的封装带来的时间，也有助干团队的编码风格和形成规范。......
golang语言web开发01-之 gin框架的路由router管理示例
weixin_51604181的博客
11-21 600
1、gin文档gin 是golang语言开发的一个web框架，文章也选取这个框架进行描述 2、一个关于golang web 开发用到的案例 3、go语言圣经golang 基础go 的环境安装这里没做介绍提示：以下是本篇文章正文内容， （1）路由管理这一模块完美管理（2）最麻烦的就是后面的总路由管理，那里有些绕，需要沉下心来感受感受，梳理梳理。
Go Gin web框架的路由原理及中间件原理
梦~'
11-17 2384
Go Gin web框架的路由原理及中间件原理
Golang Gin基本使用 路由参数解析 ShouldBind参数绑定
小楼一夜听春雨，深巷明朝卖杏花
04-02 1828
这种也不是常用的，常用的其实是传递参数的方式。比如系统是单集群，那么这种就不需要传参了。
go语言 gin路由 没进入sockjs.NewHandler
07-22
如果你在使用Go语言的Gin框架时没有进入`sockjs.NewHandler`处理程序，可能是由于路由配置不正确导致的。以下是一个示例代码，演示如何在Gin中正确配置SockJS处理程序： ```go package main import ( "log" ...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值