当前位置：首页 > news >正文

【Go】Go Gin框架初识（一）

news 来源：原创 2025/6/8 16:26:26

1. 什么是Gin框架

Gin框架：是一个由 Golang 语言开发的 web 框架，能够极大提高开发 web 应用的效率！

1.1 什么是web框架

web框架体系图（前后端不分离）如下图所示：

从上图中我们可以发现一个Web框架最重要的一些组成部分：

HTTP解析/封装系统：解析HTTP请求以及将响应构造为HTTP请求等任务交由web框架来完成
路由系统：将一个请求路由给某一个指定的处理器函数
逻辑处理系统：是后端人员需要关注的重点区域，编写具体业务逻辑以及链接数据库
模板引擎（前后端不分离）：将数据嵌入到HTML模板中，构建动态页面

简单来说，web框架将一些繁琐且与业务逻辑无关的部分封装起来供开发者使用，这样开发人员只需要关注业务逻辑层的实现

1.2 web框架两种架构模式

常见的 web 架构模式有两种：

前后端不分离
前后端分离

上面已经介绍了前后端不分离的架构体系图，下图是前后端分离的架构图：

可以看出主要区别在于后端没有了模板引擎，意味着HTML页面、图片等static静态资源全部都在前端服务器部署（如nginx），后端服务器只负责编写接口进行业务逻辑处理，然后将前端所需的数据暴露成接口返回！（不和页面打任何交道）

2. Gin框架

2.1 Gin框架如何安装

在Go 1.11之后引入了包管理机制，我们就可以使用go mod tidy一键将代码中所需导入的包从远程服务器下载到本地

package mainimport "github.com/gin-gonic/gin"func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/hello", func(c *gin.Context) {c.String(200, "Hello Gin")})// 启动r.Run(":8080")
}

编写完上述代码以后在控制台输入以下命令：

go mod init gin_first：包管理初始化
go mod tidy：下载所需依赖

看到上述信息就表明 gin 框架已经引入完毕！可以正式编写代码啦~

2.2 Gin框架的路由系统

2.2.1 基本使用

其实在 2.1 节我们已经初步使用过路由系统了

// 设置路由
r.GET("/hello", func(c *gin.Context) {c.String(200, "hello gin")
})

基本语法：r.操作方法(url, 处理器函数)

操作方法：引擎对象基本支持所有的HTTP请求方法，比如GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS，以及Any（任何请求）、NoRoute(没有请求对应上时访问)
url：表示请求对应的路径
处理器函数：表示请求路径为"/hello"时映射到该处理器函数进行执行

现在我们通过浏览器使用GET请求访问路径：http://localhost:8080/hello

2.2.2 路由分组

有时候我们希望对一个 url 路径做更统一化的管理，比如"/user/login"和"/user/register"实际上都是在"/user"路径下的子路由，这个时候就需要引入 路由分组

基本语法：子路由对象 := r.Group(根路由)

package mainimport "github.com/gin-gonic/gin"func main() {// 获取引擎对象r := gin.Default()// 设置根路由userRouter := r.Group("/user"){userRouter.GET("/login", func(ctx *gin.Context) {ctx.String(200, "/user/login")})userRouter.GET("/register", func(ctx *gin.Context) {ctx.String(200, "/user/register")})}// 启动r.Run(":8080")
}

2.3 Gin框架获取参数

2.3.1 获取基本信息

2.3.1.1 获取请求方法

比如在Any请求内部想要知道具体请求方法可以使用：

基本语法：var method string = ctx.Request.Method

package mainimport ("fmt""github.com/gin-gonic/gin"
)func handleFunc(ctx *gin.Context) {// 获取请求方法method := ctx.Request.Methodfmt.Println("请求方法是:" + method)ctx.String(200, "request ok")
}func main() {// 获取引擎对象r := gin.Default()// 设置路由r.Any("/method", handleFunc)// 启动r.Run(":8080")
}

