6-Gin 路由详解 --[Gin 框架入门精讲与实战案例]

Gin 是一个用 Go 语言编写的 HTTP Web 框架,以其高性能和简洁的 API 而闻名。它提供了一套强大的路由功能,使得开发者可以轻松地定义 URL 路由规则,并将这些规则映射到具体的处理函数(handler)。以下是关于 Gin 路由的详细解析:

1. 基本路由

Gin 允许你非常简单地定义基本的路由。你可以为不同的 HTTP 方法(如 GET、POST 等)指定路径和相应的处理器。

package mainimport ("github.com/gin-gonic/gin"
)// main 是程序的入口点
func main() {// 创建一个默认的 Gin 路由器router := gin.Default()// 定义根路径的 GET 请求处理函数router.GET("/", func(c *gin.Context) {// 返回 HTTP 200 状态码和 "Hello World!" 字符串响应c.String(200, "Hello World!")})// 定义 /submit 路径的 POST 请求处理函数router.POST("/submit", func(c *gin.Context) {// 返回 HTTP 200 状态码和一个 JSON 响应,包含消息 "Form submitted"c.JSON(200, gin.H{"message": "Form submitted",})})// 监听并在 0.0.0.0:8080 上启动服务router.Run(":8080")
}

在这里插入图片描述

2. 参数化路由

Gin 支持在路径中使用参数,这允许你创建动态路由。

package mainimport ("github.com/gin-gonic/gin"
)// main 是程序的入口点
func main() {// 创建一个默认的 Gin 路由器router := gin.Default()// 路由处理函数,用于响应带有具体用户ID的GET请求router.GET("/user/:id", func(c *gin.Context) {// 提取URL参数中的id值id := c.Param("id")// 返回用户ID信息c.String(200, "User ID is %s", id)})// 使用通配符 :name 匹配任意字符直到斜杠或结尾router.GET("/file/*filepath", func(c *gin.Context) {// 提取URL参数中的filepath值filepath := c.Param("filepath")// 返回文件路径信息c.String(200, "File path is %s", filepath)})// 监听并在 0.0.0.0:8080 上启动服务router.Run(":8080")
}

在这里插入图片描述

3. 查询参数

除了路径参数外,还可以通过 c.Query() 方法获取 URL 查询参数。

package mainimport ("github.com/gin-gonic/gin"
)// main 是程序的入口点
func main() {// 创建一个默认的 Gin 路由器router := gin.Default()// RouterGET为/search路径定义了一个处理函数,用于处理GET请求。// 该函数接收一个*gin.Context参数c,代表HTTP请求的上下文。// 参数c包含了请求、响应、HTTP头等信息,并且是处理请求和写入响应的核心对象。router.GET("/search", func(c *gin.Context) {// 使用c.Query方法从请求的查询字符串中获取名为'q'的值。// 如果'q'不存在,该方法返回一个空字符串。query := c.Query("q")// 使用c.String方法向HTTP响应中写入一个格式化后的字符串。// 该方法的参数包括HTTP状态码(此处为200,表示OK)和格式化字符串以及相应的参数。c.String(200, "Search query is %s", query)})// 监听并在 0.0.0.0:8080 上启动服务router.Run(":8080")
}

在这里插入图片描述

4. 表单数据

对于 POST 请求,可以使用 c.PostForm() 来获取表单字段。

package mainimport ("github.com/gin-gonic/gin"
)// main 是程序的入口点
func main() {// 创建一个默认的 Gin 路由器router := gin.Default()// 处理 POST 请求的路由router.POST("/form", func(c *gin.Context) {// 获取表单数据中的 name 字段name := c.PostForm("name")// 获取表单数据中的 age 字段age := c.PostForm("age")// 返回处理结果c.String(200, "Name: %s, Age: %s", name, age)})// 监听并在 0.0.0.0:8080 上启动服务router.Run(":8080")
}

在这里插入图片描述

5. 分组路由

为了更好地组织代码,可以使用 Group 创建一组具有相同前缀的路由。

