Python BaseHTTPServer 介绍 | Cizixs Write Here

本文针对 python 2.7 版本，介绍了 BaseHTTPServer 这个库的使用方法。

这个库是 python 自带的标准库的一部分，不需要额外安装，在 linux 系统下，位置在 /usr/lib/python2.7/BaseHTTPServer.py。

HTTP 协议

HTTP 请求（request）

http 请求分为三个部分：

第一行：请求类型、地址和版本号
头部信息：HTTP header
数据部分

标准的 HTTP 请求是：

GET / HTTP/1.1
Host: cizixs.com
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:42.0) Gecko/20100101 Firefox/42.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: zh-CN,zh;q=0.8,en-US;q=0.5,en;q=0.3
Accept-Encoding: gzip, deflate
Connection: keep-alive
If-Modified-Since: Thu, 25 Feb 2016 16:00:57 GMT
Cache-Control: max-age=0

标准的 HTTP 响应头部：

HTTP/1.1 304 Not Modified
Server: GitHub.com
Date: Thu, 24 Mar 2016 06:21:25 GMT
Last-Modified: Thu, 25 Feb 2016 16:00:57 GMT
access-control-allow-origin: *
Expires: Thu, 24 Mar 2016 06:31:25 GMT
Cache-Control: max-age=600
X-GitHub-Request-Id: 3AF60A59:7CE3:1C889201:56F38765

data...

使用 BaseHTTPServer 写一个简单的 web server

这个类可以帮助你快速编写一个 HTTP 服务端 server。别说了，先上代码：

from BaseHTTPServer import BaseHTTPRequestHandler
import cgi
import json


class TodoHandler(BaseHTTPRequestHandler):
    """A simple TODO server

    which can display and manage todos for you.
    """

    # Global instance to store todos. You should use a database in reality.
    TODOS = []

    def do_GET(self):
        # return all todos

        if self.path != '/':
            self.send_error(404, "File not found.")
            return

        # Just dump data to json, and return it
        message = json.dumps(self.TODOS)

        self.send_response(200)
        self.send_header('Content-type', 'application/json')
        self.end_headers()
        self.wfile.write(message)

    def do_POST(self):
        """Add a new todo

        Only json data is supported, otherwise send a 415 response back.
        Append new todo to class variable, and it will be displayed
        in following get request
        """
        ctype, pdict = cgi.parse_header(self.headers['content-type'])
        if ctype == 'application/json':
            length = int(self.headers['content-length'])
            post_values = json.loads(self.rfile.read(length))
            self.TODOS.append(post_values)
        else:
            self.send_error(415, "Only json data is supported.")
            return

        self.send_response(200)
        self.send_header('Content-type', 'application/json')
        self.end_headers()

        self.wfile.write(post_values)

if __name__ == '__main__':
    # Start a simple server, and loop forever
    from BaseHTTPServer import HTTPServer
    server = HTTPServer(('localhost', 8888), TodoHandler)
    print("Starting server, use <Ctrl-C> to stop")
    server.serve_forever()

这段代码实现的功能很简单，就是一个简单的 Todo 管理：你可以添加 todo，也可以查询 todo。更新和删除 todo 可以根据上面的代码自行添加。

代码也不难理解，在关键的步骤我已经添加了注释，在这里就不再解释了。

好了，我们用 httpie 来和它交互一下，最开始的时候返回的数据是空的

➜  ~ http --verbose http://localhost:8888
GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Host: localhost:8888
User-Agent: HTTPie/0.8.0


HTTP/1.0 200 OK
Content-type: application/json
Date: Fri, 25 Mar 2016 09:35:08 GMT
Server: BaseHTTP/0.3 Python/2.7.10

[]

然后，添加几条试试：

➜  ~ http --verbose POST http://localhost:8888 content="buy a beer" finished:=false
POST / HTTP/1.1
Accept: application/json
Accept-Encoding: gzip, deflate
Content-Length: 44
Content-Type: application/json; charset=utf-8
Host: localhost:8888
User-Agent: HTTPie/0.8.0

