Gin基本使用

最新推荐文章于 2025-03-13 11:56:46 发布
最新推荐文章于 2025-03-13 11:56:46 发布
阅读量1.6k 收藏 3
点赞数 3
分类专栏： Go 文章标签： go
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_51164450/article/details/117124434
版权
本文详细介绍了Gin框架的使用，包括安装、创建基本的HTTP服务、处理各种HTTP请求方法、静态文件服务、URL参数、泛绑定、获取请求参数（GET、POST、body内容、bind参数）、结构体验证及自定义验证规则，以及多语言验证错误提示。此外，还讲解了Gin的中间件机制，如内置的日志和恢复中间件，并展示了如何自定义中间件。通过实例代码，深入理解Gin在Web开发中的强大功能。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Gin框架使用
*基于httprouter开发的web框架
*提供Martini风格的API，但比Martini要快40倍
*非常轻量级，使用起来非常简洁
Gin框架安装与使用
*安装：go get -u github.com/gin-gonic/gin
*import"github.com/gin-gonic/gin"
第一个Gin程序

package main

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

func main(){
r := gin.Default()//创建一个默认的路由引擎
r.GET("/ping",func(c *gin.Context){//创建测试的路由
//GET:请求方式    /ping:请求的路径
//当客户端以GET方法请求/ping路径时，会执行后面的匿名函数
//c.JSON:返回JSON格式的数据
    c.JSON(200,gin.H{
   "message":"pong",
})
   })
   //启动HTTP服务，默认在0.0.0.0:8200启动服务
   r.Run(":8200")
}

1.首先，我们使用了gin.Default()生成了一个实例，这个实例即WSGI应用程序（Web服务器网关接口）。
2.接下来，我们使用了r.GET("/",…)声明了一个路由，告诉Gin什么样的URL(在www上，每一信息资源都有统一的且在网上唯一的地址，该地址就叫URL)能触发传入的函数，这个函数返回我们想要显示在用户浏览器中的信息。
3.最后用r.Run()函数来让应用运行在本地服务器上，默认监听端口是8200，可以传入参数设置端口，例如r.Run(":9999")即运行在9999端口。
4.然后使用浏览器打开127.0.0.1:8200/ping就能看到一串JSON字符串
请求路由-多种请求

package main

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

func main(){
	r := gin.Default()
	r.GET("/get",func(c *gin.Context){
		c.String(200,"get")
	})
	r.POST("/post",func(c *gin.Context){
		c.String(200,"post")
	})
	r.Handle("DELETE","/delete",
		func(c *gin.Context){
			c.String(200,"delete")
		})
	r.Any("/any",func(c *gin.Context){
		c.String(200,"any")
	})
	r.Run()
}

请求路由-静态文件夹

package main

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

func main(){
	r := gin.Default()
    r.Static("/assets","./assets")
	//先设置路由，再设置相对文件夹
	//另外一种写法
    r.StaticFS("/static",http.Dir("static"))
	//先设置路由，再设置资源
	//设置单个静态文件
	r.StaticFile("/favicon.ico",
		"./favicon.ico")
	//设置路由，设置资源
	r.Run()//启动服务器
}

请求路由-参数作为url

package main

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

func main(){
	r := gin.Default()
	r.GET("/:name/:id",func(c *gin.Context){
		c.JSON(200,gin.H{
			"name":c.Param("name"),
			"id":c.Param("id"),
		})
	})
	r.Run()
}

请求路由-泛绑定

package main

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

func main(){
	r := gin.Default()
	r.GET("/user/*action",
		func(c *gin.Context){
			c.String(200,"hello world")
		})
	r.Run()
}

获取请求参数-获取GET参数

package main

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

func main(){
	r := gin.Default()
	r.GET("/test",func(c *gin.Context){
		firstName := c.Query("first_name")
		lastName := c.DefaultQuery("last_name",
		"last_default_name")
		c.String(http.StatusOK,"%s,%s",
			firstName,lastName)
	})
	r.Run(":8080")
}

获取请求参数-获取body内容

package main

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

