上下文模块主要是针对 HTTP 请求中,request 和 response 的进一步封装,他包括用户的输入和输出,用户的输入即为 request,context 模块中提供了 Input 对象进行解析,用户的输出即为 response,context 模块中提供了 Output 对象进行输出。
context 对象是对 Input 和 Output 的封装,里面封装了几个方法:
context 对象是 Filter 函数的参数对象,这样你就可以通过 filter 来修改相应的数据,或者提前结束整个的执行过程。
Input 对象是针对 request 的封装,里面通过 reqeust 实现很多方便的方法,具体如下:
名称 | 说明 |
---|---|
Protocol | 获取用户请求的协议,例如 HTTP/1.0 |
Uri | 用户请求的 RequestURI,例如 /hi?id=1001 |
Url | 请求的 URL 地址,例如 /hi |
Site | 请求的站点地址,scheme+domain 的组合,例如 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 对应的值 |
Session | session 是用户可以初始化的信息,默认采用了 beego 的 session 模块中的 Session 对象,用来获取存储在服务器端中的数据。 |
Body | 返回请求 Body 中数据,例如 API 应用中,很多用户直接发送 json 数据包,那么通过 Query 这种函数无法获取数据,就必须通过该函数获取数据。该函数已经 beego 1.5 版本之后删除,目前可以通过 RequestBody 获取数据。 |
GetData | 用来获取 Input 中 Data 中的数据 |
SetData | 用来设置 Input 中 Data 的值,上面 GetData 和这个函数都是用来方便用户在 Filter 中传递数据到 Controller 中来执行 |
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 判断,是否为服务器端错误的状态 |
参考文章: