GO语言 gin框架 简述

news2024/11/17 17:39:54

原文地址 基本路由 · Go语言中文文档

一、简介

    Gin是一个golang的轻量级web框架，性能不错，API友好。

    Gin支持Restful风格的API，可以直接从URL路径上接收api参数或者URL参数，也可是使用json或者表单 数据绑定的方式接收参数。

    Gin响应前端的方式，可以使用的方式包括 json、结构体、protobuff的、XML、YAML。

    Gin可以使用路由分组的方式管理API，支持api路径重定向。

    Gin的路由库用的是 httprouter，路由节点的数据结构是压缩字典树，提高路由效率。

    Gin支持全局中间件和局部中间件，支持中间件分段逻辑的Next方法。

    Gin支持cookie和Session的方法去识别和验证客户端。

    Gin支持 Air 实时监听代码文件自动重新编译执行。

二、gin路由

1. 基本路由

    gin 框架中采用的路由库是基于 httprouter 做的，是第三方HTTP路由包，特点高性能、可扩展

(1) 使用方式：

     New()函数生成了一个 Router对象 。

     GET()方法 或 POST()方法 注册一个适配路径的响应函数  

     将 Router对象 作为参数传给 ListenAndServe()函数 启动HTTP服务。

router := httprouter.New()
router.GET("/", handleFunc)
http.ListenAndServe(":8080", router)

(2) httprouter 为常用的HTTP方法提供快捷使用方式：

     获取：  func (r *Router) GET(path string, handle Handle)

     添加：  func (r *Router) POST(path string, handle Handle)

     修改：  func (r *Router) PUT(path string, handle Handle)

     删除：  func (r *Router) DELETE(path string, handle Handle)

