tornado手册

以下是 Tornado 框架的核心内容中文指南，涵盖安装、基础用法、关键模块及最佳实践，适用于 Tornado 6.x+ 版本：

1. 安装

pip install tornado

2. 最小示例

import tornado.ioloop
import tornado.web

class MainHandler(tornado.web.RequestHandler):
    def get(self):
        self.write("Hello, Tornado!")

def make_app():
    return tornado.web.Application([
        (r"/", MainHandler),
    ])

if __name__ == "__main__":
    app = make_app()
    app.listen(8888)
    tornado.ioloop.IOLoop.current().start()

运行后访问 http://localhost:8888

3. 核心模块

3.1 异步处理（协程）

class AsyncHandler(tornado.web.RequestHandler):
    async def get(self):
        result = await self.some_async_task()
        self.write(result)

3.2 WebSocket

class ChatHandler(tornado.websocket.WebSocketHandler):
    clients = set()

    def open(self):
        self.clients.add(self)

    async def on_message(self, message):
        for client in self.clients:
            await client.write_message(f"Echo: {message}")

    def on_close(self):
        self.clients.remove(self)

3.3 HTTP 客户端

from tornado.httpclient import AsyncHTTPClient

async def fetch_data():
    http_client = AsyncHTTPClient()
    response = await http_client.fetch("https://api.example.com/data")
    return response.body

4. 配置要点

路由与设置

settings = {
    "template_path": "templates",  # 模板目录
    "static_path": "static",        # 静态文件目录
    "xsrf_cookies": True,           # 开启XSRF保护
}

app = tornado.web.Application([
    (r"/", MainHandler),
    (r"/ws", ChatHandler),
], **settings)

静态文件服务

<!-- 模板中引用静态文件 -->
<link href="{{ static_url('css/style.css') }}" rel="stylesheet">

5. 部署建议

生产环境：使用 Nginx 反向代理 + 多进程模式

app.listen(8888, xheaders=True)  # 启用代理头部支持

启动多进程（不推荐，建议用外部负载均衡）：
```
tornado.process.fork_processes(0)  # 0 = CPU核心数
```

6. 常见场景示例

表单处理与XSRF

class LoginHandler(tornado.web.RequestHandler):
    def get(self):
        self.render("login.html")

    async def post(self):
        user = self.get_body_argument("user")
        passwd = self.get_body_argument("password")
        # 验证逻辑（自动验证XSRF令牌）

模板渲染

login.html:

<form method="post">
  {% raw xsrf_form_html() %} <!-- 插入XSRF令牌 -->
  <input type="text" name="user">
  <input type="password" name="password">
</form>

7. 调试与测试

调试模式（开发环境）：

app = tornado.web.Application(debug=True, autoreload=True)

单元测试：

class TestHandler(tornado.testing.AsyncHTTPTestCase):
  def get_app(self):
      return make_app()

  def test_homepage(self):
      response = self.fetch("/")
      self.assertEqual(response.code, 200)