标准库net/http包使用及工作原理

k2huang · · 1996 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

标准库net/http包使用及工作原理

一. 1个 HTTP Server的基本构成

一个Web应用从 浏览器向服务器发送请求(Request)开始,到服务器根据请求做出相应响应(Response)结束,整个流程中服务器的控制核心无疑是:服务器从HTTP Request中提取请求路径(URL)并找到对应的处理程序(Handler)处理请求,最后返回结果。

我们知道HTTP协议是基于TCP协议的,我们当然可以自己通过标准库net中提供TCP API开始写一个HTTP Server,但你不得不自己额外做的事有:

  1. 实现TCP Server监听,为每一新来的TCP link建立一个goroutine, 并在goroutine与客户端交互(不用担心单机C10K问题,因为goroutine是用户态线程,很轻量级,可以很随意就创建成千上万个)。
  2. 在每个goroutine中将TCP link中的请求数据按HTTP协议格式解析出来(可以将数据解析出成Request对象,以后的访问提供方便),并根据其URL找到相应的处理程序Handler, 因此你还需要提前建立好 URL:Handler映射表
  3. 当处理程序处理结束后,你还需要将处理结果数据按HTTP协议格式返回给客户端。代码大致如下:
//建立 URL:Handler映射表
//注意:由于table会在不同goroutine中使用,因此真正环境中需要锁保护
var table = map[string]Handler {
    "/": rootHandler,
    "/login": loginHandler,
    ... 
} 

//Server监听
ln, _ := net.Listen("tcp", ":8080")
for {
    conn, _ := ln.Accept()
    go handleConn(conn)
}

//请求处理
func handleConn(conn net.Conn) {
    //1. 将请求成封装Request对象
    //2. 从table中查找相应处理程序
    //3. 将处理结果封装HTTP格式数据返回给客户端
}

然而这些需求在net/http包中都满足了,为什么不直接用?(Don't Repeat Yourself)
net/http包中几个重要的类型:
http.ServeMux: 建立URL:Handler映射表
http.Server: 运行HTTP Server
http.Request: 封装客户端HTTP请求数据
http.ResponseWriter: 用来构造服务器端HTTP响应数据
http.Handler: URL处理程序必须实现的接口

二. 使用net/http搭建一个最简单的HTTP Server

//step1. 建立 URL:Handler映射表
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "Hello, world")
})

//step2. 创建并运行HTTP server
server := http.Server{Addr: ":8080", Handler: mux}
log.Fatal(server.ListenAndServe())

然后我们打开浏览器在地址栏输入:http://localhost:8080
服务器将返回:Hello, world
是不是so easy!!!

三. 第二部分代码内部工作原理

第二部分代码和第一部分工作原理基本一致。首先看看step1中的 mux(http.ServeMux)的定义:

type ServeMux struct {
	mu    sync.RWMutex        //保护m
	m     map[string]muxEntry //URL:Handler映射表
	hosts bool
}
type muxEntry struct {
	explicit bool
	h        Handler
	pattern  string
}

很显然当我们调用mux.HandleFunc(...)的时候就是添加URL:Handler键值对到mux的map中。 那么问题来了,func(http.ResponseWriter,*http.Request)是个函数类型,而http.Handler是一个接口类型,二者是如何转换的?不妨看看 mux.HandleFunc:

func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {
	mux.Handle(pattern, HandlerFunc(handler))  //又调用了mux.Handle
}

而 mux.Handle 就比较简单了,就是将 func(http.ResponseWriter,*http.Request)转换为 http.Handler 然后放入mux的map中。

HandlerFunc(注意不要与 HandleFunc 函数混淆了)是个什么鬼?又有什么用?

type HandlerFunc func(ResponseWriter, *Request) 
func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
    f(w, r)
}

其实就是一个实现了 http.Handler 接口的类型,该类型底层基础类型就是 func(ResponseWriter, *Request),我们知道在go语言中除了 指针与接口 其他基础类型也是可以定义方法的,标准库定义这个一个类型,为的就是将 普通func(ResponseWriter, *Request) 适配到 http.Handler接口. 所以 HandlerFunc 这样的类又称为适配器类,这一做法很有用,一定要掌握住该技巧。

好了,现在看看step2的 http.Server,将 监听地址 和 step1中的 http.ServeMux 对象传递给了它,然后调用server.ListenAndServe()开始监听, 处理流程大致如下:

  1. server监听到有新链接进来,创建一个goroutine来处理新链接
  2. 在goroutine中,将请求和响应分别封装为 http.Request和http.ResponseWriter对象。然后用这两个对象作为函数参数调用 server.Handler.serveHTTP(...), 而server.Handler 即为我们传入的 http.ServeMux 对象,而http.ServeMux对象的serveHTTP方法,我们都没有碰过,里面到底做了什么?
  3. http.ServeMux对象的serveHTTP方法做的事,其实就是根据 http.Request对象中的URL 在自己的map中查找对应的Handler(这个又是我们在step1中添加的),然后执行。

绕了一大圈,简单来说就是 每当有新请求进来,server都会为我们新建一个goroutine,并在其中根据请求URL调用 我们在创建server之前添加的 URL:Handler映射表(通过server中的http.Handler字段混入)中的相应URL的Handler.

问题:为什么不在server中放置一个 URL:Handler 映射表?
这样上面步骤2中就不用先绕到 server.Handler.serveHTTP(...)中,才能查找映射表了。这样的话http.ServeMux 对象也不需要了。 这样做从程序逻辑上讲没有问题,但将http.Server的逻辑弄得更复杂了,通过一个 http.Handler中间层URL路由功能从http.Server 解耦出来,虽然理解起来有点绕,但各自的职责将更加清楚(http.Server就是只管HTTP Server中通用功能的部分,业务逻辑的不同处理都通过 http.ServeMux 来构建)

四. 更简单的代码写法

http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "Hello, world")
})
log.Fatal(http.ListenAndServe(":8080", nil))

为什么连 http.ServeMuxhttp.Server都没有用到?其实肯定是需要的,只是被封装了起来。大家都说golang很容易上手,这其实得益于 实现golang的团队 强大的封装抽象能力,将复杂留给了自己,简单易用性给了开发者。

其实这种写法是使用了 net/http包中定义的一个 全局http.ServeMux对象变量 DefaultServeMux, 然后在 http.ListenAndServe(":8080", nil) 函数中新构建了一个 http.Server对象,然后让server进入监听。比较巧妙地是 函数http.ListenAndServe的第二个参数,如果是nil,该server才会使用DefaultServeMux,否则使用新传入的http.ServeMux对象。


有疑问加站长微信联系(非本文作者)

本文来自:GITHUB

感谢作者:k2huang

查看原文:标准库net/http包使用及工作原理

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

1996 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传