Gin框架操作指南06：POST绑定（下）

🕗 发布于 2024-10-16 18:14 gin golang

官方文档地址（中文）：https://gin-gonic.com/zh-cn/docs/
注：没用过Gin的读者强烈建议先阅读第一节：Gin操作指南：开山篇。
本节继续演示POST绑定，包括将request-body绑定到不同的结构体中；映射查询字符串或表单参数；上传文件 Query和post-form。

一、将request-body绑定到不同的结构体中

package main

import (
"net/http"

"github.com/gin-gonic/gin"
)

// 定义表单结构体 formA，包含一个必需字段 Foo
type formA struct {
Foo string `json:"foo" xml:"foo" binding:"required"` // 绑定 JSON 和 XML 的字段 foo
}

// 定义表单结构体 formB，包含一个必需字段 Bar
type formB struct {
Bar string `json:"bar" xml:"bar" binding:"required"` // 绑定 JSON 和 XML 的字段 bar
}

// 处理请求的函数
func SomeHandler(c *gin.Context) {
objA := formA{} // 创建 formA 的实例
objB := formB{} // 创建 formB 的实例

// c.ShouldBind 使用了 c.Request.Body，不可重用。
if errA := c.ShouldBind(&objA); errA == nil {
// 如果绑定成功，返回表单A的成功信息
c.String(http.StatusOK, `the body should be formA`)
} else if errB := c.ShouldBind(&objB); errB == nil {
// 因为现在 c.Request.Body 是 EOF，所以这里会报错。
c.String(http.StatusOK, `the body should be formB`)
} else {
// 处理绑定错误
c.String(http.StatusBadRequest, `Invalid input`)
}
}

func main() {
router := gin.Default()
router.POST("/some-handler", SomeHandler) // 注册路由
router.Run(":8080")                       // 启动服务器
}

注意if分支中的注释，效果如下
在这里插入图片描述

要想多次绑定，可以使用 c.ShouldBindBodyWith.