package mainimport ("github.com/gin-gonic/gin"
)func main() {// 创建默认的路由引擎router := gin.Default()// 创建一个名为 "api" 的分组路由,所有以 /api 开头的 URL 都会进入这个分组api := router.Group("/api"){// 为整个分组添加一个简单的日志中间件api.Use(func(c *gin.Context) {fmt.Println("API Middleware Called")c.Next()})// 定义一个 GET 路由,用于获取所有用户api.GET("/users", getUsers)// 定义一个带参数的 GET 路由,用于根据 ID 获取单个用户api.GET("/users/:id", getUserByID)}// 启动 HTTP 服务,默认监听端口是 8080router.Run(":8080")
}// 模拟获取所有用户的处理器
func getUsers(c *gin.Context) {users := []string{"Alice", "Bob", "Charlie"}c.JSON(200, users)
}// 模拟根据 ID 获取单个用户的处理器
func getUserByID(c *gin.Context) {id := c.Param("id")user := "User with ID " + idc.JSON(200, gin.H{"user": user})
}

在这里插入图片描述

6. 中间件

Gin 提供了中间件机制,可以在请求到达最终处理器之前对请求进行预处理。

package mainimport ("fmt""time""github.com/gin-gonic/gin"
)func main() {// 创建默认的路由引擎router := gin.Default()// 定义一个全局中间件,用于记录所有请求的时间戳和耗时router.Use(Logger())// 定义一个 GET 路由,访问根路径时返回 "Hello World!"router.GET("/", func(c *gin.Context) {c.String(200, "Hello World!")})// 定义另一个 GET 路由,模拟处理较慢的请求router.GET("/slow", func(c *gin.Context) {time.Sleep(2 * time.Second)c.String(200, "This was a slow request.")})// 启动 HTTP 服务,默认监听端口是 8080router.Run(":8080")
}// Logger 是一个自定义的中间件函数
func Logger() gin.HandlerFunc {return func(c *gin.Context) {// 记录开始时间start := time.Now()path := c.Request.URL.Pathraw := c.Request.URL.RawQuery// 处理请求前的操作fmt.Printf("Started %s %s\n", c.Request.Method, path)// 将请求传递给下一个中间件或处理器c.Next()// 处理请求后的操作end := time.Since(start)fmt.Printf("Completed %s in %v\n", path, end)// 如果有查询参数,则打印出来if raw != "" {fmt.Printf("With query: %s\n", raw)}}
}

在这里插入图片描述

7. 静态文件服务

在 Gin 框架中提供静态文件服务(如图片、CSS 文件、JavaScript 文件等)非常简单。你可以使用 router.Static() 方法来指定一个 URL 路径前缀和本地文件系统的目录,从而将静态文件暴露给客户端。

下面是一个简单的 Gin 应用程序示例,它展示了如何设置静态文件服务。

示例:Gin 静态文件服务简单示例

创建项目结构

首先,创建如下所示的项目结构:

my-gin-app/
├── main.go
└── static/├── css/│   └── style.css├── js/│   └── script.js└── images/└── logo.png

在这个例子中,static 文件夹包含了 CSS、JavaScript 和图片文件。

创建 main.go 文件

接下来,在 main.go 文件中编写代码来配置 Gin 以提供静态文件服务。

package mainimport ("github.com/gin-gonic/gin"
)func main() {// 创建默认的路由引擎router := gin.Default()// 提供静态文件服务// 这里的第一个参数是 URL 路径前缀,第二个参数是本地文件系统中的目录路径。// 访问 http://localhost:8080/static/css/style.css 将会返回 ./static/css/style.css 文件router.Static("/static", "./static")// 定义一个简单的根路径处理器,用于展示如何链接到静态资源router.GET("/", func(c *gin.Context) {c.HTML(200, "index.tmpl", nil)})// 加载 HTML 模板router.LoadHTMLGlob("templates/*")// 启动 HTTP 服务,默认监听端口是 8080router.Run(":8080")
}
创建 HTML 模板

为了展示如何链接到静态资源,我们还需要创建一个简单的 HTML 模板。在项目的根目录下创建一个名为 templates 的文件夹,并在里面添加一个名为 index.tmpl 的文件:

<!-- templates/index.tmpl -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Gin Static Files Example</title><!-- 链接到静态 CSS 文件 --><link rel="stylesheet" href="/static/css/style.css">
</head>
<body><h1>Welcome to the Gin Static Files Example!</h1><p>This page uses static files served by Gin.</p><!-- 显示静态图片 --><img src="/static/images/logo.png" alt="Logo"><!-- 包含静态 JavaScript 文件 --><script src="/static/js/script.js"></script>
</body>
</html>
添加静态资源

确保你的 static 文件夹中有以下内容:

  • static/css/style.css:包含一些基本的样式规则。

    /* static/css/style.css */
    body {font-family: Arial, sans-serif;text-align: center;margin-top: 50px;
    }
    h1 {color: #333;
    }
    
  • static/js/script.js:包含一段简单的 JavaScript 代码。

    // static/js/script.js
    console.log('Static JavaScript file loaded.');
    
  • static/images/logo.png:放置一张你想要显示的图片。

测试你的应用

保存所有文件后,在终端中运行以下命令启动应用程序:

go run main.go

然后你可以使用浏览器访问 http://localhost:8080/ 来查看页面。你应该能够看到样式化的 HTML 页面,并且控制台中会有来自 JavaScript 文件的日志信息。此外,页面上应该正确显示了 logo.png 图片。

总结

通过上述步骤,我们创建了一个简单的 Gin 应用程序,它可以提供静态文件服务。使用 router.Static() 方法可以轻松地将本地文件夹中的静态资源映射到 Web 上的 URL 路径。这对于开发和测试来说非常方便,也可以直接部署到生产环境中。

在这里插入图片描述

8. 错误处理

虽然 Gin 默认提供了简单的错误处理,但你也可以自定义错误页面或全局错误处理逻辑。

package mainimport ("fmt""net/http""github.com/gin-gonic/gin"
)func main() {// 创建默认的路由引擎router := gin.Default()// 定义一个 GET 路由,访问根路径时返回 "Hello World!"router.GET("/", func(c *gin.Context) {c.String(http.StatusOK, "Hello World!")})// 定义一个可能引发错误的 GET 路由router.GET("/error", func(c *gin.Context) {// 模拟一个可能导致 panic 的操作panic("Something went wrong!")})// 自定义 404 页面router.NoRoute(func(c *gin.Context) {c.JSON(http.StatusNotFound, gin.H{"code":    http.StatusNotFound,"message": "Sorry, the page you're looking for doesn't exist.",})})// 使用 recover 中间件来捕获任何导致 panic 的错误,并返回 500 状态码router.Use(func(c *gin.Context) {defer func() {if err := recover(); err != nil {// 如果发生 panic,记录错误信息并返回 500 状态码fmt.Printf("Panic occurred: %v\n", err)c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"code":    http.StatusInternalServerError,"message": "Internal Server Error",})}}()c.Next()})// 启动 HTTP 服务,默认监听端口是 8080router.Run(":8080")
}

在这里插入图片描述

9. 加载模板

如果你的应用程序需要渲染 HTML 页面,Gin 支持加载和渲染模板。

router.LoadHTMLGlob("templates/*")
router.GET("/welcome", func(c *gin.Context) {c.HTML(http.StatusOK, "welcome.tmpl", gin.H{"title": "Main website",})
})

10. CORS 中间件

跨域资源共享 (CORS) 是一个常见的需求,Gin 提供了官方的 CORS 中间件来简化配置。

router.Use(cors.New(cors.Config{AllowOrigins:     []string{"https://foo.com"},AllowMethods:     []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},AllowHeaders:     []string{"Origin", "Content-Length", "Content-Type"},ExposeHeaders:    []string{"FooBar"},AllowCredentials: true,
}))

