多图详解万星 Restful 框架原理与实现
rest框架概览
我们先通过 go-zero
自带的命令行工具 goctl
来生成一个 api service
,其 main
函数如下:
func main() {
flag.Parse()
var c config.Config
conf.MustLoad(*configFile, &c)
ctx := svc.NewServiceContext(c)
server := rest.MustNewServer(c.RestConf)
defer server.Stop()
handler.RegisterHandlers(server, ctx)
fmt.Printf("Starting server at %s:%d...\n", c.Host, c.Port)
server.Start()
}
- 解析配置文件
- 将配置文件传入,初始化
serviceContext
- 初始化
rest server
- 将
context
注入server
中:- 注册路由
- 将
context
中的启动的endpoint
同时注入到router
当中
- 启动
server
接下来我们来一步步讲解其设计原理!Let's Go!
web框架
从日常开发经验来说,一个好的 web 框架大致需要满足以下特性:
- 路由匹配/多路由支持
- 支持自定义中间件
- 框架和业务开发完全解耦,方便开发者快速开发
- 参数校验/匹配
- 监控/日志/指标等服务自查功能
- 服务自保护(熔断/限流)
go-zero rest设计
概览
- 借助 context (不同于 gin 的 context),将资源初始化好 → 保存在
serviveCtx
中,在 handler 中共享(至于资源池化,交给资源自己处理,serviveCtx
只是入口和共享点) - 独立 router 声明文件,同时加入 router group 的概念,方便开发者整理代码结构
- 内置若干中间件:监控/熔断/鉴权等
- 利用 goctl codegen + option 设计模式,方便开发者自己控制部分中间件的接入
上图描述了 rest 处理请求的模式和大部分处理路径。
- 框架内置的中间件已经帮开发者解决了大部分服务自处理的逻辑
- 同时 go-zero 在
business logic
处也给予开发者开箱即用的组件(dq、fx 等) - 从开发模式上帮助开发者只需要关注自己的
business logic
以及所需资源准备
下面我们来细说一下整个 rest 是如何启动的?
启动流程
上图描述了整体 server 启动经过的模块和大致流程。准备按照如下流程分析 rest 实现:
- 基于 http.server 封装以及改造:把 engine(web框架核心) 和 option 隔离开
- 多路由匹配采取 radix-tree 构造
- 中间件采用洋葱模型 →
[]Middleware
- http parse 解析以及匹配校验 →
httpx.Parse()
- 在请求过程会收集指标 (
createMetrics()
) 以及监控埋点 (prometheus)
server engine封装
点开大图观看
engine 贯穿整个 server 生命周期中:
- router 会携带开发者定义的 path/handler,会在最后的 router.handle() 执行
- 注册的自定义中间件 + 框架中间件,在 router handler logic 前执行
在这里:go-zero 处理的粒度在 route 上,封装和处理都在 route 一层层执行
路由匹配
那么当 request 到来,首先是如何到路由这一层的?
首先在开发最原始的 http server ,都有这么一段代码:
type helloHandler struct{}
func (h *helloHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello, world!"))
}
func main() {
http.Handle("/", &helloHandler{})
http.ListenAndServe(":12345", nil)
}
http.ListenAndServe()
内部会执行到:server.ListenAndServe()
我们看看在 rest 里面是怎么运用的:
而传入的 handler 其实就是:router.NewRouter() 生成的 router。这个 router 承载了整个 server 的处理函数集合。
同时 http.Server 结构在初始化时,是把 handler 注入到里面的:
type Server struct {
...
Handler Handler
}
func start(..., handler http.Handler, run func(srv *http.Server) error) (err error) {
server := &http.Server{
Addr: fmt.Sprintf("%s:%d", host, port),
Handler: handler,
}
...
return run(server)
}
在 http.Server 接收 req 后,最终执行的也是:handler.ServeHTTP(rw, req)
所以内置的 router 也需要实现 ServeHTTP
。至于 router 自己是怎么实现 ServeHTTP
:无外乎就是寻找匹配路由,然后执行路由对应的 handle logic。
解析参数
解析参数是 http 框架需要提供的基本能力。在 goctl code gen 生成的代码中,handler 层已经集成了 req argument parse 函数:
// generate by goctl
func QueryAllTaskHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
// custom request in .api file
var req types.QueryAllTaskRequest
// parse http request
if err := httpx.Parse(r, &req); err != nil {
httpx.Error(w, err)
return
}
l := logic.NewEventLogic(r.Context(), ctx)
resp, err := l.QueryAllTask(req)
baseresponse.FormatResponseWithRequest(resp, err, w, r)
}
}
进入到 httpx.Parse()
,主要解析以下几块:
https://github.com/zeromicro/go-zero/blob/master/rest/httpx/requests.go#L32:6
- 解析path
- 解析form表单
- 解析http header
- 解析json
Parse() 中的 参数校验 的功能见:
https://go-zero.dev/cn/api-grammar.html 中的
tag修饰符
Tips
学习源码推荐 fork 出来边看边写注释和心得,可以加深理解,以后用到这块功能的时候也可以回头翻阅。
项目地址
https://github.com/zeromicro/go-zero
欢迎使用 go-zero
并 star 支持我们!
多图详解万星 Restful 框架原理与实现的更多相关文章
- SPI总线协议及SPI时序图详解
SPI,是英语Serial Peripheral Interface的缩写,顾名思义就是串行外围设备接口.SPI,是一种高速的,全双工,同步的通信总线,并且在芯片的管脚上只占用四根线,节约了芯片的管脚 ...
- (转)CAS (4) —— CAS浏览器SSO访问顺序图详解(CAS Web Flow Diagram by Example)
CAS (4) —— CAS浏览器SSO访问顺序图详解(CAS Web Flow Diagram by Example) tomcat版本: tomcat-8.0.29 jdk版本: jdk1.8.0 ...
- SPI总线协议及SPI时序图详解【转】
转自:https://www.cnblogs.com/adylee/p/5399742.html SPI,是英语Serial Peripheral Interface的缩写,顾名思义就是串行外围设备接 ...
- 十图详解tensorflow数据读取机制(附代码)转知乎
十图详解tensorflow数据读取机制(附代码) - 何之源的文章 - 知乎 https://zhuanlan.zhihu.com/p/27238630
- CAS (6) —— Nginx代理模式下浏览器访问CAS服务器网络顺序图详解
CAS (6) -- Nginx代理模式下浏览器访问CAS服务器网络顺序图详解 tomcat版本: tomcat-8.0.29 jdk版本: jdk1.8.0_65 nginx版本: nginx-1. ...
- CAS (4) —— CAS浏览器SSO访问顺序图详解(CAS Web Flow Diagram by Example)
CAS (4) -- CAS浏览器SSO访问顺序图详解(CAS Web Flow Diagram by Example) tomcat版本: tomcat-8.0.29 jdk版本: jdk1.8.0 ...
- UML类图详解_关联关系_一对多
对于一对多的示例,可以想象一个账户可以多次申购.在申购的时候没有固定上限,下限为0,那么就可以使用容器类(container class)来搞,最常见的就是vector了. 下面我们来看一个“一对多” ...
- UML类图详解_关联关系_多对一
首先先来明确一个概念,即多重性.什么是多重性呢?多重性是指两个对象之间的链接数目,表示法是“下限...上限”,最小数据为零(0),最大数目为没有设限(*),如果仅标示一个数目级上下限相同. 实际在UM ...
- UML简单介绍—类图详解
类图详解 阅读本文前请先阅读:UML简单介绍—类图这么看就懂了 1.泛化关系 一个动物类: /** * 动物类 */ public class Animal { public String name; ...
随机推荐
- xmake v2.5.7 发布,包依赖锁定和 Vala/Metal 语言编译支持
xmake 是一个基于 Lua 的轻量级跨平台构建工具,使用 xmake.lua 维护项目构建,相比 makefile/CMakeLists.txt,配置语法更加简洁直观,对新手非常友好,短时间内就能 ...
- JS方式实现隐藏手机号码中间4位数
1.截取 function test (value) { const start = value.slice(0, 3) const end = value.slice(-4) return `${s ...
- 《网页布局基础篇》HTML+CSS单列布局--水平居中,垂直居中,水平垂直居中
https://blog.csdn.net/panlu666_pl/article/details/66480433 一.水平居中 子元素在父元素中水平居中 1.使用 text-align和inlin ...
- 如何将excel中纵向的转换成横向保证格式不变,
先选定,复制,然后用--编辑---选择性粘贴--转置--确定.试试能不能实现 ,能把文件发过来看一下
- Powershell免杀从入门到实践
转载https://www.jianshu.com/p/fb078a99e0d8 前言 文章首发于Freebuf 在之前发布的一篇 渗透技巧之Powershell实战思路 中,学习了powershel ...
- 区间DP的瞎扯淡
写在前面连个引言都不加就直接开1. 区间DP状态常见模板: f[i][j]常常表示第i个到第j个这个区间内达到题目要求,所需要的最小值(最大值) 如: 1. [石子合并](https://www.lu ...
- kivy之ProgressBar、ToggleButton实操学习
之所以将kivy的ProgressBar(进度条)与ToggleButton(切换按钮)作一篇内容来记录学习,是因为这两个内容比较简单,源码内容篇幅也少. 两个功能实例源码均以main.py+prog ...
- C语言实现有限状态机
1. 什么是有限状态机 有限状态机在百度百科上的解释为: 有限状态自动机(FSM "finite state machine" 或者FSA "finite state a ...
- 三剑客之sed编辑器 基操
目录: 一.sed编辑器 二.打印内容 三.使用地址 四.删除行 五.替换 六.插入 一.sed编辑器 sed是一种流编辑器,流编辑器会在编辑器处理数据之前基于预先提供的一组规则来编辑数据流. sed ...
- AWVS13批量添加目标脚本
# -*-coding:utf-8-*- # @Author:malphite.tang import json import requests from queue import Queue req ...