AI 助理
备案控制台
开发者社区 云原生 文章 正文

【GoGin】（3）Gin的数据渲染和中间件的使用：数据渲染、返回JSON、浅.JSON()源码、中间件、Next()方法

2025-10-09 10
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
本文涉及的产品
应用实时监控服务-可观测链路OpenTelemetry版，每月50GB免费额度
可观测可视化 Grafana 版，10个用户账号 1个月
应用实时监控服务-应用监控，每月50GB免费额度
简介： 我们在正常注册中间件时，会打断原有的运行流程，但是你可以在中间件函数内部添加Next()方法，这样可以让原有的运行流程继续执行，当原有的运行流程结束后再回来执行中间件内部的内容。​ c.Writer.WriteHeaderNow()还会写入文本流中。可以看到使用next后，正常执行流程中并没有获得到中间件设置的值。接口还提供了一个可以修改ContentType的方法。判断了传入的状态码是否符合正确的状态码，并返回。在内部封装时，只是标注了不同的render类型。再看一下其他返回的类型；

1. 数据渲染

1.1 各种数据格式的响应

  • json、结构体、XML、YAML类似于java的properties、ProtoBuf

1.1.1 返回JSON

package main

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

func main() {
   
    r := gin.Default()

    r.POST("/demo", func(res *gin.Context) {
   
        res.JSON(http.StatusOK, gin.H{
   
            "message": "success",
        })
    })
    r.Run(":8080")
}

1.1.2 返回结构体

r.GET("/demo", func(res *gin.Context) {
   
    var obj struct {
   
        name string
        age  int8
    }
    obj.age = 1
    obj.name = "张三"
    res.JSON(http.StatusOK, obj)
})

1.1.3 XML 和 YAML

// 3.XML
r.GET("/someXML", func(c *gin.Context) {
   
    c.XML(200, gin.H{
   "message": "abc"})
})
// 4.YAML响应
r.GET("/someYAML", func(c *gin.Context) {
   
    c.YAML(200, gin.H{
   "name": "zhangsan"})
})

1.1.4 浅浅扒一下源码

进入res.JSON函数里面看一下

res.JSON(http.StatusOK, obj)

func (c *Context) JSON(code int, obj any) {
   
    c.Render(code, render.JSON{
   Data: obj})
}
  • (c *Context) 代表可以被Context类型调用
  • (code int, obj any) 传入参数，状态码和返回对象

它本身内部再次封装了一层提供给Render类型

func (c *Context) Render(code int, r render.Render) {
   
    c.Status(code)

    if !bodyAllowedForStatus(code) {
   
       r.WriteContentType(c.Writer)
       c.Writer.WriteHeaderNow()
       return
    }

    if err := r.Render(c.Writer); err != nil {
   
       // Pushing error to c.Errors
       _ = c.Error(err)
       c.Abort()
    }
}

进入Render里面，可以看到

  • (code int, r render.Render) 参数进行了更改，传入了render包下的Render类型

可以看一下Render这个接口

type Render interface {
   
    // Render writes data with custom ContentType.
    Render(http.ResponseWriter) error
    // WriteContentType writes custom ContentType.
    WriteContentType(w http.ResponseWriter)
}

接口还提供了一个可以修改ContentType的方法

if !bodyAllowedForStatus(code) {
   
    r.WriteContentType(c.Writer)
    c.Writer.WriteHeaderNow()
    return
}
  • bodyAllowedForStatus()进行了判断
func bodyAllowedForStatus(status int) bool {
   
    switch {
   
    case status >= 100 && status <= 199:
        return false
    case status == http.StatusNoContent:
        return false
    case status == http.StatusNotModified:
        return false
    }
    return true
}

判断了传入的状态码是否符合正确的状态码，并返回

  • 当bodyAllowedForStatus()判断为错误状态码时

    会在返回对象中写入ContentType内容

​ c.Writer.WriteHeaderNow()还会写入文本流中

再看一下其他返回的类型；例如XML

func (c *Context) XML(code int, obj any) {
   
    c.Render(code, render.XML{
   Data: obj})
}