总结

Gin 的路由系统设计得非常直观且强大,能够满足大多数 Web 应用的需求。通过上述方法,你可以轻松地构建出高效、可维护的 RESTful API 或完整的 Web 应用。根据你的具体应用场景,选择合适的路由策略和中间件组合,可以使开发过程更加流畅和高效。如果你有更复杂的需求,比如基于正则表达式的路由匹配等,Gin 也提供了足够的灵活性来进行扩展。

下载示例代码

Gin 框架入门精讲与实战案例代码

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

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

【数据库初阶】Linux中库的基础操作

&#x1f389;博主首页&#xff1a; 有趣的中国人 &#x1f389;专栏首页&#xff1a; 数据库初阶 &#x1f389;其它专栏&#xff1a; C初阶 | C进阶 | 初阶数据结构 亲爱的小伙伴们&#xff0c;大家好&#xff01;在这篇文章中&#xff0c;我们将深入浅出地为大家讲解 Linux…

使用envoyfilter添加请求头

该envoyfilter实现了这样一个功能&#xff0c;如果请求头中含有Sw8&#xff0c;则添加请求头HasSw8: true。 1. 内嵌lua脚本 apiVersion: networking.istio.io/v1alpha3 kind: EnvoyFilter metadata:name: add-header-filternamespace: demo-bookinfo # 可根据实际情况调整命…

