Go Web下gin框架使用（一）

最新推荐文章于 2024-07-04 20:50:51 发布
最新推荐文章于 2024-07-04 20:50:51 发布
阅读量640 收藏
点赞数
分类专栏： Golang 前端 文章标签： golang 前端 gin 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_73651896/article/details/130976145
版权

〇、前言

在前面，已经在这篇文章中详细地讨论了 gin 框架下的模板渲染问题，这篇文章主要对 gin 框架的使用进行讨论。

一、不同的路由

以下可以选择不同的路由进行渲染：

r := gin.Default()
	type usr struct {
		Name string `json:"name"`
		Msg  string
		Age  int
	}
	r.GET("/json", func(c *gin.Context) {
		data := gin.H{
			"name":    "小王子!",
			"massage": "hello",
			"age":     18,
		}
		c.JSON(http.StatusOK, data)
	})
	r.GET("/another_json", func(c *gin.Context) {
		data := usr{
			"小王子!",
			"hello,golang!",
			18,
		}
		c.JSON(http.StatusOK, data)
	})

当我们在浏览器中输入不同的 url （本例中仅仅是路径不同）时，服务器就会返回不同的数据，这是很好理解的。

（一）URL

URL是Uniform Resource Locator的缩写，它是用于标识互联网上资源位置的字符串。URL由几个组件组成，包括协议（如HTTP或HTTPS）、主机名、端口号（可选）、路径和查询参数（可选）。URL的主要目的是在网络上定位资源，如网页、图像、视频等。

下面是一个URL的示例：
https://www.example.com:8080/path/to/resource?param1=value1&param2=value2

在这个示例中：

  • 协议是HTTP（或HTTPS，如果使用加密连接；
  • 主机名是www.example.com；
  • 端口号是8080（在这个示例中是可选的，默认使用协议的默认端口）；
  • 路径是/path/to/resource；
  • 查询参数是param1=value1和param2=value2（用于向服务器传递额外的信息）；
  • URL在浏览器中用于访问网页，也在许多其他应用程序中用于定位网络资源。

二、查询参数的获取

当我们在浏览器中输入不同的参数事，服务器必须对这些参数进行获取和处理，这样才能正确处理用户的需求，返回用户想要的数据。比如我们在浏览器中输入：https://www.google.com/search?q=你好这个 q=你好就是参数字段。服务器获取到参数 q 后，就对你好进行查询，然后返回给用户，这样就完成了搜索。

一下是一个gin框架下的参数获取示例：


func main() {
	r := gin.Default()
	r.GET("/web", func(c *gin.Context) {
		// 获取浏览器发送的 query 字段
		// name := c.Query("query")
		// http://127.0.0.1:9001/web?query=杨超越&age=18
		name := c.DefaultQuery("query", "someone")
		age := c.DefaultQuery("age", "age")
		c.JSON(http.StatusOK, gin.H{
			"name": name,
			"age":  age,
		})
	})
	r.Run(":9001")
}

main 函数的作用就是获取用户输入的 url 中的 query参数以及 age 参数，并处理。处理的过程具体为展示给用户他们输入的 name、age。运行结果为（杨超越 2023 年 5 月 31 日时的年龄为 24 岁，下面的年龄仅供参考）：

在这里插入图片描述

三、获取表单数据

我们有时候会有让用户登录的需求，后台需要对用户输入的用户名以及登录密码进行判断和处理。实际上，一般返回这种数据就是表单数据的返回。在 gin 框架里有很方便的函数。以下是一个示例。

（一）表单数据的生成和处理

以下是一个网页 login.html，里面要求用户分别填写用户名以及密码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>login</title>
</head>
<body>
<form action="/login" method="post" novalidate autocomplete="off">
    <div>
        <label for="username">username:</label>
        <input type="text" name="username" id="username">
    </div>
    <div>
        <label for="password">password:</label>
        <input type="password" name="password" id="password">
    </div>
    <div>
        <input type="submit" value="登陆">
    </div>

