上下文模塊

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

context 對象

context 對象是對 Input 和 Output 的封裝，里面封裝了幾個方法：

• Redirect
• Abort
• WriteString
• GetCookie
• SetCookie

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

Input 對象

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

• Protocol獲取用戶請求的協(xié)議，例如 HTTP/1.0
• Uri用戶請求的 RequestURI，例如 /hi?id=1001
• Url請求的 URL 地址，例如 /hi
• Site請求的站點地址,scheme+doamin 的組合，例如 http://beego.me
• Scheme請求的 scheme，例如 "http" 或者 "https"
• Domain請求的域名，例如 beego.me
• Host請求的域名，和 domain 一樣
• Method請求的方法，標準的 HTTP 請求方法，例如 GET、POST 等
• Is判斷是否是某一個方法，例如 Is("GET") 返回 true
• IsAjax判斷是否是 AJAX 請求，如果是返回 true，不是返回 false
• IsSecure判斷當前請求是否 HTTPS 請求，是返回 true，否返回 false
• IsWebsocket判斷當前請求是否 Websocket 請求，如果是返回 true，否返回 false
• IsUpload判斷當前請求是否有文件上傳，有返回 true，否返回 false
• IP返回請求用戶的 IP，如果用戶通過代理，一層一層剝離獲取真實的 IP
• Proxy返回用戶代理請求的所有 IP
• Refer返回請求的 refer 信息
• SubDomains返回請求域名的根域名，例如請求是 blog.beego.me，那么調(diào)用該函數(shù)返回 beego.me
• Port返回請求的端口，例如返回 8080
• UserAgent返回請求的 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ù)的，例如 Param(":id"),返回12
• Query該函數(shù)返回 Get 請求和 Post 請求中的所有數(shù)據(jù)，和 PHP 中 $_REQUEST 類似
• Header返回相應(yīng)的 header 信息，例如 Header("Accept-Language")，就返回請求頭中對應(yīng)的信息 zh-CN,zh;q=0.8,en;q=0.6
• Cookie返回請求中的 cookie 數(shù)據(jù)，例如 Cookie("username")，就可以獲取請求頭中攜帶的 cookie 信息中 username 對應(yīng)的值
• Sessionsession 是用戶可以初始化的信息，默認采用了 beego 的 session 模塊中的 Session 對象，用來獲取存儲在服務(wù)器端中的數(shù)據(jù)。
• Body返回請求 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 和這個函數(shù)都是用來方便用戶在 Filter 中傳遞數(shù)據(jù)到 Controller 中來執(zhí)行

Output 對象

Output 是針對 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 路徑傳遞進來，然后輸出文件給用戶
• ContentType設(shè)置輸出的 ContentType
• SetStatus設(shè)置輸出的 status
• Session設(shè)置在服務(wù)器端保存的值，例如 Session("username","astaxie")，這樣用戶就可以在下次使用的時候讀取
• 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 判斷，是否為請求客戶端錯誤的狀態(tài)
• IsServerError根據(jù) status 判斷，是否為服務(wù)器端錯誤的狀態(tài)