Gin框架入门之Rest操作、Query操作、提交表单、上传单个文件、上传多个文件用法

2023-10-23 19:58
文章标签 表单 入门 操作 用法 框架 提交 多个 上传 rest gin query 传单

本文主要是介绍Gin框架入门之Rest操作、Query操作、提交表单、上传单个文件、上传多个文件用法，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

在这里插入图片描述

文章目录

    • @[toc]
  • 1. 基本路由操作
  • 2. Restful风格的API
    • 2.1 API参数
    • 2.2 URL参数
      • 2.5 表单数据
      • 2.6上传单个文件
      • 2.7上传多个文件
      • 2.8 Route Group

1. 基本路由操作

  • gin框架采用的路由库是基于httprouter做的
  • httprouter链接：https://github.com/julienschmidt/httprouter

gin的基本路由框架如下：

package mainimport ("net/http""github.com/gin-gonic/gin"
)func getHandler(c *gin.Context) {c.String(http.StatusOK, "这是查询操作")
}
func addHandler(c *gin.Context) {c.String(http.StatusOK, "这是ADD操作")
}
func modifyHandler(c *gin.Context) {c.String(http.StatusOK, "这是PUT操作")
}
func main() {r := gin.Default()r.GET("/xxx", getHandler)r.POST("/xxx", addHandler)r.PUT("/xxx", modifyHandler)r.Run()
}

编译运行：go run main.go

为了方便测试，这里使用Postman软件进行测试验证。
请添加图片描述

2. Restful风格的API

  • gin支持Restful风格的API
  • 即Representational State Transfer的缩写。直接翻译的意思是"表现层状态转化"，是一种互联网应用程序的API设计理念：URL定位资源，用HTTP描述操作
序号操作url
1获取文章/blog/getXxxGet blog/Xxx
2添加/blog/addXxxPOST blog/Xxx
3修改/blog/updateXxxPUT blog/Xxx
4删除/blog/delXxxDELETE blog/Xxx

2.1 API参数

在REST-API中传递参数的方式有多种：

  • 通过定义的API传递参数
  • 通过Query操作传递URL参数
  • 在Header中传递参数
  • 在Body中传递参数

后面两个比较常见。这里主要是前两个：API参数和URL参数

API参数说的是：在定义API时，通过占位符的方式给可能需要传递的参数预留位置。在Gin框架中可以通过Context的Param方法来获取这部分参数。