</form>
</body>

</html>

这个html 文件有三个 type类型的数据，分别是type=“text”、type=“password”、type=“submit”，他是用 post 方法进行提交的。main函数是这样渲染的：

package main

import (
	"github.com/gin-gonic/gin"
	"net/http"
)

func main() {
	r := gin.Default()
	r.LoadHTMLFiles("/Users/luliang/GoLand/gin_practice/chap8/login.html", "/Users/luliang/GoLand/gin_practice/chap8/index.html")
	r.GET("/login", func(c *gin.Context) {
		c.HTML(http.StatusOK, "login.html", nil)
	})
	r.POST("/login", func(c *gin.Context) {
		// 获取 form 表单的数据
		//username := c.PostForm("username")
		//password := c.PostForm("password")
		// 第二种方式
		username := c.DefaultPostForm("username", "用户名")
		password := c.DefaultPostForm("password", "密码")
		c.HTML(http.StatusOK, "index.html", gin.H{
			"Name":     username,
			"Password": password,
		})
	})
	r.Run(":9001")

}

首先，通过GET方法渲染上述 login.html文件，然后 login文件中文submit 将会把表单返回到 context类型的 c：

	r.GET("/login", func(c *gin.Context) {
		c.HTML(http.StatusOK, "login.html", nil)
	})

之后，login 里面会用 POST 方法请求，在这个请求里，对该请求的处理方法是对另一个 html 文件进行渲染：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>index</title>
</head>
<body>
<h1>hello,{{ .Name }}</h1>
<h1>你的密码是{{ .Password}}</h1>

</body>
</html>

这时，只需要把提价的数据从 c 中拿出来就好了：

// 获取 form 表单的数据
		//username := c.PostForm("username")
		//password := c.PostForm("password")
		// 第二种方式
		username := c.DefaultPostForm("username", "用户名")
		password := c.DefaultPostForm("password", "密码")

拿出来之后，就可以对我们的 html 文件进行渲染了：

	c.HTML(http.StatusOK, "index.html", gin.H{
			"Name":     username,
			"Password": password,
		})

运行结果为：

在这里插入图片描述
我们输入数据之后，点击登陆，进行POST 请求，渲染的新的结果为：

在这里插入图片描述

为了更清晰地展示这一过程，这里会用 Postman这个软件进行模拟。

（二）Postman进行分析

在这里插入图片描述

我们在对这个 url=http://127.0.0.1:9001/login进行 GET 请求时，可以看到服务器进行的是：

	r.GET("/login", func(c *gin.Context) {
		c.HTML(http.StatusOK, "login.html", nil)
	})

如果我们把 GET 请求换成 POST 请求，这时候就应该进行的是index.html渲染：

r.POST("/login", func(c *gin.Context) {
		// 获取 form 表单的数据
		//username := c.PostForm("username")
		//password := c.PostForm("password")
		// 第二种方式
		username := c.DefaultPostForm("username", "用户名")
		password := c.DefaultPostForm("password", "密码")
		c.HTML(http.StatusOK, "index.html", gin.H{
			"Name":     username,
			"Password": password,
		})
	})

在这里插入图片描述
打开检查器，也可以看到它进行的是 POST 请求，携带的参数为：在这里插入图片描述
渲染的是 index.html。
在这里插入图片描述

四、路径参数

路径参数和上面的参数不一样：

func main() {
	r := gin.Default()
	r.GET("/user/:name/:age", func(c *gin.Context) {
		name := c.Param("name")
		age := c.Param("age")
		c.JSON(http.StatusOK, gin.H{
			"name": name,
			"age":  age,
		})
	})
	r.GET("/blog/:year/:month", func(c *gin.Context) {
		year := c.Param("year")
		month := c.Param("month")
		c.JSON(http.StatusOK, gin.H{
			"year":  year,
			"month": month,
		})
	})
	r.Run(":9001")

}

运行一下：

在这里插入图片描述
可以看到，服务端会将 URL 的路径参数提取出来并进行处理：

