Gin框架基础

1、一个简单的Gin示例

下载并安装Gin:

go get -u github.com/gin-gonic/gin

1.1 一个简单的例子

package mainimport ("net/http""github.com/gin-gonic/gin"
)func main() {// 创建一个默认的路由引擎r := gin.Default()// 当客户端以GET方式访问 /hello 时，会执行后面的匿名函数，返回Hello Worldr.GET("/hello", func(ctx *gin.Context) {ctx.String(http.StatusOK, "Hello World")})r.GET("/json", func(ctx *gin.Context) {ctx.JSON(http.StatusOK, gin.H{"message": "Hello World",})})// 在8080端口监听r.Run(":8080")
}

使用浏览器打开127.0.0.1:8080/hello就能看到一串字符串，打开127.0.0.1:8080/json就能看到一串JSON字符串。
在这里插入图片描述

1.2 RESTful API

Gin 如何处理 GET, POST, PUT, PATCH, DELETE 和 OPTIONS 请求
Gin 处理各种 HTTP 请求是非常简单的，只要使用 router.XXX 方法即可注册处理器。其中 XXX 是 HTTP 请求方法的大写模式。

也就是说，Gin框架支持开发RESTful API的开发。
在这里插入图片描述

package mainimport ("net/http""github.com/gin-gonic/gin"
)func main() {// 创建一个默认的路由引擎r := gin.Default()//r.GET("/book", func(ctx *gin.Context) {ctx.JSON(http.StatusOK, gin.H{"message": "GET",})})r.POST("/book", func(ctx *gin.Context) {ctx.JSON(http.StatusOK, gin.H{"message": "POST",})})r.PUT("/book", func(ctx *gin.Context) {ctx.JSON(http.StatusOK, gin.H{"message": "PUT",})})r.DELETE("/book", func(ctx *gin.Context) {ctx.JSON(http.StatusOK, gin.H{"message": "DELETE",})})// 在8080端口监听r.Run(":8080")
}

开发RESTful API的时候我们通常使用Postman来作为客户端的测试工具。

在这里插入图片描述

2、获取参数

2.1、如何获取 GET 查询字符串参数？

查询字符串参数就是 URL 中 ? 后面 # 之前的参数，比如下面的 URL，
https://www.xxxxx.cn/user/search?username=金克斯&address=艾欧尼亚#reply0
查询字符串参数特指 username=金克斯&address=艾欧尼亚

Gin 的 Handler 提供了 以下几种方式

方法说明
ctx.Query()获取查询参数，如果参数不存在或值为空则返回空字符串 “”
ctx.DefaultQuery()获取查询参数，如果参数不存在或值为空则返回第二个参数做为值
ctx.GetQuery()类似于 c.Query(),但同时返回第二个 bool 参数用于判断该参数到底存不存在
  1. ctx.Query()
ctx.Query("username")	// 返回"金克斯"
ctx.Query("address")	// 返回"艾欧尼亚"
ctx.Query("gender")		// 返回""
  1. ctx.DefaultQuery()
ctx.DefaultQuery("username", "none")	// 返回"金克斯"
ctx.DefaultQuery("address", "none")		// 返回"艾欧尼亚"
ctx.DefaultQuery("gender", "none")		// 返回"none"
  1. ctx.GetQuery()
ctx.GetQuery("username")	// 返回("金克斯", true)
ctx.GetQuery("address") 	// 返回("艾欧尼亚", true)
ctx.GetQuery("gender")		// 返回("", false)

例子

package mainimport ("net/http""github.com/gin-gonic/gin"
)func main() {// 创建一个默认的路由引擎router := gin.Default()// 解析/user/search?username=金克斯&address=艾欧尼亚#reply0router.GET("/user/search", func(ctx *gin.Context) {username := ctx.Query("username")address, _ := ctx.GetQuery("address")gender := ctx.DefaultQuery("gender", "none")ctx.JSON(http.StatusOK, gin.H{"username": username,"address": address,"gender": gender,})})// 在8080端口监听router.Run(":8080")
}

浏览器返回http://127.0.0.1:8080/user/search?username=金克斯&address=艾欧尼亚#reply0，返回