在内部封装时，只是标注了不同的render类型

1.2 重定向

访问/demo地址时，将页面重定向跳转至其他页面

package main

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

func main() {
   
    r := gin.Default()

    r.GET("/demo", func(c *gin.Context) {
   
       c.Redirect(http.StatusMovedPermanently, "http://www.baidu.com")
    })

    r.Run(":8080")
}

2. 中间件

2.1 全局中间件

  • 所有请求都经过此中间件
package main

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

func MiddleWare() gin.HandlerFunc {
   
    return func(c *gin.Context) {
   
        t := time.Now()
        log.Println("中间件开始运行：", t)

        c.Set("middle_1", "中间件1执行结束")

        status := c.Writer.Status()
        log.Println("中间件执行结束：", status)
        t2 := time.Since(t)
        log.Println("耗时：", t2)
    }
}

func main() {
   
    r := gin.Default()

    // 注册中间件
    r.Use(MiddleWare())

    r.GET("/demo", func(c *gin.Context) {
   
        // 获得内容
        m, _ := c.Get("middle_1")
        log.Println("中间件接收参数：", m)
        c.JSON(200, gin.H{
   "中间件接收参数：": m})
    })

    r.Run(":8080")
}

测试：http://localhost:8080/demo

返回结果：

[GIN-debug] Listening and serving HTTP on :8080
2025/04/29 00:12:34 中间件开始运行： 2025-04-29 00:12:34.5992889 +0800 CST m=+1.770059901
2025/04/29 00:12:34 中间件执行结束： 200
2025/04/29 00:12:34 耗时： 11.5258ms
2025/04/29 00:12:34 中间件接收参数： 中间件1执行结束
[GIN] 2025/04/29 - 00:12:34 | 200 |     11.5258ms |             ::1 | GET      "/demo"

gin 使用r.Use()来注册一个组件

  • 在注册组件时，我们需要规定函数的返回类型，这才能让gin知道这是什么组件
func MiddleWare() gin.HandlerFunc {
   
    return func(c *gin.Context) {
   
        t := time.Now()
        log.Println("中间件开始运行：", t)

        c.Set("middle_1", "中间件1执行结束")

        status := c.Writer.Status()
        log.Println("中间件执行结束：", status)
        t2 := time.Since(t)
        log.Println("耗时：", t2)
    }
}
  • 这里MiddleWare()函数规定了返回类型是 gin.HandlerFunc ，这就代表这个函数是一个处理类

2.1.1 Next() 方法

我们在正常注册中间件时，会打断原有的运行流程，但是你可以在中间件函数内部添加Next()方法，这样可以让原有的运行流程继续执行，当原有的运行流程结束后再回来执行中间件内部的内容

package main

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

func MiddleWare() gin.HandlerFunc {
   
    return func(c *gin.Context) {
   
        t := time.Now()
        log.Println("中间件开始运行：", t)

        // 开启正常执行流程
        c.Next()

        c.Set("middle_1", "中间件1执行结束")

        status := c.Writer.Status()
        log.Println("中间件执行结束：", status)
        t2 := time.Since(t)
        log.Println("耗时：", t2)
    }
}

func main() {
   
    r := gin.Default()

    // 注册中间件
    r.Use(MiddleWare())

    r.GET("/demo", func(c *gin.Context) {
   
        // 获得内容
        m, _ := c.Get("middle_1")
        log.Println("中间件接收参数：", m)
        c.JSON(200, gin.H{
   "中间件接收参数：": m})
    })

    r.Run(":8080")
}

测试：http://localhost:8080/demo

返回结果：

[GIN-debug] Listening and serving HTTP on :8080
2025/04/29 00:14:14 中间件开始运行： 2025-04-29 00:14:14.5697461 +0800 CST m=+2.981609901
2025/04/29 00:14:14 中间件接收参数： <nil>
2025/04/29 00:14:14 中间件执行结束： 200
2025/04/29 00:14:14 耗时： 14.0262ms
[GIN] 2025/04/29 - 00:14:14 | 200 |     14.0262ms |             ::1 | GET      "/demo"

