摘要：通過杠桿生成器可以讓你引導(dǎo)回調(diào)函數(shù)，極大的提升錯誤處理。這是因為原先很難讓用戶有好的使用的回調(diào)函數(shù)。返回一個回調(diào)函數(shù)，相當(dāng)于方法，來出了請求。使的有效期到期。檢查請求緩存是否刷新，或者內(nèi)容是否發(fā)生改變。

次世代nodejs 的 web框架

koa是由Express幕后團(tuán)隊打造的，目的是更小，更快，更穩(wěn)定的web應(yīng)用和apis。通過杠桿生成器（leveraging generators)Koa可以讓你引導(dǎo)（ditch）回調(diào)函數(shù)，極大的提升錯誤處理。Koa核心不集成任何的中間件，其本身提供的優(yōu)雅的功能套件就能夠?qū)懗黾瓤煊謓ice的服務(wù)器。

Koa需要node7.6.0或更高的版本，因為需要async function支持。
你可以使用自己的版本管理器很快的安裝一個支持的版本。

nvm install 7
npm i koa
node my-koa-app.js

想要在較低版本的node中使用async函數(shù)，我們建議使用babel。

require("babel-core/register")
//然后在加載應(yīng)用的主代碼，這個必須在babel后面
const app = require("./app")

為了編譯和轉(zhuǎn)化async functions你需要在最后的壓縮版本中使用"transform-async-to-generator"或者transform-async-to-module-method插件。例如，在你的.babelrc文件中，進(jìn)行如下設(shè)置。

{
    "plugins":["transform-async-to-generator"]
}

你也可以使用stage-3 persent來代替。

一個Koa應(yīng)用是一個對象，其包含一個數(shù)組，數(shù)組有很多函數(shù)組成的中間件，這些函數(shù)集合起來等待請求，并且執(zhí)行時是按照類棧的方式。koa和很多其他中間件系統(tǒng)相似，你也許是用過Ruby的Rack,Connect等。然而一個設(shè)計的決定行因素是提供高等級"sugar"，與此同時低等級中間件層。因此提升了交互性，魯棒性（軟件設(shè)計術(shù)語，即穩(wěn)定性）并且使得編寫中間件更加的帶勁！

這包括一些常用任務(wù)的方法——例如鏈接協(xié)調(diào)，緩存，代理支持，別用等。盡管提供了大量的有用的方法，但是koa仍然保持了一個較小的體積，因為沒有綁定中間件。

怎么能偶少得了一個hello world應(yīng)用。

const Koa = require("koa");
const app = new Koa();

app.use(ctx => {
    ctx.body = "hello world";
})

app.listen(3000)

koa 的串聯(lián)中間件使用了一個比較傳統(tǒng)的方式，跟你通常用的工具很像。這是因為原先很難讓用戶有好的使用node的回調(diào)函數(shù)。然而使用異步函數(shù)我們能偶“真正得”是有中間件。相較于連接的實現(xiàn)，這個更容易提供一些列函數(shù)/功能來控制，在最后返回便可。koa調(diào)用"downstream",控制流返回"upstream".

下面的例子返回“hello world”，然而最開始請求先通過x-response-time和logging中間件來記錄請求的開始。然后通過返回的中間件產(chǎn)出控制。當(dāng)一個中間件執(zhí)行next()函數(shù)，來延遲和傳遞控制給下一個聲明的中間件。然后直到?jīng)]有中間件需要執(zhí)行downstream了，棧將會松開然后每個中間件復(fù)原去展現(xiàn)自己的“upstream”行為。

應(yīng)用設(shè)置即在實例app上的屬性。當(dāng)前支持如下：

app.env 默認(rèn)是NODE_ENV或者“development”。

app.proxy 當(dāng)設(shè)置為true時，porxy頭部將被信任。

app.subdomainOffset 設(shè)置.subdomains的偏移量。替代[2]。

app.listen(...)
一個Koa應(yīng)用不是一對一的呈現(xiàn)一個htpp服務(wù)器。一個或者多個應(yīng)用也許被添加到一塊形成大的應(yīng)用對應(yīng)一個http服務(wù)器。

app.listen(...)方法是如下的一個語法糖。

const http = require("http")
const Koa = require("koa")
const app = new Koa()
http.createServer(app.callback()).listen(3000)

const http = require("http");
const Koa = require("koa");
const app = new Koa();
http.createServer(app.callback()).listen(3000);
http.createServer(app.callback()).listen(3001);

