《introduction-to-tornado》笔记

http://docs.pythontab.com/tornado/introduction-to-tornado/index.html

 

一、安装tornado
$curl -L -O https://github.com/facebook/tornado/archive/v3.1.0.tar.gz
$tar xvzf v3.1.0.tar.gz
$cd tornado-3.1.0
$python setup.py build
$sudo python setup.py install
验证安装成功：
[root@localhost ~]# ipython
In [1]: import tornado

 


# 二、Hello Tornado
# 代码清单1-1 基础：hello.py
# -*- coding: utf-8 -*-

import tornado.web
import tornado.ioloop


# Tornado 的 Web 程序会将 URL 或者 URL 范式映射到 tornado.web.RequestHandler 的子类上去。
# 在其子类中定义了 get() 或 post() 方法，用以处理不同的 HTTP 请求。
# 
# 下面的代码将 URL 根目录 / 映射到 MainHandler，还将一个 URL 范式 /story/([0-9]+) 映射到 StoryHandler。
# 正则表达式匹配的分组会作为参数引入 的相应方法中：

class MainHandler(tornado.web.RequestHandler):
    def get(self):
     # RequestHandler的另一个有用的方法是write，它以一个字符串作为函数的参数，并将其写入到HTTP响应中。
        self.write(''
                   ''
                   ''
                   '')

    def post(self):
        self.set_header("Content-Type", "text/plain")
        # 你可以使用 get_argument() 方法来获取查询字符串参数，以及解析 POST 的内容：
        self.write("You wrote " + self.get_argument("message"))


class StoryHandler(tornado.web.RequestHandler):
    def get(self, story_id):
        self.write("You requested the story " + story_id)

class ReverseHandler(tornado.web.RequestHandler):
    # get方法有一个额外的参数input。这个参数将包含匹配处理函数正则表达式第一个括号里的字符串。
    # （如果正则表达式中有一系列额外的括号，匹配的字符串将被按照在正则表达式中出现的顺序作为额外的参数传递进来。）
    def get(self, input):
        self.write(input[::-1])

if __name__ == '__main__':
 # 传递给Application类__init__方法的最重要的参数是handlers。它告诉Tornado应该用哪个类来响应请求。
 application = tornado.web.Application([
     (r"/", MainHandler),
     (r"/story/([0-9]+)", StoryHandler),
     (r"/reverse/(\w+)", ReverseHandler),
 ])

 application.listen(8888)
 tornado.ioloop.IOLoop.instance().start()
验证：
在浏览器中打开
或者
[cxiong@localhost ~]$ curl http://localhost:8000/
Hello, friendly user![cxiong@localhost ~]$ curl http://localhost:8000/?greeting=Salutations
Salutations, friendly user![cxiong@localhost ~]$


# 三、重写 RequestHandler 的方法函数
# 
# 除了 get()/post()等以外，RequestHandler 中的一些别的方法函数，这都是 一些空函数，它们存在的目的是在必要时在子类中重新定义其内容。
#  对于一个请求的处理 的代码调用次序如下：
# 1.程序为每一个请求创建一个 RequestHandler 对象
# 2.程序调用 initialize() 函数，这个函数的参数是 Application 配置中的关键字 参数定义。
# （initialize 方法是 Tornado 1.1 中新添加的，旧版本中你需要 重写 __init__ 以达到同样的目的） initialize 方法一般只是把传入的参数存 到成员变量中，而不会产生一些输出或者调用像 send_error 之类的方法。
# 3.程序调用 prepare()。无论使用了哪种 HTTP 方法，prepare 都会被调用到，因此 这个方法通常会被定义在一个基类中，然后在子类中重用。
# prepare可以产生输出 信息。如果它调用了finish（或send_error` 等函数），那么整个处理流程 就此结束。
# 4.程序调用某个 HTTP 方法：例如 get()、post()、put() 等。
# 如果 URL 的正则表达式模式中有分组匹配，那么相关匹配会作为参数传入方法。


 # 四、用户认证
 # -*- coding: utf-8 -*-

import tornado.httpserver
import tornado.ioloop
import tornado.web
import tornado.options
import os.path

from tornado.options import define, options
define("port", default=8000, help="run on the given port", type=int)

class BaseHandler(tornado.web.RequestHandler):
    # 请求处理类有一个current_user属性（同样也在处理程序渲染的任何模板中可用）可以用来存储为当前请求进行用户验证的标识。
    # 其默认值为None。为了authenticated装饰器能够成功标识一个已认证用户，
    # 你必须覆写请求处理程序中默认的get_current_user()方法来返回当前用户。
    def get_current_user(self):
        print("get secure cookie:"+self.get_secure_cookie("username"))
        return self.get_secure_cookie("username")

class LoginHandler(BaseHandler):
    def get(self):
        self.render('login.html')

    def post(self):
        self.set_secure_cookie("username", self.get_argument("username"))
        self.redirect("/")

class WelcomeHandler(BaseHandler):
    @tornado.web.authenticated
    def get(self):
        # Tornado的认证功能
        # @tornado.web.authenticated装饰器实现对登录用户标记具体的处理函数。
        # 当我们使用这个装饰器包裹一个处理方法时，Tornado将确保这个方法的主体只有在合法的用户被发现时才会调用。
        # 在get方法被调用之前，authenticated装饰器确保current_usr属性有值。
        # 如果current_user值为假（None、False、0、""），任何GET或HEAD请求都将把访客重定向到应用设置中login_url指定的URL。
        # 如果发现了一个合法的用户，Tornado将如期调用处理方法。为了实现完整功能，authenticated装饰器依赖于current_user属性和login_url设置
        self.render('index.html', user=self.current_user)
        print("current user:"+self.current_user)

class LogoutHandler(BaseHandler):
    def get(self):
        if (self.get_argument("logout", None)):
            self.clear_cookie("username")
            self.redirect("/")

if __name__ == "__main__":
    tornado.options.parse_command_line()

    # 记住这里我们传递了一个新的设置给应用：login_url是应用登录表单的地址。
    # 如果get_current_user方法返回了一个假值，带有authenticated装饰器的处理程序将重定向浏览器的URL以便登录。
    settings = {
        "template_path": os.path.join(os.path.dirname(__file__), "templates"),
        "cookie_secret": "bZJc2sWbQLKos6GkHn/VB9oXwQt8S0R0kRvJ5/xJ89E=",
        "xsrf_cookies": True,
        "login_url": "/login"
    }

    application = tornado.web.Application([
        (r'/', WelcomeHandler),
        (r'/login', LoginHandler),
        (r'/logout', LogoutHandler)
    ], **settings)

    http_server = tornado.httpserver.HTTPServer(application)
    http_server.listen(options.port)
    tornado.ioloop.IOLoop.instance().start()


《tornado概览》

http://www.tornadoweb.cn/documentation

 

http://www.tornadoweb.org


《python与tornado》-现代魔法学院

http://www.nowamagic.net/academy/part/13/325

 

《tornado框架》

http://www.cnblogs.com/kongqi816-boke/p/5699866.html#_labelTop