上下文模塊
上下文模塊主要是針對 HTTP 請求中,request 和 response 的進一步封裝,他包括用戶的輸入和輸出,用戶的輸入即為 request,context 模塊中提供了 Input 對象進行解析,用戶的輸出即為 response,context 模塊中提供了 Output 對象進行輸出。
context 對象
context 對象是對 Input 和 Output 的封裝,里面封裝了幾個方法:
- Redirect
- Abort
- WriteString
- GetCookie
- SetCookie
context 對象是 Filter 函數的參數對象,這樣你就可以通過 filter 來修改相應的數據,或者提前結束整個的執(zhí)行過程。
Input 對象
Input 對象是針對 request 的封裝,里面通過 reqeust 實現很多方便的方法,具體如下:
- Protocol獲取用戶請求的協議,例如 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,那么調用該函數返回 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在路由設置的時候可以設置參數,這個是用來獲取那些參數的,例如 Param(":id"),返回12
- Query該函數返回 Get 請求和 Post 請求中的所有數據,和 PHP 中 $_REQUEST 類似
- Header返回相應的 header 信息,例如 Header("Accept-Language"),就返回請求頭中對應的信息 zh-CN,zh;q=0.8,en;q=0.6
- Cookie返回請求中的 cookie 數據,例如 Cookie("username"),就可以獲取請求頭中攜帶的 cookie 信息中 username 對應的值
- Sessionsession 是用戶可以初始化的信息,默認采用了 beego 的 session 模塊中的 Session 對象,用來獲取存儲在服務器端中的數據。
- Body返回請求 Body 中數據,例如 API 應用中,很多用戶直接發(fā)送 json 數據包,那么通過 Query 這種函數無法獲取數據,就必須通過該函數獲取數據。該函數已經 beego 1.5 版本之后刪除,目前可以通過 RequestBody 獲取數據。
- GetData用來獲取 Input 中 Data 中的數據
- SetData用來設置 Input 中 Data 的值,上面 GetData 和這個函數都是用來方便用戶在 Filter 中傳遞數據到 Controller 中來執(zhí)行
Output 對象
Output 是針對 Response 的封裝,里面提供了很多方便的方法:
- Header設置輸出的 header 信息,例如 Header("Server","beego")
- Body設置輸出的內容信息,例如 Body([]byte("astaxie"))
- Cookie設置輸出的 cookie 信息,例如 Cookie("sessionID","beegoSessionID")
- Json把 Data 格式化為 Json,然后調用 Body 輸出數據
- Jsonp把 Data 格式化為 Jsonp,然后調用 Body 輸出數據
- Xml把 Data 格式化為 Xml,然后調用 Body 輸出數據
- Download把 file 路徑傳遞進來,然后輸出文件給用戶
- ContentType設置輸出的 ContentType
- SetStatus設置輸出的 status
- Session設置在服務器端保存的值,例如 Session("username","astaxie"),這樣用戶就可以在下次使用的時候讀取
- IsCachable根據 status 判斷,是否為緩存類的狀態(tài)
- IsEmpty根據 status 判斷,是否為輸出內容為空的狀態(tài)
- IsOk根據 status 判斷,是否為 200 的狀態(tài)
- IsSuccessful根據 status 判斷,是否為正常的狀態(tài)
- IsRedirect根據 status 判斷,是否為跳轉類的狀態(tài)
- IsForbidden根據 status 判斷,是否為禁用類的狀態(tài)
- IsNotFound根據 status 判斷,是否為找不到資源類的狀態(tài)
- IsClientError根據 status 判斷,是否為請求客戶端錯誤的狀態(tài)
- IsServerError根據 status 判斷,是否為服務器端錯誤的狀態(tài)
更多建議: