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。

相关文章

Python调用Orator ORM进行数据库操作

Python调用Orator ORM进行数据库操作

《Python调用OratorORM进行数据库操作》OratorORM是一个功能丰富且灵活的PythonORM库,旨在简化数据库操作,它支持多种数据库并提供了简洁且直观的API,下面我们就... 目录Orator ORM 主要特点安装使用示例总结Orator ORM 是一个功能丰富且灵活的 python O
阅读更多...
Java实现检查多个时间段是否有重合

Java实现检查多个时间段是否有重合

《Java实现检查多个时间段是否有重合》这篇文章主要为大家详细介绍了如何使用Java实现检查多个时间段是否有重合,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录流程概述步骤详解China编程步骤1：定义时间段类步骤2：添加时间段步骤3：检查时间段是否有重合步骤4：输出结果示例代码结语作
阅读更多...
Java判断多个时间段是否重合的方法小结

Java判断多个时间段是否重合的方法小结

《Java判断多个时间段是否重合的方法小结》这篇文章主要为大家详细介绍了Java中判断多个时间段是否重合的方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录判断多个时间段是否有间隔判断时间段集合是否与某时间段重合判断多个时间段是否有间隔实体类内容public class D
阅读更多...
JavaScript中的reduce方法执行过程、使用场景及进阶用法

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》：本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程
阅读更多...
python使用fastapi实现多语言国际化的操作指南

python使用fastapi实现多语言国际化的操作指南

《python使用fastapi实现多语言国际化的操作指南》本文介绍了使用Python和FastAPI实现多语言国际化的操作指南,包括多语言架构技术栈、翻译管理、前端本地化、语言切换机制以及常见陷阱和... 目录多语言国际化实现指南项目多语言架构技术栈目录结构翻译工作流1. 翻译数据存储2. 翻译生成脚本
阅读更多...
linux下多个硬盘划分到同一挂载点问题

linux下多个硬盘划分到同一挂载点问题

《linux下多个硬盘划分到同一挂载点问题》在Linux系统中,将多个硬盘划分到同一挂载点需要通过逻辑卷管理（LVM）来实现,首先,需要将物理存储设备（如硬盘分区）创建为物理卷,然后,将这些物理卷组成... 目录linux下多个硬盘划分到同一挂载点需要明确的几个概念硬盘插上默认的是非lvm总结Linux下多
阅读更多...
0基础租个硬件玩deepseek,蓝耘元生代智算云|本地部署DeepSeek R1模型的操作流程

0基础租个硬件玩deepseek,蓝耘元生代智算云|本地部署DeepSeek R1模型的操作流程

《0基础租个硬件玩deepseek,蓝耘元生代智算云|本地部署DeepSeekR1模型的操作流程》DeepSeekR1模型凭借其强大的自然语言处理能力,在未来具有广阔的应用前景,有望在多个领域发... 目录0基础租个硬件玩deepseek,蓝耘元生代智算云|本地部署DeepSeek R1模型，3步搞定一个应
阅读更多...
Python itertools中accumulate函数用法及使用运用详细讲解

Python itertools中accumulate函数用法及使用运用详细讲解

《Pythonitertools中accumulate函数用法及使用运用详细讲解》：本文主要介绍Python的itertools库中的accumulate函数,该函数可以计算累积和或通过指定函数... 目录1.1前言：1.2定义：1.3衍生用法：1.3Leetcode的实际运用:总结 1.1前言：本文将详
阅读更多...
MyBatis-Flex BaseMapper的接口基本用法小结

MyBatis-Flex BaseMapper的接口基本用法小结

《MyBatis-FlexBaseMapper的接口基本用法小结》本文主要介绍了MyBatis-FlexBaseMapper的接口基本用法小结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具... 目录MyBATis-Flex简单介绍特性基础方法INSERT① insert② insertSelec
阅读更多...
轻松上手MYSQL之JSON函数实现高效数据查询与操作

轻松上手MYSQL之JSON函数实现高效数据查询与操作

《轻松上手MYSQL之JSON函数实现高效数据查询与操作》：本文主要介绍轻松上手MYSQL之JSON函数实现高效数据查询与操作的相关资料,MySQL提供了多个JSON函数,用于处理和查询JSON数... 目录一、jsON_EXTRACT 提取指定数据二、JSON_UNQUOTE 取消双引号三、JSON_KE
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2