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

ops/2025/1/17 1:44:03/

1. 什么是Gin框架

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

1.1 什么是web框架

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

画板

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

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

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

1.2 web框架两种架构模式

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

  1. 前后端不分离
  2. 前后端分离

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

画板

可以看出主要区别在于后端没有了模板引擎，意味着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")
}

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

  1. go mod init gin_first：包管理初始化
  2. 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")
}

程序运行结果：


http://www.ppmy.cn/ops/150687.html

相关文章

基于YOLOv8与CGNet的鸟类智能识别系统 深度学习图像分类 鸟类目标检测与分类 图像特征提取 模型优化与应用 数据可视化（源码+指导+定制）

基于YOLOv8与CGNet的鸟类智能识别系统 深度学习图像分类 鸟类目标检测与分类 图像特征提取 模型优化与应用 数据可视化（源码+指导+定制）

博主介绍： ✌我是阿龙，一名专注于Java技术领域的程序员，全网拥有10W粉丝。作为CSDN特邀作者、博客专家、新星计划导师，我在计算机毕业设计开发方面积累了丰富的经验。同时，我也是掘金、华为云、阿里云、InfoQ等平台…
阅读更多...
科技快讯 | 抖音治理AI造假地震图片；投影仪也玩三折叠；京东发布“AI京医”大模型

科技快讯 | 抖音治理AI造假地震图片；投影仪也玩三折叠；京东发布“AI京医”大模型

智谱 GLM 大模型在模型幻觉排行榜中居首，事实一致性达 98.7% 近日，智谱旗下GLM-4-9B模型在HHEM-2.1-Open幻觉评估模型排行榜中，以1.3%的幻觉率排名第一，超越了OpenAI的GPT系列和Google的Gemini系列等世界顶尖模型。信息来源于智谱…
阅读更多...
C#中的Span

C#中的Span

一、引言 在 C# 开发的广袤天地里，性能犹如一把高悬的达摩克利斯之剑，时刻影响着应用程序的质量与用户体验。从响应迟缓的界面交互，到耗时良久的数据处理，性能瓶颈如同顽疾，阻碍着软件的高效运行。无论是追求极致流畅…
阅读更多...
PyCharm文档管理

PyCharm文档管理

背景：使用PyCharmgit做文档管理 需求：需要PyCharm自动识别docx/xslx/vsdx等文件类型，并在PyCharm内点击文档时唤起系统内关联应用(如word、excel、visio) 设置步骤： 1、file -》 settings -》file types 2、在Files opened i…
阅读更多...
iOS - 底层实现中涉及的类型

iOS - 底层实现中涉及的类型

1. 基本类型定义 // 基础类型 typedef unsigned long uintptr_t; // 指针大小的无符号整数 typedef long ptrdiff_t; // 指针差值类型 typedef unsigned int uint32_t; // 32位无符号整数 typedef unsigned long long uint64_t; // 64…
阅读更多...
利用 Java 爬虫获取 1688 商品评论的实践指南

利用 Java 爬虫获取 1688 商品评论的实践指南

在电商领域，商品评论是消费者决策的重要参考因素，同时也是商家了解产品反馈、优化服务的关键数据来源。1688 作为国内知名的 B2B 电商平台，拥有海量的商品评论数据。本文将详细介绍如何利用 Java 爬虫技术获取 1688 商品评论，并提…
阅读更多...
利用 Python 爬虫获取 1688 商品评论的实践指南

利用 Python 爬虫获取 1688 商品评论的实践指南

在当今电商蓬勃发展的时代，商品评论成为了消费者决策的重要依据，同时也为商家提供了宝贵的市场反馈。1688 作为国内知名的 B2B 电商平台，拥有海量的商品评论数据。通过 Python 爬虫技术，我们可以高效地获取这些评论数据&#xff0…
阅读更多...
启动项目报JVM初始化错误

启动项目报JVM初始化错误

说明：有次像往常一样启动项目，但是报下面的错误 错误信息： Error occurred during initialization of VM Unable to allocate 261760KB bitmaps for parallel garbage collection for the requested 8376320KB headp.Error：Cou…
阅读更多...
最新文章

Copyright @ 2022~2023