app.callback()
返回一個回調(diào)函數(shù)，相當(dāng)于http.createServer()方法，來出了請求。

你也可以使用這個方法在你的Connect/Express應(yīng)用中添加koa應(yīng)用。

app.use(function)

添加一個給定的中間件方法來實現(xiàn)它的功能。查看Middleware了解更多。

app.keys=
設(shè)置cookie的鍵。

這些鍵被傳遞到KeyGrip,也許你想使用自己的KeyGrip，可以如下做。

app.keys = ["im a newer secret", "i like turtle"];
app.keys = new KeyGrip(["im a newer secret", "i like turtle"], "sha256");

這些鍵也許是循環(huán)的，并且可以設(shè)置{signed:true}來使用。

ctx.cookies.set("name","tobi",{signed:true})

app.context
app.context是ctx的來源。你可以使用app.context添加額外的屬性到ctx。這對于創(chuàng)建跨越整個app應(yīng)用的屬性或者方法來說是有用的，而且性能更好，在依賴上也跟簡單，可以考慮做一個anti-pattern。

例子，從ctx添加一個數(shù)據(jù)庫引用。

add.context.db = db()

app.use(async (ctx)=>{
    console.log(ctx.db)
})

注意:

通過getter和setter以及Object.difineProperty()設(shè)置的屬性，你只能在app.context使用Object.defineProperty()來編輯他們。（不推薦）

使用父級的ctx和設(shè)置來添加當(dāng)前的應(yīng)用。這樣添加的app就能使用到那些中間件。

除非設(shè)置app.silent是true，不然所有的出無輸出都是標(biāo)準(zhǔn)輸出。默認(rèn)的錯誤輸出不會處理像是err.sttus是404或者err.expose是true。為了自定義錯誤輸出例如日志，你可以添加錯誤事件監(jiān)聽。

app.on("error", err =>
  log.error("server error", err)
);

當(dāng) req/res 周期中出現(xiàn)任何錯誤且無法響應(yīng)客戶端時，Koa 會把 Context(上下文) 實例作為第二個參數(shù)傳遞給 error 事件：

app.on("error", (err, ctx) =>
  log.error("server error", err, ctx)
);

如果有錯誤發(fā)生, 并且還能響應(yīng)客戶端(即沒有數(shù)據(jù)被寫入到 socket), Koa 會返回 500 "Internal Server Error". 這兩種情況都會觸發(fā) app-level 的 error 事件, 用于 logging.

一個Koa環(huán)境（實例）封裝了node原生的請求和返回對象到一個多帶帶的對象中，這個多帶帶的對象提供了許多使用的方法，能夠編寫web應(yīng)用和API。這些HTTP服務(wù)器開發(fā)中經(jīng)常用到的操作被添加到當(dāng)前等級，而不是高等級。他將強(qiáng)制中間件重新實現(xiàn)這些常用的功能。

一個環(huán)境Context在每次請求時被創(chuàng)建，并且被引用至中間件作為接收器，或者定義成this。如下所示。

app.use(function *(){
    this;//這里是koa環(huán)境context
    this.request;//是一個koa請求
    this.response;//是一個koa返回
})

很多context環(huán)境訪問器和方法只是ctx.requestkoa請求或者ctx.responsekoa返回的代理，主要是為了方便。例如ctx.type和ctx.length代表response返回對象，ctx.paht和ctx.methos代表請求。

API 接口。
環(huán)境（Context）定義的方法和訪問器。

ctx.req Node的request對象。

ctx.res Node的response對象。
繞開使用koa的response處理是不支持的。避免使用下面的node屬性。

res.statusCode

res.writeHead()

res.write()

res.end()

ctx.request 一個Koa的request對象。

ctx.response 一個Koa的response對象。

ctx.state
推薦的通過中間件傳遞信息給前端view（顯示）的命名空間。

ctx.app 應(yīng)用實例的引用。

ctx.cookies.get(name,[options])
通過options獲得cookie名字。

signed 要求cookie已經(jīng)簽名。
koa使用cookie模塊，這里只是傳入選項即可。

ctx.coolies.set(name,value,[options])
使用options設(shè)置name的值value。

signed 簽名cookie的值。

expires 使cookie的有效期到期。

path cookie路徑，默認(rèn)/。

domain cookie域

secure 保護(hù)coolie

httpOnly 服務(wù)器端cookie，默認(rèn)值true。
通過設(shè)置options來使用cookie模塊。

