Tornado框架簡介（二）

1、settings
    1、debug=True：，設(shè)置tornado是否工作在調(diào)試模式，默認(rèn)為False即工作在生產(chǎn)模式。當(dāng)設(shè)置debug=True 后，tornado會(huì)工作在調(diào)試/開發(fā)模式，在此種模式下，可以根據(jù)設(shè)置修改tornado提供的其他幾種特性

    2、autoreload=True：自動(dòng)重啟，tornado應(yīng)用會(huì)監(jiān)控我們的源代碼文件，當(dāng)有改動(dòng)保存后便會(huì)重啟程序，這可以減少我們手動(dòng)重啟程序的次數(shù)。需要注意的是，一旦我們保存的更改有錯(cuò)誤，自動(dòng)重啟會(huì)導(dǎo)致程序報(bào)錯(cuò)而退出，從而需要我們保存修正錯(cuò)誤后手動(dòng)啟動(dòng)程序。

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

    4、static_hash_cache = False：取消緩存靜態(tài)文件hash值

    5、server_traceback = True：提供追蹤信息，當(dāng)RequestHandler或者其子類拋出一個(gè)異常而未被捕獲后，會(huì)生成一個(gè)包含追蹤信息的頁面

    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、對(duì)于路由中的字典，會(huì)傳入到對(duì)應(yīng)的RequestHandler的initialize()方法中。
        from tornado.web import RequestHandler

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

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


    3、對(duì)于路由中的name字段，注意此時(shí)不能再使用元組，而應(yīng)使用tornado.web.url來構(gòu)建。name是給該路由起一個(gè)名字，可以通過調(diào)用RequestHandler.reverse_url(name)來獲取該名子對(duì)應(yīng)的url。
        def get(self):
            self.write("<a href="+RequestHandler.reverse_url('static_url')+"></a>")


--------------------輸入--------------------
1、獲取查詢字符串參數(shù)
    1、get_query_argument(name,default=_ARG_DEFAULT,strip=True)
        1、name：從請(qǐng)求的查詢字符串中返回指定參數(shù)name的值，如果出現(xiàn)多個(gè)同名參數(shù)，則返回最后一個(gè)的值。

        2、default：為設(shè)值未傳name參數(shù)時(shí)返回的默認(rèn)值，如若default也未設(shè)置，則會(huì)拋出tornado.web.MissingArgumentError異常。

        3、strip：表示是否過濾掉左右兩邊的空白字符，默認(rèn)為過濾。

    2、get_query_arguments(name,strip=True)
        1、從請(qǐng)求的查詢字符串中返回指定參數(shù)name的值，注意返回的是list列表（即使對(duì)應(yīng)name參數(shù)只有一個(gè)值）。若未找到name參數(shù)，則返回空列表[]。

2、獲取請(qǐng)求體參數(shù)
    1、get_body_argument(name,default=_ARG_DEFAULT,strip=True)
        從請(qǐng)求體中返回指定參數(shù)name的值，如果出現(xiàn)多個(gè)同名參數(shù)，則返回最后一個(gè)的值。

    2、get_body_argument(name,strip=True)
        從請(qǐng)求體中返回指定參數(shù)name的值，注意返回的是list列表（即使對(duì)應(yīng)name參數(shù)只有一個(gè)值）。若未找到name參數(shù)，則返回空列表[]。

3、前兩類方法的整合
    1、get_argument(name,default=_ARG_DEFAULT,strip=True)
        從請(qǐng)求體和查詢字符串中返回指定參數(shù)name的值，如果出現(xiàn)多個(gè)同名參數(shù)，則返回最后一個(gè)的值。

    2、get_argument(name,strip=True)
        從請(qǐng)求體和查詢字符串中返回指定參數(shù)name的值，注意返回的是list列表（即使對(duì)應(yīng)name參數(shù)只有一個(gè)值）。若未找到name參數(shù)，則返回空列表[]。

4、關(guān)于請(qǐng)求的其他信息
    RequestHandler.request 對(duì)象存儲(chǔ)了關(guān)于請(qǐng)求的相關(guān)信息，具體屬性有：
        1、method HTTP的請(qǐng)求方式，如GET或POST;

        2、host 被請(qǐng)求的主機(jī)名；

        3、uri 請(qǐng)求的完整資源標(biāo)示，包括路徑和查詢字符串；

        4、path 請(qǐng)求的路徑部分；

        5、query 請(qǐng)求的查詢字符串部分；

        6、version 使用的HTTP版本；

        7、headers 請(qǐng)求的協(xié)議頭，是類字典型的對(duì)象，支持關(guān)鍵字索引的方式獲取特定協(xié)議頭信息
            1、request.headers["Content-Type"]

        8、body 請(qǐng)求體數(shù)據(jù)；

        9、remote_ip 客戶端的IP地址；

        10、files 用戶上傳的文件，為字典類型
            tornado.httputil.HTTPFile是接收到的文件對(duì)象，它有三個(gè)屬性：
            1、filename 文件的實(shí)際名字，與form_filename1不同，字典中的鍵名代表的是表單對(duì)應(yīng)項(xiàng)的名字；

            2、body 文件的數(shù)據(jù)實(shí)體；

            3、content_type 文件的類型。 這三個(gè)對(duì)象屬性可以像字典一樣支持關(guān)鍵字索引，
                request.files["form_filename1"][0]["body"]。

