gin框架

最新推荐文章于 2024-10-16 00:48:40 发布
最新推荐文章于 2024-10-16 00:48:40 发布
阅读量595 收藏 8
点赞数 18
文章标签： gin
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41728554/article/details/138701346
版权
初识gin

Gin 是一个 Go (Golang) 编写的轻量级 http web 框架，运行速度非常快。点击此处访问官方文档。

基本使用
I. 响应
  • 入门案例
func main() {
	router := gin.Default()
	router.GET("/hello", func(c *gin.Context) {
		c.String(http.StatusOK, "Hello World!")
	})
	_ = router.Run(":8080")
	// _ = http.ListenAndServe(":8080", router)
}
  • 响应json数据
func main() {
	router := gin.Default()
	router.GET("/hello", func(c *gin.Context) {
		type User struct {
			UserName string `json:"user_name"`  // 自定义json字段名称
			Age      int    `json:"age"`
			Password string `json:"-"` // 不去序列化该字段
		}
		user := User{
			UserName: "lc",
			Age:      20,
			Password: "123456",
		}
		c.JSON(http.StatusOK, user)
		// 直接响应json
		//c.JSON(http.StatusOK, gin.H{"user_name": "lc", "age": 23})
	})
	_ = router.Run(":8080")
}
  • 响应xml/yaml数据
func _xml(c *gin.Context) {
	c.XML(http.StatusOK, gin.H{"user_name": "lc", "age": 23, "data": gin.H{"name": "test"}})
}

func _yaml(c *gin.Context) {
	c.YAML(http.StatusOK, gin.H{"user_name": "lc", "age": 23})
}
func main() {
	router := gin.Default()
	//router.GET("/json", _json)
	router.GET("/xml", _xml)
	router.GET("/yaml", _yaml)
	_ = router.Run(":8080")
}
  • 响应html
// 参考：https://gin-gonic.com/zh-cn/docs/examples/html-rendering/
func _html(c *gin.Context) {
	c.HTML(http.StatusOK, "index.html", gin.H{"username": "lc"})
}

func main() {
	router := gin.Default()
	// 加载模板目录
	router.LoadHTMLGlob("template/*")
	router.GET("/html", _html)
	_ = router.Run(":8080")
}
  • 文件响应
func main() {
	router := gin.Default()
	// 加载模板目录
	router.LoadHTMLGlob("template/*")
	// 在go中,可以理解为没有相对文件的路径，只有相对项目的路径
	// 访问单个文件
	router.StaticFile("/titian", "static/titian.png")
	router.StaticFS("/static", http.Dir("static/"))
	_ = router.Run(":8080")
}
  • 重定向
// 301和302区别: 301重定向通常用于永久性的URL改变，例如网站迁移、改变域名等；302重定向通常用于临时性的内容改变和URL重定向，例如网站维护期间，原URL临时跳转到维护通知页面。
router.GET("/baidu", func(c *gin.Context) {
		c.Redirect(301, "https://www.baidu.com")
		// 可以跳转自定义路径
		// c.Redirect(301, "/html")
	})
II. 参数
  • 查询参数
func _query(c *gin.Context) {
	fmt.Println(c.GetQuery("user"))
	fmt.Println(c.Query("user"))
	fmt.Println(c.QueryArray("user")) // 拿到多个相同参数
}
// query?id=2&user=lc&user=l3
  • 动态参数
func _param(c *gin.Context) {
	fmt.Println(c.Param("user_id"))
	fmt.Println(c.Param("book_id"))
}

func main() {
	router := gin.Default()
	router.GET("/param/:user_id", _param)
	router.GET("/param/:user_id/:book_id", _param)

	_ = router.Run(":8080")
}
//  http://localhost:8080/param/12323
  • 表单参数
func _form(c *gin.Context) {
	fmt.Println(c.PostForm("name"))
	fmt.Println(c.PostFormArray("name"))
	fmt.Println(c.DefaultPostForm("addr", "四川")) // 如果用户没传,使用默认值
	fmt.Println(c.DefaultQuery("age", "27"))     // 如果用户没传,使用默认值
	forms, err := c.MultipartForm()  // 接受所有的form参数
	fmt.Println(forms, err)
}

func main() {
	router := gin.Default()
	router.POST("/form", _form)
	_ = router.Run(":8080")
}
  • 请求头的各种获取方式
