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.
- 设置响应HTTP头, 前两者的不同点在于多次设置同一个项时, .add_header()会叠加参数,
- .clear_header() .clear()
- .clear_header()清除指定的headers,
而.clear()清除.set_default_headers()以外所有的headers设置.
- .clear_header()清除指定的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()