BeegoAutoRouter工作原理解析
来源:脚本之家
时间:2022-12-29 21:37:04 111浏览 收藏
本篇文章给大家分享《BeegoAutoRouter工作原理解析》,覆盖了Golang的常见基础知识,其实一个语言的全部知识点一篇文章是不可能说完的,但希望通过这些问题,让读者对自己的掌握程度有一定的认识(B 数),从而弥补自己的不足,更好的掌握它。
一、前言 🎈
Beego Web框架应该是国内Go语言社区第一个框架,个人觉得十分适合新手入门Go Web。笔者半年前写过一篇搭建Beego项目并实习简单功能的文章,大家有兴趣可以先看看。
其实我接触的大部分人都在学校学过Java Web,其实有Java Web的经验,上手Beego也会很舒服。
本文着重讲讲Beego的AutoRouter模块,会结合源码来讲讲,不过由于笔者技术水平有限,如有错误,烦请指出。🎉
二、从一个例子入手✨
Beego的路由设计灵感是sinatra,刚开始并不支持自动路由,项目的每一个路由都需要开发者配置。
🎃 不过,在Beego里面注册一个路由是十分简单的,不信你看:
import "github.com/beego/beego/v2/server/web" type ReganYueController struct { web.Controller }
接下来我们可以添加一个方法,也可以重写Get,Post,Delete等方法来响应客户端不同的请求方式。
import "github.com/beego/beego/v2/server/web" type ReganYueController struct { web.Controller } func (u *ReganYueController) HelloWorld() { u.Ctx.WriteString("Welcome, Regan Yue") } func main() { web.AutoRouter(&ReganYueController{}) web.Run() }
该处web.AutoRouter(&ReganYueController{})
就是使用的自动路由,如果是以前的话,我们还需要配置路由🥶 。例如以下这种形式:
beego.Router("/", &IndexController{})
对于下面这段代码,有几点需要注意:
func (u *ReganYueController) HelloWorld() { u.Ctx.WriteString("Welcome, Regan Yue") }
⏰这个处理HTTP请求的方法必须是公共方法(首字母要大写),并且不能有参数,不能有返回值,若非如此,可能会发生Panic。
🎨AutoRouter的解析规则:
影响因素有三:
RouterCaseSensitive
的值。Controller
的名字- 方法名字
比如我们上面ReganYueController的名字是ReganYue,而方法名字是HelloWorld,那么就会有以下几种情况出现:
- 如果
RouterCaseSensitive
为true
,那么AutoRouter就会注册两个路由,其中一个是/ReganYue/HelloWorld/*
,另一个是/reganyue/helloworld/*
。 - 如果
RouterCaseSensitive
为false
,那么AutoRouter只会注册一个路由,即/reganyue/helloworld/*
。
三、AutoRouter是如何工作的
先看看web.AutoRouter()
// AutoRouter see HttpServer.AutoRouter func AutoRouter(c ControllerInterface) *HttpServer { return BeeApp.AutoRouter(c) }
web.AutoRouter()
马上又指向(app *HttpServer) AutoRouter(c ControllerInterface)
// AutoRouter adds defined controller handler to BeeApp. // it's same to HttpServer.AutoRouter. // if beego.AddAuto(&MainContorlller{}) and MainController has methods List and Page, // visit the url /main/list to exec List function or /main/page to exec Page function. func (app *HttpServer) AutoRouter(c ControllerInterface) *HttpServer { app.Handlers.AddAuto(c) return app }
前面传来的主语BeeApp
执行该处程序:
BeeApp是一个应用实例,使用NewHttpSever()创建,继续跟进,发现是根据Bconfig
这个配置文件创建的,
// NewHttpServerWithCfg will create an sever with specific cfg func NewHttpServerWithCfg(cfg *Config) *HttpServer { cr := NewControllerRegisterWithCfg(cfg) app := &HttpServer{ Handlers: cr, Server: &http.Server{}, Cfg: cfg, } return app }
上图即配置Bconfig的主要结构。
到此我们对于BeeApp已经有一定了解了,下面我们回过头来看看app.Handlers.AddAuto(c)
。
先看看这个c
是什么,它的类型是ControllerInterface
,我们现在进去看看。
这个c是用来统一所有controller handler的接口。
根据上图我们可以知道,这个app.Handles就是ControllerRegister,再来看看ControllerRegister的AddAuto方法:
func (p *ControllerRegister) AddAuto(c ControllerInterface) { p.AddAutoPrefix("/", c) }
AddAuto又指向AddAutoPrefix,这个AddAutoPrefix有什么用,我们先给出一个例子,然后再来看源码。
beego.AddAutoPrefix("/admin",&MainContorlller{})
如果MainContorlller
有两个方法List
、Page
。那么我们可以访问/admin/main/list
来执行List
函数,访问/admin/main/page
来执行Page
函数
来看看ControllerRegister的AddAutoPrefix方法:
func (p *ControllerRegister) AddAutoPrefix(prefix string, c ControllerInterface) { //对传入的Controller做反射 reflectVal := reflect.ValueOf(c) //获取传入的Controller的类型 rt := reflectVal.Type() //因为c是指针,所以要用Indirect方法获取指针指向的变量类型 ct := reflect.Indirect(reflectVal).Type() //使用Beego注册controller的名称后面有Controller,这里把它去掉得到controllerName。 controllerName := strings.TrimSuffix(ct.Name(), "Controller") // for i := 0; i
reflectVal.Type()
直接的获取传入的Controller的类型,而reflect.Indirect(reflectVal).Type()
,interface其实就是两个指针,一个指向类型信息,一个指向实际的对象,用Indirect方法获取指针指向的实际变量的类型。在
runtime/runtime2.go
可以了解interface其实就是两个指针:type iface struct { tab *itab //类型信息 data unsafe.Pointer //实际对象指针 } type itab struct { inter *interfacetype //接口类型 _type *_type //实际对象类型 hash uint32 _ [4]byte fun [1]uintptr //实际对象方法地址 }接下来是
for i := 0; i ,我们来看看这个
NumMethod()
,可以看到这个方法获得interface类型的方法数量。
utils.InSlice()方法正如其名:
func InSlice(v string, sl []string) bool { for _, vv := range sl { if vv == v { return true } } return false }该方法是用来判断字符串v是不是在字符串切片sl里面。
此处判断方法名是不是在exceptMethod里面。
下面是exceptMethod的内容:
exceptMethod = []string{"Init", "Prepare", "Finish", "Render", "RenderString", "RenderBytes", "Redirect", "Abort", "StopRun", "UrlFor", "ServeJSON", "ServeJSONP", "ServeYAML", "ServeXML", "Input", "ParseForm", "GetString", "GetStrings", "GetInt", "GetBool", "GetFloat", "GetFile", "SaveToFile", "StartSession", "SetSession", "GetSession", "DelSession", "SessionRegenerateID", "DestroySession", "IsAjax", "GetSecureCookie", "SetSecureCookie", "XsrfToken", "CheckXsrfCookie", "XsrfFormHtml", "GetControllerAndAction", "ServeFormatted"}接下来创建了一个结构体,记录了controller的信息,下面几行代码就生成了每个方法对应的controller信息。
controller的pattern这里生成了4个模式:
- prefix/全小写的controllerName/全小写的方法名/*
- prefix/controllerName/方法名/*
- prefix/全小写的controllerName/全小写的方法名
- prefix/controllerName/方法名
然后对每一种HTTP方法:
都使用addToRouter
方法用四种模式执行一遍。
下面看看addToRouter。
func (p *ControllerRegister) addToRouter(method, pattern string, r *ControllerInfo) { if !p.cfg.RouterCaseSensitive { pattern = strings.ToLower(pattern) } if t, ok := p.routers[method]; ok { t.AddRouter(pattern, r) } else { t := NewTree() t.AddRouter(pattern, r) p.routers[method] = t } }
- 如果
RouterCaseSensitive
为true
,那么AutoRouter就会注册两个路由,其中一个是/ReganYue/HelloWorld/*
,另一个是/reganyue/helloworld/*
。 - 如果
RouterCaseSensitive
为false
,那么AutoRouter只会注册一个路由,即/reganyue/helloworld/*
。
然后将method传给ControllerRegister,看是不是注册成功。
成功就执行:t.AddRouter(pattern, r)
添加路由。
否则就执行:
t := NewTree() t.AddRouter(pattern, r) p.routers[method] = t
那就到此为止吧,
再爱就不礼貌了...
结语
本文通过源码解析,从一个例子入手,了解Beego的AutoRouter模块是如何工作的,以上就是Beego AutoRouter工作原理解析的详细内容,更多关于Beego AutoRouter工作原理的资料请关注golang学习网其它相关文章!
终于介绍完啦!小伙伴们,这篇关于《BeegoAutoRouter工作原理解析》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识,快来关注吧!
-
505 收藏
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
382 收藏
-
163 收藏
-
370 收藏
-
201 收藏
-
102 收藏
-
467 收藏
-
469 收藏
-
148 收藏
-
250 收藏
-
350 收藏
-
206 收藏
-
467 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 508次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习
-
- 感动的芝麻
- 这篇技术文章真及时,博主加油!
- 2023-04-17 19:36:01
-
- 沉默的小刺猬
- 这篇文章真是及时雨啊,好细啊,受益颇多,码住,关注up主了!希望up主能多写Golang相关的文章。
- 2023-03-22 03:48:15
-
- 陶醉的鼠标
- 赞 👍👍,一直没懂这个问题,但其实工作中常常有遇到...不过今天到这,帮助很大,总算是懂了,感谢作者分享文章!
- 2023-03-18 06:47:26
-
- 开放的白昼
- 太细致了,已收藏,感谢博主的这篇文章,我会继续支持!
- 2023-03-09 10:46:10
-
- 强健的夕阳
- 这篇技术贴真及时,太全面了,很棒,码起来,关注作者了!希望作者能多写Golang相关的文章。
- 2023-01-01 22:46:57
-
- 复杂的抽屉
- 写的不错,一直没懂这个问题,但其实工作中常常有遇到...不过今天到这,看完之后很有帮助,总算是懂了,感谢大佬分享技术贴!
- 2022-12-31 18:51:32
-
- 重要的楼房
- 太全面了,收藏了,感谢作者大大的这篇文章内容,我会继续支持!
- 2022-12-31 01:37:47