router.GET("/header", func(c *gin.Context) {
		fmt.Println(c.GetHeader("User-Agent"))
		fmt.Println(c.Request.Header)
		// 使用map方式获取需要区分大小写
		fmt.Println(c.Request.Header["User-Agent"])
		// 设置响应头
		// c.Header("token", "112233")
		c.JSON(200, gin.H{"msg": "success"})
	})
III.绑定参数

gin中的bind可以很方便的将前端传递的数据与结构体进行参数绑定，以及参数校验。在使用这个功能的时候，需要给结构体加上Tag-----json,form,url,xml

  • 具体使用
type UserInfo struct {
	Name string `json:"name" form:"name" uri:"name"`
	Age  int    `json:"age" form:"age" uri:"age"`
	Sex  string `json:"sex" form:"sex" uri:"sex"`
}

func main() {
	router := gin.Default()
	// json
	router.POST("/", func(c *gin.Context) {
		// 如果校验不通过会返回错误
		//c.BindJSON()
		var userInfo UserInfo
		err := c.ShouldBindJSON(&userInfo)
		if err != nil {
			c.JSON(200, gin.H{
				"msg": "出错了",
			})
			return
		}
		c.JSON(200, userInfo)
	})

	// query
	router.POST("/query", func(c *gin.Context) {
		var userInfo UserInfo
		err := c.ShouldBindQuery(&userInfo)
		if err != nil {
			c.JSON(200, gin.H{
				"msg": "出错了",
			})
			return
		}
		c.JSON(200, userInfo)
	})

	// uri
	router.POST("/uri/:name/:age/:sex", func(c *gin.Context) {
		var userInfo UserInfo
		err := c.ShouldBindUri(&userInfo)
		if err != nil {
			c.JSON(200, gin.H{
				"msg": "出错了",
			})
			return
		}
		c.JSON(200, userInfo)
	})

	// form-data参数
	router.POST("/form", func(c *gin.Context) {
		var userInfo UserInfo
		err := c.ShouldBind(&userInfo)
		if err != nil {
			c.JSON(200, gin.H{
				"msg": "出错了",
			})
			return
		}
		c.JSON(200, userInfo)
	})

	_ = router.Run(":8080")
}
  • bind绑定器

常用验证器

required: 必填字段,如: binding:"required"
min 最小长度
max 最大长度
len 长度
eq  等于
ne  不等于
gt  大于
gte 大于等于
lt 小于
lte 小于等于
eqfield 等于其他字符的值
nefield 不等于其他字符的值
- 忽略字段: binding:"-"

gin内置验证器

oneof=man women // 枚举 只能是man women
contains=f   // 包含f的字符串
excludes=f   // 不包含f的字符串
startswith   // 字符串前缀
endswith     // 字符串后缀

dive  // LikeList   []string `json:"like_list" binding:"required,dive,required,startswith=lire"`

ip
uri
url

datetime // 1月2号下午3点4分5秒  在06年

自定义验证的错误信息

// GetValidMsg 获取结构体中的msg参数
func GetValidMsg(err error, obj any) string {
	getObj := reflect.TypeOf(obj)
	// 将err断言为具体类型
	if errs, ok := err.(validator.ValidationErrors); ok {
		// 断言成功
		for _, e := range errs {
			// 循环每一个错误信息
			// 根据报错的字段名获取结构体具体字段
			if f, exist := getObj.Elem().FieldByName(e.Field()); exist {
				msg := f.Tag.Get("msg")
				return msg
			}
		}
	}
	return err.Error()
}

func main() {
	router := gin.Default()
	router.POST("/", func(c *gin.Context) {
		type User struct {
			Name string `json:"name" binding:"required" msg:"用户名校验失败"`
			Age  int    `json:"age" binding:"required" msg:"请输入年龄"`
		}
		var user User
		err := c.ShouldBindJSON(&user)
		if err != nil {
			c.JSON(200, gin.H{"msg": GetValidMsg(err, &user)})
			return
		}
		c.JSON(200, gin.H{"data": user})
	})
	_ = router.Run(":8080")
}

自定义验证器

type User struct {
	Name string `json:"name" binding:"required,sign" msg:"用户名校验失败"`
	Age  int    `json:"age" binding:"required" msg:"请输入年龄"`
}

func signValid(fl validator.FieldLevel) bool {
	var nameList = []string{"ll", "cc", "33"}
	for _, nameStr := range nameList {
		name := fl.Field().Interface().(string)
		if name == nameStr {
			return false
		}
	}
	return true
}