服务器被攻击怎么办

当服务器遭受恶意流量攻击&#xff0c;如DDoS&#xff08;分布式拒绝服务&#xff09;或CC&#xff08;Challenge Collapsar&#xff09;攻击时&#xff0c;传统的防护措施可能不足以应对。此时&#xff0c;采用高防IP服务可以有效缓解攻击压力&#xff0c;确保业务连续性和数据…

03.04、化栈为队

03.04、化栈为队 1、题目描述 实现一个 MyQueue 类&#xff0c;该类用两个栈来实现一个队列。 2、解题思路 本题要求使用两个栈来实现一个队列。队列遵循先进先出&#xff08;FIFO&#xff09;的原则&#xff0c;而栈遵循后进先出&#xff08;LIFO&#xff09;的原则。因此…

【机器学习(九)】分类和回归任务-多层感知机(Multilayer Perceptron,MLP)算法-Sentosa_DSML社区版 (1)11

文章目录 一、算法概念11二、算法原理&#xff08;一&#xff09;感知机&#xff08;二&#xff09;多层感知机1、隐藏层2、激活函数sigma函数tanh函数ReLU函数 3、反向传播算法 三、算法优缺点&#xff08;一&#xff09;优点&#xff08;二&#xff09;缺点 四、MLP分类任务实…

【LLM】OpenAI 的DAY12汇总和o3介绍

note o3 体现出的编程和数学能力&#xff0c;不仅达到了 AGI 的门槛&#xff0c;甚至摸到了 ASI&#xff08;超级人工智能&#xff09;的边。 Day 1&#xff1a;o1完全版&#xff0c;开场即巅峰 12天发布会的开场即是“炸场级”更新——o1完全版。相比此前的预览版本&#x…

智能工厂的设计软件 应用场景的一个例子:为AI聊天工具添加一个知识系统 之2

前情提要 这一次我们暂时抛开前面对“智能工厂的软件设计”的考虑--其软件智能 产品就是 应用程序。直接将这些思维方式和方法论 运用在其具体应用场景中。本文是其中的一个应用场景。 今天用了 一个新的AI助手工具来交流。下面是就这一应用场景和“天意ChatGPT”&#xff08…

高斯核函数(深入浅出)

目录 定义及数学形式主要特点应用示例小结 高斯核函数&#xff08;Gaussian Kernel&#xff09;&#xff0c;又称径向基核&#xff08;Radial Basis Function Kernel&#xff0c;RBF Kernel&#xff09;&#xff0c;是机器学习与模式识别中最常用的核函数之一。它通过在高维空间…

MaixBit k210学习记录

开发背景&#xff1a;Window系统主机&#xff0c;在主机上安装了虚拟机&#xff08;VirtualBoxUbuntu23.04&#xff09; 目标实现&#xff1a;在虚拟机&#xff08;Ubuntu&#xff09;中&#xff0c;实现对Maix bit&#xff08;k210&#xff09;开发板的开发 虚拟机的安装参考…

WordPress TutorLMS插件 SQL注入漏洞复现(CVE-2024-10400)(附脚本)

0x01 产品描述: ‌Tutor LMS‌是一个功能强大的

ExpDemo-JavaFX打造属于你自己的图形化漏洞利用工具