代码运行结果：

2.3.1.2 获取请求URL

基本语法：var url string = ctx.Request.URL

package mainimport ("fmt""github.com/gin-gonic/gin"
)func handleFunc(ctx *gin.Context) {// 获取请求URLvar url string = ctx.Request.URL.String()fmt.Println("请求URL是:" + url)ctx.String(200, "request ok")
}func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/url", handleFunc)// 启动r.Run(":8080")
}

代码运行结果：

2.3.1.3 获取远程IP地址

基本语法：

方式一：var remoteAddr string = ctx.Request.RemoteAddr（包含端口）
方式二：var remoteAddr string = ctx.ClientIP()（不包含端口）

package mainimport ("fmt""github.com/gin-gonic/gin"
)func handleFunc1(ctx *gin.Context) {// 获取远程ipvar addr string = ctx.Request.RemoteAddrfmt.Println("远程ip:", addr)ctx.String(200, "request ok")
}func handleFunc2(ctx *gin.Context) {// 获取远程ipvar addr string = ctx.ClientIP()fmt.Println("远程ip:", addr)ctx.String(200, "request ok")
}func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/addr1", handleFunc1)r.GET("/addr2", handleFunc2)// 启动r.Run(":8080")
}

代码运行结果：

2.3.1.4 获取请求头信息

本语法：var headerInfo string = ctx.GetHeader(键)

package mainimport ("fmt""github.com/gin-gonic/gin"
)func handleFunc(ctx *gin.Context) {// 获取指定请求头var userAgent string = ctx.GetHeader("User-Agent")fmt.Println("Content-Type:", userAgent)ctx.String(200, "request ok")
}func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/header", handleFunc)// 启动r.Run(":8080")
}

代码运行结果：

2.3.2 获取请求数据

2.3.2.1 获取查询字符串内容

通常来说使用 GET 请求发送请求都会将数据放置在查询字符串位置

方式一：var content string = ctx.Query(键)
方式二：var content string = ctx.DefaultQuery(键, 缺省值)，如果不存在则使用默认值填充
方式三：value, ok := ctx.GetQuery(键)，可以通过ok判断是否存在键

package mainimport ("fmt""github.com/gin-gonic/gin"
)func handleFunc1(ctx *gin.Context) {// 获取查询字符串数据var username = ctx.Query("username")var pwd = ctx.Query("pwd")fmt.Println("username:", username)fmt.Println("pwd:", pwd)ctx.String(200, "request ok")
}func handleFunc2(ctx *gin.Context) {// 获取查询字符串数据var user = ctx.DefaultQuery("user", "wjj")fmt.Println("user:", user)ctx.String(200, "request ok")
}func handleFunc3(ctx *gin.Context) {// 获取查询字符串数据user, exists := ctx.GetQuery("user")if exists {fmt.Println("键存在，值为:", user)} else {fmt.Println("键不存在!")}ctx.String(200, "request ok")
}func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/queryString1", handleFunc1)r.GET("/queryString2", handleFunc2)r.GET("/queryString3", handleFunc3)// 启动r.Run(":8080")
}

程序运行结果：

2.3.2.2 获取表单数据

前端使用 form表单提交发送请求，此时Content-Type为x-www-form-urlencoded可以使用PostForm获取表单内容

方式一：var content string = ctx.PostForm(键)
方式二：var content string = ctx.DefaultPostForm(键, 缺省值)，如果不存在则使用默认值填充
方式三：value, ok := ctx.GetPostForm(键)，可以通过ok判断是否存在键