func SomeHandler(c *gin.Context) {
objA := formA{}
objB := formB{}
// 读取 c.Request.Body 并将结果存入上下文。
if errA := c.ShouldBindBodyWith(&objA, binding.JSON); errA == nil {
c.String(http.StatusOK, the body should be formA)
// 这时, 复用存储在上下文中的 body。
} else if errB := c.ShouldBindBodyWith(&objB, binding.JSON); errB == nil {
c.String(http.StatusOK, the body should be formB JSON)
// 可以接受其他格式
} else if errB2 := c.ShouldBindBodyWith(&objB, binding.XML); errB2 == nil {
c.String(http.StatusOK, the body should be formB XML)
} else {
…
}
}
c.ShouldBindBodyWith 会在绑定之前将 body 存储到上下文中。这会对性能造成轻微影响，如果调用一次就能完成绑定的话，那就不要用这个方法。
只有某些格式需要此功能，如 JSON, XML, MsgPack, ProtoBuf。对于其他格式, 如 Query, Form, FormPost, FormMultipart 可以多次调用 c.ShouldBind() 而不会造成任任何性能损失 (详见 #1341)。

二、映射查询字符串或表单参数

package main

import (
"fmt" // 导入格式化I/O库

"github.com/gin-gonic/gin" // 导入Gin框架
)

func main() {
router := gin.Default() // 创建默认的Gin路由

// 设置处理POST请求的路由
router.POST("/post", func(c *gin.Context) {

// c.QueryMap("ids") 用于映射查询字符串中的 "ids" 参数
// 例如：POST /post?ids[a]=1234&ids[b]=hello
// 这个方法会将查询参数转换为一个map，key为参数名，value为参数值
ids := c.QueryMap("ids")

// c.PostFormMap("names") 用于映射表单数据中的 "names" 参数
// 例如：names[first]=thinkerou&names[second]=tianou
// 这个方法会将表单数据转换为一个map
names := c.PostFormMap("names")

// 打印解析后的 ids 和 names 的值
// ids: map[b:hello a:1234], names: map[second:tianou first:thinkerou]
fmt.Printf("ids: %v; names: %v", ids, names)
})

router.Run(":8080") // 启动服务器并监听8080端口
}

打开postman，输入http://localhost:8080/post?ids[a]=1234&ids[b]=hello
然后在body中添加key和value，注意names[]作为一个key，效果如图
在这里插入图片描述

三、上传文件

在”上传文件”，目录下建立两个文件夹demo01和demo02，demo01用于单文件上传：

package main

import (
"fmt"
"log"
"net/http"

"github.com/gin-gonic/gin"
)

func main() {
router := gin.Default()
// 为 multipart forms 设置较低的内存限制 (默认是 32 MiB)
// 将内存限制设置为 8 MiB，这意味着如果上传的文件超过这个大小，
// 将会返回错误，确保服务器不会因为大文件上传而耗尽内存
router.MaxMultipartMemory = 8 << 20 // 8 MiB

// 定义一个 POST 路由，处理文件上传
router.POST("/upload", func(c *gin.Context) {
// 从请求中获取文件，"file" 是表单字段的名称
file, err := c.FormFile("file")
if err != nil {
// 处理文件获取错误，返回状态码 400 和错误信息
c.String(http.StatusBadRequest, "Error retrieving the file")
return
}

// 打印文件名到服务器日志
log.Println(file.Filename)

// 设置文件保存的目标路径，文件将保存在当前目录下
dst := "./" + file.Filename
// 上传文件至指定的完整文件路径
if err := c.SaveUploadedFile(file, dst); err != nil {
// 如果文件保存失败，返回状态码 500 和错误信息
c.String(http.StatusInternalServerError, "Unable to save the file")
return
}

// 返回成功信息，告知用户文件已上传
c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
})

// 启动服务器，监听 8080 端口
router.Run(":8080")
}

打开postman，输入http://loaclhost:8080/upload，在body中填充form-data，key=file，类型为File，然后选择文件，选好后点击send，效果如下
在这里插入图片描述

多文件上传

package main

import (
"fmt"
"log"
"net/http"

"github.com/gin-gonic/gin"
)

func main() {
router := gin.Default()
// 为 multipart forms 设置较低的内存限制 (默认是 32 MiB)
// 将内存限制设置为 8 MiB，这意味着如果上传的文件总大小超过这个限制，
// 将返回错误，确保服务器不会因为大文件上传而耗尽内存
router.MaxMultipartMemory = 8 << 20 // 8 MiB

// 定义一个 POST 路由，用于处理文件上传
router.POST("/upload", func(c *gin.Context) {
// Multipart form
// 从请求中获取 multipart 表单数据
form, err := c.MultipartForm()
if err != nil {
// 如果获取 multipart 表单数据失败，返回状态码 400 和错误信息
c.String(http.StatusBadRequest, "Failed to get multipart form")
return
}

// 获取上传的文件，"upload[]" 是表单字段的名称
files := form.File["upload[]"]

// 遍历每个文件
for _, file := range files {
// 打印文件名到服务器日志
log.Println(file.Filename)

// 设置文件保存的目标路径，文件将保存在当前目录下
dst := "./" + file.Filename
// 上传文件至指定目录
if err := c.SaveUploadedFile(file, dst); err != nil {
// 如果文件保存失败，返回状态码 500 和错误信息
c.String(http.StatusInternalServerError, "Unable to save the file")
return
}
}

// 返回成功信息，告知用户上传的文件数量
c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
})

// 启动服务器，监听 8080 端口
router.Run(":8080")
}

在这里插入图片描述

四、Query和post-form

package main

import (
"fmt"

"github.com/gin-gonic/gin"
)

func main() {
// 创建一个新的 Gin 路由引擎
router := gin.Default()

// 定义一个 POST 路由，用于处理 POST 请求
router.POST("/post", func(c *gin.Context) {
// 从查询字符串中获取 "id" 参数
id := c.Query("id")
// 从查询字符串中获取 "page" 参数，如果未提供，则返回默认值 "0"
page := c.DefaultQuery("page", "0")
// 从 POST 请求的表单数据中获取 "name" 参数
name := c.PostForm("name")
// 从 POST 请求的表单数据中获取 "message" 参数
message := c.PostForm("message")

// 打印获取到的参数值到标准输出
fmt.Printf("id: %s; page: %s; name: %s; message: %s\n", id, page, name, message)
})

// 启动 HTTP 服务器，监听 8080 端口
router.Run(":8080")
}

效果
在这里插入图片描述

原文地址：https://blog.csdn.net/weixin_54259326/article/details/142965509

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：Redis 数据类型set（集合）
下一篇：如何优雅的通过Spring Boot+Redission对订单实现定时关闭

【人工智能-初级】第3章 k-最近邻算法（KNN）：分类和Python实现
K-最近邻算法（K-Nearest Neighbors，简称KNN）是一种简单而有效的监督学习算法，主要用于分类和回归问题。在分类问题中，KNN算法通过计算测试样本与训练样本之间的距离，找到距离测试样
阅读更多2024-10-18
Java使用原生HttpURLConnection实现发送HTTP请求
HttpURLConnection 是 Java 提供的原生标准的用于发送 HTTP 请求和接收 HTTP 响应的一个类，它位于 java.net 包下，并继承了 URLConnection 类。Ht
阅读更多2024-10-18
React前端框架高级技巧
自定义Hooks是React 16.8引入的一个强大特性,允许你将组件逻辑提取到可重用的函数中。}, []);// 在组件中使用掌握这些React高级技巧,你将能够编写出更加高效、可维护的代码。Rea
阅读更多2024-10-18
Google Tx-LLM：用大型语言模型助力治疗药物开发
值得注意的是，Tx-LLM不仅可以结合分子信息与文本信息，还能在不同类型的治疗任务之间实现能力迁移，成为贯穿药物开发全流程的单一模型。在性能测试中，Tx-LLM在许多任务上展现了强大的数值预测能力，这
阅读更多2024-10-18
机器学习面试笔试知识点之K近邻算法(KNN)、最大期望算法(EM)
机器学习面试笔试知识点之K近邻算法(KNN)、最大期望算法(EM)
阅读更多2024-10-18
【STM32】STM32学习笔记-EXTI外部中断
外部中断（EXTI）是STM32单片机中常用的一种中断方式，它允许单片机对外部事件快速响应。本文将详细介绍如何使用STM32的EXTI外部中断，包括配置步骤和代码示例。
阅读更多2024-10-18
Spring Boot比Spring多哪些注解
需要注意的是，虽然这些注解是Spring Boot特有的，但Spring Boot本身是基于Spring框架构建的，因此它仍然支持Spring框架中的所有注解。此外，随着Spring Boot的不断发
阅读更多2024-10-18
Linux 命令 chown 和 chmod 的区别
chmod 命令可以更改文件的读（r）、写（w）和执行（x）权限，适用于文件所有者（u）、同组用户（g）、其他用户（o）以及所有用户（a）mode：新的权限模式，可以是字母和操作符的组合，如 u+rw
阅读更多2024-10-18
AWS账号的费用结构与使用指南
然而，虽然创建账号不需要费用，但使用AWS的各种服务通常是要收费的。总之，AWS账号本身是免费的，但使用AWS提供的服务通常会产生费用。了解AWS的费用结构、合理利用免费套餐以及定期监控使用情况，是确
阅读更多2024-10-18
推荐算法的学习
例如：随着人工智能的不断发展，机器学习这门技术也越来越重要，很多人都开启了学习机器学习，本文就介绍了机器学习的基础内容。提示：以下是本篇文章正文内容，下面案例可供参考LR的主要限制在于需要大量手动特征
阅读更多2024-10-18

Gin框架操作指南06：POST绑定（下）

目录

一、将request-body绑定到不同的结构体中

二、映射查询字符串或表单参数

三、上传文件

四、Query和post-form

相关文章