func main() {
	router := gin.Default()
	if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
		_ = v.RegisterValidation("sign", signValid)
	}
	router.POST("/", func(c *gin.Context) {

		var user User
		err := c.ShouldBindJSON(&user)
		if err != nil {
			c.JSON(200, gin.H{"msg": err.Error()})
			return
		}
		c.JSON(200, gin.H{"data": user})
	})
	_ = router.Run(":8080")
}
IV. 中间件
  • 单个路由中间件
func m1(c *gin.Context) {
	fmt.Println("m1...in")
	c.Next()
	fmt.Println("m1...out")
}

func m2(c *gin.Context) {
	fmt.Println("m2...in")
	c.Next()
	fmt.Println("m2...out")
}
func main() {
	router := gin.Default()
	router.GET("/", m1, func(c *gin.Context) {
		fmt.Println("index...in")
		c.JSON(200, gin.H{"msg": "index"})
		// 拦截后续响应
		//c.Abort()
		c.Next() // 类似于栈
		fmt.Println("index...out")
	}, m2)
	_ = router.Run(":8080")
}
// 输出顺序
//m1...in
//index...in
//m2...in
//m2...out
//index...out
//m1...out
// 如果其中一个中间件响应了abort(),后续中间件将不再执行
  • 全局中间件和中间件传参
func m10(c *gin.Context) {
	fmt.Println("m10...in")
}
func main() {
	router := gin.Default()
	router.Use(m10)
	router.GET("/", func(c *gin.Context) {
		c.JSON(200, gin.H{"msg": "index"})
	})
	router.GET("/m10", func(c *gin.Context) {
		c.JSON(200, gin.H{"msg": "index"})
	})
	_ = router.Run(":8080")
}

注:本文档参考枫枫知道大佬的gin教程