(3) httprouter 包中对URL使用两种匹配模式：

     形如/user/name的精确匹配

     形如/user/*name的匹配所有的模式

(4) 可以处理二级域名。先 根据域名获取对应的Handler路由，然后调用分发机制去处理。

func main() {
    ......
	//分别处理不同的二级域名
	hs := make(HostMap)
	hs["sub1.localhost:8080"] = userRouter
	hs["sub2.localhost:8080"] = dataRouter
    //一级域名：localhost，二级域名：sub1.localhost
	http.ListenAndServe(":8080", hs)
}

type HostMap map[string]http.Handler

func (hs HostMap) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	//先根据域名获取对应的Handler路由，然后调用处理
	if handler := hs[r.Host]; handler != nil {
		handler.ServeHTTP(w, r)
	}
}
2. Restful风格的API

    gin支持Restful风格的API，即： URL定位资源，用HTTP描述操作。例如：

(1) 获取文章 /blog/getXxx Get blog/Xxx

(2) 添加 /blog/addXxx POST blog/Xxx

(3) 修改 /blog/updateXxx PUT blog/Xxx

(4) 删除 /blog/delXxxx DELETE blog/Xxx

3. API参数

    Api参数就是在Api地址上输入的参数。

    可以通过Context的Param方法来获取API参数

func main() {
    r := gin.Default()
    r.GET("/user/:name/*action", func(c *gin.Context) {
        name := c.Param("name")
        action := c.Param("action")
        action = strings.Trim(action, "/") //截取/后面的内容
        c.String(http.StatusOK, name+" is "+action)
    })
    r.Run(":8000") //监听8080端口
}

 在浏览器输入：   http://localhost:8080/user/枯藤/doview，获得name参数"枯藤"，action参数 "doview"

4. URL参数

   URL参数就是在用Get方式，在?后面输入的参数。

   可以通过DefaultQuery()或Query()方法获取URL参数

r.GET("/user", func(c *gin.Context) {
    name := c.DefaultQuery("name", "枯藤")    //name是参数名称，枯藤是默认值
    c.String(http.StatusOK, fmt.Sprintf("hello %s", name))
})

 在浏览器输入：   http://localhost:8080/user?name=乌鸦，获得name参数"乌鸦"

5. 表单参数

(1) 表单传输为 post请求。http常见的传输格式：

    application/json

    application/x-www-form-urlencoded （默认）

    multipart/form-data

(2) 表单参数可以通过 PostForm() 方法获取

r.POST("/form", func(c *gin.Context) {
    username := c.PostForm("username")
    password := c.PostForm("userpassword")
    c.String(http.StatusOK, fmt.Sprintf("username:%s,password:%s", username, password))
})
6. 上传单个文件

(1) multipart/form-data格式用于文件上传

(2) 通过 FormFile() 方法获得文件对象 

r.POST("/upload", func(c *gin.Context) {
        file, err := c.FormFile("file")
        c.String(http.StatusOK, file.Filename)
    })
7. 上传多个文件

(1) 上传多个文件也是用 multipart/form-data格式

(2) 通过 MultipartForm() 方法获得文件对象列表

r.POST("/upload", func(c *gin.Context) {
    form, err := c.MultipartForm()
    files := form.File["files"]    // 获取所有图片
    for _, file := range files {    // 遍历所有图片
        c.SaveUploadedFile(file, file.Filename)
    }
})
8. routes group

  routes group(路由分组) 可以分组管理相同的URL。 

   如下代码，v1和v2分别是两个路由组。

func main() {
   r := gin.Default() //创建默认路由
   v1 := r.Group("/v1")    //路由组1
   {   // {} 是书写规范
      v1.GET("/login", login)
      v1.GET("submit", submit)
   }
   v2 := r.Group("/v2")    //路由组2
   {
      v2.POST("/login", login)
      v2.POST("/submit", submit)
   }
   r.Run(":8000")
}
9. 路由原理

  httprouter使用的数据结构是压缩字典树。

  普通的字典树：每个字母都建立一个路由节点

  压缩字典树：只对每个有效前缀建立路由节点。如下图所示：

三、gin数据解析和绑定

     支持三种方式的数据解析，json、表单 和 url参数

1. Json 数据解析和绑定

     使用 context 的 ShouldBindJSON 方法

type Login struct {
   User    string `json:"user"  binding:"required"`
   Pssword string `json:"password"  binding:"required"`
}

func main() {
   r := gin.Default()
   r.POST("loginJSON", func(c *gin.Context) {
      // 声明接收的变量
      var json Login
      // 将request的body中的数据，自动按照json格式解析到结构体
      if err := c.ShouldBindJSON(&json); err != nil {
         ......
      }
      ......
   })
   ......
}
2. 表单数据解析和绑定

   使用 context 的 Bind 方法

type Login struct {
    User    string `form:"username" binding:"required"`
    Pssword string `form:"password" binding:"required"`
}

func main() {
    r := gin.Default()
    r.POST("/loginForm", func(c *gin.Context) {
        var form Login
        // Bind()默认解析并绑定form格式
        // 根据请求头中content-type自动推断
        if err := c.Bind(&form); err != nil {
            ......
        }
        ......
    })
    ......
}
3. URI数据解析和绑定

   使用 context 的 ShouldBindUri 方法

type Login struct {
    User    string `uri:"user" xml:"user" binding:"required"`
    Pssword string `uri:"password" xml:"password" binding:"required"`
}

func main() {
    r := gin.Default()
    r.GET("/:user/:password", func(c *gin.Context) {
        if err := c.ShouldBindUri(&login); err != nil {
            .......
        }
        .......
    })
    .......
}

四、gin 渲染

1. 各种数据格式的响应

(1) json 响应

c.JSON(200, gin.H{"message": "someJSON", "status": 200})

(2) 结构体 响应

var msg struct {
    Name    string
    Message string
}
msg.Name = "root"
msg.Message = "message"
c.JSON(200, msg)

(3) XML，YAML 响应

c.XML(200, gin.H{"message": "abc"})
c.YAML(200, gin.H{"name": "zhangsan"})

(4) protobuf 响应

data := &protoexample.Test{
    Label: &label,
    Reps:  reps,
}
c.ProtoBuf(200, data)
2. HTML模板渲染

   gin支持加载 HTML模板, 然后根据模板参数进行配置并返回相应的数据。

   本质上就是字符串替换。

func main() {
    r := gin.Default()
    r.LoadHTMLGlob("tem/*")    //加载模板文件
    r.GET("/index", func(c *gin.Context) {
        //index.html就是具体的模板文件
        c.HTML(http.StatusOK, "index.html", gin.H{"title": "我是测试", "ce": "123456"})
    })
    r.Run()
}
3. 重定向

  可以使用 context 的  Redirect 方法进行重定向

func main() {
    r := gin.Default()
    r.GET("/redirect_me", func(c *gin.Context) {
        c.Redirect(http.StatusMovedPermanently, "http://www.5lmh.com")
    })
    r.Run()
}

  当客户端请求 /redirect_me 时，服务器将重定向到 https://www.5lmh.com

4. 同步异步

  goroutine机制可以实现异步处理，但不应该使用原始上下文，必须使用它的只读副本。

func main() {
    r := gin.Default()
    r.GET("/long_async", func(c *gin.Context) { 
        copyContext := c.Copy()    // 需要拷贝一个副本
        go func() {    // 异步处理
            time.Sleep(3 * time.Second)
            log.Println("异步执行：" + copyContext.Request.URL.Path)
        }()
    })
    r.Run(":8000")
}

五、gin中间件

1. 全局中间件

    所有请求都经过此中间件。

    实现代码如下：

func MiddleWare() gin.HandlerFunc {
    ......
}

func main() {
    r := gin.Default()
    r.Use(MiddleWare())
    r.Run()
}
2. Next()方法

    当程序执行到context.Next时，会转而先去执行具体的业务逻辑。

    执行完业务逻辑处理函数之后，程序会再次回到context.Next处，继续执行中间件后续的代码。

func MiddleWare() gin.HandlerFunc {
    return func(c *gin.Context) {
        fmt.Println("中间件开始执行了")
        c.Next()    //转去执行业务逻辑
        //业务逻辑执行完，返回此处，继续执行中间件代码
        .......
        fmt.Println("中间件执行完毕", status)
    }
}

func main() {
    r := gin.Default()
    r.Use(MiddleWare())    // 注册中间件
    r.GET("/ce", func(c *gin.Context) {
        ......
    })
    r.Run()
}

  解释原文 Golang gin 中间件、context.Next函数_gin context.next-CSDN博客

3. 局部中间件

    中间件只在具体某个路由生效，不使用 r.use() 定义的中间件。

func main() {
    r := gin.Default()
    //只在 /ce 的路由里使用局部中间件 PartMiddleWare()
    r.GET("/ce", PartMiddleWare(), func(c *gin.Context) { 
        ......
    })
    r.Run()
}

  解释原文 局部生效的中间件_如何使用局部中间件-CSDN博客

六、会话控制

 1. Cookie介绍

(1) HTTP是无状态协议，服务器不能记录浏览器的访问状态，不能区分两次请求是否由同一个客户端发出。

(2) Cookie 就是一段可以区分不同客户端的信息，由服务器创建，发送给浏览器，浏览器保存。

(3) 浏览器向服务器发送请求时，都会同时将Cookie发送给服务器，服务器根据处理请求。

2. Cookie的使用

   登录时设置cookie，其他请求检验cookie，代码如下：

func AuthMiddleWare() gin.HandlerFunc {
   return func(c *gin.Context) {
      //2.获取cookie并校验
      if cookie, err := c.Cookie("abc"); err == nil {
         if cookie == "123" {
            c.Next() //3.cookie检验通过，执行请求逻辑
            return
         }
      }
      ......
      return
   }
}

func main() {
   r := gin.Default()
   r.GET("/login", func(c *gin.Context) {
      c.SetCookie("abc", "123", 60, "/", "localhost", false, true) //1.登录成功，设置cookie
      c.String(200, "Login success!")
   })
   ......
}
3. Cookie的缺点

(1) 不安全，明文，容易泄露信息

(2) 可以被浏览器禁用。

(3) 有数量限制。某些浏览器对某个域名的cookie有数量限制，大概50个。

4. Sessions

(1) session和cookie 实现的目标是一致的，但实现的方法不同；

(2) session 是另一种记录客户状态的机制， 不同的是 Cookie 保存在客户端浏览器中，而 session保存在服务器

(3) 浏览器第一次访问服务器时，服务器端会创建一个 session 对象，生成一个类似于 key,value 的键值对， 然后将 value 保存到服务器，将 key(cookie)返回到浏览器(客户)端。
      浏览器下次访问时会携带 key(cookie)，找到对应的 session(value)。

(4) sessions包地址： github.com/gorilla/sessions

七、参数验证

1. 结构体验证

   用gin框架的数据验证，可以不用解析数据，减少if else，会简洁许多。

   比如，在定义结构体时，添加如下 binding:"required,gt=10"，表示不能为空并且大于10

type Person struct {
    //不能为空并且大于10
    Age      int       `form:"age" binding:"required,gt=10"`
}
 2. 自定义验证

    可以自定义验证函数，并注册到 validator中。

    包地址：gopkg.in/go-playground/validator.v9/translations

type Person struct {
    //1.在binding上使用自定义的 参数名称 stringCheckName
    Name    string `form:"name" binding:"stringCheckName"`
}
//2.自定义的校验方法
func checkStringValid(v *validator.Validate, ......) bool {
    if value, ok := field.Interface().(string); ok {
        return value != "" && !("5lmh" == value) //字段不能为空，并且不等于5lmh
    }
    return true
}
func main() {
    r := gin.Default()
    // 3、将我们自定义的校验方法 和 参数名称 注册到 validator中
    if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
        v.RegisterValidation("stringCheckName", checkStringValid)
    }
}
3. 多语言翻译验证

   如需要自定义返回信息的语言，比如部分用户返回中文，部分返回英文。

   可以使用  validator.v9/translations

import (
    ut "github.com/go-playground/universal-translator"
    en_translations "gopkg.in/go-playground/validator.v9/translations/en"
)
func startPage(c *gin.Context) {
    locale := c.DefaultQuery("locale", "zh")  //1.获得前端使用语言
    //2.获得翻译器
    en := en.New()
    zh := zh.New()
    Uni = ut.New(en, zh)
    trans, _ := Uni.GetTranslator(locale)     
    //3.注册翻译器
    Validate = validator.New()
    en_translations.RegisterDefaultTranslations(Validate, trans) 
    //4.解析结构体，获得翻译过的内容
    user := User{}
    c.ShouldBind(&user)
    err := Validate.Struct(user)
}

八、其他

1. 日志

  使用 io.MultiWriter  和 gin.DefaultWriter

import (
    "io"
    "os"
)
func main() {
    f, _ := os.Create("gin.log")
    gin.DefaultWriter = io.MultiWriter(f) //将日志写入文件
    //gin.DefaultWriter = io.MultiWriter(f, os.Stdout) //将日志同时写入文件和控制台
}
2. Air 实时加载

    在开发调试的时候，变更代码之后需要按下Ctrl+C停止程序并重新编译再执行，不是很方便。

    Air能够实时监听项目的代码文件，在代码发生变更之后自动重新编译并执行，提高开发效率。

3. gin验证码

   为了防止接口被恶意频繁调用，可以采用加验证码的方式。

   库地址：github.com/dchest/captcha

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1710930.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

152.找出峰值（力扣）

152.找出峰值（力扣）

代码解决 class Solution { public:// 函数用于找到山峰元素的索引vector<int> findPeaks(vector<int>& mountain) {vector<int> result; // 用于存储山峰元素的索引// 遍历数组&#xff0c;从第二个元素到倒数第二个元素for(int i 1; i 1 < mount…
阅读更多...
C++ | Leetcode C++题解之第117题填充每个节点的下一个右侧节点指针II

C++ | Leetcode C++题解之第117题填充每个节点的下一个右侧节点指针II

题目&#xff1a; 题解&#xff1a; class Solution { public:void handle(Node* &last, Node* &p, Node* &nextStart) {if (last) {last->next p;} if (!nextStart) {nextStart p;}last p;}Node* connect(Node* root) {if (!root) {return nullptr;}Node *…
阅读更多...
数据结构——二叉树的基本应用

数据结构——二叉树的基本应用

在此之前我们已经初步了解了二叉树&#xff0c;在介绍堆的基本应用时&#xff0c;我们已经具体介绍了完全二叉树的基本应用&#xff0c;本章我们介绍二叉树的基本应用&#xff0c;这个不止指的是完全二叉树&#xff0c;而是指泛型的二叉树。 二叉树的基本应用&#xff0c;由于…
阅读更多...
NDIS协议驱动(三)

NDIS协议驱动(三)

协议驱动程序源自发送请求并处理基础驱动程序的接收指示。 在单个函数调用中&#xff0c;NDIS 协议驱动程序可以在每个 NET_BUFFER_LIST 结构上发送具有多个 NET_BUFFER 结构的多个NET_BUFFER_LIST结构。 在接收路径中&#xff0c;协议驱动程序可以接收NET_BUFFER_LIST结构的列…
阅读更多...
宝塔部署Java+Vue前后端分离项目

宝塔部署Java+Vue前后端分离项目

1. 服务器 服务器选择Linux的CentOS7的版本 2. 宝塔Linux面板 2.1 百度搜索宝塔 2.2 进去之后点击立即免费安装 2.3 选择Linux在线安装&#xff0c;输入服务器信息进行安装(也可以选择其他方式) 安装完成之后会弹一个宝塔的应用面板&#xff0c;并附带有登录名称和密码&…
阅读更多...
Hugging face win使用教程（二）

Hugging face win使用教程（二）

1. 将环境迁移到win&#xff0c;可以直接下载修改好的cuda环境https://download.csdn.net/download/liangjiubujiu/89368302?spm1001.2014.3001.5503 2. 修改hugging face的缓存路径 3. 重启pycharm 4. 编写测试代码&#xff0c;注意可能由于网络链接问题&#xff0c;需要关…
阅读更多...
OSINT 与心理学：通过开源情报进行剖析和行为分析

OSINT 与心理学：通过开源情报进行剖析和行为分析

在不断发展的心理学领域&#xff0c;人们越来越认识到通过应用开源情报 (OSINT) 方法取得进步的潜力。OSINT 主要以其在安全和情报领域的应用而闻名&#xff0c;并且越来越多地展示其在心理分析和行为分析方面的潜力。本文探讨了 OSINT 和心理学的迷人交叉点&#xff0c;研究如…
阅读更多...
基于BP神经网络和小波变换特征提取的烟草香型分类算法matlab仿真,分为浓香型,清香型和中间香型

基于BP神经网络和小波变换特征提取的烟草香型分类算法matlab仿真,分为浓香型,清香型和中间香型

目录 1.算法运行效果图预览 2.算法运行软件版本 3.部分核心程序 4.算法理论概述 5.算法完整程序工程 1.算法运行效果图预览 2.算法运行软件版本 matlab2022a 3.部分核心程序 ...................................................................................... …
阅读更多...
AURIX TC3xx单片机介绍-启动过程介绍3

AURIX TC3xx单片机介绍-启动过程介绍3

如下的内容是英文为主，对于TC3xx芯片启动原理不清楚的，可以给我留言，我来解答你们的问题！ 3.2.1 Reset类型识别 Reset类型的识别是用来判断上次的复位是Application Reset还是System Reset还是CPU0 Reset。基于复位的原因，启动软件会运行不同的分支逻辑。复位原因可以通…
阅读更多...
每日两题 / 131. 分割回文串 42. 接雨水（LeetCode热题100）

每日两题 / 131. 分割回文串 42. 接雨水（LeetCode热题100）

131. 分割回文串 - 力扣&#xff08;LeetCode&#xff09; 数据量较小&#xff0c;考虑直接暴力&#xff0c;每次dfs&#xff1a;以bg作为左区间&#xff0c;往右遍历&#xff0c;找到一段回文串区间后&#xff0c;将回文串插入vector<string>&#xff0c;并以下一个下标…
阅读更多...
【最优化方法】实验一 熟悉MATLAB基本功能

【最优化方法】实验一 熟悉MATLAB基本功能

实验一　　熟悉MATLAB基本功能 实验的目的和要求&#xff1a;在本次实验中&#xff0c;通过亲临使用MATLAB&#xff0c;对该软件做一全面了解并掌握重点内容。 实验内容&#xff1a; &#xff11;、全面了解MATLAB系统 &#xff12;、实验常用工具的具体操作和功能 学习建…
阅读更多...
PHP：phpmyadmin 将查询数据导出csv

PHP：phpmyadmin 将查询数据导出csv

1、输入你的SQL查询出结果 2、查出数据以后拖到最下方【导出】 3、导出CSV
阅读更多...
cs61B-sp21 | lab6

cs61B-sp21 | lab6

cs61B-sp21 | lab6 TODO 1 在 CapersRepository.java 中 static final File CAPERS_FOLDER null; // TODO Hint: look at the join // function in Utils在 Utils.java 我们找到 join 函数&#xff0c;第一个 join 的作用是将 first 和 others 连接起来形成一个路径…
阅读更多...
部署LAMP环境

部署LAMP环境

红帽9搭建LAMP 安装Apache 2.安装数据库服务 3.安装php (1)使用IP访问/phpinfo.php 4.安装phpMyAdmin &#xff08;1&#xff09;数据库端口改为学号后五位 &#xff08;2&#xff09;登录phpmyadmin 5.SSH增加一个端口10022&#xff0c;fttp增加两个端口10080和8080 &#xf…
阅读更多...
使用python绘制一个五颜六色的爱心

使用python绘制一个五颜六色的爱心

使用python绘制一个五颜六色的爱心 介绍效果代码 介绍 使用numpy与matplotlib绘制一个七彩爱心&#xff01; 效果 代码 import numpy as np import matplotlib.pyplot as plt# Heart shape function def heart_shape(t):x 16 * np.sin(t)**3y 13 * np.cos(t) - 5 * np.cos…
阅读更多...
HNU-人工智能-作业3

HNU-人工智能-作业3

人工智能-作业3 计科210X 甘晴void 202108010XXX 1.贝叶斯网络 根据图所给出的贝叶斯网络&#xff0c;其中&#xff1a;P(A)0.5&#xff0c;P(B|A)1&#xff0c; P(B|A)0.5&#xff0c; P(C|A)1&#xff0c; P(C|A)0.5&#xff0c;P(D|BC)1&#xff0c;P(D|B, C)0.5&#xff…
阅读更多...
链式法则：神经网络前向与反向传播的基石

链式法则：神经网络前向与反向传播的基石

在深度学习的浪潮中&#xff0c;神经网络以其强大的学习和预测能力&#xff0c;成为解决复杂问题的有力工具。而神经网络之所以能够不断学习和优化&#xff0c;离不开两个核心过程&#xff1a;前向传播和反向传播。其中&#xff0c;链式法则作为微积分学中的一个基本概念&#…
阅读更多...
闲鱼电商运营高级课程，一部手机学会闲鱼开店赚钱

闲鱼电商运营高级课程，一部手机学会闲鱼开店赚钱

课程下载&#xff1a;https://download.csdn.net/download/m0_66047725/89360471 更多资源下载&#xff1a;关注我。 课程内容&#xff1a; 10-9、怎么寻找优质的货源店铺.mp4 11-10、怎么去选择商品图片.mp4 12-11、商品图片的注意避免事项.mp4 13-12、怎么写标题.mp4 …
阅读更多...
C++ 基于vs2019创建并使用动态链接库（dll）

C++ 基于vs2019创建并使用动态链接库（dll）

库的基本认识 静态库&#xff08;Static Library&#xff09; 基本概念&#xff1a;静态库是在编译时链接到目标程序中的库文件。它包含了程序运行所需的所有函数和数据&#xff0c;这些函数和数据会被直接嵌入到最终生成的可执行文件中。静态库通常以.a&#xff08;在Unix-l…
阅读更多...
三步走，Halo DB 安装指引

三步走，Halo DB 安装指引

前文介绍了国产数据库新星 Halo 数据库是什么&#xff0c; 哈喽&#xff0c;国产数据库&#xff01;Halo DB! ★ HaloDB是基于原生PG打造的新一代高性能安全自主可控全场景通用型统一数据库。 业内首次创造性的提出插件式内核架构设计&#xff0c;通过配置的方式&#xff0c;适…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023