声明&#xff01;本文章所有的工具分享仅仅只是供大家学习交流为主&#xff0c;切勿用于非法用途&#xff0c;如有任何触犯法律的行为&#xff0c;均与本人及团队无关&#xff01;&#xff01;&#xff01; 目录标题 前言编写属于你的图像化漏洞利用工具项目结构编写EXP部署 部…

串口通信标准RS232、RS422、RS485有什么区别和不同

目录 第一个区别&#xff1a;硬件管脚接口定义不同&#xff1a; 第二个区别、工作方式不同 第三个区别、通信方式不同 第四个区别&#xff0c;逻辑特性不同 第五个区别、抗干扰性、传输距离和传输速率也不同 RS-232与RS-485对比 RS-422与RS-485对比 今天给大家分享的是&…

python中的列表及操作

1、列表类型的定义 列表是序列类型的一种扩展&#xff0c;创建后可以随意被修改 使用方括号[]或list()创建&#xff0c;元素间用逗号&#xff0c;分隔 列表中各元素类型可以不同&#xff0c;无长度限制 定义示例&#xff1a; ls [88, cat, dog]2、列表的操作函数和方法 函…

银河麒麟操作系统安装达梦数据库(超详细)

目录 引言1. 前期准备1.1 安装麒麟系统1.2 下载达梦数据库安装包&#xff08;DM8&#xff09;1.3 上传安装包到麒麟系统1.4 挂载安装包&#xff08;iso&#xff09;文件1.5 配置安装用户和组1.6 创建安装路径及修改权限1.7 设置临时安装目录 2. 安装达梦数据库&#xff08;DM8&…

Linux-frp_0.61.1内网穿透的配置和使用

下载frp frp官网 https://gofrp.org/zh-cn/docs/setup/ frp安装包下载地址 https://github.com/fatedier/frp/releases?page1 下载之后在服务器上 解压 tar -zxvf frp_0.61.1_linux_amd64.tar.gztar&#xff1a;一个用于压缩和解压缩的工具。-z&#xff1a;表示使用 gzi…

【操作系统】如何创建一个守护进程

守护进程&#xff08;Daemon&#xff09;是一类在后台运行的特殊进程&#xff0c;它们通常不与任何终端或用户直接交互&#xff0c;而是执行特定的系统任务或等待系统或网络事件的发生。守护进程是操作系统中不可或缺的一部分&#xff0c;它们负责执行各种后台任务&#xff0c;…

Unity开发AR之Vuforia-MultiTarget笔记

前言 在增强现实(AR)技术蓬勃发展的今天,越来越多的开发者开始探索如何将AR应用于各种场景中。Vuforia作为一个领先的AR开发平台,为开发者提供了强大的工具和功能,使得创建AR体验变得更加简单和直观。本文将为您介绍Vuforia的基本概念、特点,以及如何配置和使用MultiTar…

python|利用ffmpeg按顺序合并指定目录内的ts文件

前言&#xff1a; 有的时候我们利用爬虫爬取到的ts文件很多&#xff0c;但ts文件只是视频片段&#xff0c;并且这些视频片段是需要按照一定的顺序合并的&#xff0c;通常ts文件合并输出格式为mp4格式 因此&#xff0c;本文介绍利用python&#xff0c;调用ffmpeg来批量的按自己…

【Python】 基于Python实现日志聚合与分析工具:利用Logstash与Fluentd构建高效分布式日志系统

《Python OpenCV从菜鸟到高手》带你进入图像处理与计算机视觉的大门! 解锁Python编程的无限可能:《奇妙的Python》带你漫游代码世界 在分布式系统中,日志数据的生成速度和数量呈指数级增长,传统的日志管理方式已无法满足现代企业对实时性、可扩展性和高效性的需求。本文深…

04.HTTPS的实现原理-HTTPS的混合加密流程

04.HTTPS的实现原理-HTTPS的混合加密流程 简介1. 非对称加密与对称加密2. 非对称加密的工作流程3. 对称加密的工作流程4. HTTPS的加密流程总结 简介 主要讲述了HTTPS的加密流程&#xff0c;包括非对称加密和对称加密两个阶段。首先&#xff0c;客户端向服务器发送请求&#xf…