Web 中间件怎么玩?

本次主要是聊聊关于 web 中间件, 分为如下四个方面

  • 什么是 web 框架中间件
  • 为什么要使用 web 中间件
  • 如何使用及其原理
  • 哪些场景需要使用中间件

开门见山 web 中间件是啥

Web 框架中的中间件主要指的是在 web 请求到具体路由之前或者之后,会经过一个或者多个组件进行处理一些必要的公共逻辑(业务相关或者与业务无关的),而处理这些事项的部分,就称为 web 中间件

那是否会有这样的疑问?

明明就能直接请求到具体的路由,为什么要在它之前加一个中间件?

这是在增加程序复杂度?有啥事情不能直接在路由中做的吗?

我们可以带着这个问题继续往下看

为什么要使用中间件

一般很多技术或者很多组件大多是因为现有的工具无法满足日益正常的需求而慢慢出现的

例如

在 web 中需要对多个路由或者业务进行解耦,或者需要在多个路由之前或者之后加上一些统一的逻辑,这个时候就需要中间件来进行处理

又例如

我们的 web 服务需要有限流功能

如果我们 web 框架中只有几个路由,那么很简单,可能你会去对每个路由进行限流,那么如果是达到几十上百个路由你还会这样做吗?

如果已经有几十上百个路由了,需要针对所有路由统计一下程序处理时长,那么,这个时候你会去给这些路由一个一个的去复制粘贴代码吗?

正常人自然是不会的,我们会想办法寻求简单高效且保证质量的方式,明明使用一个中间件就能搞定的事情,何必去做无意义的卷王

多多提高效率去做更多有意义的事情不香吗?

中间件如何使用及其原理

此处咱们使用大名鼎鼎的高性能 web 框架 Gin 框架来举例子,使用 Gin 框架

Gin 中的中间件实际上就是一个 RouterGroup 对应的 handers 调用链 ,我们先来看一个例子,自定义两个最简单的中间件,先写一个 main

func main() {
   log.SetFlags(log.Lshortfile)
   r := gin.New()
   r.Use(Demo2())
   r.Use(Demo1())

   r.GET("/test", func(c *gin.Context) {
      log.Println("----inner test----")
      c.JSON(200, gin.H{
         "message": "demo",
      })
   })

   // 监听8080 端口
   r.Run(":8080")
}

Main 函数中,我们可以看到,开启了一个 web 服务,监听的端口是 8080,其中使用 Use 方法关联了 2 个中间件,分别是 Demo2 和 Demo1

Gin 框架中,先新建一个引擎,然后通过 Use 方法来将中间件和路由关联起来,这些中间件会对于每一个请求形成一个调用链

此处的调用链就是通过 Use 方法中使用 append 来进行追加的

// Use adds middleware to the group, see example code in GitHub.
func (group *RouterGroup) Use(middleware ...HandlerFunc) IRoutes {
   group.Handlers = append(group.Handlers, middleware...)
   return group.returnObj()
}

因此,对于我们自定义的中间件,先关联的中间件就先执行,后关联的中间件就后执行,这里我们简单写了两个自定义中间件

中间件,实际上就是去写一个这样的函数

// HandlerFunc defines the handler used by gin middleware as return value.
type HandlerFunc func(*Context)

对于 Demo1 自定义中间件实现是这样的

  • 代码在 c.Next() 前的会在请求具体接口之前进行运行
  • 在代码 c.Next() 后的代码会在执行完具体接口之后执行

可以看到此处我们简单的添加了打印,以及记录接口执行的时间

func Demo1() gin.HandlerFunc {
   return func(c *gin.Context) {
      // 请求接口之前
      a := time.Now()
      log.Println("--before--demo1----")
      c.Next()
      // 请求接口之后
      log.Println("--after--demo1----")
      dur := time.Since(a)
      log.Println("req Time consuming : ",dur)
   }
}

Demo2 也是类似的逻辑,仅仅是添加一些打印

[图片上传失败...(image-a0bb59-1696079927343)]

程序运行起来,我们请求localhost:8080/test 接口,即可查看到我们的打印信息如下

[图片上传失败...(image-87907e-1696079927343)]

细心的朋友可以看出来,此处的中间件的执行顺序很明显是一个先进后出的效果,没错,此处的中间件确实做法如此

[图片上传失败...(image-d3ae84-1696079927343)]

可以看到,执行顺序是这样的Demo2 -> Demo1 -> /test 路由 -> Demo1 -> Demo2

那么对于 Gin 的中间件具体是个啥,如何使用你也会,是不是中间件不就那么回事呢?

自然,此处仅仅是做一个抛砖引玉,让不知 web 中间件的人知道其具体是何物

如果要深入研究,可以查看 Gin 的源码,还是非常有意思的,如果有必要,以后可以写一篇关于核心源码深入解读的

哪一些场景可以使用 web 中间件?

  • 接口限流场景

Gin 中有现成的限流组件 golang.org/x/time/rate , 具体关于限流相关的知识可以查看文末相关链接

  • 数据打点场景

例如记录接口响应时长,请求路由结果,一般这种打点数据数据会写到日志中,另外系统中有另外一个应用会来扫日志里面的记录,最终推到具体做日志分析和聚合的组件上

例如相关的组件就有 prometheus ,grafana 等等

  • 接口认证场景

例如 web 框架中需要做鉴权,例如接口需要校验 token 才能进入到具体的路由去做实际的业务,就可以把鉴权放到中间件中进行处理

  • 链路跟踪

对每一个请求都去带上 span ,实际上都是放到 ctx 来做文章,便于排查问题时,直接就可以看到整条链路中哪个节点出现了问题

  • 数据压缩,数据预处理等等,欢迎 xdm 进行补充哦

感谢阅读,欢迎交流,点个赞,关注一波 再走吧

欢迎点赞,关注,收藏

朋友们,你的支持和鼓励,是我坚持分享,提高质量的动力

[图片上传失败...(image-659eaa-1696079927343)]

技术是开放的,我们的心态,更应是开放的。拥抱变化,向阳而生,努力向前行。

我是阿兵云原生,欢迎点赞关注收藏,下次见~

文中提到的技术点,感兴趣的可以查看这些文章:

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,544评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,430评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,764评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,193评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,216评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,182评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,063评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,917评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,329评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,543评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,722评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,425评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,019评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,671评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,825评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,729评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,614评论 2 353

推荐阅读更多精彩内容