可以看到使用next后，正常执行流程中并没有获得到中间件设置的值

2.2 局部中间件

package main

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

func MiddleWare() gin.HandlerFunc {
   
    return func(c *gin.Context) {
   
       t := time.Now()
       log.Println("中间件开始运行：", t)

       c.Set("middle_1", "中间件1执行结束")

       status := c.Writer.Status()
       log.Println("中间件执行结束：", status)
       t2 := time.Since(t)
       log.Println("耗时：", t2)
    }
}

func main() {
   
    r := gin.Default()

    // 局部中间件-在为一个请求添加执行函数时即可挂载中间件
    r.GET("/demo", MiddleWare(), func(c *gin.Context) {
   
       // 获得内容
       m, _ := c.Get("middle_1")
       log.Println("中间件接收参数：", m)
       c.JSON(200, gin.H{
   "中间件接收参数：": m})
    })

    r.Run(":8080")
}
  • 为你想给哪一个请求挂载中间件，直接在对应的请求中添加中间件函数即可

3. ❤️GoGin框架——前文链接

Gin框架学习参考网站：gin框架·Go语言中文文档

文章标签：
中间件
数据格式
JSON
Java
Go
凉凉心.
目录
相关文章
2025「AI安全」全球攻防赛小编
|
11天前
|
云安全 人工智能 安全
阿里云欧阳欣 ：AI Agent时代下，云安全的双轮驱动战略
云安全的新趋势、新发布
2025「AI安全」全球攻防赛小编
1152 19
阿里云欧阳欣 ：AI Agent时代下，云安全的双轮驱动战略
数据库知识分享者小北
|
11天前
|
存储 关系型数据库 分布式数据库
PostgreSQL 18 发布，快来 PolarDB 尝鲜！
PostgreSQL 18 发布，PolarDB for PostgreSQL 全面兼容。新版本支持异步I/O、UUIDv7、虚拟生成列、逻辑复制增强及OAuth认证，显著提升性能与安全。PolarDB-PG 18 支持存算分离架构，融合海量弹性存储与极致计算性能，搭配丰富插件生态，为企业提供高效、稳定、灵活的云数据库解决方案，助力企业数字化转型如虎添翼！
数据库知识分享者小北
982 24
硅基脂肪论
|
10天前
|
存储 人工智能 搜索推荐
终身学习型智能体
当前人工智能前沿研究的一个重要方向：构建能够自主学习、调用工具、积累经验的小型智能体（Agent）。 我们可以称这种系统为“终身学习型智能体”或“自适应认知代理”。它的设计理念就是： 不靠庞大的内置知识取胜，而是依靠高效的推理能力 + 动态获取知识的能力 + 经验积累机制。
硅基脂肪论
356 131
varin
|
10天前
|
存储 人工智能 Java
AI 超级智能体全栈项目阶段二：Prompt 优化技巧与学术分析 AI 应用开发实现上下文联系多轮对话
本文讲解 Prompt 基本概念与 10 个优化技巧，结合学术分析 AI 应用的需求分析、设计方案，介绍 Spring AI 中 ChatClient 及 Advisors 的使用。
varin
443 131
AI 超级智能体全栈项目阶段二：Prompt 优化技巧与学术分析 AI 应用开发实现上下文联系多轮对话
花非花雾非雾11
|
4天前
|
存储 安全 前端开发
如何将加密和解密函数应用到实际项目中？
如何将加密和解密函数应用到实际项目中？
花非花雾非雾11
206 138
varin
|
10天前
|
人工智能 Java API
AI 超级智能体全栈项目阶段一：AI大模型概述、选型、项目初始化以及基于阿里云灵积模型 Qwen-Plus实现模型接入四种方式（SDK/HTTP/SpringAI/langchain4j）
本文介绍AI大模型的核心概念、分类及开发者学习路径，重点讲解如何选择与接入大模型。项目基于Spring Boot，使用阿里云灵积模型（Qwen-Plus），对比SDK、HTTP、Spring AI和LangChain4j四种接入方式，助力开发者高效构建AI应用。
varin
405 122
AI 超级智能体全栈项目阶段一：AI大模型概述、选型、项目初始化以及基于阿里云灵积模型 Qwen-Plus实现模型接入四种方式（SDK/HTTP/SpringAI/langchain4j）
花非花雾非雾11
|
4天前
|
存储 JSON 安全
加密和解密函数的具体实现代码
加密和解密函数的具体实现代码
花非花雾非雾11
204 136
南瓜佬
|
22天前
|
弹性计算 关系型数据库 微服务
基于 Docker 与 Kubernetes（K3s）的微服务：阿里云生产环境扩容实践
在微服务架构中，如何实现“稳定扩容”与“成本可控”是企业面临的核心挑战。本文结合 Python FastAPI 微服务实战，详解如何基于阿里云基础设施，利用 Docker 封装服务、K3s 实现容器编排，构建生产级微服务架构。内容涵盖容器构建、集群部署、自动扩缩容、可观测性等关键环节，适配阿里云资源特性与服务生态，助力企业打造低成本、高可靠、易扩展的微服务解决方案。
南瓜佬
1363 8
计算机程序设计Y2013070224
|
9天前
|
监控 JavaScript Java
基于大模型技术的反欺诈知识问答系统
随着互联网与金融科技发展，网络欺诈频发，构建高效反欺诈平台成为迫切需求。本文基于Java、Vue.js、Spring Boot与MySQL技术，设计实现集欺诈识别、宣传教育、用户互动于一体的反欺诈系统，提升公众防范意识，助力企业合规与用户权益保护。
计算机程序设计Y2013070224
243 127

