1. 程式人生 > >Tornado框架簡介(二)

Tornado框架簡介(二)

IT ali cati tput 靜態 特定 with 命名方式 method

--------------------Application--------------------
1、settings
1、debug=True:,設置tornado是否工作在調試模式,默認為False即工作在生產模式。當設置debug=True 後,tornado會工作在調試/開發模式,在此種模式下,可以根據設置修改tornado提供的其他幾種特性

2、autoreload=True:自動重啟,tornado應用會監控我們的源代碼文件,當有改動保存後便會重啟程序,這可以減少我們手動重啟程序的次數。需要註意的是,一旦我們保存的更改有錯誤,自動重啟會導致程序報錯而退出,從而需要我們保存修正錯誤後手動啟動程序。

3、compiled_templite_carch = False:取消緩存編譯的模板

4、static_hash_cache = False:取消緩存靜態文件hash值

5、server_traceback = True:提供追蹤信息,當RequestHandler或者其子類拋出一個異常而未被捕獲後,會生成一個包含追蹤信息的頁面

6、
    import tornado.web
    app = tornado.web.Application([],debug=True)

2、路由映射
1、Application中列表中的信息
app = tornado.web.Application([
(r"/", Indexhandler),
(r"/cpp", SubjectHandler, {"subject":"c++"}),
url(r"/python", StaticFileHandler, {"subject":"python"}, name="static_url")
],
debug = True
)

2、對於路由中的字典,會傳入到對應的RequestHandler的initialize()方法中。
    from tornado.web import RequestHandler

    class StaticFileHandler(RequestHandler):
        def initialize(self):
            self.subject = subject

        def get(self):
            self.write(self.subject)

3、對於路由中的name字段,註意此時不能再使用元組,而應使用tornado.web.url來構建。name是給該路由起一個名字,可以通過調用RequestHandler.reverse_url(name)來獲取該名子對應的url。
    def get(self):
        self.write("<a href="+RequestHandler.reverse_url(‘static_url‘)+"></a>")

--------------------輸入--------------------
1、獲取查詢字符串參數
1、get_query_argument(name,default=_ARG_DEFAULT,strip=True)
1、name:從請求的查詢字符串中返回指定參數name的值,如果出現多個同名參數,則返回最後一個的值。

    2、default:為設值未傳name參數時返回的默認值,如若default也未設置,則會拋出tornado.web.MissingArgumentError異常。

    3、strip:表示是否過濾掉左右兩邊的空白字符,默認為過濾。

2、get_query_arguments(name,strip=True)
    1、從請求的查詢字符串中返回指定參數name的值,註意返回的是list列表(即使對應name參數只有一個值)。若未找到name參數,則返回空列表[]。

2、獲取請求體參數
1、get_body_argument(name,default=_ARG_DEFAULT,strip=True)
從請求體中返回指定參數name的值,如果出現多個同名參數,則返回最後一個的值。

2、get_body_argument(name,strip=True)
    從請求體中返回指定參數name的值,註意返回的是list列表(即使對應name參數只有一個值)。若未找到name參數,則返回空列表[]。

3、前兩類方法的整合
1、get_argument(name,default=_ARG_DEFAULT,strip=True)
從請求體和查詢字符串中返回指定參數name的值,如果出現多個同名參數,則返回最後一個的值。

2、get_argument(name,strip=True)
    從請求體和查詢字符串中返回指定參數name的值,註意返回的是list列表(即使對應name參數只有一個值)。若未找到name參數,則返回空列表[]。

4、關於請求的其他信息
RequestHandler.request 對象存儲了關於請求的相關信息,具體屬性有:
1、method HTTP的請求方式,如GET或POST;

    2、host 被請求的主機名;

    3、uri 請求的完整資源標示,包括路徑和查詢字符串;

    4、path 請求的路徑部分;

    5、query 請求的查詢字符串部分;

    6、version 使用的HTTP版本;

    7、headers 請求的協議頭,是類字典型的對象,支持關鍵字索引的方式獲取特定協議頭信息
        1、request.headers["Content-Type"]

    8、body 請求體數據;

    9、remote_ip 客戶端的IP地址;

    10、files 用戶上傳的文件,為字典類型
        tornado.httputil.HTTPFile是接收到的文件對象,它有三個屬性:
        1、filename 文件的實際名字,與form_filename1不同,字典中的鍵名代表的是表單對應項的名字;

        2、body 文件的數據實體;

        3、content_type 文件的類型。 這三個對象屬性可以像字典一樣支持關鍵字索引,
            request.files["form_filename1"][0]["body"]。

5、正則提取uri
tornado中對於路由映射也支持正則提取uri,提取出來的參數會作為RequestHandler中對應請求方式的成員方法參數。若在正則表達式中定義了名字,則參數按名傳遞;若未定義名字,則參數按順序傳遞。提取出來的參數會作為對應請求方式的成員方法的參數。

    (r"/sub-city/(.+)/([a-z]+)", SubjectCityHandler), # 無名方式
    (r"/sub-date/(?P<subject>.+)/(?P<date>\d+)", SubjectDateHandler), # 命名方式

    class SubjectCityHandler(RequestHandler):
        def get(self, subject, city):
            self.write(("Subject: %s<br/>City: %s" % (subject, city)))

