针对 HTTP 请求中,request (Input)和 response (Output)的进一步封装。
context 对象是对 Input 和 Output 的封装。
Input 对象
具体方法如下:
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 OSX 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 对应的值
Session
session 是用户可以初始化的信息,默认采⽤用了 beego 的 session 模块中的 Session 对象,用来获取存储在服务器端中的数据。
Body
返回请求 Body 中数据,例如 API 应用中,很多用户直接发送 json 数据包,那么通过 Query 这种函数无法获取数据,就必须通过该函数获取数据。该函数已经beego1.5版本之后删除,目前可以通过RequestBody获取数据。
GetData
用来获取 Input 中 Data 中的数据
SetData
用来设置 Input 中 Data 的值,上面 GetData 和这个函数都是用来方便用户在 Filter 中传递数据到 Controller 中来执行
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 判断,是否为缓存类的状态
IsEmpty
根据 status 判断,是否为输出内容为空的状态
IsOk
根据 status 判断,是否为 200 的状态
IsSuccessful
根据 status 判断,是否为正常的状态
IsRedirect
根据 status 判断,是否为跳转类的状态
IsForbidden
根据 status 判断,是否为禁用类的状态
IsNotFound
根据 status 判断,是否为找不到资源类的状态
IsClientError
根据 status 判断,是否为请求客户端错误的状态
IsServerError
根据 status 判断,是否为服务器端错误的状态