ctx.throw([msg],[status],[properties])
處理拋出錯誤的輔助方法，默認(rèn).status的值為500時拋出，koa在返回的信息中適當(dāng)處理。限免的組合也是可疑的。

this.throw(403);

this.throw("name require", 400);

this.throw(400,"name require");

this.throw("something exploded");

例如：this.throw("name require", 400)等于

var err = new Error("name require");
err.status = 400;
throw err;

注意這些是用戶自定義的錯誤，使用err.expose發(fā)出。因此只適合某些客戶端的反饋。這些錯誤不同于內(nèi)置的錯誤信息提醒，因為錯誤的詳細(xì)信息不會泄露。

你也許傳遞一個properties選項對象，他和原來的錯誤信息進(jìn)行了整合，對于人性化體驗很有幫助，它報告?zhèn)€給請求者一個回溯流（upsteam）。

this.throw(401,"access_denied",{user:user});
this.throw("access_denied",{user:user});

koa使用http-errors來創(chuàng)建錯誤。

ctx.assert(value,[msg],[status],[properties])

跑出錯誤輔助方法，類似`.throw()`，當(dāng)`!value`是類似node的`assert()`方法。

this.assert(this.sate.user,401,"User not found, Please login!");

koa使用http-assert實現(xiàn)斷言(assertions)

ctx.response
通過繞開koa內(nèi)置的返回處理(response handling)，你可以明確的設(shè)置this.response = false;如果你想使用原生的res對象處理而不是koa的response處理，那么就使用它。

注意那種用法koa不支持。這也許會打斷koa中間件本來的功能，或者koa也被打斷。使用這個屬性最好考慮一下hack，這是使用傳統(tǒng)的fn(req,res)方法和koa中間件的唯一方便的方法。

請求別名Request aliases
下面的訪問起和Request別名相等。

ctx.header

ctx.headers

ctx.method

ctx.method=

ctx.url

ctx.url=

ctx.originalUrl

ctx.origin

ctx.href

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
下面的訪問起和返回別名相等

ctx.body

ctx.body=

ctx.status

ctx.status=

ctx.message

ctx.message=

ctx.length=

ctx.length

ctx.type

ctx.type=

ctx.handerSent

ctx.redirect()

ctx.attachment()

ctx.set()

ctx.append()

ctx.remove()

ctx.lastModified=

ctx.etag=

一個koa請求Request對象是個建立在node請求request之上的抽象。提供了一些額外的功能，這對每個http服務(wù)器開發(fā)者來說非常有用。

request.header

Request header 對象

request.headers

Requests header 對象,別名`request.header`。

request.method

request.method

request.method=

設(shè)置request method，實現(xiàn)中間件很有用，例如`methodoverride()`。

request.length

返回request Content-lenght值是數(shù)字或者undefined。

request.url

返回rquest URL

request.url=

設(shè)置rquest URL，重寫url時有用。

request.originalUrl

返回request 原始 URL

request.orgin

得到URL的域，包括協(xié)議和host（主機(jī)號）。

this.request.origin
//=>http://example.com

request.href

返回全部request URL,包括協(xié)議，主機(jī)號，和url。

this.request.href
//=>http://example.com/foo/bar?q=1

request.path

返回路徑名（pathname）。

request.path=

設(shè)置請求路徑名字，保存查詢參數(shù)

rquest.querystring

得到原始的查詢參數(shù)，不包含`?`。

request.querystring=

設(shè)置原始的查詢參數(shù)。

request.search

得到原始的查詢字符，帶`?`。

request.search=

設(shè)置原始的查詢字符。

rquest.host

得到主機(jī)號（hostname:port）當(dāng)呈現(xiàn)時。支持`X-Forwarded-Host`當(dāng)`app.proxy`是true，否則是常用的`host`。

request.hostname

當(dāng)有時返回hostname，支持`X-Frowarded-Host`當(dāng)`app.proxy`是true，否則是常用的。

request.type

返回request的`Content-type`，無效的一些參數(shù)，如`charset`。

var ct = this.request.type.
//=>"image/png"

request.charset

當(dāng)有時返回request的charset，或者`undefined`。

this.request.charset
//=>"utf-8"

request.query

返回解析過的查詢字符query-string，如果沒有則返回一個空對象。注意，這個getter不支持嵌套的解析nested parsing。例如：`color=blue&size=small`。

{
    color:"blue",
    size:"small"
}

request.query=
設(shè)置查詢字符query-string到給定的對象。注意給設(shè)置setter不支持嵌套對象。