{"address":"艾欧尼亚","gender":"none","username":"金克斯"}

2.2、如何获取 POST 表单form数据

Gin 提供了三个类似的方法用于获取 POST 请求提交的参数

方法说明
ctx.PostForm()获取 POST 表单参数，如果参数不存在或值为空则返回空字符串 “”
ctx.DefaultPostForm()获取 POST 表单参数，如果参数不存在或值为空则返回第二个参数做为值
ctx.GetPostForm()类似于 c.PostForm(),但同时返回第二个 bool 参数用于判断该参数到底存不存在
package mainimport ("net/http""github.com/gin-gonic/gin"
)func main() {// 创建一个默认的路由引擎router := gin.Default()// 解析/user/search?username=金克斯&address=艾欧尼亚#reply0router.POST("/user/search", func(ctx *gin.Context) {username := ctx.PostForm("username")address, _ := ctx.GetPostForm("address")gender := ctx.DefaultPostForm("gender", "none")ctx.JSON(http.StatusOK, gin.H{"username": username,"address": address,"gender": gender,})})// 在8080端口监听router.Run(":8080")
}

使用postman发送表单请求
在这里插入图片描述

2.3、如何同时获取 GET 数据和 POST 数据

package mainimport ("net/http""github.com/gin-gonic/gin"
)func main() {router := gin.Default()router.POST("user/search", func(ctx *gin.Context) {query_name := ctx.Query("name")query_address := ctx.Query("address")post_name := ctx.PostForm("name")post_address := ctx.PostForm("address")ctx.JSON(http.StatusOK, gin.H{"query_name": query_name,"query_address": query_address,"post_name": post_name,"post_address": post_address,})})router.Run(":8080")}

在这里插入图片描述

2.4、如何获取路由参数

在没有路由参数之前，如果我们想获取/user/1和/user/2的用户数据，我们需要注册多个路由器

router.GET("/user/1", func(c *gin.Context) {})
router.GET("/user/2", func(c *gin.Context) {})

如果用户量大了，这个注册显然不靠谱。

Gin 允许我们使用 :[参数名] 或 *[参数名] 来注册一个路由参数，比如上面的用户详情就可以注册为 /user/:user_id。然后我们就可以在路由 Handler 中通过 c.Param("user_id")获取到这个参数。

  • :[参数名] ：路由参数能够匹配任何字符串，除了路径分隔符 /。 也就是说 /user/:user_id 可以匹配 /user/1 但不能匹配 /user/1/message
	router.GET("/user/:name", func(ctx *gin.Context) {name := ctx.Param("name")ctx.JSON(http.StatusOK, gin.H{"message": name,})})/*127.0.0.1:8080/user/金克斯， 返回 {"message":"金克斯"}127.0.0.1:8080/user/金克斯/艾欧尼亚， 返回 404 page not found*/
  • *[参数名] ：路由参数可以匹配任意字符，包括/，也就是说 /user/:user_id 可以匹配 /user/1 也可以能匹配 /user/1/message ，还能匹配 /user/1/message/a/b/c/d/e
	router.GET("/user/:name/*address", func(ctx *gin.Context) {name := ctx.Param("name")address := ctx.Param("address")ctx.JSON(http.StatusOK, gin.H{"message": name,"address": address,})})/*127.0.0.1:8080/user/金克斯， 返回 {"address":"/","message":"金克斯"}127.0.0.1:8080/user/金克斯/艾欧尼亚， 返回 {"address":"/艾欧尼亚","message":"金克斯"}*/

Gin 的路由定义遵循几个规范

  • 和访问路径一样的路由定义(精确路由) 将会被优先匹配。 比如
	router.GET("/user/:name", func(ctx *gin.Context) {name := ctx.Param("name")ctx.JSON(http.StatusOK, gin.H{"message": name,})})// 精确路由（相对于有路由参数的路由）会被优先匹配，而无论他们在哪里定义router.GET("/user/groups", func(c *gin.Context) {c.String(http.StatusOK, "The available groups are [...]")})
  • 默认情况下，如果先定义的路由匹配了，那么后续定义的路由就不会被匹配。

