3.3 輸出

1. write(chunk)

將chunk數(shù)據(jù)寫到輸出緩沖區(qū)。如我們?cè)谥暗氖纠a中寫的：

class IndexHandler(RequestHandler):
    def get(self):
        self.write("hello itcast!")

想一想，可不可以在同一個(gè)處理方法中多次使用write方法？

下面的代碼會(huì)出現(xiàn)什么效果？

class IndexHandler(RequestHandler):
    def get(self):
        self.write("hello itcast 1!")
        self.write("hello itcast 2!")
        self.write("hello itcast 3!")

write方法是寫到緩沖區(qū)的，我們可以像寫文件一樣多次使用write方法不斷追加響應(yīng)內(nèi)容，最終所有寫到緩沖區(qū)的內(nèi)容一起作為本次請(qǐng)求的響應(yīng)輸出。

想一想，如何利用write方法寫json數(shù)據(jù)？

import json

class IndexHandler(RequestHandler):
    def get(self):
        stu = {
            "name":"zhangsan",
            "age":24,
            "gender":1,
        }
        stu_json = json.dumps(stu)
        self.write(stu_json)

實(shí)際上，我們可以不用自己手動(dòng)去做json序列化，當(dāng)write方法檢測(cè)到我們傳入的chunk參數(shù)是字典類型后，會(huì)自動(dòng)幫我們轉(zhuǎn)換為json字符串。

class IndexHandler(RequestHandler):
    def get(self):
        stu = {
            "name":"zhangsan",
            "age":24,
            "gender":1,
        }
        self.write(stu)

兩種方式有什么差異？

對(duì)比一下兩種方式的響應(yīng)頭header中Content-Type字段，自己手動(dòng)序列化時(shí)為Content-Type:text/html; charset=UTF-8，而采用write方法時(shí)為Content-Type:application/json; charset=UTF-8。

write方法除了幫我們將字典轉(zhuǎn)換為json字符串之外，還幫我們將Content-Type設(shè)置為application/json; charset=UTF-8。

2. set_header(name, value)

利用set_header(name, value)方法，可以手動(dòng)設(shè)置一個(gè)名為name、值為value的響應(yīng)頭header字段。

用set_header方法來完成上面write所做的工作。

import json

class IndexHandler(RequestHandler):
    def get(self):
        stu = {
            "name":"zhangsan",
            "age":24,
            "gender":1,
        }
        stu_json = json.dumps(stu)
        self.write(stu_json)
        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。注意：在HTTP處理方法中使用set_header()方法會(huì)覆蓋掉在set_default_headers()方法中設(shè)置的同名header。

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è)名為itcast、值為python的header
        self.set_header("itcast", "python")

    def get(self):
        print "執(zhí)行了get()"
        stu = {
            "name":"zhangsan",
            "age":24,
            "gender":1,
        }
        stu_json = json.dumps(stu)
        self.write(stu_json)
        self.set_header("itcast", "i love python") # 注意此處重寫了header中的itcast字段

    def post(self):
        print "執(zhí)行了post()"
        stu = {
            "name":"zhangsan",
            "age":24,
            "gender":1,
        }
        stu_json = json.dumps(stu)
        self.write(stu_json)

終端中打印出的執(zhí)行順序：

day60_tornado-深入tornado-01.png

get請(qǐng)求方式的響應(yīng)header:

day60_tornado-深入tornado-02.png

post請(qǐng)求方式的響應(yīng)header:

day60_tornado-深入tornado-03.png

4. set_status(status_code, reason=None)

為響應(yīng)設(shè)置狀態(tài)碼。

參數(shù)說明：

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

class Err404Handler(RequestHandler):
    """對(duì)應(yīng)/err/404"""
    def get(self):
        self.write("hello itcast")
        self.set_status(404) # 標(biāo)準(zhǔn)狀態(tài)碼，不用設(shè)置reason

class Err210Handler(RequestHandler):
    """對(duì)應(yīng)/err/210"""
    def get(self):
        self.write("hello itcast")
        self.set_status(210, "itcast error") # 非標(biāo)準(zhǔn)狀態(tài)碼，設(shè)置了reason

class Err211Handler(RequestHandler):
    """對(duì)應(yīng)/err/211"""
    def get(self):
        self.write("hello itcast")
        self.set_status(211) # 非標(biāo)準(zhǔn)狀態(tài)碼，未設(shè)置reason，錯(cuò)誤

day60_tornado-深入tornado-04.png

day60_tornado-深入tornado-05.png

day60_tornado-深入tornado-06.png

5. redirect(url)

告知瀏覽器跳轉(zhuǎn)到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):
        self.write("主頁")
        self.send_error(404, content="出現(xiàn)404錯(cuò)誤")

注意：默認(rèn)的write\_error()方法不會(huì)處理send\_error拋出的kwargs參數(shù)，即上面的代碼中content="出現(xiàn)404錯(cuò)誤"是沒有意義的。

嘗試下面的代碼會(huì)出現(xiàn)什么問題？

class IndexHandler(RequestHandler):
    def get(self):
        self.write("主頁")
        self.send_error(404, content="出現(xiàn)404錯(cuò)誤")
        self.write("結(jié)束") # 我們?cè)趕end_error再次向輸出緩沖區(qū)寫內(nèi)容

day60_tornado-深入tornado-07.png

注意：使用send_error()方法后就不要再向輸出緩沖區(qū)寫內(nèi)容了！

7. write_error(status_code, **kwargs)

用來處理send_error拋出的錯(cuò)誤信息并返回給瀏覽器錯(cuò)誤信息頁面?？梢灾貙懘朔椒▉矶ㄖ谱约旱腻e(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("主頁")

    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"])

day60_tornado-深入tornado-08.png