this.query = {next:"/login"};

request.fresh

檢查請求緩存是否“刷新fresh”，或者內(nèi)容是否發(fā)生改變。這個方法是為了`if-None-Match`和`if-Modified-Since`以及`last-modified`之間的緩存溝通。他必須能夠引用到更改之后的返回頭部response headers

//freshness check requeire stats 20x or 304
this.status = 200;
this.set("ETag","123");

//cache is ok
if(this.fresh) {
    this.status = 304;
    return;
}

//cache is stale
//fetch new data
shis.body = yield db.find("something");

request.stale

與`request.fresh`相反

request.protocol

返回請求協(xié)議，`https`或者`http`。支持`X-Forwarded-Proto`當(dāng)`app.proxy`是true。

request.secure

`this.protocol == "https"`的速記，用以檢查一個求情能否通過安全傳輸層。

request.ip

請求的遠(yuǎn)程地址。支持`X-Forwarded-For`當(dāng)`app.proxy`為true。

request.ips

當(dāng)有`X-Forwarded-For`并且`app.proxy`可用，那么返回這些的ip的一個數(shù)組。
從回溯upstream——>downstream預(yù)定，當(dāng)上述不可用則返回一個空數(shù)組。

request.subdomains

返回子域數(shù)組。
子域是在主域之前的部分，由點`.`分開。默認(rèn)情況下，應(yīng)用的主域都被假設(shè)成倒數(shù)的那兩個。可以通過`app.subdomainOffset`來改變。
例如，如果域是`tobi.ferrest.example.com`，并且`app.subdomainOffset`沒有設(shè)置，那么這個子域是["ferrets","tobi"]。如果設(shè)置`app.subdomainOffset`為3，那么子域是["tobi"]。

request.is(type...)

檢查接下來的請求是否包含`Content-Type`頭部內(nèi)容，它包含任何的mime類型。如果這里沒有請求體，返回undefined。如果沒有內(nèi)容類型，或者匹配失敗，返回false。其他的直接返回內(nèi)容類型（mime）。

//Contetn-type:text/html;charset=utf-8
this.is("html");//=>"html"
this.is("text/html");//=>"text/html"
this.is("text/*", "test/html");//=>"test/html"

//when Content-type is application/json
this.is("json","urlencoded");//=>"json"
this.is("application/json",);//=>"application/json"
this.is("html","application/*",);//=>"application/json"

this.is("html");//=>false

例子：你只想只有圖片能夠發(fā)送到路由

if(this.is("image/*")) {
    //process
}else{
    this.throw(415,"image only!");
}

內(nèi)容協(xié)商 Content Negotiation
koa請求request包含有用的內(nèi)容寫上工具，由accepts和negotaitor支持實現(xiàn)，這些工具是：

request accepts(types)

rquest acceptsEncoding(types)

rquest acceptsCharsets(charsets)

rquest acceptsLanguages(langs)
如果沒有提供類型，那么所有可接受的類型將被返回。

如果提供了多個類型，最優(yōu)匹配獎杯返回。如果沒有匹配到，返回false，并且你應(yīng)該發(fā)送406 "Not Acceptable"返回response給客戶端。

在可以接受任何類型的地方丟失了accept頭部。第一個匹配到的將被返回。因此提供科技收的類型是很重要的。

request.accepts(types)

檢查給定的類型是否是可接受的。當(dāng)為true則返回最佳匹配，否則false。類型`type`的值也許是一個或者多個mime類型字符，例如"application/json",擴(kuò)展名是"josn"，或者一個數(shù)組`["josn","html","text/plain"]`。

//Accept:text/html
this.accepts("html")
//=>"html"

//Accept:text/*, application/json
this.accepts("html")
//=>"html"
this.accepts("json", "text")
//=>"json"
this.accepts("application/json")
//=>"application/json"

//Accept.text/*, application/json
this.accepts("image/png")
this.accepts("png")
//=>false

//Accept:text/*,q=.5, application/json
this.accepts(["html", "json"])
this.accepts("html", "json")
//=>json

//No Accepts header
this.accpts("html", "json")
//=>html
this.accepts("json","html")
//=> json

你也許調(diào)用this.accepts()很多次，或者使用switch語句。

switch(this.accepts("json", "html", "text")) {
    case "json": bareak;
    case "html": bareak;
    case "text": bareak;
    default: this.throw(406, "json , html or text only");
}

request.acceptsEncodings(encodings)