r.GET("/user/:name/:age", func(c *gin.Context) {
		name := c.Param("name")
		age := c.Param("age")
		c.JSON(http.StatusOK, gin.H{
			"name": name,
			"age":  age,
		})
	})

五、参数绑定

为了能够更方便的获取请求相关参数，提高开发效率，我们可以基于请求的Content-Type识别请求数据类型并利用反射机制自动提取请求中QueryString、form表单、JSON、XML等参数到结构体中。 下面的示例代码演示了.ShouldBind()强大的功能，它能够基于请求自动提取JSON、form表单和QueryString类型的数据，并把值绑定到指定的结构体对象：

func main() {
	type user struct {
		Username string `form:"username" json:"uname"`
		Password string `form:"password" json:"pwd"`
	}
	r := gin.Default()
	r.GET("/user", func(c *gin.Context) {
		var u user
		err := c.ShouldBind(&u) // 按值传递
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{
				"msg":   "请求的参数不正确!",
				"error": err.Error(),
			})
		} else {
			c.JSON(http.StatusOK, gin.H{
				"message": "ok!",
				"user":    u,
			})
		}

	})
	r.POST("/user", func(c *gin.Context) {
		var u user
		err := c.ShouldBind(&u)
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{
				"msg":   "请求的参数不正确!",
				"error": err.Error(),
			})
		} else {
			c.JSON(http.StatusOK, gin.H{
				"message": "ok!",
				"user":    u,
			})
		}

	})

	r.Run(":9001")
}

看看这个请求的运行效果：
在这里插入图片描述
ShouldBind()就是这么强大！

六、文件上传

我们有时候需要对文件上传，上传文件在前端由用户进行操作，我们后端接收到用户文件上传的文件时，就对该文件进行一些可能的操作。
前端页面：

<!DOCTYPE html>
<html>
<head>
    <title>index</title>
</head>
<body>
<form action="/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="f1">
    <input type="submit" value="upload">
</form>
</body>
</html>

这里通过 post 方法，将文件submit 到了context 类型的 c对象中，我们继续处理：

r := gin.Default()
	r.LoadHTMLFiles("/Users/luliang/GoLand/gin_practice/chap11/index.html")
	r.GET("/index", func(c *gin.Context) {
		c.HTML(http.StatusOK, "index.html", nil)

	})
	r.POST("/upload", func(c *gin.Context) {
		// 读取文件
		f, err := c.FormFile("f1")
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{
				"error": err.Error(),
			})
		} else {
			// 将读取的文件保存到本地
			// dsf := fmt.Sprintf("./%s", f.Filename)
			dsf := path.Join("./", f.Filename)
			err = c.SaveUploadedFile(f, dsf)
			if err != nil {
				return
			} // 将文件 f 保存到 dsf 中
			c.JSON(http.StatusOK, gin.H{
				"status": "OK",
			})

		}

	})

过程为，先通过 GET请求，访问到index.html：
在这里插入图片描述随便选一个文件：
在这里插入图片描述
点击上传：
在这里插入图片描述
在这个过程中，我们对 context 的c进行获取文件，存储并发送了一个合适的响应：

r.POST("/upload", func(c *gin.Context) {
		// 读取文件
		f, err := c.FormFile("f1")
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{
				"error": err.Error(),
			})
		} else {
			// 将读取的文件保存到本地
			// dsf := fmt.Sprintf("./%s", f.Filename)
			dsf := path.Join("./", f.Filename)
			err = c.SaveUploadedFile(f, dsf)
			if err != nil {
				return
			} // 将文件 f 保存到 dsf 中
			c.JSON(http.StatusOK, gin.H{
				"status": "OK",
			})

		}
	})

七、路由重定向

这个过程很简单，就是当用户访问了某些请求之后，我们可以将该请求转接到另一个 URL 上去，类似于 DNS 劫持：