2.5、如何接受表单中的字典(Map)参数

Gin 提供了 ctx.QueryMap() 用于获取字典形式的查询字符串参数，提供了ctx.PostFormMap()用于获取字典形式的 POST 表单参数。

package mainimport ("net/http""github.com/gin-gonic/gin"
)func main() {router := gin.Default()router.POST("/post", func(ctx *gin.Context) {ids := ctx.QueryMap("ids")names := ctx.PostFormMap("names")ctx.JSON(http.StatusOK, gin.H{"ids": ids,"names": names,})})router.Run(":8080")}

在这里插入图片描述

2.6、如何对请求参数模型绑定和验证

为了能够更方便的获取请求相关参数，提高开发效率，我们可以基于请求的Content-Type识别请求数据类型并利用反射机制自动提取请求中QueryString、form表单、JSON、XML等参数到结构体中。
原理都是一样的： 需要在要绑定的所有字段上，设置相应的 tag。例如，使用 JSON 绑定时，设置字段标签为 json:"fieldname"

Gin 框架提供了两类绑定方法：

  • 第一类： 必须绑定 (Must Bind)，BindXXX() 方法，如果绑定出错则会直接抛出 400 错误：
    方法有： Bind(), BindJSON(), BindXML(), BindQuery(), BindYAML(), BindHeader(), BindTOML()。

  • 第二类： 应该绑定 (Should bind)，ShouldBindXXX() 等方法，如果绑定出错则会抛出异常
    方法有： ShouldBind(), ShouldBindJSON(), ShouldBindXML(), ShouldBindQuery(), ShouldBindYAML(), ShouldBindHeader(), ShouldBindTOML(),

这些方法具体的实现调用了 ShouldBindWith()。 如果发生绑定错误，Gin 会返回错误并由开发者处理错误和请求。

