node中的koa2

建立koa2工程

首先，咱們建立一個目錄hello-koa並做爲工程目錄用VS Code打開。而後，咱們建立app.js，輸入如下代碼：

// 導入koa，和koa 1.x不一樣，在koa2中，咱們導入的是一個class，所以用大寫的Koa表示:
const Koa=require('koa2');

// 建立一個Koa對象表示web app自己:
const app = new Koa();

// 對於任何請求，app將調用該異步函數處理請求：
app.use(async (ctx, next) => {
    await next();
    ctx.response.type = 'text/html';
    ctx.response.body = '<h1>Hello, koa2!</h1>';
});

// 在端口3000監聽:
app.listen(3000);
console.log('app started at port 3000...');
//能夠在http://127.0.0.1:3000訪問

對於每個http請求，koa將調用咱們傳入的異步函數來處理：

async (ctx, next) => {
    await next();
    // 設置response的Content-Type:
    ctx.response.type = 'text/html';
    // 設置response的內容:
    ctx.response.body = '<h1>Hello, koa2!</h1>';
}

其中，參數ctx是由koa傳入的封裝了request和response的變量，咱們能夠經過它訪問request和response，next是koa傳入的將要處理的下一個異步函數。

上面的異步函數中，咱們首先用await next();處理下一個異步函數，而後，設置response的Content-Type和內容。

由async標記的函數稱爲異步函數，在異步函數中，能夠用await調用另外一個異步函數，這兩個關鍵字將在ES7中引入。

廖老師官網上還探討了koa2這個包怎麼裝，可是如今koa2已經嵌入了node中，不用另外npm安裝，這裏就忽略了，直接用require在項目中引入使用便可。

koa middleware（koa的核心代碼   中間件）

讓咱們再仔細看看koa的執行邏輯。核心代碼是：

app.use(async (ctx, next) => {
    await next();
    ctx.response.type = 'text/html';
    ctx.response.body = '<h1>Hello, koa2!</h1>';
});

每收到一個http請求，koa就會調用經過app.use()註冊的async函數，並傳入ctx和next參數。

咱們能夠對ctx操做，並設置返回內容。可是爲何要調用await next()？

緣由是koa把不少async函數組成一個處理鏈，每一個async函數均可以作一些本身的事情，而後用await next()來調用下一個async函數。咱們把每一個async函數稱爲middleware，這些middleware能夠組合起來，完成不少有用的功能。

例如，能夠用如下3個middleware組成處理鏈，依次打印日誌，記錄處理時間，輸出HTML：

app.use(async (ctx, next) => {
    console.log(`${ctx.request.method} ${ctx.request.url}`); // 打印URL
    await next(); // 調用下一個middleware
});

app.use(async (ctx, next) => {
    const start = new Date().getTime(); // 當前時間
    await next(); // 調用下一個middleware
    const ms = new Date().getTime() - start; // 耗費時間
    console.log(`Time: ${ms}ms`); // 打印耗費時間
});

app.use(async (ctx, next) => {
    await next();
    ctx.response.type = 'text/html';
    ctx.response.body = '<h1>Hello, koa2!</h1>';
});

middleware的順序很重要，也就是調用app.use()的順序決定了middleware的順序。

此外，若是一個middleware沒有調用await next()，會怎麼辦？答案是後續的middleware將再也不執行了。這種狀況也很常見，例如，一個檢測用戶權限的middleware能夠決定是否繼續處理請求，仍是直接返回403錯誤：

app.use(async (ctx, next) => {
    if (await checkUserPermission(ctx)) {
        await next();
    } else {
        ctx.response.status = 403;
    }
});

理解了middleware，咱們就已經會用koa了！

最後注意ctx對象有一些簡寫的方法，例如ctx.url至關於ctx.request.url，ctx.type至關於ctx.response.type。