func main(){
	r := gin.Default()
	r.POST("/test",func(c *gin.Context){
		bodyByts,err := ioutil.ReadAll(c.Request.Body)
		if err != nil{
			c.String(http.StatusBadRequest,err.Error())
			c.Abort()
		}
		c.String(http.StatusOK,string(bodyByts))
	})
	r.Run()
}

获取请求参数-获取bind参数

package main

import (
	"github.com/gin-gonic/gin"
	"time"
)

type Person struct{
	Name string   `form:"name"`
	Address string    `form:"address"`
	Birthday time.Time   `form:"birthday"`
}
func main(){
	r := gin.Default()
    r.GET("/testing",testing)
	r.POST("/testing",testing)
	r.Run()
}

func testing(c *gin.Context){
    var person Person
    if err := c.ShouldBind(&person);err==nil{
    	c.String(200,"%v",person)
	}else{
		c.String(200,"person bind error:%v",err)
	}
}

验证请求参数-结构体验证

package main

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

type Person struct{
	Age int    `form:"age" binding:"required,gt=10"`
	Name string    `form:"name" binding:"required"`
	Address string  `form:"address" binding:"required"`
}
func main(){
     r := gin.Default()
     r.GET("/testing",func(c *gin.Context){
         var person Person
         if err := c.ShouldBind(&person);err != nil{
         	c.String(500,"%v",err)
		 }
		 c.String(200,"%v",person)
	 })
     r.Run()
}

验证请求参数-自定义验证规则

package main

import (
	"github.com/gin-gonic/gin"
	"github.com/go-playground/validator/v10"
	"net/http"
	"time"
)

type Booking struct{
	CheckIn time.Time `form:"check_in" validate:"required,bookableDate" time_format:"2006-01-02"`
	CheckOut time.Time `form:"check_out" validate:"required,gtfield=CheckIn" time_format:"2006-01-02`
}
func main(){
	r := gin.Default()
	validate := validator.New()
	validate.RegisterValidation("bookableDate",bookableDate)
	r.GET("/bookable",func(c *gin.Context){
		var book Booking
		if err := c.ShouldBind(&book);err != nil{
			c.JSON(http.StatusInterServerError,gin.H{
				"error":err.Error(),
			})
			c.Abort()
			return
		}
		if err := validate.Struct(book);err != nil{
			c.JSON(http.StatusInternalServerError,gin.H{
				"error":err.Error(),
			})
			c.Abort()
			return
		}
		c.JSON(http.StatusOK,gin.H{
			"message":"OK",
			"booking":book,
		})
	})
	r.Run()
}

func bookableDate(fl validator.FieldLevel)bool{
	if date,ok := fl.Field().Interface().(time.Time);ok{
		today := time.Now()
		if date.Unix() > today.Unix(){
			return true
		}
	}
	return false
}

验证请求参数-多语言翻译验证

package main

import (
	"github.com/gin-gonic/gin"
	en2 "github.com/go-playground/locales/en"
	zh2 "github.com/go-playground/locales/zh"
	ut "github.com/go-playground/universal-translator"
	"github.com/go-playground/validator/v10"
	en_translations "gopkg.in/go-playground/validator.v9/translations/en"
	zh_translations "gopkg.in/go-playground/validator.v9/translations/zh"
)

type people struct{
	Age int `form:"age" validate:"required,gt=10"`
	Name string `form:"name" validate:"required"`
	Address string `form:"address" validate:"required"`
}
var(
	Uni *ut.UniversalTranslator
	Validate *validator.Validate
)
//验证信息多语言化
func main(){
    Validate = validator.New()//创建一个验证器
    zh := zh2.New()
    en := en2.New()
    Uni = ut.New(zh,en)//创建翻译器，翻译器里有可支持的语言
    r := gin.Default()
    r.GET("/testing",func(c *gin.Context){
    	locale := c.DefaultQuery("locale",
    		"zh")
    	trans,_ := Uni.GetTranslator("locale")
    	switch locale{
		case "zh":
			zh_translations.RegisterDefaultTranslations(Validate,trans)
		case "en":
			en_translations.RegisterDefaultTranslations(Validate,trans)
		default:
			zh_translations.RegisterDefaultTranslations(Validate,trans)
		}
		var person people
    	if err := c.ShouldBind(&person);err != nil{//结构绑定
    		c.String(500,"%v",err)
    		c.Abort()
    		return
		}
		if err := Validate.Struct(person);err != nil{
			errs := err.(validator.ValidationErrors)
			sliceErrs := []string{}
			for _,e := range errs{
				sliceErrs=append(sliceErrs,e.Translate(trans))
			}
            c.String(500,"%v",sliceErrs)
			c.Abort()
			return
		}
		c.String(200,"%v",person)
	})
    r.Run()
}

Gin中间件
Gin框架允许开发者在处理请求的过程中，加入用户自己的钩子(Hook)函数。这个钩子函数就叫中间件，中间件适合处理一些公共的业务逻辑，比如登录认证、权限校验、数据分页、记录日志、耗时统计等
中间件-使用

package main

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

func main(){
	r := gin.New()//这次用new来实现
    r.Use(gin.Logger())//设置中间件
    r.GET("/test",func(c *gin.Context){
    	name := c.DefaultQuery("name","default_name")
    	c.String(200,"%s",name)
	})
	r.Run()
}

那么，想把错误打印到文件应该怎么办呢？、

package main

import (
	"github.com/gin-gonic/gin"
	"io"
	"os"
)

func main(){
	f,_ := os.Create("gin.log")
	gin.DefaultWriter = io.MultiWriter(f)
	gin.DefaultErrorWriter = io.MultiWriter(f)
	r := gin.New()//这次用new来实现
    r.Use(gin.Logger())//设置中间件
    r.GET("/test",func(c *gin.Context){
    	name := c.DefaultQuery("name","default_name")
    	c.String(200,"%s",name)
	})
	r.Run()
}

gin.Recovery的作用

package main

import (
	"github.com/gin-gonic/gin"
	"io"
	"os"
)

func main(){
	f,_ := os.Create("gin.log")
	gin.DefaultWriter = io.MultiWriter(f)
	gin.DefaultErrorWriter = io.MultiWriter(f)
	r := gin.New()//这次用new来实现
    r.Use(gin.Logger(),gin.Recovery())//设置中间件
    r.GET("/test",func(c *gin.Context){
    	name := c.DefaultQuery("name","default_name")
    	panic("test panic")//加上这个程序不至于报错
    	c.String(200,"%s",name)
	})
	r.Run()
}

中间件-自定义中间件

【Golang】Gin框架中如何使用JWT来实现登录认证
景天科技苑
11-01 5万+
JWT: JSON Web Token，是一种用于身份验证和授权的开放标准，JWT可以在网络应用间安全的传输。JWT由三个部分组成:头部(Header)、载荷(Payload)和签名(Signature) JWT具有可扩展性、简单、轻量级、跨语言等优点，是前后端分离框架中最常用的验证方式。
Gin框架的使用
m0_56137272的博客
09-10 2193
以上就是今天要讲的内容，本文仅仅简单介绍了Gin框架的使用，更多的用法请参考官方文档。
【Go语言】Gin 框架教程
Python、Golang、大数据
06-16 4556
开头，通过分组路由就能够简化路由的定义，也可以更好的实现路由的权限控制，例如将需要登录的路由放到同一分组中。这里使用一个表单参数进行举例，如下所示，输入分数转化为及格、不及格的判断，代码如下所示。请求其他的路由，则不受影响，就如我们在中间件方法所写的判断一样，仅仅只是拦截了。分组路由主要是为了处理路由前缀一致的情况，例如有一组路由前缀都是。程序，重启之后，再次访问路由地址，就能够正常解析路由参数了。与上文的路由参数一样，参数都是路由的一部分，不同的是。请求不同的路由地址，均能够得到正常的响应。
gin使用教程
penngo的专栏
01-15 2968
gin使用教程
Gin框架入门：一个简单使用示例
最新发布
weixin_42433737的博客
03-13 1170
本文还有配套的精品资源，点击获取 简介：Gin框架是Go语言中一个流行的高性能HTTP web框架。本示例介绍了Gin的核心特性以及如何快速搭建一个基础的web应用。内容包括安装Gin、创建web服务器、定义路由、处理请求与响应、支持路径与查询参数、处理文件上传和表单数据、中间件链的使用以及错误处理机制。通过这个示例，读者可以初步了解Gin框架的使用方法，并在实践中进一步掌...
GIN简单使用
程序猿的博客
12-19 1028
Gin是一个golang的微框架，封装比较优雅，API友好，源码注释比较明确，已经发布了1.0版本。具有快速灵活，容错方便等特点。其实对于而言，web框架的依赖要远比Python，Java之类的要小。自身的net/http足够简单，性能也非常不错。框架更像是一些常用函数或者工具的集合。借助框架开发，不仅可以省去很多常用的封装带来的时间，也有助于团队的编码风格和形成规范。
Gin使用
weixin_34315665的博客
01-06 421
这里的博客版本都不会被更新维护。查看最新的版本请移步：http://neojos.com Gin对net/http包做了封装，支持路由、中间件等特性，极大的方便对Http Server的开发。文章通过一个Test例子，来简要介绍。对于特别基础的部分，请阅读参考文章。 接口测试 Go中testing包为程序自测提供了便利。可以查阅之前写的...
Gin 框架的使用
功不唐捐，玉汝于成
04-29 1898
Go Web 开发框架 Gin 快速入门
gin基本使用
weixin_68658847的博客
09-16 1370
创建中间件文件根目录下创建import ("fmt"fmt.Println("这是自定义的中间件,里面可以写统一的业务逻辑")在main.go里面进行引入注册,切记要在路由之前引入import (// 使用中间件// 切记,中间件一定要在路由之前引入// 指定总路由// 启动服务器访问任意接口即可查看控制台打印中间件的那句话是否触发。
golang 网络框架之gin的使用方法
09-18
在Gin中，我们可以通过以下方式创建一个基本的HTTP服务器： ```go package main import "github.com/gin-gonic/gin" func main() { r := gin.New() r.GET("/ping", func(c *gin.Context) { c.String(200, ...
example-gin:使用Framework Gin和mongodb的示例Go
04-22
1. **Gin的基本使用**：项目将展示如何初始化Gin上下文，设置路由，以及使用中间件来处理请求。例如，可能有`main.go`文件，其中包含了`gin.New()`函数的使用，用于创建一个新的Gin实例，然后定义路由如`router.GET...
GinStudy:使用golang语言基于gin框架进行web开发
03-07
3. **Gin基本使用** 初始化一个Gin应用非常简单，只需创建一个`gin.Default()`实例。接着，我们可以定义路由并绑定处理器函数。例如： ```go router := gin.Default() router.GET("/hello", func(c *gin.Context...
Gin 框架使用指南
m0_57836225的博客
11-08 1237
定义不同请求方法的路由GET 请求：收起go复制// 处理 GET 请求逻辑})POST 请求：收起go复制// 处理 POST 请求逻辑})PUT 请求：收起go复制// 处理 PUT 请求逻辑})DELETE 请求：收起go复制// 处理 DELETE 请求逻辑})路由参数定义带有参数的路由：收起go复制// 使用参数 id 进行处理})查询参数获取查询参数：收起go复制// 使用查询参数 keyword 进行处理})
gin框架基本使用
m0_64288219的博客
01-19 5767
在go的web项目中，gin相当于java中的springmvc、gorm相当于java中的mybatis、gomod相当于java中的maven。gin的中文文档。
Gin框架的大致使用方法（详细）
weixin_51991615的博客
03-20 6383
1、在gin框架中文文档是这么介绍的 Gin 是一个用 Go (Golang) 编写的 web 框架。 它是一个类似于 martini 但拥有更好性能的 API 框架，由于 httprouter，速度提高了近 40 倍。 如果你是性能和高效的追求者，你会爱上 Gin。两款Web框架相比较，Gin自己说他比Martini要强很多。 2、Gin的基本使用方法 首先在项目终端下载安装gin包： go get -u github.com/gin-gonic/gin 举一个简单的例子： package main
GIN框架介绍以及使用
编程技术， 日益精进
02-20 3541
李文周的博客
Gin的使用
wzbwzt的博客
07-17 960
Gin框架 gin框架路由使用前缀树，路由注册的过程是构造前缀树的过程，路由匹配的过程就是查找前缀树的过程。 gin框架的中间件函数和处理函数是以切片形式的调用链条存在的，我们可以顺序调用也可以借助c.Next()方法实现嵌套调用。 借助c.Set()和c.Get()方法我们能够在不同的中间件函数中传递数据。 使用前需要调用gin.Default()生成gin引擎 调用r.Run()结尾，可以指定端口 安装 go get -u github.com/gin-gonic/gin 静态文件解析 一般放在
gin jwt 使用
03-03
在Gin框架中使用JWT（JSON Web Token）可以实现份验证和授权功能。JWT是一种用于在网络应用间传递信息的安全方法，它由三部分组成：header、payload和signature[^1]。 下面是在Gin框架中使用JWT的示例代码[^2]： 1. 导入所需的包： ```go import ( "github.com/gin-gonic/gin" "github.com/dgrijalva/jwt-go" ) ``` 2. 定义JWT的密钥： ```go var jwtKey = []byte("your_secret_key") ``` 3. 创建一个JWT的Claims结构体，用于存储用户的信息： ```go type Claims struct { Username string `json:"username"` jwt.StandardClaims } ``` 4. 创建一个处理登录请求的路由： ```go func login(c *gin.Context) { var loginData LoginData if err := c.ShouldBindJSON(&loginData); err != nil { c.JSON(http.StatusBadRequest, gin.H{"error": "Invalid request"}) return } // 验证用户名和密码 if loginData.Username == "admin" && loginData.Password == "password" { // 创建JWT的Claims claims := &Claims{ Username: loginData.Username, StandardClaims: jwt.StandardClaims{ ExpiresAt: time.Now().Add(time.Hour * 24).Unix(), // 设置过期时间 }, } // 创建JWT token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims) tokenString, err := token.SignedString(jwtKey) if err != nil { c.JSON(http.StatusInternalServerError, gin.H{"error": "Failed to generate token"}) return } // 返回JWT给客户端 c.JSON(http.StatusOK, gin.H{"token": tokenString}) } else { c.JSON(http.StatusUnauthorized, gin.H{"error": "Invalid credentials"}) } } ``` 5. 创建一个需要身份验证的路由： ```go func protectedRoute(c *gin.Context) { // 从请求头中获取JWT authHeader := c.GetHeader("Authorization") if authHeader == "" { c.JSON(http.StatusUnauthorized, gin.H{"error": "Missing authorization header"}) return } // 解析JWT tokenString := authHeader[7:] // 去除Bearer前缀 claims := &Claims{} token, err := jwt.ParseWithClaims(tokenString, claims, func(token *jwt.Token) (interface{}, error) { return jwtKey, nil }) if err != nil { if err == jwt.ErrSignatureInvalid { c.JSON(http.StatusUnauthorized, gin.H{"error": "Invalid token signature"}) return } c.JSON(http.StatusBadRequest, gin.H{"error": "Invalid token"}) return } if !token.Valid { c.JSON(http.StatusUnauthorized, gin.H{"error": "Invalid token"}) return } // 验证通过，继续处理请求 c.JSON(http.StatusOK, gin.H{"message": "Protected route"}) } ``` 6. 在路由中注册处理函数： ```go func main() { r := gin.Default() r.POST("/login", login) r.GET("/protected", protectedRoute) r.Run(":8080") } ``` 以上代码演示了在Gin框架中使用JWT进行身份验证和授权的基本流程。用户可以通过发送登录请求获取JWT，然后在需要身份验证的路由中将JWT放入请求头中进行验证。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

李元芳芳芳

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值