云原生

热门文章

最新文章

  • 1
    Docker CE 镜像源站
  • 2
    容器镜像服务 Docker镜像的基本使用
  • 3
    使用阿里云容器服务Jenkins 2.0实现持续集成之Pipeline篇(updated on 2016.12.23)
  • 4
    【沉淀】从网络中间件到搜索，从移动开发到分布式计算平台，阿里高级专家李睿博谈自己的折腾路
  • 5
    阿里云容器服务K8S Ingress Controller日志采集实践
  • 6
    阿里云容器服务飞天敏捷版详解
  • 7
    Kafka、RabbitMQ、RocketMQ 消息中间件的对比 | 消息发送性能篇
  • 8
    Docker日志收集新方案：log-pilot
  • 9
    Kubernetes集群上基于Jenkins的CI/CD流程实践
  • 10
    容器内日志收集方案示例
  • 1
    图文解析带你精通时序PromQL语法
    23
  • 2
    【GoGin】（3）Gin的数据渲染和中间件的使用：数据渲染、返回JSON、浅.JSON()源码、中间件、Next()方法
    10
  • 3
    【SpringBoot（三）】从请求到响应再到视图解析与模板引擎，本文带你领悟SpringBoot请求接收全流程！
    12
  • 4
    【Docker】（2）还在浏览网页寻找Docker命令？本文全面列举与使用Docker里的各个命令！想要什么命令直接从本文拿！
    10
  • 5
    【Golang】（3）条件判断与循环？切片和数组的关系？映射表与Map？三组关系傻傻分不清？本文带你了解基本的复杂类型与执行判断语句
    11
  • 6
    【Docker】（3）学习Docker中 镜像与容器数据卷、映射关系！手把手带你安装 MySql主从同步 和 Redis三主三从集群！并且进行主从切换与扩容操作，还有分析 哈希分区 等知识点！
    12
  • 7
    【Golang】（2）变量与常量？字面量与变量的较量！
    12
  • 8
    【Java】（9）抽象类、接口、内部的运用与作用分析，枚举类型的使用
    14
  • 9
    【JUC】（2）共享问题解决与synchronized对象锁分析！全程干货！！快快收藏！！
    12
  • 10
    【JUC】（3）常见的设计模式概念分析与多把锁使用场景！！理解线程状态转换条件！带你深入JUC！！文章全程笔记干货！！
    16

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    深度 | 从0到3.0，揭秘阿里云洛神云网络的进化之路