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

Gin框架---基础综述

news 2025/6/27 20:42:24

目录

    • 一：经典入门案例
    • 二：请求参数
      • 2.1: API参数
      • 2.2: URL参数
      • 2.3: 表单参数
    • 三： 响应参数
    • 四：数据解析和绑定
      • 4.1: JSON数据解析绑定
      • 4.2: FROM表单数据解析和绑定
    • 五： 路由组
    • 六：异步处理
    • 七：中间件
      • 7.1: 全局中间件
      • 7.2: 局部中间件

一：经典入门案例

  • 代码：
    package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 2: 编写路由处理函数r.GET("/hello", func(context *gin.Context) {context.String(http.StatusOK, "hello world!!!")})// 3: 路由监听端口r.Run(":8080")
}
  • 请求：
    在这里插入图片描述

二：请求参数

2.1: API参数

  • API参数： 参数写在路径中。
  • 注意：
    • 1: 一般用冒号 + 路径参数名称来划分。 冒号的作用是可以让Param方法取到后面的数据。
    • 2: 如果是用星号 + 路径名称，则获取到的是包含路径斜杠+后续的所有内容的。
  • 案例一：
    	package mainimport ("github.com/gin-gonic/gin""net/http")func main() {// 1：实例化默认路由r := gin.Default()// 2: 编写路由处理函数r.GET("/user/:name/:action", func(context *gin.Context) {name := context.Param("name")action := context.Param("action")context.String(http.StatusOK, "name is "+name+", action is "+action+"。")})// 3: 路由监听端口r.Run(":8080")}```
- 结果， 发送请求：http://127.0.0.1:8080/user/renshanwen/reading

在这里插入图片描述

  • 案例二：
    package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 2: 编写路由处理函数r.GET("/user/*name_action", func(context *gin.Context) {nameAction := context.Param("name_action")context.String(http.StatusOK, "name_action is "+nameAction)})// 3: 路由监听端口r.Run(":8080")
}

在这里插入图片描述

2.2: URL参数

  • URL参数：参数写在请求k-v对中。
  • 使用Query()函数获取参数信息， 获取不到默认获取到空字符串。
  • 案例
    package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 2: 编写路由处理函数r.GET("/user", func(context *gin.Context) {name := context.Query("name")age := context.Query("age")context.String(http.StatusOK, "name is "+name+" age is "+age+".")})// 3: 路由监听端口r.Run(":8080")
}

在这里插入图片描述

2.3: 表单参数

  • POST请求中的信息， 一般是JSON数据。
  • 使用PostForm函数在表单中获取数据。
  • 案例：
    package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 2: 编写路由处理函数r.POST("/user", func(context *gin.Context) {name := context.PostForm("name")age := context.PostForm("age")context.String(http.StatusOK, "name is "+name+" age is "+age+".")})// 3: 路由监听端口r.Run(":8080")
}

在这里插入图片描述

  • 解析JSON数据
  • 案例：
    package mainimport ("github.com/gin-gonic/gin""net/http""strconv"
)func main() {// 1：实例化默认路由r := gin.Default()// 定义一个User结构体type User struct {Name string `json:"name"`Age  int64  `json:"age"`}// 2: 编写路由处理函数r.POST("/user", func(context *gin.Context) {// 实例化UserreqData := User{}// 将内容绑定到字典中context.BindJSON(&reqData)// 构造响应context.String(http.StatusOK, "name is "+reqData.Name+" age is "+strconv.FormatInt(reqData.Age, 10)+".")})// 3: 路由监听端口r.Run(":8080")
}
  • 结果
    在这里插入图片描述

三： 响应参数

  • Gin支持多种响应格式， 例如：json、结构体、XML、YAML类似于java的properties、ProtoBuf。
  • 最常用的就是json。
  • 案例：
    package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 定义一个User结构体type User struct {Name string `json:"name"`Age  int64  `json:"age"`}// 2: 编写路由处理函数r.POST("/user", func(context *gin.Context) {// 实例化UserreqData := User{}// 将内容绑定到字典中context.BindJSON(&reqData)respData := gin.H{"name": "renshanwen","age":  25,}// 构造响应context.JSON(http.StatusOK, respData)})// 3: 路由监听端口r.Run(":8080")
}
  • 结果：
    在这里插入图片描述

四：数据解析和绑定

4.1: JSON数据解析绑定

  • 案例：
package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 定义一个User结构体type User struct {// 名称 类型   被解析的类型:参数名称 binding:"required"表示必须绑定(请求中必须携带)Name string `json:"name" binding:"required"`Age  int64  `json:"age"`}// 2: 编写路由处理函数r.POST("/user", func(context *gin.Context) {// 实例化UserreqData := User{}// 将内容绑定到字典中if err := context.BindJSON(&reqData); err == nil {respData := gin.H{"name": "renshanwen","age":  25,}// 构造响应context.JSON(http.StatusOK, respData)} else {context.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})}})// 3: 路由监听端口r.Run(":8080")
}
  • 缺失name测试
    在这里插入图片描述
  • 缺失age测试
    在这里插入图片描述