package mainimport ("fmt""net/http""strings""github.com/gin-gonic/gin"
)func main() {r := gin.Default()r.GET("/user/:name/*passwd", func(c *gin.Context) {name := c.Param("name")passwd := c.Param("passwd")//此时passwd="/xxxxx", 需要截断passwd(去除/)passwd = strings.Trim(passwd, "/")fmt.Printf("name=%s, passwd=%s\n", name, passwd)c.String(http.StatusOK, fmt.Sprintf("name=%s, passwd=%s\n", name, passwd))})r.Run(":8080")
}

编译运行：go run main.go

在浏览器中输入相应的API，结果如下：
请添加图片描述

已经从API中成功获取到了用户名和密码信息。

2.2 URL参数

URL参数一般是通过HTTP的Query方法来传递的。例如：https://cn.bing.com/search?q=aaa

其中：?q=aaa 便是Query的查询条件，也就是我们说的URL参数。不过URL参数不包括那个’?’

  • Gin框架中，URL参数可以通过DefaultQuery()或Query()方法获取
  • DefaultQuery()若参数不到则，返回默认值，Query()若不存在，返回空串
  • API ? name=zs
package mainimport ("fmt""net/http""github.com/gin-gonic/gin"
)func main() {r := gin.Default()r.GET("/user", func(c *gin.Context) {name, _ := c.GetQuery("name")passwd, _ := c.GetQuery("passwd")fmt.Printf("name=%s, passwd=%s\n", name, passwd)c.String(http.StatusOK, fmt.Sprintf("name=%s, passwd=%s\n", name, passwd))})r.Run(":8080")
}

编译运行：go run main.go

在浏览器查看结果如下：
请添加图片描述

2.5 表单数据

http常见的传输格式有四种：

  • application/json
  • application/x-www-form-urlencoded
  • application/xml
  • mutipart/form-data

客户端向服务端提交数据时，通常采用表单的方式进行传输。例如提交用户名、密码、评论信息大多数都是采用表单的方式提交。这里简答介绍下gin中对表单数据的处理。

​ 在Gin框架中，使用PostForm()方法获取表单参数，该方法默认解析的是：x-www-form-urlencoded或者form-data数据。DefaultPostForm()如果没有获取到指定的参数，则会填充默认字段。

demo如下：

package mainimport ("fmt""net/http""github.com/gin-gonic/gin"
)func handler(c *gin.Context) {user := c.PostForm("user")passwd := c.PostForm("passwd")types := c.DefaultPostForm("phone", "13031000000")c.String(http.StatusOK, fmt.Sprintf("用户名:%s, 密码:%s,联系方式:%s", user, passwd, types))
}func main() {r := gin.Default()r.POST("/golang/web/gin/form-data", handler)r.Run()
}

上次用的Postman进行测试，但是我用的比较少，不太习惯；如果自己再写一个提交表单的web页面，也着实有点难为人。最近一直在使用Eolinker进行项目管理，因此使用eolinker对该接口进行测试，个人感觉eolinker特别好用，强烈推荐一波。

请添加图片描述

2.6上传单个文件

http使用mutipart/form-data格式进行文件传输。

Gin文件上传与原生的net/http方法类似，不同点在于gin把原生的request封装到c.Rquest中·

package mainimport ("net/http""github.com/gin-gonic/gin"
)func upload(c *gin.Context) {file, err := c.FormFile("file")if err != nil {c.String(http.StatusNotImplemented, "上传文件失败")return}c.SaveUploadedFile(file, file.Filename)c.String(http.StatusOK, "接收文件成功：", file.Filename)
}func main() {r := gin.Default()r.MaxMultipartMemory = 8 << 20 //8Mr.POST("/golang/web/gin/upload", upload)r.Run()
}

测试效果：

请添加图片描述

2.7上传多个文件

接收多个文件，在代码处理上有些微不同，不过在Eolinker上的测试不用修改，直接导入多个文件即可。

package mainimport ("fmt""net/http""github.com/gin-gonic/gin"
)func uploadFiles(c *gin.Context) {form, err := c.MultipartForm()if err != nil {c.String(http.StatusNotImplemented, "上传文件失败")return}fmt.Printf("%+v\n", form)files := form.File["file"]//需要与eolinker上的参数名保持一致for _, file := range files {if err = c.SaveUploadedFile(file, file.Filename); err != nil {c.String(http.StatusNotImplemented, "上传文件失败")return}c.String(http.StatusOK, "接收文件成功：", file.Filename)}}func main() {r := gin.Default()r.MaxMultipartMemory = 8 << 20 //8Mr.POST("/golang/web/gin/upload", uploadFiles)r.Run()
}

测试效果如下：
请添加图片描述

2.8 Route Group

route group主要是为了管理一些具有相同前缀的URL.

将上面提到的几种常见用法注册到一个group中，然后进行测试。

package mainimport ("fmt""net/http""strings""github.com/gin-gonic/gin"
)func helloGin(c *gin.Context) {fmt.Println("hello Gin")c.String(http.StatusOK, "欢迎来到三体世界")
}//使用Query进行参数传递
func urlParam(c *gin.Context) {name, _ := c.GetQuery("name")passwd, _ := c.GetQuery("passwd")fmt.Printf("name=%s, passwd=%s\n", name, passwd)c.String(http.StatusOK, fmt.Sprintf("name=%s, passwd=%s\n", name, passwd))
}//使用rest方式进行参数传递
func apiParam(c *gin.Context) {name := c.Param("name")passwd := c.Param("passwd")//此时passwd="/xxxxx", 需要截断passwd(去除/)passwd = strings.Trim(passwd, "/")fmt.Printf("name=%s, passwd=%s\n", name, passwd)c.String(http.StatusOK, fmt.Sprintf("name=%s, passwd=%s\n", name, passwd))}//提交表单
func postForm(c *gin.Context) {user := c.PostForm("user")passwd := c.PostForm("passwd")types := c.DefaultPostForm("phone", "13031000000")c.String(http.StatusOK, fmt.Sprintf("用户名:%s, 密码:%s,联系方式:%s", user, passwd, types))
}func uploadFile(c *gin.Context) {file, err := c.FormFile("file")if err != nil {c.String(http.StatusNotImplemented, "上传文件失败")return}c.SaveUploadedFile(file, file.Filename)c.String(http.StatusOK, "接收文件成功：", file.Filename)
}func uploadFiles(c *gin.Context) {form, err := c.MultipartForm()if err != nil {c.String(http.StatusNotImplemented, "上传文件失败")return}fmt.Printf("%+v\n", form)files := form.File["file"]for _, file := range files {if err = c.SaveUploadedFile(file, file.Filename); err != nil {c.String(http.StatusNotImplemented, "上传文件失败")return}c.String(http.StatusOK, "接收文件成功：", file.Filename)}}
func GinMain(r *gin.RouterGroup) {ginGroup := r.Group("/gin") //gin框架前缀{ginGroup.GET("/", helloGin)ginGroup.GET("/url-param", urlParam)ginGroup.GET("/api-param/:name/:passwd", apiParam)ginGroup.POST("/form-data", postForm)ginGroup.POST("/upload/file", uploadFile)ginGroup.POST("/upload/files", uploadFiles)}
}func main() {r := gin.Default()web := r.Group("/golang/web") //公共前缀GinMain(web)//最后注册的api是将其拼接起来r.Run(":8080")
}

测试效果如下
请添加图片描述

这篇关于Gin框架入门之Rest操作、Query操作、提交表单、上传单个文件、上传多个文件用法的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/270127。

相关文章

MySQL游标和触发器的操作流程

MySQL游标和触发器的操作流程

《MySQL游标和触发器的操作流程》本文介绍了MySQL中的游标和触发器的使用方法,游标可以对查询结果集进行逐行处理,而触发器则可以在数据表发生更改时自动执行预定义的操作,感兴趣的朋友跟随小编一起看看... 目录游标游标的操作流程1. 定义游标2.打开游标3.利用游标检索数据4.关闭游标例题触发器触发器的基
阅读更多...
在C#中分离饼图的某个区域的操作指南

在C#中分离饼图的某个区域的操作指南

《在C#中分离饼图的某个区域的操作指南》在处理Excel饼图时,我们可能需要将饼图的各个部分分离出来,以使它们更加醒目,Spire.XLS提供了Series.DataFormat.Percent属性,... 目录引言如何设置饼图各分片之间分离宽度的代码示例：从整个饼图中分离单个分片的代码示例：引言在处理
阅读更多...
Python列表的创建与删除的操作指南

Python列表的创建与删除的操作指南

《Python列表的创建与删除的操作指南》列表（list）是Python中最常用、最灵活的内置数据结构之一,它支持动态扩容、混合类型、嵌套结构,几乎无处不在,但你真的会创建和删除列表吗,本文给大家介绍... 目录一、前言二、列表的创建方式1. 字面量语法（最常用）2. 使用list()构造器3. 列表推导式
阅读更多...
input的accept属性让文件上传安全高效

input的accept属性让文件上传安全高效

《input的accept属性让文件上传安全高效》文章介绍了HTML的input文件上传`accept`属性在文件上传校验中的重要性和优势,通过使用`accept`属性,可以减少前端JavaScrip... 目录前言那个悄悄毁掉你上传体验的“常见写法”改变一切的 html 小特性：accept真正的魔法：让
阅读更多...
MySQL中between and的基本用法、范围查询示例详解

MySQL中between and的基本用法、范围查询示例详解

《MySQL中betweenand的基本用法、范围查询示例详解》BETWEENAND操作符在MySQL中用于选择在两个值之间的数据,包括边界值,它支持数值和日期类型,示例展示了如何使用BETWEEN... 目录一、between and语法二、使用示例2.1、betwphpeen and数值查询2.2、be
阅读更多...
Go异常处理、泛型和文件操作实例代码

Go异常处理、泛型和文件操作实例代码

《Go异常处理、泛型和文件操作实例代码》Go语言的异常处理机制与传统的面向对象语言（如Java、C#）所使用的try-catch结构有所不同,它采用了自己独特的设计理念和方法,：本文主要介绍Go异... 目录一：异常处理常见的异常处理向上抛中断程序恢复程序二：泛型泛型函数泛型结构体泛型切片泛型 map三：文
阅读更多...
C#实现将Excel工作表拆分为多个窗格

C#实现将Excel工作表拆分为多个窗格

《C#实现将Excel工作表拆分为多个窗格》在日常工作中,我们经常需要处理包含大量数据的Excel文件,本文将深入探讨如何在C#中利用强大的Spire.XLSfor.NET自动化实现Excel工作表的... 目录为什么需要拆分 Excel 窗格借助 Spire.XLS for .NET 实现冻结窗格（Fro
阅读更多...
MySQL基本表查询操作汇总之单表查询+多表操作大全

MySQL基本表查询操作汇总之单表查询+多表操作大全

《MySQL基本表查询操作汇总之单表查询+多表操作大全》本文全面介绍了MySQL单表查询与多表操作的关键技术,包括基本语法、高级查询、表别名使用、多表连接及子查询等,并提供了丰富的实例,感兴趣的朋友跟... 目录一、单表查询整合（一）通用模版展示（二）举例说明（三）注意事项（四）Mapper简单举例简单查询
阅读更多...
Nginx概念、架构、配置与虚拟主机实战操作指南

Nginx概念、架构、配置与虚拟主机实战操作指南

《Nginx概念、架构、配置与虚拟主机实战操作指南》Nginx是一个高性能的HTTP服务器、反向代理服务器、负载均衡器和IMAP/POP3/SMTP代理服务器,它支持高并发连接,资源占用低,功能全面且... 目录Nginx 深度解析：概念、架构、配置与虚拟主机实战一、Nginx 的概念二、Nginx 的特点
阅读更多...
SpringCloud Stream 快速入门实例教程

SpringCloud Stream 快速入门实例教程

《SpringCloudStream快速入门实例教程》本文介绍了SpringCloudStream（SCS）组件在分布式系统中的作用,以及如何集成到SpringBoot项目中,通过SCS,可... 目录1.SCS 组件的出现的背景和作用2.SCS 集成srping Boot项目3.Yml 配置4.Sprin
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2