func main() {
	r := gin.Default()
	r.GET("/index", func(c *gin.Context) {
		//c.JSON(http.StatusOK,gin.H{
		//	"status":"Ok",
		//})
		c.Redirect(http.StatusMovedPermanently, "https://www.google.com")

	})
	r.GET("/a", func(c *gin.Context) {
		// 跳转到 b
		c.Request.URL.Path = "/b" // 修改请求 URL
		r.HandleContext(c)        // 继续处理 c

	})
	// 处理所有的方法
	r.GET("/b", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"status": "ok",
		})

	})

	r.Run(":9001")

}

在这里插入图片描述
可以看到它重复定向到了url=http://127.0.0.1:9001/a。

全文完，感谢阅读。

瑜陀
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
Go Web开发进阶实战（gin框架）
01-05
Go Web开发进阶实战（gin框架）课程，适用于Go语言初学者、掌握Go语言基础语法想学习进阶内容。 由在职程序员打造的Go语言实战课程体系，与你分享企业项目开发经验与技巧。真正做到课程有内容、有深度，并且老师讲...
Go Web框架gin的入门教程
09-20
### 安装gin框架 安装gin非常简单，只需通过`go get`命令即可： ```bash go get github.com/gin-gonic/gin ``` 安装完成后，你就可以在项目中导入并使用gin库了。 ### 简单示例 下面是最基本的gin应用示例，它创建...
gin+skywalking
weixin_36013896的博客
08-04 513
skywalking 部署教程 贼简单 1、下载安装包 linux版的 https://skywalking.apache.org/downloads/ 选中distribution 选择版本 选择 es6 或者7 的进行下载 我选择了 6版本 2、 上传到服务器/server/tools apache-skywalking-apm-8.6.0.tar.gz 3、解压 tar zxf apache-skywalking-apm-8.6.0.tar.gz ...
【web框架】go的web框架——gin（详细）
Jzin的博客
11-02 2659
一、gin的helloworld体验 1. 安装 2. 代码 3.使用New和Default初始化路由器的区别 4. 使用get、post、put等http方法 二、url和路由分组 1. 路由分组 2.带参数的url 3. 获取路由分组的参数 三、获取参数 1.获取get参数 2. 获取post参数 3. get、post混合 四、JSON、ProtoBuf 渲染（输出格式） 1.输出json和protobuf 2. PureJSON 五、表单验证 2. 错误翻译改进 等等
Go语言web框架 gin
fwhezfwhez的博客
01-25 1万+
Go语言web框架 GIN gin是go语言环境下的一个web框架, 它类似于Martini, 官方声称它比Martini有更好的性能, 比Martini快40倍, Ohhhh….看着不错的样子, 所以就想记录一下gin的学习. gin的github代码在这里: gin源码. gin的效率获得如此突飞猛进, 得益于另一个开源项目httprouter, 项目地址: httprouter源码. 下面
用gin进行web开发的基本框架搭建
qq_46004291的博客
04-20 2573
作者很菜，欢迎交流，不对的请指正！ 使用gin构建了一个平常开发易用脚手架，代码简洁易读，可快速进行高效web开发。 主要功能有： mysql/redis的配置 使用viper读取配置文件（yaml） 支持swagger文档生成 使用zap作为日志记录，支持日志分割归档 目录结构： 整合swagger 创建一个docs文件夹，然后获取swagger go get -u github.com/swaggo/swag/cmd/swag 然后运行下方代码，会获得swagger.json，swagger.
探索Gin框架：快速构建高性能的Golang Web应用
热门推荐
qq_35716689的博客
01-23 37万+
Gin框架是一个轻量级的Web框架，基于Go语言开发，旨在提供高性能和简洁的API。作者：鼠鼠我捏，要死了捏
基于Go语言Gin框架的Web项目骨架设计源码
05-23
GinSkeleton是一个基于Go语言Gin框架封装的Web项目骨架，包含145个文件，其中包括94个Go源文件、36个Markdown文件、3个文本文件、3个SQL文件、2个YAML文件、1个Git忽略文件、1个LICENSE文件、1个Go Mod文件、1个Sum...
GinStudy:使用golang语言基于gin框架进行web开发
03-07
【GinStudy: 使用Golang语言基于Gin框架进行Web开发】 Gin 是一个用 Golang 编写的轻量级、高性能的Web框架，它以其简洁的API设计、高效的性能和丰富的中间件库赢得了广大开发者喜爱。Gin 基于 Martini 框架，但...
Go语言中的gin框架之GET/POST请求参数接收传值（五）
06-15
在Go语言中，Gin框架是一个非常流行的HTTP微服务框架，它提供了简洁的API来处理HTTP请求，使得开发Web应用变得更加高效。本教程将详细讲解如何在Gin中接收GET和POST请求的参数。 首先，我们需要引入Gin库。在`go....
四、golang基础之defer
weixin_54447296的博客
06-29 338
defer语句被用于预定对一个函数的调用。可以把这类被defer语句调用的函数称为延迟函数。
编写Linux下第一个Go程序（2024版）
06-27 693
首先是安装GO语言包，预备要安装的是go version go1.22.4 linux/amd64，移步至,选择go1.22.4.linux-amd64.tar.gz 下载Do not。
Go-知识测试-工作机制
a18792721831的博客
06-29 1176
在 Go 语言的源码中，go test 命令的实现主要在 src/cmd/go/internal/test 包中。当你运行 go test 命令时，Go 的命令行工具会调用这个包中的代码来执行测试。在 src/cmd/go/internal/test 包中，runTest 函数是 go test 命令的主要入口点。这个函数负责解析命令行参数，构建测试的二进制文件，启动这个二进制文件，以及读取和解析测试结果。
golang template模板 template: xxx.html is an incomplete or empty template 解决方法
07-02 287
当我们在使用go语言中的template渲染多个模板文件时，如果我们使用的模板文件没有使用 ParseFiles方法进行解析就直接在模板里面使用 template进行嵌套的话就会出现 template: xxx.html is an incomplete or empty template 的异常。ParseFiles解析命名文件，并将生成的模板与t相关联。如果发生错误，解析将停止，返回的模板为nil；解决方法： 在我们使用的时候先将可能用到的模板文件全部扫描后用ParseFiles进行解析以下即可。
#### golang中【堆】的使用及底层 ####
最新发布
仅做个人笔记
07-04 289
堆（Heap）是实现优先队列的数据结构，Go提供了接口和方法来操作堆。
C++ 模板类与友元
qq_40135848的博客
06-30 205
C++ 模板类与友元
goLang小案例-获取从控制台输入的信息
preserveXing的博客
06-28 343
goLang小案例-获取从控制台输入的信息 在这里可以查阅goLang内置的api说明。 //创建一个io读取 读取控制台的数据 reader := bufio.NewReader(os.Stdin) //从读取io读取中 获取数据 直到'\n'换行结束 //把数据赋值给name 如果有错误 返回错误给err name, err := reader.ReadString('\n')
golang web服务搭建学习和优雅的停止服务
nbplus_007的博客
07-04 207
这里分享一下golang web服务搭建过程，仅分享安装搭建过程中的配置，相关工具的安装请自行下载安装：项目打包使用了（go-bindata）包实现将项目静态配置文件编译成二进制嵌入到go文件中，解决了打包时候因相对路径问题，导致的二进制文件不能再任何目录下运行优雅的启停服务。
五、golang基础之slice和map
weixin_54447296的博客
06-29 501
切片不需要说明长度。也可以简写为也可以指定容量，其中capacity为可选参数。这里 len 是数组的长度并且也是切片的初始长度。
使用国内镜像安装golang的web框架gin
06-12
好的，你可以按照以下步骤在国内使用镜像来安装golang的web框架gin： ...5. 最后，你可以使用gin框架来开发你的web应用程序了。 希望这些步骤能够帮助你顺利地在国内安装和使用golang的web框架gin。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值