4.2: FROM表单数据解析和绑定

  • 表单只需要调整一下使用的方法：Bind和定义的类型form
    package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {// 1：实例化默认路由r := gin.Default()// 定义一个User结构体type User struct {// 名称 类型   被解析的类型:参数名称 binding:"required"表示必须绑定(请求中必须携带)Name string `form:"name" binding:"required"`Age  int64  `form:"age"`}// 2: 编写路由处理函数r.POST("/user", func(context *gin.Context) {// 实例化UserreqData := User{}// 将内容绑定到字典中if err := context.Bind(&reqData); err == nil {respData := gin.H{"name": "renshanwen","age":  25,}// 构造响应context.JSON(http.StatusOK, respData)} else {context.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})}})// 3: 路由监听端口r.Run(":8080")
}
  • 测试
    在这里插入图片描述
    在这里插入图片描述

五： 路由组

  • 作用：根据URL前缀可以分组。
  • 案例：
    package mainimport ("github.com/gin-gonic/gin""net/http"
)// 定义一个User结构体
type User struct {// 名称 类型   被解析的类型:参数名称 binding:"required"表示必须绑定(请求中必须携带)Name string `form:"name" binding:"required"`Age  int64  `form:"age"`
}func main() {// 实例化默认路由r := gin.Default()// 定义一个路由组userRoutes := r.Group("/user"){userRoutes.POST("/shan", test)userRoutes.POST("/wen", test)}// 路由监听端口r.Run(":8080")
}func test(context *gin.Context) {// 实例化UserreqData := User{}// 将内容绑定到字典中if err := context.Bind(&reqData); err == nil {respData := gin.H{"name": "renshanwen","age":  25,}// 构造响应context.JSON(http.StatusOK, respData)} else {context.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})}
}
  • 测试
    在这里插入图片描述

六：异步处理

  • 需求：某些处理， 我们可以放在后台去做， 接口要求立刻返回数据。 则可以使用异步处理的方式。
  • 案例
    package mainimport ("fmt""github.com/gin-gonic/gin""net/http""time"
)// 定义一个User结构体
type User struct {// 名称 类型   被解析的类型:参数名称 binding:"required"表示必须绑定(请求中必须携带)Name string `form:"name" binding:"required"`Age  int64  `form:"age"`
}func main() {// 实例化默认路由r := gin.Default()// 定义一个路由组userRoutes := r.Group("/user"){userRoutes.POST("/action", test)}// 路由监听端口r.Run(":8080")
}func test(context *gin.Context) {// 实例化UserreqData := User{}// 将内容绑定到字典中if err := context.Bind(&reqData); err == nil {respData := gin.H{"name": "renshanwen","age":  25,}// 进行异步处理go func() {for i := 0; i < 10; i++ {fmt.Printf("正在处理 %d \n", i)time.Sleep(3 * time.Second)}}()// 构造响应context.JSON(http.StatusOK, respData)} else {context.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})}
}
  • 结果， 先返回了响应， 后进行循环处理。
    在这里插入图片描述

七：中间件

7.1: 全局中间件

  • 所有的请求都经过的中间件。
  • 例如： 所有的请求都经过

7.2: 局部中间件

http://www.lryc.cn/news/166312.html

相关文章：

  • 排序算法-快速排序
  • 【Spring容器的启动过程】
  • 普通二本+转专业学计算机是什么感受
  • 力扣1、两数之和
  • 一百七十三、Flume——Flume写入HDFS后的诸多小文件问题
  • Android.mk中C++使用
  • K8S：Pod概念、分类及相关的策略
  • 【Java杂谈】#1 【MCA JAVA后端架构师】
  • Vue3路由
  • Android Studio的笔记--aidl实现和调用
  • 大模型从入门到应用——LangChain：代理（Agents）-[工具包（Toolkit）]
  • VR全景算不算好的创业项目？有哪些特性？
  • Spring系列文章：Spring集成Log4j2⽇志框架、整合JUnit
  • flink的网络缓冲区
  • 产品经理学习笔记
  • 【深入理解Linux锁机制】七、互斥体
  • UGUI画布加载优化
  • SEC的下一步目标是什么？过时的证券法与加密货币行业，哪个会被先淘汰？
  • Kafka3.0.0版本——消费者（独立消费者消费某一个主题数据案例__订阅主题）
  • 笔记本多拓展出一个屏幕
  • Redis 高可用及持久化
  • Java高级: 反射
  • 【计算机网络】什么是WebSocket？
  • Apinto 网关： Go语言实现 HTTP 转 gRPC
  • 【管理运筹学】第 7 章 | 图与网络分析（4，最大流问题）
  • linux学习总结
  • 【API 管理】什么是 API 管理，为什么它很重要？
  • 基于人体呼出气体的电子鼻系统的设计与实现
  • OPC发展历程
  • 第69步 时间序列建模实战：ARIMA建模（R）