Tornado 简述
前言
- python 旗下,群英荟萃,豪杰并起。单是用于 web 开发的,就有 webpy、web2py、bottle、pyramid、zope2、flask、tornado、django 等等,不一而足。最近几年较为流行的,大概也就是flask、tornado 和 django 了。
- 关于以上各个 web 开发框架的性能比较,上网一搜,铺天盖地——这不是本文讨论的重点,但有一点我想提醒大家:在以上众多模块中,只有 tornado 同时具备异步IO、webserver、web框架三大功能,同时又是最简洁的、学习门槛最低的。有 python 语言基础的程序员,只需要花点时间就可以登堂入室了。
- 如果把 web 开发框架比作程序员手中的冷兵器,我觉得 flask 好比是花枪, 轻灵飘逸,舞之令人眼花缭乱;django 像大戟,合矛戈为一体,可直刺,可横击,威力无比;tornado 秀外而惠中,更像是剑。剑在中国传统武术中有着很高的地位,为兵器之神,被认为有君子之风。
从 hello world 开始
如果你的 python 环境还没有安装 tornado,请直接使用 pip 安装:
pip install tornado
- 下面的代码,虽然只有区区六行(不包括导入模块的两行),却是一个完整的 web 服务程序。运行下面的代码,就开启了一个 web 服务,从本机浏览器直接访问 http://127.0.0.1,不出意外的话,我们的第一个网页 hello, world 即可正常显示出来。
demo.py
# -*- coding: utf-8 -*- import tornado.ioloop import tornado.web class HomeHandler(tornado.web.RequestHandler): def get(self): # 响应以get方式发送的请求 self.write("hello, world") # 向请求者(浏览器)应答hello, world app = tornado.web.Application([ (r"/", HomeHandler), ]) # URL映射 app.listen(80) # 绑定侦听端口 tornado.ioloop.IOLoop.instance().start() # 启动服务
如果多少了解一点 http 协议,知道 get / post 方法,相信你一定能够读懂。也许你的项目规划了很多的url,也许你的服务需要监听非80端口,没有关系,在这个代码上扩展就行。仅仅六行!!!请让我们向犀利的、简洁的、无所不能的 python 致敬!
重点:tornado.web.RequestHandler.write() 不只可以接受字符串参数,还可以接受列表或字典参数——如果应答类型为json时,这个重载特性非常高效
最简单的登录
假定我们有这样一个 web 服务需求:
- 首页:地址“/”,显示“点此登录”两个汉字,点击则跳转到登录页面
- 登录页:地址“/login”,以 get 方式访问,则显示账号、密码输入框和登录按钮;以 post 方式访问,则是提交表单提交,验证登录信息。登录成功,跳转至个人信息页面,否则,跳转至首页
- 个人信息页:地址“/me”,显示登录账号
以上面的代码为基础,我们首先要做的工作是 URL 和 对应的处理类之间的关联。这件工作实际上是非常轻松愉快的:
app = tornado.web.Application([ (r"/", HomeHandler), (r"/login", LoginHandler), (r"/me", MeHandler) ])
接下来,我们要实现 HomeHandler、LoginHandler 和 MeHandler 这三个类了。通常,我们习惯把这些和URL 对应的处理类,保存为一个独立的文件,比如文件名为 handlers.py,然后在服务器脚本 demo.py 中导入它们。
handlers.py
# -*- coding: utf-8 -*- import tornado.web class HomeHandler(tornado.web.RequestHandler): """响应主页请求""" def get(self): # 以get方式请求 self.write("""<!DOCTYPE html><html><body><a href="login">点此登录</a></body></html>""") class LoginHandler(tornado.web.RequestHandler): """响应登录页请求""" def get(self): # 以get方式请求 self.write( """ <!DOCTYPE html><html><body><form method="POST" action="/login"> 账号:<input type="text" name="account" value="" /><br /> 密码:<input type="password" name="passwd" value="" /> <input type="submit" value="确定" /> </form></body></html> """ ) def post(self): # 以post方式请求(本例为提交表单) account = self.get_argument('account', None) passwd = self.get_argument('passwd', None) if account == 'xufive' and passwd == 'dgdgwstd': self.redirect('/me?name=%s'%account) else: self.redirect('/') class MeHandler(tornado.web.RequestHandler): """响应个人信息页请求""" def get(self): # 以get方式请求 name = self.get_argument('name', None) if name: self.write( """ <!DOCTYPE html><html><head><meta charset="UTF-8" /></head> <body>欢迎你来到这里,%s</body></html> """%name ) else: self.redirect('/')
相应地,服务脚本变成了这样:
demo.py
# -*- coding: utf-8 -*- import os import tornado.ioloop import tornado.web from tornado.options import parse_command_line from handlers import * parse_command_line() app = tornado.web.Application( handlers=[ (r"/", HomeHandler), (r"/login", LoginHandler), (r"/me", MeHandler) ], template_path = os.path.join(os.path.dirname(__file__), 'templates') ) app.listen(80) # 绑定侦听端口 tornado.ioloop.IOLoop.instance().start() # 启动服务
重点:tornado.web.RequestHandler.get_argument() 可以读取通过表单和QueryString传递的参数
模板技术
读到这里,你一定会觉得奇怪:为什么服务端程序里面混杂了一大堆的 html 代码?Don’t worry,以上的代码仅仅是帮助你建立基本概念的,实际上,tornado 是为数不多的支持模板技术很到位的框架之一,其模板技术不仅支持继承,支持子模版。让我们一步一步讨论如何使用模板。
第1步:模板保存在哪儿?
- 在服务端脚本里,当我们使用 tornado.web.Application() 创建一个应用时,通常需要传递一个 template_path 参数,这个参数就是模板文件的保存路径。上面的例子已经增加了这个参数,我们只要把模板文件放在和 demo.py 同级的 templates 文件夹下就可以了。
第2步:怎样写模板?
- 其实,模板就是 html 文件,只是其中混杂了少量特别约定的符号。一个 web 项目,通常由若干页面组成,这些页面有很多共同的地方,因此一个基类模板是必要的。
base.html
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <!-- 此处省略各种样式表文件 --> </head> <body> {% block block_body %}{% end %} </body> <html>
基类模板 base.html 定义了一个 block_body 容器,如果有必要,我们在基类模板的任意位置定义更多的容器。假定我们需要一个个人信息页模板,可以直接继承 base.html,然后只填写 block_body 这一部分就行了。
me.html
{% extends "base.html" %} {% block block_body %} <h1>欢迎你来到这里,{{name}}</h1> {% end %}
个人信息页模板引中,我们使用 {{}} 引用了一个变量 name
第3步:如何使用模板?
- 很简单,前面我们用 tornado.web.RequestHandler.write() 向浏览器应答信息,现在则是这样使用模板:
class MeHandler(tornado.web.RequestHandler): """响应个人信息页请求""" def get(self): # 以get方式请求 name = self.get_argument('name', None) if name: self.render('me.html', name=name ) else: self.redirect('/')
常用的模板语法汇总如下:
- 引用变量:{{…}}
- 引用 python 表达式:{%…%}
- 循环:{% for var in expr %}…{% end %}
- 分支:{% if condition %}…{% elif condition %}…{% else %}…{% end %}
- 引用原生表达式:{% raw expr %}
Cookie 演练
tornado.web.RequestHandler 的 cookie 操作非常灵活,下面的 handler 展示了 cookie 的基本读写方法:
class CookieHandler(tornado.web.RequestHandler): def get(self): visit_num = self.get_cookie('visit_num') if not visit_num: visit_num = ' visit_num = str(int(visit_num)+1) #self.set_cookie('visit_num', visit_num, expires=None) # 内存cookie self.set_cookie('visit_num', visit_num, expires=time.time()+1000) # 持久化的cookie self.write("这是您第%s次访问本页面"%visit_num)
如果我们要使用持久化的 Cookie(硬盘 Cookie),为了防止被破解,一般是要加密的,那么,在 tornado.web.Application 中需要设置 cookie_secret 项(加密因子)。
定义tornado.web.Application,这是常用的一个模式:
class Application(tornado.web.Application): def __init__(self): handlers = [ (r"/", WelcomeHandler), # 欢迎信息 (r"/server_time",ServerTimeHandler) # 显示服务器时间 ] settings = dict( title = u"网站名称", template_path = os.path.join(os.path.dirname(__file__), 'templates'), static_path = os.path.join(os.path.dirname(__file__), 'static'), cookie_secret = 'rewqr4gfd654fdsg@$%34dfs', session_expiry = 0, login_url = "/", debug = 1 ) tornado.web.Application.__init__(self, handlers, **settings)
Session 扩展
- 为 tornado 增加 session 机制,基本思路就是从 tornado.web.RequestHandler 派生新类,重写 initialize() 方法。当类实例被构造函数创建后,会先运行该方法。我们定义 initialize() 方法读取名为 session_id 的 cookie,如果存在,则读取以 session_id 命名的 session 文件,取得 session 内容,否则,session 为空。
- tornado 是一个非常流行的 web framework,也是一个自带 IO 的 web server,而它作为 web server 采用的是 asynchronous IO 的网络模型,这是一种很高效的模型。网上有很多 tornado 与其他 web 框架的性能比较,其实,它们根本不是一个层次的东西,因为在所有的比较对象中,只有 tornado 同时具备 IO / web server / web framework,并且做到了极致。
- 开发 web 项目,我一般会首选 tornado 。喜欢 tornado,不是因为它全能,而是因为它简洁。简洁到什么程度呢?作为 web 框架,它连 session 都没有。但是,正是这种简洁,降低了学习成本,给用户提供了无限的开发空间。
- 为 tornado 增加 session 机制,基本思路就是从 tornado.web.RequestHandler 派生新类,重写 initialize() 方法。当类实例被构造函数创建后,会先运行该方法。我们定义 initialize() 方法读取名为 session_id 的 cookie,如果存在,则读取以 session_id 命名的 session 文件,取得 session 内容,否则,session 为空。
这段代码在 py2 环境 tornado 2.x 以后的各种版本下都可运行。
# -*- coding: utf-8 -*- # Tornado Session For py2 #--------------------------------------- # version 3.2 / Update: 2018-12-24 # # 1. 重写get_current_user方法,读取session_id # version 3.1 / Update: 2018-12-21 # # 1. 以文件作为session的后端 # 2. 私有方法命名规范化 # version 3.0 / Update: 2018-12-19 # # 1. 以cookie形式实现session # 2. 用装饰器引入db # 3. 类方法命名规范化(不兼容之前的版本) import os, time import hashlib import json import tornado.web class SessionRH(tornado.web.RequestHandler): """为RequestHandler增加session机制""" def initialize(self): """初始化(构造函数完成之后)""" self._init_session() def _init_session(self): """session初始化""" self.session = dict() self.session_id = self.get_secure_cookie('session_id') if self.session_id: session_file = os.path.join(self.application.settings["session_path"], self.session_id) if os.path.isfile(session_file): with open(session_file, 'r') as fp: self.session.update(json.loads(fp.read().strip())) if not self.session: self.session_id = None self.clear_cookie('session_id') def _save_session(self): """保存session""" try: expiry = self.application.settings["session_expiry"] except: expiry = 0 if not expiry: expiry = None self.set_secure_cookie('session_id', self.session_id, expires_days=expiry) with open(os.path.join(self.application.settings["session_path"], self.session_id), 'w') as fp: fp.write(json.dumps(self.session)) def create_session(self, **kwargs): """生成唯一的session_id及其它需要保存的数据项""" rand = os.urandom(16) now = time.time() self.session_id = hashlib.sha1("%s%s%s" %(rand, now, self.request.remote_ip)).hexdigest() self.session.update(kwargs) self.session.update({'last_active':str(now)}) self._save_session() def destroy_session(self): """注销session""" session_file = os.path.join(self.application.settings["session_path"], self.session_id) if os.path.isfile(session_file): os.remove(session_file) self.session_id = None self.session = dict() self.clear_cookie('session_id') def append_session_item(self, **kwargs): """追加session项""" self.session.update(kwargs) self._save_session() def delete_session_item(self, name): """删除session项""" if name in self.session: self.session.pop(name) self._save_session() def get_current_user(self): """重写get_current_user方法,读取session_id""" return self.get_secure_cookie("session_id") @property def db(self): """用装饰器引入db(application.db)""" return self.application.db if __name__ == '__main__': pass
Tornado 简述的更多相关文章
- Python(九)Tornado web 框架
一.简介 Tornado 是 FriendFeed 使用的可扩展的非阻塞式 web 服务器及其相关工具的开源版本.这个 Web 框架看起来有些像web.py 或者 Google 的 webapp,不过 ...
- 简述 OAuth 2.0 的运作流程
本文将以用户使用 github 登录网站留言为例,简述 OAuth 2.0 的运作流程. 假如我有一个网站,你是我网站上的访客,看了文章想留言表示「朕已阅」,留言时发现有这个网站的帐号才能够留言,此时 ...
- JavaScript单线程和浏览器事件循环简述
JavaScript单线程 在上篇博客<Promise的前世今生和妙用技巧>的开篇中,我们曾简述了JavaScript的单线程机制和浏览器的事件模型.应很多网友的回复,在这篇文章中将继续展 ...
- 使用tornado,我们可以做什么?
以下介绍都是建立在python2.x的基础上面,tornado使用任意版本皆可. 如果我们需要对外提供一个http server(web api)/websocket server时,我们都可以使用t ...
- tornado session
[转]tornado入门 - session cookie 和session 的区别: 1.cookie数据存放在客户的浏览器上,session数据放在服务器上. 2.cookie不是很安全,别人可以 ...
- tornado template
若果使用Tornado进行web开发可能会用到模板功能,页面继承,嵌套... 多页应用模板的处理多半依赖后端(SPA就可以动态加载局部视图),就算是RESTfull的API设计,也不妨碍同时提供部分模 ...
- tornado上手
http://www.tornadoweb.org/en/stable/ http://www.cnblogs.com/fanweibin/p/5418697.html import tornado. ...
- Design Patterns Simplified - Part 3 (Simple Factory)【设计模式简述--第三部分(简单工厂)】
原文链接:http://www.c-sharpcorner.com/UploadFile/19b1bd/design-patterns-simplified-part3-factory/ Design ...
- tornado+sqlalchemy+celery,数据库连接消耗在哪里
随着公司业务的发展,网站的日活数也逐渐增多,以前只需要考虑将所需要的功能实现就行了,当日活越来越大的时候,就需要考虑对服务器的资源使用消耗情况有一个清楚的认知. 最近老是发现数据库的连接数如果 ...
随机推荐
- Error: Invalid or corrupt jarfile SpringBootTemplate.jar
当在尝试将SpringBoot打包成为Jar文件, 丢到linux服务器去运行的时候, 尝试在windows自带的CMD窗口命令行中运行jar文件的时候, 遇到了这样的问题. 错误的意思是: 无效 或 ...
- [HNOI2019]鱼(计算几何)
看到数据范围n<=1000,但感觉用O(n^2)不现实,所以考虑方向应该是O(n^2logn). 一种暴力做法:用vector存到1点相同的2点和到2点相同的1点,然后枚举A,枚举BC,再枚举D ...
- day03-函数
形参:位置参数:必须传 *args:动态参数,可以接收任意多个位置参数 默认值参数:可以传也可以不传 **kwargs:动态参数,可以接收多个关键字参数. 实参:按照位置传参,按照关键字传参. #顺序 ...
- sql语句查询去除重复语句的结果集
返回operation表中time列的唯一值 语句1 select time from operation group by time having count(time) > ...
- keras使用、函数功能
#1. keras.engine.input_layer.Input() def Input(shape=None, batch_shape=None, name=None, dtype=None ...
- springboot学习笔记:10.springboot+atomikos+mysql+mybatis+druid+分布式事务
前言 上一篇文章我们整合了springboot+druid+mybatis+mysql+多数据源: 本篇文章大家主要跟随你们涛兄在上一届基础上配置一下多数据源情况下的分布式事务: 首先,到底啥是分布式 ...
- Jumpserver 一键部署(支持离线安装)
1.教程介绍1.1::通过本教程起到抛砖引玉效果,希望各位喜爱Jumpserver堡垒机的朋友受益良多. 1.2::以下提供的任何软件仅供学习交流使用. 2.下载链接2.1::centos_1810最 ...
- HDU-2544-最短路(各种最短路径算法)
迪杰斯特拉算法--O(n^2) #include"iostream" #include"cstring" #include"cstdio" ...
- JavaScript小数转百分比
在浏览器的控制台操作0.28*100会得到28.000000000000004这样一个不太精确的值 进行转换 toPercent(point){ let str = Number(point * 10 ...
- MAYA卸载/完美解决安装失败/如何彻底卸载清除干净MAYA各种残留注册表和文件的方法
在卸载MAYA重装MAYA时发现安装失败,提示是已安装或安装失败.这是因为上一次卸载后没有清理干净,系统会误认为已经安装过了.有的同学是新装的系统也会出现安装失败的情况,这是因为C++ 或者.NET的 ...