--------------------輸出--------------------
1、write(chunk)
class IndexHandler(RequestHandler):
def get(self):
self.write("hello itcast!")

2、set_header(name, value)
利用set_header(name, value)方法,可以手動設置一個名為name、值為value的響應頭header字段
self.set_header("Content-Type", "application/json; charset=UTF-8")

3、set_default_headers()
該方法會在進入HTTP處理方法前先被調用,可以重寫此方法來預先設置默認的headers
class IndexHandler(RequestHandler):
def set_default_headers(self):
print "執行了set_default_headers()"

設置get與post方式的默認響應體格式為json

        self.set_header("Content-Type", "application/json; charset=UTF-8")
        # 設置一個名為webServer、值為Hello的header
        self.set_header("webServer", "Hello")

4、set_status(status_code, reason=None)
1、status_code int類型,狀態碼,若reason為None,則狀態碼必須為下表中的。

2、reason string類型,描述狀態碼的詞組,若為None,則會被自動填充為下表中的內容。

5、redirect(url)
class IndexHandler(RequestHandler):
"""對應/"""
def get(self):
self.write("主頁")

class LoginHandler(RequestHandler):
    """對應/login"""
    def get(self):
        self.write(‘<form method="post"><input type="submit" value="登陸"></form>‘)

    def post(self):
        self.redirect("/")

6、send_error(status_code=500, **kwargs)
拋出HTTP錯誤狀態碼status_code,默認為500,kwargs為可變命名參數。使用send_error拋出錯誤後tornado會調用write_error()方法進行處理,並返回給瀏覽器處理後的錯誤頁面。
class IndexHandler(RequestHandler):
def get(self):
err_code = self.get_argument("code", None) # 註意返回的是unicode字符串,下同
err_title = self.get_argument("title", "")
err_content = self.get_argument("content", "")
if err_code:
self.send_error(err_code, title=err_title, content=err_content)
else:
self.write("主頁")

7、write_error(status_code, kwargs)
用來處理send_error拋出的錯誤信息並返回給瀏覽器錯誤信息頁面。可以重寫此方法來定制自己的錯誤顯示頁面
def write_error(self, status_code,
kwargs):
self.write(u"<h1>出錯了,程序員GG正在趕過來!</h1>")
self.write(u"<p>錯誤名:%s</p>" % kwargs["title"])
self.write(u"<p>錯誤詳情:%s</p>" % kwargs["content"])

--------------------Tornado接口與調用順序--------------------
1、initialize()
對應每個請求的處理類Handler在構造一個實例後首先執行initialize()方法。在講輸入時提到,路由映射中的第三個字典型參數會作為該方法的命名參數傳遞

class ProfileHandler(RequestHandler):
    def initialize(self, database):
        self.database = database

    def get(self):
        ...

app = Application([
    (r‘/user/(.*)‘, ProfileHandler, dict(database=database)),
    ])

2、perpare()
預處理,即在執行對應請求方式的HTTP方法(如get、post等)前先執行,註意:不論以何種HTTP方式請求,都會執行prepare()方法。

def prepare(self):
    if self.request.headers.get("Content-Type").startswith("application/json"):
        self.json_dict = json.loads(self.request.body)
    else:
        self.json_dict = None

3、HTTP方法
1、get:請求指定的頁面信息,並返回實體主體。

2、head:類似get請求,只不過返回的響應中沒有具體的內容,用於獲取報頭。

3、post:向指定資源提交數據進行處理請求(例如提交表單或上傳文件)。數據被包含在請求體中。POST請求可能會導致新的資源的建立和/或已有資源的修改。

4、delete:請求服務器刪除指定的內容。

5、patch:請求修改局部數據。

6、put:從客戶端向服務器傳送的數據取代指定的文檔的內容。

7、options:返回給定URL支持的所有HTTP方法

4、on_finish()
在請求處理結束後調用,即在調用HTTP方法後調用。通常該方法用來進行資源清理釋放或處理日誌等。註意:請盡量不要在此方法中進行響應輸出。

5、set_default_headers()

6、write_error()

7、調用順序
1、測試
class IndexHandler(RequestHandler):

    def initialize(self):
        print "調用了initialize()"

    def prepare(self):
        print "調用了prepare()"

    def set_default_headers(self):
        print "調用了set_default_headers()"

    def write_error(self, status_code, **kwargs):
        print "調用了write_error()"

    def get(self):
        print "調用了get()"

    def post(self):
        print "調用了post()"
        self.send_error(200)  # 註意此出拋出了錯誤

    def on_finish(self):
        print "調用了on_finish()"

2、在正常情況未拋出錯誤時,調用順序為:
    1、set_defautl_headers()

    2、initialize()

    3、prepare()

    4、HTTP方法

    5、on_finish()

3、在有錯誤拋出時,調用順序為:
    1、set_default_headers()

    2、initialize()

    3、prepare()

    4、HTTP方法

    5、set_default_headers()

    6、write_error()

    7、on_finish()

Tornado框架簡介(二)