go语言的成神之路-筑基篇-gin常用功能

第一节-gin参数绑定

目录

第一节-?gin参数绑定

ShouldBind简要概述

功能:

使用场景:

可能的错误:

实例代码

效果展示

第二节-gin文件上传

选择要上传的文件

选择要上传的文件。

效果展示?

代码部分

第三节-gin请求重定向

第四节-gin路由和路由组

Any用法

NoRoute

路由组


ShouldBindgin框架中的一个方法,用于将请求中的数据绑定到指定的结构体上。

ShouldBind简要概述

功能
  • 它会根据请求的Content-Type自动解析请求中的数据,并将其绑定到传入的结构体指针所指向的结构体中。
  • 对于GET请求,它会尝试从查询参数中解析数据;对于POST请求,它会根据Content-Type进行不同的解析,例如application/x-www-form-urlencodedapplication/json等。
使用场景
  • 当你需要从客户端请求中提取数据并存储到结构体中时,使用ShouldBind可以方便地将请求中的数据映射到结构体的字段上。
  • 它会自动处理数据类型的转换,将请求中的字符串数据转换为结构体字段对应的类型。
可能的错误
  • 如果请求中的数据无法正确解析或转换为结构体字段的类型,ShouldBind会返回错误。
  • 例如,如果请求中某个字段的值无法转换为结构体中相应字段的类型(如将字符串 "abc" 转换为int类型),会导致绑定失败并返回错误。

实例代码

复制代码
package main

import (
	"fmt"
	"net/http"

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

// 定义结构体
type UserInfo struct {
	UserName string `form:"username"`
	Password string `form:"password"`
}

func main() {
	r := gin.Default()
	r.GET("/user", func(c *gin.Context) {
		var u UserInfo
		err := c.ShouldBind(&u)
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{
				"error": err.Error(),
			})
		} else {
			fmt.Printf("u:%#v
", u)
			c.JSON(http.StatusOK, gin.H{
				"username": u.UserName,
				"password": u.Password,
			})
		}
	})

	
	r.Run(":1205")
}

效果展示

第二节-gin文件上传

选择要上传的文件

复制代码
// 处理 POST 请求到 /upload 路径
	r.POST("/upload", func(c *gin.Context) {
		// 从请求中获取名为 f1 的文件
		f, err := c.FormFile("f1")
		if err != nil {
			// 记录错误信息
			log.Printf("Error retrieving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Failed to retrieve file",
			})
			return
		}
		// 验证文件大小,假设限制文件大小为 5MB
		if f.Size > 1024*1024*5 {
			// 记录文件大小超出限制的错误信息
			log.Printf("File size too large: %v", f.Size)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "File size exceeds limit",
			})
			return
		}
		// 验证文件类型,假设只允许 JPEG 和 PNG
		if f.Header.Get("Content-Type") != "image/jpeg" && f.Header.Get("Content-Type") != "image/png" {
			// 记录文件类型错误信息
			log.Printf("Invalid file type: %v", f.Header.Get("Content-Type"))
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Invalid file type",
			})
			return
		}
		// 构建保存文件的目标路径
		dst := path.Join("./", f.Filename)
		// 保存上传的文件
		if err := c.SaveUploadedFile(f, dst); err != nil {
			// 记录保存文件时的错误信息
			log.Printf("Error saving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusInternalServerError, gin.H{
				"error": "Failed to save file",
			})
			return
		}
		// 返回成功响应
		c.JSON(http.StatusOK, gin.H{
			"status": "ok",
		})
	})

对上传的文件进行相对应的操作。

选择要上传的文件。

效果展示

代码部分

因为前端部分较为简单,在这里就不再进行展示了。

复制代码
package main

import (
	"log"
	"net/http"
	"path"

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

func main() {
	// 创建一个默认的 gin 路由
	r := gin.Default()
	// 加载 index.html 文件
	r.LoadHTMLFiles("./index.html")
	// 处理 GET 请求到 /index 路径
	r.GET("/index", func(c *gin.Context) {
		// 渲染 index.html 文件
		c.HTML(http.StatusOK, "index.html", nil)
	})

	// 处理 POST 请求到 /upload 路径
	r.POST("/upload", func(c *gin.Context) {
		// 从请求中获取名为 f1 的文件
		f, err := c.FormFile("f1")
		if err != nil {
			// 记录错误信息
			log.Printf("Error retrieving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Failed to retrieve file",
			})
			return
		}
		// 验证文件大小,假设限制文件大小为 5MB
		if f.Size > 1024*1024*5 {
			// 记录文件大小超出限制的错误信息
			log.Printf("File size too large: %v", f.Size)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "File size exceeds limit",
			})
			return
		}
		// 验证文件类型,假设只允许 JPEG 和 PNG
		if f.Header.Get("Content-Type") != "image/jpeg" && f.Header.Get("Content-Type") != "image/png" {
			// 记录文件类型错误信息
			log.Printf("Invalid file type: %v", f.Header.Get("Content-Type"))
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Invalid file type",
			})
			return
		}
		// 构建保存文件的目标路径
		dst := path.Join("./", f.Filename)
		// 保存上传的文件
		if err := c.SaveUploadedFile(f, dst); err != nil {
			// 记录保存文件时的错误信息
			log.Printf("Error saving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusInternalServerError, gin.H{
				"error": "Failed to save file",
			})
			return
		}
		// 返回成功响应
		c.JSON(http.StatusOK, gin.H{
			"status": "ok",
		})
	})
	// 启动服务器,监听 1205 端口
	r.Run(":1205")
}

第三节-gin请求重定向

注意此处请求的是ddd

回车之后

ddd变成了a

仔细观察后端部分的代码,不难看出,访问ddd的时候,跳转到了a,访问a的时候跳转到了b,所以会打印出b中存放的信息。也就是上述效果中展示的样子。

第四节-gin路由和路由组

Any用法

Any可以匹配任何形式的请求,这里因为没有postman所以没有对其他形式的请求进行测试,大家可以自行使用postman进行测试。

NoRoute

当没有对应的请求的时候,会进入到这一函数,如果没有进行定义就会出现404错误的页面。这里也只是对404页面进行了一下自定义操作。

路由组

路由组

路由组可以嵌套路由组

路由组可以添加中间件

路由组可以添加路由

路由组可以添加静态文件

路由组可以添加模板

路由组可以添加重定向

路由组可以添加错误处理

路由组可以添加自定义渲染器

仔细观察这三个图片的url不难看出都是voide开头的,因此我们可以将它们分成一个组来进行汇总一下。将他们的公共前缀提取出来,使得代码看起来不那么繁琐。

这样看起来更加条理清晰,用一个{}进行包括。

相关推荐
名字还没想好☜15 分钟前
Java 21 switch 模式匹配实战:sealed 接口 + record 替代 if-instanceof 链
java·人工智能·后端·python·spring
devilnumber23 分钟前
Java 30 组高频技术 / 知识点多角度对比
java·开发语言
摇滚侠29 分钟前
《SpringBoot 3:入门与应用实战》第 6 章 Spring Boot 最佳实践 阅读笔记 10
java·spring boot·笔记
gugucoding1 小时前
57. 【Java】日志框架:SLF4J与Logback
java·开发语言·logback
今天的砖头有点烫手啊1 小时前
JVM 调优实战:从 GC 日志到参数优化,一次完整排查
java·jvm
爱奥尼欧1 小时前
10.C++ string 实现详解
java·开发语言·c++
小飞学编程...1 小时前
【equals 、Comparable、Comparator 三者的区别】
java·python
骇客野人1 小时前
Java分布式任务调度方案(完整落地指南)
java·开发语言·分布式
ylj_dev1 小时前
从 0 构建 AI Workload Platform(五):Agent Runtime、工具权限与自然语言工作流
golang·工作流·ai agent·大模型应用开发·agent runtime
JacksonMx1 小时前
Spring @Async 坑点 + 改造方案
java·开发语言