{
    "content": "buy a beer",
    "finished": false
}

HTTP/1.0 200 OK
Content-type: application/json
Date: Fri, 25 Mar 2016 09:36:08 GMT
Server: BaseHTTP/0.3 Python/2.7.10

{u'content': u'buy a beer', u'finished': False}

➜  ~ http --verbose POST http://localhost:8888 content="learn HTTP" finished:=false
POST / HTTP/1.1
Accept: application/json
Accept-Encoding: gzip, deflate
Content-Length: 44
Content-Type: application/json; charset=utf-8
Host: localhost:8888
User-Agent: HTTPie/0.8.0

{
    "content": "learn HTTP",
    "finished": false
}

HTTP/1.0 200 OK
Content-type: application/json
Date: Fri, 25 Mar 2016 09:36:24 GMT
Server: BaseHTTP/0.3 Python/2.7.10

{u'content': u'learn HTTP', u'finished': False}

这个时候，再来看一下内容：

➜  ~ http --verbose http://localhost:8888
GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Host: localhost:8888
User-Agent: HTTPie/0.8.0


HTTP/1.0 200 OK
Content-type: application/json
Date: Fri, 25 Mar 2016 09:36:58 GMT
Server: BaseHTTP/0.3 Python/2.7.10

[
    {
        "content": "buy a beer",
        "finished": false
    },
    {
        "content": "learn HTTP",
        "finished": false
    }
]

我们刚刚创建的 todo 就出现了！前面也说了，这段代码不支持更新和删除功能，而且数据也没有落地，关闭程序之后，数据就消失了。

BaseHTTPServer 源代码解析

BaseHTTPServer 这个模块提供了两个类让开发者实现 HTTP server：HTTPServer 和 BaseHTTPRequestHandler。

HTTPServer 继承了 SocketServer.BaseServer，主要功能是：创建和监听 socket，把请求转发给 handler 去处理。主要的工作都是在 BaseHTTPRequestHandler 中处理的，它把和请求有关的信息都封装成自己的实例变量，可以在子类中直接使用。这些变量包括：

client_address：客户端的地址，存放在一个 tuple 里 (host, port)
server: server 实例
command：请求类型，比如，GET、POST 等
path：请求路径，比如 /index.html
request_version: 请求版本号，比如 HTTP/1.0
headers：mimetools.Message 的实例对象，包含了头部信息
rfile：rfile 是一个输入流，用来读取请求的数据
wfile：wfile 是一个输出流，用来回写响应，回写的数据必须遵守 HTTP 协议的格式

除了这些实例变量之外，还有其他的类变量：

server_version：服务器的版本号，比如 BaseHTTP/0.2
sys_version：python 的版本号，比如 Python/1.4
error_message_format：错误 response 的格式
error_content_type：错误 response 的 Content-Type，默认是 text/html
protocol_version：HTTP 协议版本号
responses：error code 对应错误消息的匹配关系

当然，还有一些方法可以使用：

handle()：调用底层的实现来处理一次请求
send_response（）：发送应答消息和状态码

更多的内容可以查看文末的链接。

为什么这个类不会被广泛使用？

写了这么多，我们也看到这个类缺点很多，比如：

不支持 url 解析和转发，如果有多个 endpoint，需要用户自己解析
回写的响应也需要用户自己维护格式，容易出错
没有模板支持，如果要写 HTML 页面，也需要自己维护

所以在正式的工作中，编写 HTTP server 端应用的时候，都是使用 web 框架的。因为 web 框架帮你封装了底层的这些细节，还提供了很多便利的功能，让开发者把中心更多地放到业务逻辑的实现。

如果有时间，以后讲讲怎么自己写一个简单的 HTTP Server。

参考资料

BaseHTTPServer — Basic HTTP server