package mainimport ("net/http""github.com/gin-gonic/gin"
)type Login struct {Username string `form:"username" json:"username" binding:"required"`Password string `form:"password" json:"password" binding:"required"`
}func main() {router := gin.Default()// 绑定JSON的示例 ({"username": "admin", "password": "123456"})router.POST("/loginJson", func(ctx *gin.Context) {var login Login// ShouldBind()会根据请求的Content-Type自行选择绑定器if err := ctx.ShouldBind(&login); err != nil {ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}if login.Username == "admin" && login.Password == "123456" {ctx.JSON(http.StatusOK, gin.H{"status":   "you are logged in","username": login.Username,"password": login.Password,})} else {ctx.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})}})// 绑定form表单示例router.POST("/loginForm", func(ctx *gin.Context) {var login Login// ShouldBind()会根据请求的Content-Type自行选择绑定器if err := ctx.ShouldBind(&login); err != nil {ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}if login.Username == "admin" && login.Password == "123456" {ctx.JSON(http.StatusOK, gin.H{"status":   "you are logged in","username": login.Username,"password": login.Password,})} else {ctx.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})}})// 绑定QueryString示例router.GET("loginQuery", func(ctx *gin.Context) {var login Login// ShouldBind()会根据请求的Content-Type自行选择绑定器if err := ctx.ShouldBind(&login); err != nil {ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}if login.Username == "admin" && login.Password == "123456" {ctx.JSON(http.StatusOK, gin.H{"status":   "you are logged in","username": login.Username,"password": login.Password,})} else {ctx.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})}})router.Run(":8080")}

绑定JSON
在这里插入图片描述
绑定form表单
在这里插入图片描述
绑定QueryString
在这里插入图片描述
需要注意的是，如果没有输入password，是会报错的。是因为tag中的binding:"required"进行了限制。如果将 Password 改为 binding:"-"， 再次运行上面的示例就不会返回错误。

Password string `form:"password" json:"password" binding:"required"`

参考资料

李文周的博客
Gin 框架中文文档

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/863843.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

常见Web认证方式对比

常见Web认证方式对比

认证是一个在用户或者设备在访问一个受限的系统时，鉴定用户凭据的过程，即确认“你是谁”的问题。最常见的认证用户的方式是通过用户名和密码的形式进行校验，目前存在多种校验方式，本文将对其进行一个简单的对比，使得大…
阅读更多...
160相交链表

160相交链表

解法1： public class Solution {public ListNode getIntersectionNode(ListNode headA, ListNode headB) {// 定义两个指针。// 获得两个链表的长度，将较长的链表先用指针移动到和短链表一样的长度。// 再一个个比较ListNode l1 headA, l2 headB;int …
阅读更多...
在我们的大数据平台(XSailbaot)上进行企业级数据建模的思路

在我们的大数据平台(XSailbaot)上进行企业级数据建模的思路

1. 背景 笔者所在的公司是差不多二十年前搞CIM（公共信息模型的）起家的。当时公司的前辈搞了基于CIS协议的模型服务器、数据服务器、模式编辑器等，形成了一套基于公共信息模型建模的平台系统。其中可视化建模，建好了模式类以后&am…
阅读更多...
Kotlin中对空的很多处理

Kotlin中对空的很多处理

代码图片直观效果 逐行解释Kotlin中对空的各种情况的使用 private fun testNull() {val flag 1var name: String? nullvar user: User? // 有警告, 因为下面的赋值可以和这一行定义合并var zhangUser: User? User()var wangUser: User User() // 提示Explicitly given t…
阅读更多...
AttGAN实验复现 2024

AttGAN实验复现 2024

AttnGAN 代码复现 2024 文章目录 AttnGAN 代码复现 2024简介环境python 依赖数据集TrainingPre-train DAMSMTrain AttnGAN SamplingB_VALIDATION 为 False (默认)B_VALIDATION 为 True 参考博客 简介 论文地址： https://arxiv.org/pdf/1711.10485.pdf 代码 python…
阅读更多...
C++: 如何用C语言实现C++的虚函数机制？

C++: 如何用C语言实现C++的虚函数机制？

前言 在 googletest的源码中，看到gtest-matchers.h 中实现的MatcherBase 类自定义了一个 VTable，这种设计实现了一种类似于C虚函数的机制。C中的虚函数机制实质上就是通过这种方式实现的，本文用c语言自定义虚函数表VTable实现了一下virtual的…
阅读更多...
Workerman在线客服系统源码，附搭建教程

Workerman在线客服系统源码，附搭建教程

源码介绍： Workerman在线客服系统源码。 workerman是一个高性能的PHP socket 服务器框架，workerman基于PHP多进程以及libevent事件轮询库，PHP开发者只要实现一两个接口，便可以开发出自己的网络应用，例如Rpc服务、聊天…
阅读更多...
240630_昇思学习打卡-Day12-Transformer中的Multiple-Head Attention

240630_昇思学习打卡-Day12-Transformer中的Multiple-Head Attention

240630_昇思学习打卡-Day12-Transformer中的Multiple-Head Attention 以下为观看大佬课程及查阅资料总结所得，附大佬视频链接：Transformer中Self-Attention以及Multi-Head Attention详解_哔哩哔哩_bilibili，强烈建议先去看大佬视频&#xff…
阅读更多...
python解锁图片相似度的神奇力量

python解锁图片相似度的神奇力量

在这个信息爆炸的时代，图片成为了我们传递信息、表达情感和记录生活的重要方式。然而，面对海量的图片资源，如何快速准确地找到相似的图片，成为了一个亟待解决的问题。现在，让我们为您揭开图片相似度的神秘面纱，带您领略这一创新技术的魅力！ 图片相似度技术，就像是一位…
阅读更多...
docker harbor仓库搭建,主从库复制

docker harbor仓库搭建,主从库复制

背景：需要主机安装docker-ce和docer-compose #1.安装相关依赖. yum install -y yum-utils device-mapper-persistent-data lvm2 #2.下载官方的docker yum源文件 yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo …
阅读更多...
10款好用不火的PC软件，真的超好用！

10款好用不火的PC软件，真的超好用！

AI视频生成：小说文案智能分镜智能识别角色和场景批量Ai绘图自动配音添加音乐一键合成视频https://aitools.jurilu.com/市场上有很多软件，除了那些常见的大众化软件，还有很多不为人知的小众软件，它们的作用非常强大，简洁…
阅读更多...
cJSON源码解析之add_item_to_object函数

cJSON源码解析之add_item_to_object函数

文章目录 前言add_item_to_object函数是干什么的add_item_to_object代码解析函数实现函数原理解析开头的代码constant_key参数的作用最后的if判断 add_item_to_array函数 总结 前言 在我们的日常编程中，JSON已经成为了一种非常常见的数据交换格式。在C语言中&#…
阅读更多...
UI Toolkit系统学习

UI Toolkit系统学习

UI Toolkit 此文章用于学习UnityUI系统，手头的项目做完会来完善 官方文档 Unity上方菜单栏点击Window->UI Toolkit->Samples可以看UI Toolkit中的很多样例 使用 UI Toolkit 和 UI Builder 制作物品编辑器 在文件夹中右键->Create->UI Toolkit->Edi…
阅读更多...
leetCode-hot100-动态规划专题

leetCode-hot100-动态规划专题

动态规划 动态规划定义动态规划的核心思想动态规划的基本特征动态规划的基本思路例题322.零钱兑换53.最大子数组和72.编辑距离139.单词拆分62.不同路径63.不同路径Ⅱ64.最小路径和70.爬楼梯121.买卖股票的最佳时机152.乘积最大子数组 动态规划定义 动态规划（Dynami…
阅读更多...
【训练篇】MLU370-M8 完成 qwen1.5-7b-chat-lora训练及推理

【训练篇】MLU370-M8 完成 qwen1.5-7b-chat-lora训练及推理

文章目录 前言一、平台环境配置二、环境 or 模型准备1.模型下载2.环境准备2.1 modelscope2.2 transformers2.3 accelerate2.4 deepspeed2.5 peft2.6 环境代码修改 3训练代码准备4 代码修改 三，训练后推理验证四.推理效果展示1.微调前2.微调后 前言 本期我们采用魔塔…
阅读更多...
distance delayed sound

distance delayed sound

distance delayed sound 在本章中，我们将讨论在游戏音频中使用距离延迟的重要性。我们将首先通过一个常见的例子——闪电和雷鸣，来展示这种重要性并解释距离延迟音频的基础知识。我们将讨论计算速度、距离和时间的数学和方程式，以确定距离延迟…
阅读更多...
数据倾斜优化：Hive性能提升的核心

数据倾斜优化：Hive性能提升的核心

文章目录 1. 定义2. 数据倾斜2.1 Map2.2 Join2.3 Reduce 3. 写在最后 1. 定义 数据倾斜，也称为Data Skew，是在分布式计算环境中，由于数据分布不均匀导致某些任务处理的数据量远大于其他任务，从而形成性能瓶颈的现象。这种情况在H…
阅读更多...
PotPlayer安装及高分辨率设置

PotPlayer安装及高分辨率设置

第1步： 下载安装PotPlayer软件 PotPlayer链接：https://pan.baidu.com/s/1hW168dJrLBonUnpLI6F3qQ 提取码：z8xd 第2步： 下载插件，选择系统对应的位数进行运行，该文件不能删除，删除后将失效。 …
阅读更多...
【强化学习的数学原理】课程笔记--2（贝尔曼最优公式，值迭代与策略迭代）

【强化学习的数学原理】课程笔记--2（贝尔曼最优公式，值迭代与策略迭代）

目录 贝尔曼最优公式最优 Policy求解贝尔曼最优公式求解最大 State Value v ∗ v^* v∗根据 v ∗ v^* v∗ 求解贪婪形式的最佳 Policy π ∗ \pi^* π∗一些证明过程 一些影响 π ∗ \pi^* π∗ 的因素如何让 π ∗ \pi^* π∗ 不 “绕弯路” γ \gamma γ 的影响reward 的…
阅读更多...
2024/6/30周报

2024/6/30周报

文章目录 摘要ABSTRACT文献阅读题目问题本文贡献方法LSTMTCN模型总体架构 实验实验结果 深度学习TCN-LSTM代码运行结果 总结 摘要 本周阅读了一篇关于TCN和LSTM进行光伏功率预测的文章，本文提出了一种利用LSTM-TCN预测光伏功率的新模型。它由长短期记忆和时间卷积网…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023