chong1604
关注
探索Gin框架：快速构建高性能的Golang Web应用
qq_35716689的博客
01-23 50万+
Gin框架是一个轻量级的Web框架，基于Go语言开发，旨在提供高性能和简洁的API。作者：鼠鼠我捏，要死了捏
探索Gin框架：Golang Gin框架请求参数的获取
qq_35716689的博客
02-06 36万+
我们在专栏的前面几篇文章内讲解了Gin框架的路由配置，服务启动等内容。在我们平常添加路由处理函数之后，就可以在路由处理函数中编写业务处理代码了，但在此之前我们往往需要获取请求参数，本文就详细的讲解下gin获取请求参数常见的几种方式。目录前言传递参数的方式HeaderURLHTTP Body直接获取请求参数获取URL Path中的参数获取URL Query中的参数获取HTTP Body中的参数绑定请求参数绑定Header参数绑定URL Path参数绑定URL Query参数绑定HTTP Body参数。
探索Gin框架：Golang使用Gin完成文件上传
热门推荐
qq_35716689的博客
02-02 37万+
Go标准库net/http对文件上传已经提供了非常完善的支持，Gin框架在其基础做了封装，使用更加简单便捷。作者：鼠鼠我捏，要死了捏
Go语言Gin框架安全加固：全面解析SQL注入、XSS与CSRF的解决方案
qq_35716689的博客
02-04 37万+
在使用 Gin 框架处理前端请求数据时，必须关注安全性问题，以防范常见的攻击。作者： 鼠鼠我捏，要死了捏
Gin框架底层原理
qq_22321199的专栏
09-12 897
Gin 是 Golang 世界里最流行的 web 框架，于 github 开源：https://github.com/gin-gonic/gin其中本文涉及到的源码走读部分，代码均取自 gin tag：v1.9.0 版本。主要优点：支持中间件操作（ handlersChain 机制 ）更方便的使用（ gin.Context ）更强大的路由解析能力（ radix tree 路由树 ）Gin 是在 Golang HTTP 标准库 net/http 基础之上的再封装下面提供一段接入 Gin 的示例代码：构造 gi
Gin框架基础
Ricardo2的博客
07-05 849
方法有： ShouldBind(), ShouldBindJSON(), ShouldBindXML(), ShouldBindQuery(), ShouldBindYAML(), ShouldBindHeader(), ShouldBindTOML(),方法有： Bind(), BindJSON(), BindXML(), BindQuery(), BindYAML(), BindHeader(), BindTOML()。原理都是一样的： 需要在要绑定的所有字段上，设置相应的 tag。
Gin框架
weixin_44058223的博客
10-26 4443
Gin介绍与代码实例包括：渲染模板、定义模板分割、渲染静态文件与目录、重定向 配置跨域、创建路由组与路由、解析路由参数、上传文件实例、注册与实现中间件。
Golang gin框架
book_longker的专栏
03-27 2万+
gin框架学习一、Gin 介绍二、Gin 环境搭建三、golang 程序的热加载四、Gin 框架中的路由五、Gin HTML 模板渲染六、静态文件服务七、路由详解八、Gin 中自定义控制器九、Gin 中间件十、Gin 中自定义Model十一、Gin 文件上传十二、Gin 中的Cookie十三、Gin 中的Session十四、Gin 中使用GORM 操作mysql 数据库十五、原生 SQL 和 SQL 生成器十六、Gin 中使用GORM 实现表关联查询十七、 GORM 中使用事务十八、Gin 中使用go
Gin框架 源码解析
S_ZaiJiangHu的博客
03-14 1063
接下来又回到了 gin.go ，可以看到上面的注册入口是通过group.engine 调用的，大家不用看 routerGroup 的结构也大致猜出来了吧，其实 engine 才是真正的路由树 router，而 gin 为了实现路由组的功能，所以在外面又包了一层 routerGroup，实现路由分组，路由路径组合隔离的功能。本系列 “拆轮子系列：gin 框架” 的第一篇就到这里了，这么通读下来，发现 gin 框架的设计和实现真的太棒了，简洁清晰，又不失巧妙，很适合大家也去阅读学习一下，墙裂推荐！
Golang-Gin框架示例二十多个源码
04-26
Golang-Gin框架是Go语言中一款非常流行的Web开发框架，以其高效、简洁和易用性受到广大开发者喜爱。Gin框架基于Martini框架设计，使用了 httprouter 库作为路由解析器，提供了高性能的路由处理能力。在这个“Golang-...
gin框架安装以及gin的请求路由
01-20
本文将介绍如何在Windows环境下安装Gin框架，并讲解如何使用Gin进行请求路由的设置。 首先，安装Gin框架前需要确保你已经安装了Git和Go语言环境。在Windows上，你可以访问官方网站下载并安装Git和Go。Go的安装路径...
Go语言中的gin框架之GET/POST请求参数接收传值（五）
06-15
在Go语言中，Gin框架是一个...总结，Gin框架在处理GET和POST请求参数时提供了多种方法，包括从URL查询字符串、JSON请求体以及Form数据中获取参数。这使得Gin成为构建Web服务的强大工具，特别是在Go语言的生态系统中。
基于Go+SQLServer语言Gin框架开发的进销存系统
03-19
在这个基于Go+SQLServer语言Gin框架开发的进销存系统中，我们可以看到现代Web应用开发的典型技术栈。 首先，让我们了解一下主要的技术组件： 1. **Go语言**：Go，又称Golang，是Google推出的一种静态类型的、编译...
GO语言gin框架实现管理员认证登陆接口
12-16
在本文中，我们将探讨如何使用Go语言的Gin框架实现后台管理员的登录验证接口。Gin是一个基于Golang的Web框架，它提供了快速、简洁的API开发方式。下面，我们将详细讲解实现这一功能的关键步骤。 首先，我们需要创建...
Gin解说
owolai的博客
10-09 562
Gin是一个用Go语言编写的高性能、开源的Web框架，它被设计为简单、快速和灵活。Gin非常适合用于构建RESTful API和微服务。
【Gin】Gin框架介绍和使用
加油，考上985的研究生
10-16 744
Gin中的中间件必须是一个 gin.HandlerFunc 类型的。// StatCost 是一个统计耗时请求耗时的中间件c.Set("name", "小王子") // 可以通过c.Set在请求上下文中设置值，后续的处理函数能够取到该值// 调用该请求的剩余处理程序c.Next()// 不调用该请求的剩余处理程序// 计算耗时。
Gin入门指南：从零开始快速掌握Go Web框架Gin
赵士杰——成功并非一蹴而就，而是在持之以恒的努力中逐渐实现。
10-13 2258
中间件函数用于记录日志。路由和请求处理：Gin 提供了简单而灵活的路由功能，可以方便地定义不同URL路径的处理函数，并支持 GET、POST 等各种HTTP请求方法。函数用于返回成功结果，它接收 Gin 的上下文对象，以及三个自定义的参数，分别为状态码、提示信息和数据。一般来说，我们需要在处理请求的路由函数中使用 defer 语句将捕获的异常记录下来，所以我们可以通过中间件实现全局的异常处理。参数绑定和验证：Gin 提供了强大的参数绑定和验证功能，可以方便地将请求参数绑定到结构体中，并进行数据验证和转换。
毕业设计论文Django+Vue学生选课系统.docx
最新发布
10-16
毕业设计论文
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值