package mainimport ("fmt""github.com/gin-gonic/gin"
)func handleFunc1(ctx *gin.Context) {// 获取查询字符串数据var username = ctx.PostForm("username")var pwd = ctx.PostForm("pwd")fmt.Println("username:", username)fmt.Println("pwd:", pwd)ctx.String(200, "request ok")
}func handleFunc2(ctx *gin.Context) {// 获取查询字符串数据var user = ctx.DefaultPostForm("user", "wjj")fmt.Println("user:", user)ctx.String(200, "request ok")
}func handleFunc3(ctx *gin.Context) {// 获取查询字符串数据user, exists := ctx.GetPostForm("user")if exists {fmt.Println("键存在，值为:", user)} else {fmt.Println("键不存在!")}ctx.String(200, "request ok")
}func main() {// 获取引擎对象r := gin.Default()// 加载HTML资源r.LoadHTMLGlob("templates/*")// 设置路由r.GET("/", func(ctx *gin.Context) {ctx.HTML(200, "index.html", nil)})r.POST("/postform1", handleFunc1)r.POST("/postform2", handleFunc2)r.POST("/postform3", handleFunc3)// 启动r.Run(":8080")
}

程序运行结果：

2.3.2.3 获取JSON请求体数据

Go语言没有提供类似于 PostForm、Query 这样的API直接获取JSON数据，但是Go提供了ShouldBind函数，可以将 json 类型的数据自动映射到指定的结构体对象上

语法格式：ctx.ShouldBind(&结构体对象)

package mainimport ("fmt""github.com/gin-gonic/gin"
)type Student struct {Username string `json:"username"`Password string `json:"password"`
}func main() {// 获取引擎对象r := gin.Default()// 设置路由r.POST("/", func(ctx *gin.Context) {// 使用ShouldBind函数获取JSON数据var student Studenterr := ctx.ShouldBind(&student)if err != nil {fmt.Println(err)ctx.String(500, "解析错误")} else {fmt.Println(student)ctx.String(200, "request ok")}})// 启动r.Run(":8080")
}

程序运行结果：

2.4 Gin框架返回响应

2.4.1 返回HTML页面

语法格式：ctx.HTML(响应状态码, 页面, 数据对象)

响应状态码：对应的HTTP状态码
页面：具体页面路径
数据对象：与模板引擎相关（后续章节介绍）

package mainimport "github.com/gin-gonic/gin"func main() {// 获取引擎对象r := gin.Default()// 加载模板文件r.LoadHTMLGlob("templates/*")// 设置路由r.GET("/", func(ctx *gin.Context) {// 返回首页ctx.HTML(202, "index.html", nil)})// 启动r.Run(":8080")
}

程序运行结果：

2.4.2 返回String类型

语法格式：ctx.String(响应状态码, 格式化字符串)

响应状态码：对应的HTTP状态码
格式化字符串：具体返回的文本内容

package mainimport "github.com/gin-gonic/gin"func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/", func(ctx *gin.Context) {// 返回sring类型ctx.String(200, "string 类型")})// 启动r.Run(":8080")
}

程序运行结果：

2.4.3 返回JSON类型

语法格式：ctx.JSON(响应状态码, gin.H对象)

响应状态码：对应的HTTP状态码
gin.H对象：具体返回JSON格式对象

package mainimport "github.com/gin-gonic/gin"func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/", func(ctx *gin.Context) {// 返回json类型ctx.JSON(200, gin.H{"name": "wjj","age":  21,})})// 启动r.Run(":8080")
}

程序运行结果：

2.4.4 返回XML类型

语法格式：ctx.XML(响应状态码, gin.H对象)

响应状态码：对应的HTTP状态码
gin.H对象：具体返回XML格式对象

package mainimport "github.com/gin-gonic/gin"func main() {// 获取引擎对象r := gin.Default()// 设置路由r.GET("/", func(ctx *gin.Context) {ctx.XML(200, gin.H{"name": "wjj","age":  21,})})// 启动r.Run(":8080")
}

程序运行结果：

【Go】Go Gin框架初识（一）

1. 什么是Gin框架 Gin框架：是一个由 Golang 语言开发的 web 框架，能够极大提高开发 web 应用的效率！ 1.1 什么是web框架 web框架体系图（前后端不分离）如下图所示： 从上图中我们可以发现一个Web框架最重要…...

编程日记 2025/5/31 1:29:18

计算机网络的五层协议

计算机网络的五层协议 ‌计算机网络的五层协议模型包括物理层、数据链路层、网络层、传输层和应用层，每一层都有其特定的功能和相关的协议。‌‌1 ‌物理层‌：负责传输原始的比特流，通过线路（有线或无线）将数据转换为…...

编程日记 2025/6/3 15:14:05

QT中，在子线程中更新UI，会出现哪些问题，如何避免这种情况发生。

在Qt中，直接从子线程更新UI（用户界面）通常会导致各种问题，主要是因为Qt的UI组件（如QWidget及其子类）并不是线程安全的。具体来说，可能会出现以下问题： 崩溃和未定义行为：…...

编程日记 2025/6/2 9:38:56

C++并发编程之多线程环境下使用无锁数据结构的重要准则

在多线程环境中使用无锁数据结构（Lock-Free Data Structures）能够显著提高程序的并发性能，因为它们避免了传统锁机制带来的竞争和阻塞问题。然而，无锁编程本身也带来了许多挑战，如内存管理、数据一致性和正确性等问题。…...

编程日记 2025/6/3 4:29:42

Vue篇-07

Vue UI组件库一、移动端常用的UI组件库 1.1、Vant 1.2、Cube UI 1.3、Mint UI 二、PC端常用的UI组件库 2.1、Element UI Element - The worlds most popular Vue UI framework 安装： 按需引入： 135_尚硅谷Vue技术_element-ui按需引入_哔哩哔哩_b…...

编程日记 2025/6/4 7:32:46

Zookeeper 数据迁移实战：基础环境搭建与高效迁移方案全览

文章目录一、Zookeeper数据迁移简介二、迁移zookeeper数据基础环境三、利用快照迁移zookeeper数据1、Node1最新的zk快照文件和日志文件2、将被迁移方node2的zookeeper的集群全部stop3、将源node1集群数据和日志拷贝到指定目录下4、验证优先启动拷贝的数据、日志的zookeeper节点…...

编程日记 2025/6/2 16:26:17

内联变量（inline variables）：在多个文件中共享全局常量

在 C17 中，引入了内联变量（inline variables） 的概念，可以用于在多个文件中共享全局常量。内联变量允许在头文件中定义变量，而不会导致链接错误（如重复定义）。这种方式非常适合用于定义跨多个文…...

编程日记 2025/6/2 2:58:30

WOA-CNN-LSTM-Attention、CNN-LSTM-Attention、WOA-CNN-LSTM、CNN-LSTM四模型对比多变量时序预测

WOA-CNN-LSTM-Attention、CNN-LSTM-Attention、WOA-CNN-LSTM、CNN-LSTM四模型对比多变量时序预测目录 WOA-CNN-LSTM-Attention、CNN-LSTM-Attention、WOA-CNN-LSTM、CNN-LSTM四模型对比多变量时序预测预测效果基本介绍程序设计参考资料预测效果基本介绍基于WOA-CNN-LSTM-A…...

编程日记 2025/6/1 19:54:30

【kubernetes】K8S节点状态的维护

1 节点状态节点是K8S集群中的一类重要资源，节点的状态通常可以作为判断集群异常的重要手段。为了展示节点在各方面的健康程度，在kubectl describe node k8s-master的输出结果中的Conditions部分可以查看k8s-master节点的一些状态数据： N…...

编程日记 2025/6/2 23:07:04

工业视觉2-相机选型

工业视觉2-相机选型一、按芯片类型二、按传感器结构特征三、按扫描方式四、按分辨率大小五、按输出信号六、按输出色彩接口类型这张图片对工业相机的分类方式进行了总结，具体如下： 一、按芯片类型 CCD相机：采用电荷耦合器件（CC…...

