Tornado 學習筆記

 交流QQ群:26651479

一、安裝 Tornado
    目前最新版本的下載：

http://github.com/downloads/facebook/tornado/tornado-1.2.1.tar.gz

    解壓之後，進入解壓的目錄，執行：
        python setup.py build
        python setup.py install

    如果開發環境是py2.6+，也可以簡單的把tornado目錄添加到py的環境變數 PYTHONPATH 中，這樣就不需要編譯setup.py(也就是不用安裝的意思)

    安裝條件：
    在py2.5 2.6 2.7上進行過測試，如果要使用 tornado 的全部功能，必須安裝 PycURL (版本7.18.2 或者以上)，對py2.5必須安裝JSON支援組件simplejson，py2.6+以上的JSON支援已經在標準庫內實現。

二、模組列表和簡介：
    最重要的模組是web模組，他作為web架構套件含了 Tornado 包內大部分的有用的東西，其他的工具和模組讓web變的更有用

    主模組
        web – 用來建立FriendFeed的web架構，他整合（混合）了大部分 Tornado 的重要功能特徵
        escape – XHTML, JSON, and URL 編解碼方法
        database -對MySQLdb的簡單封裝，讓mysql的使用更方便
        template – 基於python的模板渲染語言
        httpclient – 一個非阻塞http用戶端，設計它用來和web和httpserver協同工作
        auth – 第三方認證和認證方案的實現 (Google OpenID/OAuth, Facebook Platform, Yahoo BBAuth, FriendFeed OpenID/OAuth, Twitter OAuth)
        locale – 本地化和翻譯支援
        options – 命令列和設定檔解析工具，為了webserver環境做了最佳化

    底層模組
        httpserver – A very simple HTTP server built on which web is built
        iostream – A simple wrapper around non-blocking sockets to aide common reading and writing patterns
        ioloop – Core I/O loop

    隨機模組：
        s3server – 一個實現了Amazon S3介面的web伺服器，基於本地檔案儲存體

三、Tornado使用概覽
    一個 Tornado 應用會把URL或者URL模式映射到 tornado.web.RequestHandler 的子類，這些子類定義 get 和 set 方法來處理對應URL的GET和POST請求。

http://www.yaozinan.com/2011/04/tornado%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/?replytocom=15

 

==== 範例1 ==================================================
import tornado
import tornado.httpserver
import tornado.ioloop
import tornado.web
import os.path

# 申明一個 add 函數，提供給模板檔案使用
def add(x, y):
    return (x+y)

# 網頁訪問處理
class MainHandler(tornado.web.RequestHandler):
    def get(self):
        items = ["item1","item2","item3", '222']
        # 第一個參數是模板檔案，後面不但可以傳遞參數，還可以傳遞函數，可擴充性很好而且很強大。
        self.render("templates.html", items=items, add=add)

class StoryHandler(tornado.web.RequestHandler):
    def post(self, story_id):
        self.set_header("Content-Type", "text/plain") # 設定頭部資訊
        self.write("You wrote " + self.get_argument("message")) # get_argument方法接收參數

        # 不使用模板，則可直接把內容 write 出去
        self.write("You requested the story " + story_id)
        # 可以多次調用 write,把要顯示的內容追加上去
        self.write("<input type='button' value='返回' onclick='window.history.back();'/>")

# 更多的訪問處理方式
class IndexHandler(tornado.web.RequestHandler):
    # 處理post過來的資料，接收 service_method, argv 兩個URL參數
    def post(self, service_method='', argv=''):
        print('method:POST...')
        print('service_method:' + service_method)

        # 參數處理,按斜杠劃分成list
        if argv:
            if argv.startswith('/'): argv = argv[1:]
            if argv.endswith('/'): argv = argv[:-1]
        argv = argv.split('/') if argv else []
        print('argv:' + str(argv))

        print('request.arguments:' + str(self.request.arguments)) # form 表單提交的資訊
        print('application:' + str(self.application))

        items = ["item1","item2","item3", 'dfsdfsd']
        self.render("templates.html", items=items, add=add)

    # 處理get提交過來的資料
    def get(self, service_method='', argv=''):
        print('method:GET....')
        self.post(service_method, argv)

    # post 和 get 處理之後的調用； data 是處理模板後的內容，string類型，調用self.write或者什麼都不顯示時為None
    def finish(self, data=None):
        print('finish   data:\n' + str(data))
        super(IndexHandler, self).finish(data)

# 找不到頁面的處理
class NotFoundHandler(tornado.web.RequestHandler):
    def prepare(self):
        NOTFOUND_404 = "404.html" # 404檔案地址
        if os.path.exists(NOTFOUND_404):
            #self.set_status(404) # 設 404 狀態,瀏覽器可能會跳轉到自己定義的找不到頁面,要想全部顯示一樣就不要設定此狀態
            self.render(NOTFOUND_404, url = self.request.full_url())
        else:
            self.send_error(404)

# 網址訪問的配置
application = tornado.web.Application([
    (r"/", MainHandler),
    (r"/story/([0-9]+)", StoryHandler),
    (r'^/index/(?P<service_method>.*?)(?P<argv>/.*?)?', IndexHandler), # service_method, argv 兩個URL參數可傳遞給函數處理
    (r"/.*", NotFoundHandler), # 找不到頁面,必須放在最後
])

if __name__ == "__main__":
    http_server = tornado.httpserver.HTTPServer(application) # 載入配置
    http_server.listen(8088) # 監聽連接埠號碼
    tornado.ioloop.IOLoop.instance().start() # 啟動
    # 測試網址:
    # http://localhost:8088/
    # http://127.0.0.1:8088/story/555
    # http://127.0.0.1:8088/index/test/test2/kkkk