5、正則提取uri
    tornado中對(duì)于路由映射也支持正則提取uri，提取出來的參數(shù)會(huì)作為RequestHandler中對(duì)應(yīng)請(qǐng)求方式的成員方法參數(shù)。若在正則表達(dá)式中定義了名字，則參數(shù)按名傳遞；若未定義名字，則參數(shù)按順序傳遞。提取出來的參數(shù)會(huì)作為對(duì)應(yīng)請(qǐng)求方式的成員方法的參數(shù)。

        (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)方法，可以手動(dòng)設(shè)置一個(gè)名為name、值為value的響應(yīng)頭header字段
     self.set_header("Content-Type", "application/json; charset=UTF-8")

3、set_default_headers()
    該方法會(huì)在進(jìn)入HTTP處理方法前先被調(diào)用，可以重寫此方法來預(yù)先設(shè)置默認(rèn)的headers
    class IndexHandler(RequestHandler):
        def set_default_headers(self):
            print "執(zhí)行了set_default_headers()"
            # 設(shè)置get與post方式的默認(rèn)響應(yīng)體格式為json
            self.set_header("Content-Type", "application/json; charset=UTF-8")
            # 設(shè)置一個(gè)名為webServer、值為Hello的header
            self.set_header("webServer", "Hello")

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

    2、reason string類型，描述狀態(tài)碼的詞組，若為None，則會(huì)被自動(dòng)填充為下表中的內(nèi)容。

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

    class LoginHandler(RequestHandler):
        """對(duì)應(yīng)/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錯(cuò)誤狀態(tài)碼status_code，默認(rèn)為500，kwargs為可變命名參數(shù)。使用send_error拋出錯(cuò)誤后tornado會(huì)調(diào)用write_error()方法進(jìn)行處理，并返回給瀏覽器處理后的錯(cuò)誤頁面。
    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拋出的錯(cuò)誤信息并返回給瀏覽器錯(cuò)誤信息頁面。可以重寫此方法來定制自己的錯(cuò)誤顯示頁面
    def write_error(self, status_code, **kwargs):
            self.write(u"<h1>出錯(cuò)了，程序員GG正在趕過來！</h1>")
            self.write(u"<p>錯(cuò)誤名：%s</p>" % kwargs["title"])
            self.write(u"<p>錯(cuò)誤詳情：%s</p>" % kwargs["content"])


--------------------Tornado接口與調(diào)用順序--------------------
1、initialize()
    對(duì)應(yīng)每個(gè)請(qǐng)求的處理類Handler在構(gòu)造一個(gè)實(shí)例后首先執(zhí)行initialize()方法。在講輸入時(shí)提到，路由映射中的第三個(gè)字典型參數(shù)會(huì)作為該方法的命名參數(shù)傳遞

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

        def get(self):
            ...

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


2、perpare()
    預(yù)處理，即在執(zhí)行對(duì)應(yīng)請(qǐng)求方式的HTTP方法（如get、post等）前先執(zhí)行，注意：不論以何種HTTP方式請(qǐng)求，都會(huì)執(zhí)行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：請(qǐng)求指定的頁面信息，并返回實(shí)體主體。

    2、head：類似get請(qǐng)求，只不過返回的響應(yīng)中沒有具體的內(nèi)容，用于獲取報(bào)頭。

    3、post：向指定資源提交數(shù)據(jù)進(jìn)行處理請(qǐng)求（例如提交表單或上傳文件）。數(shù)據(jù)被包含在請(qǐng)求體中。POST請(qǐng)求可能會(huì)導(dǎo)致新的資源的建立和/或已有資源的修改。

    4、delete：請(qǐng)求服務(wù)器刪除指定的內(nèi)容。

    5、patch：請(qǐng)求修改局部數(shù)據(jù)。

    6、put：從客戶端向服務(wù)器傳送的數(shù)據(jù)取代指定的文檔的內(nèi)容。

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


4、on_finish()
    在請(qǐng)求處理結(jié)束后調(diào)用，即在調(diào)用HTTP方法后調(diào)用。通常該方法用來進(jìn)行資源清理釋放或處理日志等。注意：請(qǐng)盡量不要在此方法中進(jìn)行響應(yīng)輸出。

5、set_default_headers()


6、write_error()


7、調(diào)用順序
    1、測(cè)試
    class IndexHandler(RequestHandler):

        def initialize(self):
            print "調(diào)用了initialize()"

        def prepare(self):
            print "調(diào)用了prepare()"

        def set_default_headers(self):
            print "調(diào)用了set_default_headers()"

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

        def get(self):
            print "調(diào)用了get()"

        def post(self):
            print "調(diào)用了post()"
            self.send_error(200)  # 注意此出拋出了錯(cuò)誤

        def on_finish(self):
            print "調(diào)用了on_finish()"

    2、在正常情況未拋出錯(cuò)誤時(shí)，調(diào)用順序?yàn)椋?br/>        1、set_defautl_headers()

        2、initialize()

        3、prepare()

        4、HTTP方法

        5、on_finish()

    3、在有錯(cuò)誤拋出時(shí)，調(diào)用順序?yàn)椋?br/>        1、set_default_headers()

        2、initialize()

        3、prepare()

        4、HTTP方法

        5、set_default_headers()

        6、write_error()

        7、on_finish(    

   
作者：黑馬程序員人工智能+python培訓(xùn)學(xué)院
首發(fā)：http://python.itheima.com/