编程日记 2025/6/2 4:50:33

Oracle查询-in条件超过1000

目录 1.不分页 2.分页 oracle数据库中，in的查询条件超过1000的话，就会报错，应该怎样处理这样的情况呢？ 1.不分页把查询条件分成几个list，每个list有1000个数据，有几个list查询几次数据库就行了 2.分…...

编程日记 2025/6/2 15:58:25

使用rknn进行retinaface部署（C++）

文章目录 RetinaFace导出ONNX导出RKNN编译运行学生课堂开源数据集RetinaFace RetinaFace是一种基于深度学习的高性能人脸检测方法，由InsightFace团队提出。它的核心思想是在单阶段检测器（如RetinaNet）的基础上，结合多任务学习来实现精确的人脸检测和特征点定位。以下是Ret…...

编程日记 2025/6/2 23:05:59

微服务拆分

微服务拆分接下来，我们就一起将黑马商城这个单体项目拆分为微服务项目，并解决其中出现的各种问题。熟悉黑马商城首先，我们需要熟悉黑马商城项目的基本结构： 大家可以直接启动该项目，测试效果。不过&#xff0c…...

编程日记 2025/6/2 20:05:06

【matlab】matlab知识点及HTTP、TCP通信

1、矩阵运算点乘：对于两个同维度的向量，点乘结果是这两个向量对应分量的乘积之和。点除：是指对两个数组的对应元素进行除法运算。点幂：表示元素对元素的幂运算。 >> A[1,2,3;4,5,6]; B[1,1,1;2,2,2]>> D1B.*AD…...

编程日记 2025/6/2 23:06:47

亿道三防丨三防笔记本是什么意思？和普通笔记本的优势在哪里？

三防笔记本是什么意思？和普通笔记本的优势在哪里？ 在现代社会中，笔记本电脑已经成为人们工作和生活中不可或缺的一部分。然而，在一些特殊行业或环境中，普通笔记本电脑由于其脆弱性和对环境条件的敏感性，往…...

编程日记 2025/6/1 10:35:13

C++并发编程之并发可扩展性与阿姆达尔定律

在C并发编程中，可扩展性和阿姆达尔定律（Amdahl’s Law）是两个非常重要的概念，它们帮助我们理解和优化并发程序的性能。下面我们分别讨论这两个概念，并探讨它们在C并发编程中的应用。可扩展性可扩展性（S…...

编程日记 2025/6/2 23:06:31

java 迪米特法则，原理、思想、工作流程、实现细节、稳定性、优缺点、应用场景等

迪米特法则（Law of Demeter，LoD），也被称为“最少知识原则”，是一种指导面向对象设计的原则，旨在减少对象之间的耦合度。以下是对迪米特法则的详细解析。 1. 定义迪米特法则指出：一个对象应该…...

编程日记 2025/6/3 14:19:49

使用 Docker 部署 Java 项目（通俗易懂）

目录 1、下载与配置 Docker 1.1 docker下载（这里使用的是Ubuntu，Centos命令可能有不同） 1.2 配置 Docker 代理对象 2、打包当前 Java 项目 3、进行编写 DockerFile，并将对应文件传输到 Linux 中 3.1 编写 dockerfile 文件 …...

编程日记 2025/6/3 14:19:30

DuckDB：精通Insert语句处理数据冲突

本文介绍DuckDB insert语句用法，包括常规的批量插入，尤其是插入数据冲突的处理，最后还提及returning子句的用法，每个用法提供示例说明。 insert插入数据 INSERT INTO向表中插入新行。可以插入由值表达式指定的一行或多行&#xf…...

编程日记 2025/6/3 14:22:01

DFT可测性设置与Tetramax测试笔记

