# Context(上下文)
# Context(上下文)
Koa Context 将 node 的 `request` 和 `response` 对象封装在一个单独的对象里面，其为编写 web 应用和 API 提供了很多有用的方法。
这些操作在 HTTP 服务器开发中经常使用，因此其被添加在上下文这一层，而不是更高层框架中，因此将迫使中间件需要重新实现这些常用方法。
`context` 在每个 request 请求中被创建，在中间件中作为接收器(receiver)来引用，或者通过 `this` 标识符来引用：
```
app.use(function *(){
this; // is the Context
this.request; // is a koa Request
this.response; // is a koa Response
});
```
许多 context 的访问器和方法为了便于访问和调用，简单的委托给他们的 `ctx.request` 和 `ctx.response` 所对应的等价方法， 比如说 `ctx.type` 和 `ctx.length` 代理了 `response` 对象中对应的方法，`ctx.path` 和 `ctx.method` 代理了 `request` 对象中对应的方法。
## API
`Context` 详细的方法和访问器。
### ctx.req
Node 的 `request` 对象。
### ctx.res
Node 的 `response` 对象。
Koa *不支持* 直接调用底层 res 进行响应处理。请避免使用以下 node 属性：
- `res.statusCode`
- `res.writeHead()`
- `res.write()`
- `res.end()`
### ctx.request
Koa 的 `Request` 对象。
### ctx.response
Koa 的 `Response` 对象。
### ctx.app
应用实例引用。
### ctx.cookies.get(name, \[options\])
获得 cookie 中名为 `name` 的值，`options` 为可选参数：
- 'signed': 如果为 true，表示请求时 cookie 需要进行签名。
注意：Koa 使用了 Express 的 [cookies](https://github.com/jed/cookies) 模块，options 参数只是简单地直接进行传递。
### ctx.cookies.set(name, value, \[options\])
设置 cookie 中名为 `name` 的值，`options` 为可选参数：
- `signed`: 是否要做签名
- `expires`: cookie 有效期时间
- `path`: cookie 的路径，默认为 `/'`
- `domain`: cookie 的域
- `secure`: false 表示 cookie 通过 HTTP 协议发送，true 表示 cookie 通过 HTTPS 发送。
- `httpOnly`: true 表示 cookie 只能通过 HTTP 协议发送
注意：Koa 使用了 Express 的 [cookies](https://github.com/jed/cookies) 模块，options 参数只是简单地直接进行传递。
### ctx.throw(msg, \[status\])
抛出包含 `.status` 属性的错误，默认为 `500`。该方法可以让 Koa 准确的响应处理状态。 Koa支持以下组合：
```
this.throw(403)
this.throw('name required', 400)
this.throw(400, 'name required')
this.throw('something exploded')
```
`this.throw('name required', 400)` 等价于：
```
var err = new Error('name required');
err.status = 400;
throw err;
```
注意：这些用户级错误被标记为 `err.expose`，其意味着这些消息被准确描述为对客户端的响应，而并非使用在您不想泄露失败细节的场景中。
### ctx.respond
为了避免使用 Koa 的内置响应处理功能，您可以直接赋值 `this.repond = false;`。如果您不想让 Koa 来帮助您处理 reponse，而是直接操作原生 `res` 对象，那么请使用这种方法。
注意： 这种方式是不被 Koa 支持的。其可能会破坏 Koa 中间件和 Koa 本身的一些功能。其只作为一种 hack 的方式，并只对那些想要在 Koa 方法和中间件中使用传统 `fn(req, res)` 方法的人来说会带来便利。
## Request aliases
以下访问器和别名与 [Request](#request) 等价：
- `ctx.header`
- `ctx.method`
- `ctx.method=`
- `ctx.url`
- `ctx.url=`
- `ctx.originalUrl`
- `ctx.path`
- `ctx.path=`
- `ctx.query`
- `ctx.query=`
- `ctx.querystring`
- `ctx.querystring=`
- `ctx.host`
- `ctx.hostname`
- `ctx.fresh`
- `ctx.stale`
- `ctx.socket`
- `ctx.protocol`
- `ctx.secure`
- `ctx.ip`
- `ctx.ips`
- `ctx.subdomains`
- `ctx.is()`
- `ctx.accepts()`
- `ctx.acceptsEncodings()`
- `ctx.acceptsCharsets()`
- `ctx.acceptsLanguages()`
- `ctx.get()`
## Response aliases
以下访问器和别名与 [Response](#response) 等价：
- `ctx.body`
- `ctx.body=`
- `ctx.status`
- `ctx.status=`
- `ctx.length=`
- `ctx.length`
- `ctx.type=`
- `ctx.type`
- `ctx.headerSent`
- `ctx.redirect()`
- `ctx.attachment()`
- `ctx.set()`
- `ctx.remove()`
- `ctx.lastModified=`
- `ctx.etag=`
