1、【Python3】Tornado 入门

Tornado是Python编写的Web服务器兼Web应用框架。

优势：

• 轻量级web框架
• 异步非阻塞IO处理方式
• 出色的抗负载能力
• 优异的处理性能，不依赖多进程/多线程，一定程度上解决了C10K问题
• WSGI全栈替代产品，推荐同时使用其Web框架和HTTP服务器

一、Tornado 安装

pip3 install tornado

二、Tornado网站框架简单示例

新建Python文件，命名为：helloworld.py

import tornado.ioloop
import tornado.web


# 定义处理类型
class MainHandler(tornado.web.RequestHandler):
    # 定义一个处理get请求方式的方法
    def get(self):
        # 向响应中，添加数据
        self.write("Hello, world")

# 创建一个应用对象
application = tornado.web.Application([
    # 路由表
    (r"/", MainHandler),
])

if __name__ == "__main__":
    application.listen(8888) # 监听8888
    # ioloop实例：启动Web程序，开始监听端口的链接
    tornado.ioloop.IOLoop.current().start()

在终端执行该文件：

python helloworld.py

在浏览器中打开：localhost:8888/
就可以在页面上看到Hello, world

代码解析：

一个普通的tornado web服务器通常由四大组件组成。

• ioloop实例，它是全局的tornado事件循环，是服务器的引擎核心，示例中tornado.ioloop.IOLoop.current()就是默认的tornado ioloop实例。
• app实例，它代表着一个完成的后端app，它会挂接一个服务端套接字端口对外提供服务。一个ioloop实例里面可以有多个app实例，示例中只有1个，实际上可以允许多个，不过一般几乎不会使用多个。
• handler类，它代表着业务逻辑，我们进行服务端开发时就是编写一堆一堆的handler用来服务客户端请求。
• 路由表，它将指定的url规则和handler挂接起来，形成一个路由映射表。当请求到来时，根据请求的访问url查询路由映射表来找到相应的业务handler。

这四大组件的关系是，一个ioloop包含多个app(管理多个服务端口)，一个app包含一个路由表，一个路由表包含多个handler。ioloop是服务的引擎核心，它是发动机，负责接收和响应客户端请求，负责驱动业务handler的运行，负责服务器内部定时任务的执行。

三、httpserver底层处理

httpserver 监听端口

tornado.httpserver.HTTPServer(app)
httpserver.listen(port)

httpservere实现多进程操作

tornado.httpserver.HTTPServer(app)
httpserver.bind(port)
httpserver.start(0/None/<0/num)

示例：

# -*- coding:utf-8 -*-
from tornado.web import Application,RequestHandler
from tornado.ioloop import IOLoop
from tornado.httpserver import HTTPServer

class IndexHandler(RequestHandler):
    def get(self):
        self.write('那有那么多坚强，无非是死扛罢了。')

app = Application([(r'/', IndexHandler)])

if __name__ == '__main__':
    http_server = HTTPServer(app)
    #最原始的方式
    http_server.bind(8888)
    http_server.start(1)

    #启动Ioloop轮循监听
    IOLoop.current().start()

四、options 配置

全局配置

tornado.options.define(
    name, default, type, multiple, help
)

命令行参数

tornado.options.parse_command_line()

示例：

#-*- coding:utf-8 -*-

from tornado.web import RequestHandler,Application
from tornado.ioloop import IOLoop
from tornado.httpserver import HTTPServer
import tornado.options

#定义变量
tornado.options.define('port',default=8000,type=int,help="this is the port >for application")

class IndexHandler(RequestHandler):
   def get(self):
       self.write('To life, like today is the end.')

app = Application([(r'/',IndexHandler)])