1 DFT 1.1 DFT类型 1、扫描链（SCAN）： 扫描路径法是一种针对时序电路芯片的DFT方案.其基本原理是时序电路可以模型化为一个组合电路网络和带触发器(Flip-Flop，简称FF)的时序电路网络的反馈。 Scan 包括两个步骤，scan…...

编程日记 2025/6/3 14:21:11

AttributeError: Unknown IMAP4 command: ‘idle‘

imaplib 原生并不支持 IDLE 命令，这可能导致 AttributeError: Unknown IMAP4 command: idle 错误。解决办法是使用支持 IDLE 命令的库，例如 imapclient，或者通过扩展 imaplib 的方式实现。以下是两种解决方案： 方法 1&#xff1…...

编程日记 2025/6/3 14:21:44

css实现响应式详解

一、媒体查询（Media Queries） 基本概念媒体查询是 CSS3 中用于根据不同的设备特性（如屏幕宽度、高度、设备类型等）应用不同样式规则的技术。它允许你为特定的媒体类型（如屏幕、打印、手持设备等）和条件&a…...

编程日记 2025/6/2 23:42:09

hot100_240. 搜索二维矩阵 II

hot100_240. 搜索二维矩阵 II 直接遍历列减行增编写一个高效的算法来搜索 m x n 矩阵 matrix 中的一个目标值 target 。该矩阵具有以下特性： 每行的元素从左到右升序排列。每列的元素从上到下升序排列。示例 1： 输入：matrix [[1,4,7,1…...

编程日记 2025/6/2 17:16:26

【网络云SRE运维开发】2025第3周-每日【2025/01/15】小测-【第14章ospf高级配置】理论和实操解析

文章目录 14.1 选择题解题思路和参考答案14.2 理论题解题思路和参考答案14.3 实操题解题思路和参考答案思科（Cisco）设备华为（Huawei）设备小米/锐捷（或其他支持标准CLI命令的设备）通过网络管理工具注意事项 …...

编程日记 2025/6/3 14:21:28

Halcon代码 read_image (NinePointCalibration, D:/Desktop/halcon/ca74d-main/九点标定/NinePointCalibration.gif)rgb1_to_gray (NinePointCalibration, GrayImage)get_image_size (GrayImage, Width, Height) dev_display (GrayImage)* 获取当前显示的窗口句柄 dev_get_win…...

编程日记 2025/6/3 14:20:21

设计和优化用于 AR、HUD 和高级显示系统的表面浮雕光栅

表面浮雕光栅是许多光学系统中的关键组件，在控制增强现实 （AR） 显示器、平视显示器 （HUD） 和其他先进光子器件中的光传播方面发挥着关键作用。作为在这个领域工作的工程师和设计师，您了解针对特定应用优化这…...

编程日记 2025/6/3 14:20:55

编译pytorch——cuda-toolkit-nvcc

链接 https://blog.csdn.net/wjinjie/article/details/108997692https://docs.nvidia.com/cuda/cuda-installation-guide-linux/#switching-between-driver-module-flavorshttps://forums.developer.nvidia.com/t/can-not-load-nvidia-drivers-on-ubuntu-22-10/239750https://…...

编程日记 2025/6/3 10:03:06

1. 什么是Gin框架

1.1 什么是web框架

1.2 web框架两种架构模式

2. Gin框架

2.1 Gin框架如何安装

2.2 Gin框架的路由系统

2.2.1 基本使用

2.2.2 路由分组

2.3 Gin框架获取参数

2.3.1 获取基本信息

2.3.1.1 获取请求方法

2.3.1.2 获取请求URL

2.3.1.3 获取远程IP地址

2.3.1.4 获取请求头信息

2.3.2 获取请求数据

2.3.2.1 获取查询字符串内容

2.3.2.2 获取表单数据

2.3.2.3 获取JSON请求体数据

2.4 Gin框架返回响应

2.4.1 返回HTML页面

2.4.2 返回String类型

2.4.3 返回JSON类型

2.4.4 返回XML类型

相关文章：