上下文模塊

上下文模塊主要是針對(duì) HTTP 請(qǐng)求中，request 和 response 的進(jìn)一步封裝，他包括用戶的輸入和輸出，用戶的輸入即為 request，context 模塊中提供了 Input 對(duì)象進(jìn)行解析，用戶的輸出即為 response，context 模塊中提供了 Output 對(duì)象進(jìn)行輸出。

context 對(duì)象

context 對(duì)象是對(duì) Input 和 Output 的封裝，里面封裝了幾個(gè)方法：

• Redirect
• Abort
• WriteString
• GetCookie
• SetCookie

context 對(duì)象是 Filter 函數(shù)的參數(shù)對(duì)象，這樣你就可以通過 filter 來修改相應(yīng)的數(shù)據(jù)，或者提前結(jié)束整個(gè)的執(zhí)行過程。

Input 對(duì)象

Input 對(duì)象是針對(duì) request 的封裝，里面通過 reqeust 實(shí)現(xiàn)很多方便的方法，具體如下：

• Protocol獲取用戶請(qǐng)求的協(xié)議，例如 HTTP/1.0
• Uri用戶請(qǐng)求的 RequestURI，例如 /hi?id=1001
• Url請(qǐng)求的 URL 地址，例如 /hi
• Site請(qǐng)求的站點(diǎn)地址,scheme+doamin 的組合，例如 http://beego.me
• Scheme請(qǐng)求的 scheme，例如 "http" 或者 "https"
• Domain請(qǐng)求的域名，例如 beego.me
• Host請(qǐng)求的域名，和 domain 一樣
• Method請(qǐng)求的方法，標(biāo)準(zhǔn)的 HTTP 請(qǐng)求方法，例如 GET、POST 等
• Is判斷是否是某一個(gè)方法，例如 Is("GET") 返回 true
• IsAjax判斷是否是 AJAX 請(qǐng)求，如果是返回 true，不是返回 false
• IsSecure判斷當(dāng)前請(qǐng)求是否 HTTPS 請(qǐng)求，是返回 true，否返回 false
• IsWebsocket判斷當(dāng)前請(qǐng)求是否 Websocket 請(qǐng)求，如果是返回 true，否返回 false
• IsUpload判斷當(dāng)前請(qǐng)求是否有文件上傳，有返回 true，否返回 false
• IP返回請(qǐng)求用戶的 IP，如果用戶通過代理，一層一層剝離獲取真實(shí)的 IP
• Proxy返回用戶代理請(qǐng)求的所有 IP
• Refer返回請(qǐng)求的 refer 信息
• SubDomains返回請(qǐng)求域名的根域名，例如請(qǐng)求是 blog.beego.me，那么調(diào)用該函數(shù)返回 beego.me
• Port返回請(qǐng)求的端口，例如返回 8080
• UserAgent返回請(qǐng)求的 UserAgent，例如 Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.57 Safari/537.36
• Param在路由設(shè)置的時(shí)候可以設(shè)置參數(shù)，這個(gè)是用來獲取那些參數(shù)的，例如 Param(":id"),返回12
• Query該函數(shù)返回 Get 請(qǐng)求和 Post 請(qǐng)求中的所有數(shù)據(jù)，和 PHP 中 $_REQUEST 類似
• Header返回相應(yīng)的 header 信息，例如 Header("Accept-Language")，就返回請(qǐng)求頭中對(duì)應(yīng)的信息 zh-CN,zh;q=0.8,en;q=0.6
• Cookie返回請(qǐng)求中的 cookie 數(shù)據(jù)，例如 Cookie("username")，就可以獲取請(qǐng)求頭中攜帶的 cookie 信息中 username 對(duì)應(yīng)的值
• Sessionsession 是用戶可以初始化的信息，默認(rèn)采用了 beego 的 session 模塊中的 Session 對(duì)象，用來獲取存儲(chǔ)在服務(wù)器端中的數(shù)據(jù)。
• Body返回請(qǐng)求 Body 中數(shù)據(jù)，例如 API 應(yīng)用中，很多用戶直接發(fā)送 json 數(shù)據(jù)包，那么通過 Query 這種函數(shù)無法獲取數(shù)據(jù)，就必須通過該函數(shù)獲取數(shù)據(jù)。該函數(shù)已經(jīng) beego 1.5 版本之后刪除，目前可以通過 RequestBody 獲取數(shù)據(jù)。
• GetData用來獲取 Input 中 Data 中的數(shù)據(jù)
• SetData用來設(shè)置 Input 中 Data 的值，上面 GetData 和這個(gè)函數(shù)都是用來方便用戶在 Filter 中傳遞數(shù)據(jù)到 Controller 中來執(zhí)行

Output 對(duì)象

Output 是針對(duì) Response 的封裝，里面提供了很多方便的方法：

• Header設(shè)置輸出的 header 信息，例如 Header("Server","beego")
• Body設(shè)置輸出的內(nèi)容信息，例如 Body([]byte("astaxie"))
• Cookie設(shè)置輸出的 cookie 信息，例如 Cookie("sessionID","beegoSessionID")
• Json把 Data 格式化為 Json，然后調(diào)用 Body 輸出數(shù)據(jù)
• Jsonp把 Data 格式化為 Jsonp，然后調(diào)用 Body 輸出數(shù)據(jù)
• Xml把 Data 格式化為 Xml，然后調(diào)用 Body 輸出數(shù)據(jù)
• Download把 file 路徑傳遞進(jìn)來，然后輸出文件給用戶
• ContentType設(shè)置輸出的 ContentType
• SetStatus設(shè)置輸出的 status
• Session設(shè)置在服務(wù)器端保存的值，例如 Session("username","astaxie")，這樣用戶就可以在下次使用的時(shí)候讀取
• IsCachable根據(jù) status 判斷，是否為緩存類的狀態(tài)
• IsEmpty根據(jù) status 判斷，是否為輸出內(nèi)容為空的狀態(tài)
• IsOk根據(jù) status 判斷，是否為 200 的狀態(tài)
• IsSuccessful根據(jù) status 判斷，是否為正常的狀態(tài)
• IsRedirect根據(jù) status 判斷，是否為跳轉(zhuǎn)類的狀態(tài)
• IsForbidden根據(jù) status 判斷，是否為禁用類的狀態(tài)
• IsNotFound根據(jù) status 判斷，是否為找不到資源類的狀態(tài)
• IsClientError根據(jù) status 判斷，是否為請(qǐng)求客戶端錯(cuò)誤的狀態(tài)
• IsServerError根據(jù) status 判斷，是否為服務(wù)器端錯(cuò)誤的狀態(tài)