if __name__ == '__main__':
    tornado.options.parse_command_line()
    http_server = HTTPServer(app）
    http_server.bind(tornado.options.options.port)
    http_server.start(1)
    #启动IOLoop轮循监听
    IOLoop.current().start()

配置文件

#即在当前py文件目录创建config文件，并在py代码中加入以下代码，
tornado.options.parse_config_file("./config")

配置模块：跟配置文件类似

五、application 配置

程序调试只debug配置

#自动重启+取消缓存模板+取消缓存静态文件+提供追踪信息
tornado.web.Application([(..)], debug=True)

注：开发之初可以设置debug=True方便调试，开发完毕改为False.

路由信息初始化参数配置

tonado.web.Application([(r””, Handler, {k:v})])
def initialize(self, k)

路由名称设置及反解析

#名称设置
tornado.web.Application([
    url(r””, handler, {k,v}, name=“”)
])

#反解析操作
reverse_url(name)

实例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler, url
from tornado.ioloop import IOLoop
from tornado.httpserver import HTTPServer


class IndexHandler(RequestHandler):

    def get(self):
        self.write("<a href='"+self.reverse_url("login")+"'>用户登录</a>")


class RegistHandler(RequestHandler):
    def initialize(self, title):
        self.title = title

    def get(self):
        self.write("注册业务处理:" + str(self.title))


class LoginHandler(RequestHandler):
    def get(self):
        self.write("用户登录页面展示")

    def post(self):
        self.write("用户登录功能处理")


if __name__ == "__main__":
    app = Application(
        [
            (r"/", IndexHandler),
            (r"/regist", RegistHandler, {"title": "会员注册"}),
            url(r"/login", LoginHandler, name="login"),
        ]
    )

    http_server = HTTPServer(app)
    http_server.listen(8000)

    IOLoop.current().start()

六、参数传递

get方式传递参数

get_query_arguments(name,default=_ARG_DEFAULT,strip=True)
get_query_argument(name ,strip=True)

post方式传递参数

get_body_arguments(name, default=_ARG_DEFAULT,strip=True)
get_body_argument(name ,strip=True)

实例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler
from tornado.ioloop import IOLoop
from tornado.httpserver import HTTPServer


class IndexHandler(RequestHandler):

    def get(self):
        # 获取get方式传递的参数
        username = self.get_query_argument("username")
        usernames = self.get_query_arguments("username")

        print (username)
        print (usernames)

    def post(self):
        # 获取post方式传递的参数
        username = self.get_body_argument("username")
        usernames = self.get_body_arguments("username")

        print (username)
        print (usernames)

if __name__ == "__main__":
    app = Application([(r"/",IndexHandler)])

    app.listen(8000)

    IOLoop.current().start()

#网页运行时需要传入参数
#192.168.11.79:8000/?username=123

混合方式

get_arguments(..)/get_argument(..)

实例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler
from tornado.ioloop import IOLoop


class IndexHandler(RequestHandler):

    def get(self):
        # 获取get方式的参数
        user = self.get_argument("user")
        print("get方式获取参数：" + str(user))

    def post(self):
        # 获取post方式的参数
        user = self.get_argument("user")
        print("post方式获取参数：" + user.encode("utf-8"))


if __name__ == "__main__":
    app = Application([(r"/", IndexHandler)])

    app.listen(8000)

    IOLoop.current().start()

其他参数

通过request获取参数数据

method/host/url/path/query/version/headers/body/remote_ip/files

实例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler
from tornado.ioloop import IOLoop


class IndexHandler(RequestHandler):
    def get(self):
        print self.request

        json_str = {"username": "admin", "password": "123123"}
        self.write(json.dumps(json_str))



if __name__ == "__main__":
    app = Application([(r"/", IndexHandler)])

    app.listen(8000)

    IOLoop.current().start()

header

• .add_header() .set_header() .set_default_headers()
  • 设置响应HTTP头, 前两者的不同点在于多次设置同一个项时, .add_header()会叠加参数,
    而.set_header()则以最后一次为准.
  • .set_default_headers()比较特殊, 是一个空方法,
    可根据需要重写，作用是在每次请求初始化RequestHandler时设置默认headers.
• .clear_header() .clear()
  • .clear_header()清除指定的headers,
    而.clear()清除.set_default_headers()以外所有的headers设置.

示例：

# add_header
self.add_header('Foo', 'one')
self.add_header('Foo', 'two')
# set_header
self.set_header('Bar', 'one')
self.set_header('Bar', 'two')

# HTTP头的设置结果
# Foo → one, two
# Bar → two

实例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler
from tornado.ioloop import IOLoop


class IndexHandler(RequestHandler):
    def set_default_headers(self):
        # 第二种响应头设置方式
        self.set_header("Content-type", "application/json; charset=utf-8")
        self.set_header("qiku", "奇酷信息")

    def get(self):
        # 第一种操作响应头的方式：
        self.set_header("Content-type", "application/json")
        self.write("{'name':'jerry'}")
        self.set_header("qiku", "qikuedu.com")


if __name__ == "__main__":
    app = Application([(r"/", IndexHandler)])

    app.listen(8000)

    IOLoop.current().start()

writerror

• .send_error()用于发送HTTP错误页(状态码). 该操作会调用.clear()
  .set_status()
• .write_error()用于清除headers, 设置状态码, 发送错误页.
  重写.write_error()可以自定义错误页.

实例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler
from tornado.ioloop import IOLoop


class IndexHandler(RequestHandler):

    def get(self):
        self.write("hello qikuedu.com")

        self.send_error(404, msg="页面丢失", info="something wrong")

    def write_error(self, status_code, **kwargs):
        self.write("<h1>出错啦!</h1>")
        self.write("<p>错误信息:%s</p>" % kwargs["msg"])
        self.write("<p>错误描述:%s</p>" % kwargs["info"])


if __name__ == "__main__":
    app = Application([(r"/", IndexHandler)])

    app.listen(8000)

    IOLoop.current().start()

七、数据流

.write()

将数据写入输出缓冲区. 如果直接传入dict, 那Tornado会自动将其识别为json, 并把Content-Type设置为application/json, 如果你不想要这个Content-Type, 那么在.write()之后, 调用.set_header()重新设置就好了. 需要注意的是, 如果直接传入的是list, 考虑到安全问题(json数组会被认为是一段可执行的JavaScript脚本, 且

.flush()

将输出缓冲区的数据写入socket. 如果设置了callback, 会在完成数据写入后回调. 需要注意的是, 同一时间只能有一个”等待”的flush callback, 如果”上一次”的flush callback还没执行, 又来了新的flush, 那么”上一次”的flush callback会被忽略掉.

.finish()

完成响应, 结束本次请求. 通常情况下, 请求会在return时自动调用.finish(), 只有在使用了异步装饰器@asynchronous或其他将._auto_finish设置为False的操作, 才需要手动调用.finish().

cookie

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler
from tornado.ioloop import IOLoop


class IndexHandler(RequestHandler):

    def get(self):
        self.write("hello qikuedu.com")

        self.set_cookie("loginuser", "admin老王")

        print self.get_cookie("loginuser")

        print self.cookies


if __name__ == "__main__":
    app = Application([(r"/", IndexHandler)])

    app.listen(8000)

    IOLoop.current().start()

八、页面

.render()

返回渲染完成的html. 调用后不能再进行输出操作.

.redirect()

重定向, 可以指定3xx重定向状态码. 调用后不能再进行输出操作.

# 临时重定向 301
self.redirect('/foo')
# 永久重定向 302
self.redirect('/foo', permanent=True)
# 指定状态码, 会忽略参数 permanent
self.redirect('/foo', status=304)

示例：

# -*- coding:utf-8 -*-

from tornado.web import Application, RequestHandler, url
from tornado.ioloop import IOLoop
from tornado.httpserver import HTTPServer


class IndexHandler(RequestHandler):

    def get(self):
        self.write("<a href='"+self.reverse_url("login")+"'>用户登录</a>")


class RegistHandler(RequestHandler):
    def initialize(self, title):
        self.title = title

    def get(self):
        self.write("注册业务处理:" + str(self.title))


class LoginHandler(RequestHandler):
    def get(self):
        self.write("用户登录页面展示")

    def post(self):
        self.write("用户登录功能处理")


if __name__ == "__main__":
    app = Application(
        [
            (r"/", IndexHandler),
            (r"/regist", RegistHandler, {"title": "会员注册"}),
            url(r"/login", LoginHandler, name="login"),
        ]
    )

    http_server = HTTPServer(app)
    http_server.listen(8000)

    IOLoop.current().start()