go框架

beego 的 http server…

Author 逆雪寒 2015.12.02

原文地址 https://github.com/nixuehan/beego_you_know/blob/master/kernel.md

在工作中有用到golang，后来遇到了beego 重构了一下我的应用。感觉棒棒的~ 应用强壮了不少。所以我打算以最新的stable v1.5.0 来剖析下beego的源代码，因为知其然知其所以然.我们才能更好的使用beego ，同时提高我们的golang能力 。加我的群吧 一起学习 群号:511634754

* beego 的源代码里，为了让大家顺畅阅读更好理解。我会删掉那些本节我没分析到的代码。

这 节我们先从 beego 的 http server 说起。我们会抽丝剥茧，让一个最简单的的 “beego” 跑起来。最基础最核心其实就两样东西. http.Server 和 Handler 他们的关系~就类似 麦当劳 和 麦当劳里的服务员妹子。 先有了麦当劳..然后 你给钱妹子。。妹子给你冰淇淋。。也就 请求和输出..

这段是官网贴的启动beego的代码。 那我们就从 Run 这个函数开始

1. package main
3. import "github.com/astaxie/beego"
5. func main() {
6. beego.Run()
7. }

beego.go文件

2. // Run 函数 有一个可变参数 ...string 相当于 []string{} 这个不懂..那就别继续往下看了~先复习golang基础
3. // 此参数是告知 http server 要绑定的 host 和 port 。 例如: 127.0.0.1:9413
5. func Run(params ...string) {
7. if len(params) > 0 && params[0] != "" {
9. // -_- 看看人家是怎么把 地址和端口拆到两个变量里去的...
10. // HttpAddr 和 HttpPort 这两个变量是在 config.go 里定义的 大写字母开头哦~ 是全局变量
11. // 记录了http server 要绑定的地址和 端口号,方便在其他模块进行调用
13. strs := strings.Split(params[0], ":")
14. if len(strs) > 0 && strs[0] != "" {
15. HttpAddr = strs[0]
16. }
17. if len(strs) > 1 && strs[1] != "" {
18. HttpPort, _ = strconv.Atoi(strs[1])
19. }
20. }
22. //要绑定的地址和端口都得到了之后。正式启动。 调用BeeApp 里面的方法 Run
23. BeeApp.Run()
24. }

BeeApp 这个结构很重要。很多底层的都封装在这个结构里。我们看下 它的 Run 是啥东西。 BeeApp 是一个指向 App结构的变量。 在 config.go 文件里定义

config.go文件

1. var (
2. BeeApp *App

同时在 init 函数里 里进行初始化

1. // import的时候其实是执行了该包里面的init函数。。应该懂吧
2. //执行了 NewApp() 函数~ 那 NewApp 函数执行了啥呢。。我们一层一层的脱了她的衣服....接着看
3. func init() {
5. BeeApp = NewApp()

NewApp 函数定义在 app.go 文件里。 看代码…

app.go文件

1. type App struct {
2. Server *http.Server // 这个就是 麦当劳..
3. Handlers *ControllerRegistor //这个就是麦当劳里面的服务员妹子。具体代码请看后面
4. }
6. func NewApp() *App {
8. cr := NewControllerRegister() //new 一个 Handlers，方便用来处理 http服务 的输入和输出
10. //初始化了 App结构。http.Server 这个就是golang自带的http server了~ 太好理解了。这样
11. //app.Server 就是 等于 http.Server了~ 如果我们不用 beego 的时候。 写个http server
12. //是不是直接调用 http.Server.ListenAndServe()就很容易实现一个 类似nginx 的基础http 服务器
13. //那可能有的人说 http.ListenAndServe() 这样就可以啦。嗯 不过看下源代码就知道
14. //http.ListenAndServe 其实 也是调用更底层的 http.Server.ListenAndServe 。 beego
15. //为了灵活性所以用更底层的 http.Server.ListenAndServe
17. app := &App{Handlers: cr,Server: &http.Server{}}
18. return app
19. }
21. func (app *App) Run() {
23. endRunning := make(chan bool, 1)
25. go func() {
27. // 组装好绑定地址和端口
28. addr := fmt.Sprintf("%s:%d", HttpAddr, HttpPort)
30. //前面我们说了 app.Server 其实就是 http.Server。 那么我们看下官网手册 http.Server 这个结构里有啥
31. //type Server struct {
32. //Addr string // TCP address to listen on, ":http" if empty
33. //Handler Handler // handler to invoke, http.DefaultServeMux if nil
34. //ReadTimeout time.Duration // maximum duration before timing out read of the request
35. //WriteTimeout time.Duration // maximum duration before timing out write of the response
36. //MaxHeaderBytes int // maximum size of request headers, DefaultMaxHeaderBytes if 0
37. //TLSConfig *tls.Config // optional TLS config, used by ListenAndServeTLS
39. // 我们这里可以只关注。两个变量 Addr 和 Handler
40. // Addr 就是我们要绑定的地址和端口
41. // Handler 就是我们的处理器, GET POST PUT 等请求就是需要他接收和输出..
42. // 这么理解吧 http.Server 这个结构就像是麦当劳.. 而 Handler 就是服务员小妹妹，
43. // 她负责收钱 和给你冰淇淋
45. //确定要绑定ip和端口
46. app.Server.Addr = addr
47. //确定这个http容器里负责处理 输入和输出的方法.. 就是那个 麦当劳服务员小妹妹,你给她钱。她给你...
48. app.Server.Handler = app.Handlers
50. //下面就是标准的启动一个 golang http server 的流程了...
51. ln, err := net.Listen("tcp4", app.Server.Addr)
52. if err != nil {
53. endRunning <- true
54. return
55. }
56. err = app.Server.Serve(ln)
57. if err != nil {
58. endRunning <- true
59. return
60. }
61. }()
63. //channel 默认是阻塞。 利用这点。阻塞宿主程序。 否则~~ 宿主都退出了 而 go func 里面的程序~自然也就不存在了
64. <-endRunning
65. }

上面是创建了 http 服务容器。接下来就是 接待输入和输出的自定义方法。beego是怎么设计的呢。只有一个目的就是实现ServeHTTP 这个方法。只有实现了这个方法，那么才符合 app.Server.Handler = app.Handlers。我们看下官网手册 http 这节对于Handler的定义。

1. type Handler interface {
2. ServeHTTP(ResponseWriter, *Request)
3. }

其实就是一个接口。里面只有一个方法.. 你懂了吗？ interface 你可以理解为Handler发动机设计图. 无论是歼20还是歼16，只要按照图纸做出来的发动机，当然里面的细节可以根据具体的战斗机需要进行调整(实现了 ServeHTTP这个方法)..我们都可以说 这款战机的发动机是 Handler发动机 -_-! 讲了好多废话..

router.go

1. //beego 从命名中可以get到~~ 这个是控制器注册器
2. type ControllerRegistor struct {
4. }
7. //模仿 new go 例牌
8. func NewControllerRegister() *ControllerRegistor {
9. return &ControllerRegistor{}
10. }
12. //就是这个东西。http容器里的输入输出我们如何把玩？就看你怎么实现 ServeHTTP 这个方法了。
13. func (p *ControllerRegistor) ServeHTTP(rw http.ResponseWriter, r *http.Request) {
15. //在这里。你可以自由的发挥了。比如 写你自己的 路由算法 等等等...
17. //这段是我自己加的。为了能输出清晰点。。。
18. rw.Header().Set("Content-Type", "text/plain; charset=utf-8") // normal header
19. rw.WriteHeader(http.StatusOK)
20. io.WriteString(rw,"加我的群 golang 一起学习 群号:511634754")