檢查編碼`encodings`是否可接受，true時返回最優(yōu)匹配，否則返回false。
注意，你應(yīng)該包含一個`indentity`作為編碼`encodings`之一。

//Accept-Encoding:gzip
this.acceptsEncodings("gzip", "deflate", "identify");
//=>gzip

this.acceptsEncodings(["gzip", "deflate", "identify"])
//=>gzip

當(dāng)沒有參數(shù)時，所有可接受的編碼作為數(shù)組元素返回

//Accept-Encoding:gzip, deflate
this.acceptsEncodings();
//=>["gzip","deflate","identify"]

注意如果用戶明確發(fā)送identify為identify,q=0。雖然這是個特殊例子，你仍然需要處理這個情況，當(dāng)方法返回false時。

request.acceptsCharsets(charsets)

檢查charset是否可接受，為true時返回最優(yōu)匹配，否則返回false。

//Accept-Charset:utf-8, iso-8859-1;q=0.2,utf-7;q=0.5

this.acceptsCharsets("utf-8","utf-7")
//=>utf-8

this.acceptsCharsets(["utf-7","utf-8"]);
//=>utf-8

如果沒有參數(shù)是則返回所有可接受的編碼到一個數(shù)組。

//Accept-Charset:utf-8,iso-8859-1;q=0.2,utf-7;q=0.5
this.acceptsCharsets();
//=>["utf-8","utf-7","iso-8859-7"]

request.acceptLanguages(langs)

檢查langs是否可接受，如果為true則返回最有匹配，否則返回false。

//Accept-Language:en;q=0.8,es,pt
this.acceptsLanguages("es","en");
//=>"es"

this.acceptsLanguages(["en","es"]);
//=>"es"

當(dāng)沒有傳入?yún)?shù)則返回所有的語言。

//Accept-Language:en;q=0.8, es,pt
this.acceptsLanguages();
//=>["es", "pt", "en"]

request.idempotent

價差請求是否idempotent(冪等)

request.socket

返回請求的socket

request.get(field)

返回請求頭header

一個koa返回Response對象是個建立在node請求request之上的抽象。提供了一些額外的功能，這對每個http服務(wù)器開發(fā)者來說非常有用。

response.header
返回header對象

response。headers
返回header對象。response.header的別名

response.status
返回response的狀態(tài)，默認(rèn)情況下response.status沒有默認(rèn)值，而res.statusCode的默認(rèn)值是200。

response.status =
通過數(shù)字設(shè)置狀態(tài)值

100 "continue"繼續(xù)

101 "switch protocols"換協(xié)議

102 "processing"處理中

200 "ok" ok

201 "created"已創(chuàng)建

202 "accepted" 已接受

203 "non-authoritative information"無作者信息

204 "no content" 無內(nèi)容

205 "reset content" 重置內(nèi)容

206 "partial content" 部分內(nèi)容

207 "multi-status" 多狀態(tài)

300 "multiple choices" 多選擇

301 "moved permanently" 移動到永久

302 "moved temporarily" 移動到暫時

303 "see other" 看其他

304 "not modified" 沒有改動

305 "use proxy" 使用代理

307 "temporary redirect" 暫時改向

400 "bad request" 壞請求

401 "unauthorized" 未經(jīng)授權(quán)

402 "payment required" 要求付款

403 "forbidden" 禁止

404 "not found" 沒有發(fā)現(xiàn)

405 "method not allowed" 方法不允許

406 "not acceptable" 不接受

407 "proxy authentication required" 要求代理授權(quán)

408 "request time-out" 請求超時

409 "conflict" 沖突

410 "gone" 消失

411 "length required" 要求長度

412 "precondition failed" 預(yù)處理失敗

413 "request entity too large" 請求量太大

414 "request-uri too large" 請求同意資源太大

415 "unsupported media type" 不支持的媒體類型

416 "requested range not satisfiable" 不滿足請求范圍

417 "expectation failed" 不是期望值

418 "i"m a teapot" 我是個茶壺？？？

422 "unprocessable entity" 錯誤實體

423 "locked" 已鎖定

424 "failed dependency" 依賴錯誤

425 "unordered collection" 未預(yù)定集合

426 "upgrade required" 要求更新

428 "precondition required" 要求前提

429 "too many requests" 過多請求

431 "request header fields too large" 請求頭的域太大

500 "internal server error" 服務(wù)器內(nèi)部錯誤

501 "not implemented" 沒有實現(xiàn)

502 "bad gateway" 網(wǎng)關(guān)錯誤

