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 中的 CAST 函数详解及常见用法

MySQL 中的 CAST 函数详解及常见用法

《MySQL中的CAST函数详解及常见用法》CAST函数是MySQL中用于数据类型转换的重要函数,它允许你将一个值从一种数据类型转换为另一种数据类型,本文给大家介绍MySQL中的CAST... 目录mysql 中的 CAST 函数详解一、基本语法二、支持的数据类型三、常见用法示例1. 字符串转数字2. 数字
阅读更多...
Python中你不知道的gzip高级用法分享

Python中你不知道的gzip高级用法分享

《Python中你不知道的gzip高级用法分享》在当今大数据时代,数据存储和传输成本已成为每个开发者必须考虑的问题,Python内置的gzip模块提供了一种简单高效的解决方案,下面小编就来和大家详细讲... 目录前言：为什么数据压缩如此重要1. gzip 模块基础介绍2. 基本压缩与解压缩操作2.1 压缩文
阅读更多...
从入门到精通MySQL联合查询

从入门到精通MySQL联合查询

《从入门到精通MySQL联合查询》：本文主要介绍从入门到精通MySQL联合查询,本文通过实例代码给大家介绍的非常详细,需要的朋友可以参考下... 目录摘要1. 多表联合查询时mysql内部原理2. 内连接3. 外连接4. 自连接5. 子查询6. 合并查询7. 插入查询结果摘要前面我们学习了数据库设计时要满
阅读更多...
Python实现对阿里云OSS对象存储的操作详解

Python实现对阿里云OSS对象存储的操作详解

《Python实现对阿里云OSS对象存储的操作详解》这篇文章主要为大家详细介绍了Python实现对阿里云OSS对象存储的操作相关知识,包括连接,上传,下载,列举等功能,感兴趣的小伙伴可以了解下... 目录一、直接使用代码二、详细使用1. 环境准备2. 初始化配置3. bucket配置创建4. 文件上传到os
阅读更多...
解读GC日志中的各项指标用法

解读GC日志中的各项指标用法

《解读GC日志中的各项指标用法》：本文主要介绍GC日志中的各项指标用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、基础 GC 日志格式（以 G1 为例）1. Minor GC 日志2. Full GC 日志二、关键指标解析1. GC 类型与触发原因2. 堆
阅读更多...
mysql表操作与查询功能详解

mysql表操作与查询功能详解

《mysql表操作与查询功能详解》本文系统讲解MySQL表操作与查询,涵盖创建、修改、复制表语法,基本查询结构及WHERE、GROUPBY等子句,本文结合实例代码给大家介绍的非常详细,感兴趣的朋友跟随... 目录01.表的操作1.1表操作概览1.2创建表1.3修改表1.4复制表02.基本查询操作2.1 SE
阅读更多...
MySQL数据库中ENUM的用法是什么详解

MySQL数据库中ENUM的用法是什么详解

《MySQL数据库中ENUM的用法是什么详解》ENUM是一个字符串对象,用于指定一组预定义的值,并可在创建表时使用,下面：本文主要介绍MySQL数据库中ENUM的用法是什么的相关资料,文中通过代码... 目录mysql 中 ENUM 的用法一、ENUM 的定义与语法二、ENUM 的特点三、ENUM 的用法1
阅读更多...
JavaSE正则表达式用法总结大全

JavaSE正则表达式用法总结大全

《JavaSE正则表达式用法总结大全》正则表达式就是由一些特定的字符组成,代表的是一个规则,：本文主要介绍JavaSE正则表达式用法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下... 目录常用的正则表达式匹配符正则表China编程达式常用的类Pattern类Matcher类PatternSynta
阅读更多...
从入门到精通C++11 ＜chrono＞ 库特性

从入门到精通C++11 ＜chrono＞ 库特性

《从入门到精通C++11＜chrono＞库特性》chrono库是C++11中一个非常强大和实用的库,它为时间处理提供了丰富的功能和类型安全的接口,通过本文的介绍,我们了解了chrono库的基本概念... 目录一、引言1.1 为什么需要<chrono>库1.2<chrono>库的基本概念二、时间段（Durat
阅读更多...
MySQL之InnoDB存储引擎中的索引用法及说明

MySQL之InnoDB存储引擎中的索引用法及说明

《MySQL之InnoDB存储引擎中的索引用法及说明》：本文主要介绍MySQL之InnoDB存储引擎中的索引用法及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录1、背景2、准备3、正篇【1】存储用户记录的数据页【2】存储目录项记录的数据页【3】聚簇索引【4】二
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2