503 "service unavailable" 不可服務(wù)

504 "gateway time-out" 網(wǎng)關(guān)超時

505 "http version not supported" http版本不支持

506 "variant also negotiates" 多樣協(xié)商

507 "insufficient storage" 存儲不足

509 "bandwidth limit exceeded" 超過帶寬

510 "not extended" 擴(kuò)展錯誤

511 "network authentication required" 要求網(wǎng)路授權(quán)證明
注意：不要擔(dān)心要記太多東西，你可以隨時查看。

response.message
得到返回狀態(tài)的信息。默認(rèn)情況下，response.message是和response.status匹配的。

response.message=
設(shè)置返回狀態(tài)信息。

response.length=
設(shè)置內(nèi)容的長度

response.length
返回內(nèi)容的長度，或者計算出的this.body的大小。值為數(shù)字?；蛘遳ndifined

response.body
得到response的body。

response.body=
設(shè)置返回體(response.body)為如下之一：

String written

Buffer written

Stream piped

Object json-stringified

null no content response

String
Content-type是text/html或者text/plain，charset是utf-8.Content-length也需要設(shè)置。
Buffer
Content-type是application/octet-stream,Content-length也要設(shè)置。
Stream
Content-type是application/octet-stream.
Object
Content-type是application/json.

response.get(field)
得到response頭部的field的值，不區(qū)分大小寫。

var etag = this.get("ETag");

response.set(field, value)

設(shè)置response頭部field的值。

this.set("Cache-control", "no-cache");

response.append(field, value)

給頭部添加額為的域和值。

this.append("Link", "");

response.set(fields)

使用對象設(shè)置頭部的fields

this.set({
    "Etag":"1234",
    "Last-modified":date
});

response.remove(field)

移除頭部的某個域。

resposne.type

返回Content-type的類型，沒有其他參數(shù)——如‘charset’。

var ct = this.type;
//=>image/png

response.type

通過名字或者擴(kuò)展名設(shè)置Content-type

this.type = "text/plain;charset=utf-8";
this.type = "image/png";
this.type=".png";
this.type="png";

注意，每個字符編碼charset都是為你選的最合適的，例如response.type="html"，那么默認(rèn)的字符編碼是utf-8,然而明確定義一個完整的類型，如response.type="text/html"，將不會有指定的字符編碼。

response.is(type...)

很類似于`this.request.is()`。檢查response的類型是否是被支持的類型。這在創(chuàng)建那些對返回進(jìn)行操作的中間件是非常有用。

示例：這是一個壓縮html返回response的中間件，除了stream不被壓縮。

var minify = require("html-minifier");

app.use(function *minifyHtml(next){
    yield next;

    if(!this.response.is("html")) return;

    var body = this.body;
    if(!body||body.pipe) return;

    if(Buffer.isBuffer(body)) body = body.toString();
    this.body = minify(body);
})

response.redirect(url, [alt])

把[302]狀態(tài)碼重導(dǎo)向至`url`。
字符串`back`是一個特殊的例子，提供了引用這支持，當(dāng)引用者不存在或者`/`沒有使用。

this.redirect("back");
this.redirect("back","/index.html");
this.redirect("login");
this.redirect("http://google.com");

為了改變默認(rèn)的狀態(tài)302,只需在這個狀態(tài)嗎出現(xiàn)之前或者出現(xiàn)之后進(jìn)行重導(dǎo)向即可。為了改變body，在其調(diào)用之后進(jìn)行重定向。

this.status = 301;
this.redirect("/cart");
this.body = "Redirecting to shopping cart";

response.attachment([filename])

設(shè)置`Content-disposition`為"attachment"為客戶端發(fā)出下載的信號。
文件的名字是可以指定的。

response.headerSent

檢查返回頭response header是否早已發(fā)送。查看客戶端是否通知錯誤信號非常有用。

response.lastModified

返回`Last-Modified`最后修改頭部的數(shù)據(jù)（如果存在）。

response.LastModified=

設(shè)置`Last-Modified`頭部為一個合適的UTC（國際標(biāo)準(zhǔn)時間）字符串。你也可以設(shè)置其為一個日期或者日期字符串。

this.response.lastModified = new Date();

response.etag=

設(shè)置ETag到一個返回中，包括外面的雙引號。注意，這里沒有相應(yīng)的response.etag的getter。

this.response.etag = crypto.createHash("md5"),update(this.body).digest("hex");

response.vary(field)
激活field。