koa2

時間 2019-11-13

標籤 koa2 koa 简体版

原文原文鏈接

koa就是一種簡單好用的web框架
require引入外部文件
request獲取請求參數（請求(Request)）
響應(Response)

1、基本用法

一、架設HTTP服務

koa架設一個HTTP服務php

const Koa = require('koa');
  const app = new Koa();
  app.listen(3000);

``css

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

app.use(async ctx => {
  ctx.body = 'Hello World';
});

app.listen(3000);

二、Content對象

*Koa提供一個Context對象，表示一次對話的上下文（包括HTTP 請求和HTTP回覆）。經過加工這個對象，就能夠控制返回給用戶的內容。
Context.response.body屬性就是發送給用戶的內容html

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

const main = ctx => {
  ctx.response.body = 'Hello World';
};

app.use(main);
app.listen(3000);

main函數用來設置ctx.response.body。而後app.use方法加載main函數
ctx.response表明HTTP Response ,一樣地ctx.request表明HTTP Request.

三、HTTP Response的類型

Koa默認的返回類型是text/plain，若是想返回其餘類型的內容，能夠利用ctx.request.accepts判斷一下，客戶端但願接受什麼數據（根據HTTP Request的Accept字段），而後使用ctx.response.type指定返回類型。node

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

  const main = ctx => {
    if (ctx.request.accepts('xml')) {
      ctx.response.type = 'xml';
      ctx.response.body = '<data>Hello World</data>';
    } else if (ctx.request.accepts('json')) {
      ctx.response.type = 'json';
      ctx.response.body = { data: 'Hello World' };
    } else if (ctx.request.accepts('html')) {
      ctx.response.type = 'html';
      ctx.response.body = '<p>Hello World</p>';
    } else {
      ctx.response.type = 'text';
      ctx.response.body = 'Hello World';
    }
  };

  app.use(main);
  app.listen(3000);

四、網頁模板

實際開發中，返回給用戶的網頁每每都寫成模板文件，咱們可讓Koa先讀取模板文件，而後將這個模板返回給用戶。web

const fs = require('fs');
  const Koa = require('koa');
  const app = new Koa();

  const main = ctx => {
       ctx.response.type = 'html';
       ctx.response.body = fs.createReadStream('./demos/template.html');
   }

  app.use (main);
  app.listen(3000)

兩個代碼效果是相同數據庫

const fs = require('fs');
const Koa = require('koa');
const app = new Koa();
    
app.use(ctx=>{
       ctx.response.type = 'html';
       ctx.response.body = fs.createReadStream('./demos/template.html');
})
    

app.listen(3000)

五、POST請求如何接收

一、獲取POST請求的步驟

一、解析上下文ctx中的原生node.js對象req。
二、將POST表單數據解析成query string-字符串。
將字符串轉換成JSON格式

二、ctx.request和ctx.req的區別

ctx.request:是Koa2中的Context通過封裝的請求對象，它用起來更直觀和簡單。
ctx.req:是content提供的node.js原生HTTP請求對象。這個雖然不那麼直觀，可是能夠獲得更多的內容，適合咱們深度編程。

三、ctx.method獲得請求類型

Koa2中提供了ctx.method屬性，能夠輕鬆的獲得請求的類型，而後根據請求類型編寫不一樣的相應方法，這在工做中很是經常使用。npm

const Koa = require('koa');
  const app = new Koa();
  app.use(async(ctx)=>{
      //當請求是get請求時，顯示錶單讓用戶填寫
      if(ctx.url === '/' && ctx.method === 'GET'){
          let html = `
          <h1>Koa2 request post demo</h1>
          <form method="POST" action='/'>
              <p>username</p>
              <input name="username"/>  <br/>
              <p>age</p>
              <input name="age" /> <br/>
              <p>website</p>
              <input name="website" />
              <button type="submit">submit</button>
          </form>
          `;
          ctx.body = html;
          //當請求是post請求時
      }else if(ctx.url === '/' && ctx.method === 'POST'){
          ctx.body = '接收到post請求'
      }else{
          //其餘頁面顯示404頁面
          ctx.body = '<h1>404!</h1>'
      }
  })

  app.listen(3000,()=>{
      console.log('demo server is starting at port 3000')
  })

注意，POST必須寫成POST，post不能夠（必須大寫，小寫不行）編程

5（2）、POST請求如何接收（2）

1.解析Node原生POST參數

聲明一個方法，而後用Promise對象進行解析。這裏咱們使用了ctx.req.on來接收事件。json

function parsePostData(ctx){
      return new Promise((resolve,reject)=>{
          try{
              let postdata = '';
              ctx.req.addListener('end',function(){
                  resolve(postdata)
              })
              ctx.req.on('data',(data)=>{
                  postdata += data;
              })

          }catch(error){
              reject(error)
          }
      })
  }

2.POST字符串解析JSON對象

寫一個字符串封裝JSON兌現對象的方法。api

function parseQueryStr(queryStr) {
      let queryData = {};
      let queryStrList = queryStr.split('&');
      console.log(queryStrList);
      for (let [index,queryStr] of queryStrList.entries()){
      //entries() 方法返回一個數組的迭代對象，該對象包含數組的鍵值對 (key/value)。
      //迭代對象中數組的索引值做爲 key， 數組元素做爲 value。
          let itemList = queryStr.split('=');
          console.log(itemList);
          //key:value
          queryData[itemList[0]] = decodeURIComponent(itemList[1]);
          // decodeURIComponent() 函數可對 encodeURIComponent() 函數編碼的 URI 進行解碼。
      }
      return queryData;
  }

所有代碼

const Koa = require('koa');
const app = new Koa();
app.use(async(ctx)=>{
    //當請求是get請求時，顯示錶單讓用戶填寫
    if(ctx.url === '/' && ctx.method === 'GET'){
        let html = `
        <h1>Koa2 request post demo</h1>
        <form method="POST" action='/'>
            <p>username</p>
            <input name="username"/>  <br/>
            <p>age</p>
            <input name="age" /> <br/>
            <p>website</p>
            <input name="website" />
            <button type="submit">submit</button>
        </form>
        `;
        ctx.body = html;
        //當請求是post請求時
    }else if(ctx.url === '/' && ctx.method === 'POST'){
        let postData = await parsePostData(ctx);
        ctx.body = postData;
    }else{
        //其餘頁面顯示404頁面
        ctx.body = '<h1>404!</h1>'
    }
})

function parsePostData(ctx){
    return new Promise((resolve,reject)=>{
        try{
            let postdata = '';
            ctx.req.addListener('end',function(){
                let parseData = parseQueryStr(postdata)
                resolve(parseData)
            })
            ctx.req.on('data',(data)=>{
                postdata += data;
            })

        }catch(error){
            reject(error)
        }
    })
}

function parseQueryStr(queryStr) {
    let queryData = {};
    let queryStrList = queryStr.split('&');
    console.log(queryStrList);
    for (let [index,queryStr] of queryStrList.entries()){
    //entries() 方法返回一個數組的迭代對象，該對象包含數組的鍵值對 (key/value)。
    //迭代對象中數組的索引值做爲 key， 數組元素做爲 value。
        let itemList = queryStr.split('=');
        console.log(itemList);
        //key:value
        queryData[itemList[0]] = decodeURIComponent(itemList[1]);
        // decodeURIComponent() 函數可對 encodeURIComponent() 函數編碼的 URI 進行解碼。
    }
    return queryData;
}

app.listen(3000,()=>{
    console.log('demo server is starting at port 3000')
})

六、get請求的接收

query和querystring區別

在koa2中GET請求經過request接收，可是接受的方法有兩種：query和querystring。
query：返回的是格式化好的參數對象。

querystring：返回的是請求字符串

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

  app.use(async(ctx)=>{
      let url = ctx.url;
      //從request中接收get請求
      let request = ctx.request;
      let req_query = request.query;
      let req_querystring = request.querystring;

      ctx.body = {
          url,
          req_query,
          req_querystring

      }

  })
  app.listen(3000,()=>{
      console.log('[demo] server is starting at port 3000')
  })

2.直接從ctx中獲取get請求

直接在ctx中獲得get請求，ctx中也分爲query和querystring

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

  app.use(async(ctx)=>{
      let url = ctx.url;
      //從上下文中直接獲取
      let ctx_query = ctx.query;
      let ctx_querystring = ctx.querystring;
      ctx.body = {
          url,
          ctx_query,
          ctx_querystring

      }

  })
  app.listen(3000,()=>{
      console.log('[demo] server is starting at port 3000')
  })

總結：得到GET請求的方式有兩種，一種是從request中得到，一種是一直從上下文中得到。得到的格式也有兩種：query和querystring。

2、路由

一、原生路由

網站通常都有多個頁面。經過ctx.request.path能夠獲取用戶請求的路徑，由此實現簡單的路由

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

  const main = ctx => {
    if (ctx.request.path !== '/') {
      ctx.response.type = 'html';
      ctx.response.body = '<a href="/">Index Page</a>';
    } else {
      ctx.response.body = 'Hello World';
    }
  };

  app.use(main);
  app.listen(3000);

二、koa-route模塊

原生路由用起來不太方便，咱們可使用封裝好的koa-route模塊

const Koa = require('koa');
  const route = require('koa-route');
  const app = new Koa();

  const about = ctx =>{
      ctx.response.type = 'html';
      ctx.response.body = '<a href="/">Index Page</a>'
  };
  const main = ctx =>{
      ctx.response.body = 'Hello World'
  }

  app.use(route.get('/',main));
  app.use(route.get('/about',about))
  app.listen(3000);

根路徑/的處理函數是main，/about路徑的處理函數是about

三、靜態資源

若是網站提供靜態資源（圖片、字體、樣式、腳本......）,爲它們一個個寫路由就很麻煩，也不必。koa-static模塊封裝了這部分的請求。

const Koa = require('koa');
  const app = new Koa();
  const path = require('path');
  const serve = require('koa-static');
  const main = serve(path.join(__dirname));
  app.use(main);
  app.listen(3000);

一、安裝koa-static

npm install --save koa-static

二、新建static文件夾

在static文件夾中讓人圖片、css和js文件

三、使用koa-static中間件

const Koa = require('koa');
const path = require('path');
const static = require('koa-static');
const app = new Koa();

const staticPath = './static';

app.use(static(path.join(__dirname,staticPath)));

app.use(async(ctx)=>{
    ctx.body = 'hello static'
})

app.listen(3000,()=>{
    console.log('demo server is starting at port 3000')
})

四、重定向

有些場合，服務器須要重定向（redirect）訪問請求。好比，用戶登陸之後，將他重定向到登陸前的頁面。ctx.response.redirect()方法能夠發出一個302跳轉，將用戶導向另外一個路由

const Koa = require('koa');
  const route = require('koa-route');
  const app = new Koa();

  const redirect = ctx => {
    ctx.response.redirect('/');
  };

  const main = ctx => {
    ctx.response.body = 'Hello World';
  };

  app.use(route.get('/', main));
  app.use(route.get('/redirect', redirect));
  app.listen(3000);

訪問 http://127.0.0.1:3000/redirect ，瀏覽器會將用戶導向根路由。

五、ctx.request.url

要想實現原生路由，須要獲得地址欄輸入的路徑，而後根據路徑的不一樣進行跳轉。用ctx.request.url就能夠實現

const Koa = require('koa')
  const app = new Koa()

  app.use( async ( ctx ) => {
    let url = ctx.request.url
    ctx.body = url
  })
  app.listen(3000)

3、中間件

一、Logger功能

Koa的最大特點，也是最重要的一個設計，就是中間件（middleware）

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

  const main = ctx => {
    console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);
    ctx.response.body = 'Hello World';
  };

  app.use(main);
  app.listen(3000);

訪問 http://127.0.0.1:3000 ，命令行就會輸出日誌。
1534751382271 GET /

二、上一個例子裏面的Logger功能，能夠拆分紅一個獨立函數

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

const logger = (ctx,next)=>{
    console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);
    next();
}
const main = ctx =>{
    ctx.response.body = '我是中間件'
}

app.use(logger);
app.use(main);
app.listen(3000);

像上面代碼中的logger函數就叫作'中間件'(middleware),由於它處在HTTP Request和HTTP Response中間，用來實現某種中間功能。app.use()用來加載中間件。
基本上，Koa全部的功能都是經過中間件實現的，前面例子裏面的main也是中間件。每一箇中間件默認接受兩個參數，第一個參數是Context對象，第一個參數是next函數。只要調用next函數，就能夠把執行權轉交給下一個中間件。

三、中間件棧

多箇中間件會造成一個棧結構（middle stack)，以'先進後出'(first-in-last-out)的順序執行

1. 最外層的中間件首先執行。
  2. 調用next函數，把執行權交給下一個中間件。
  3. ...
  4. 最內層的中間件最後執行。
  5. 執行結束後，把執行權交回上一層的中間件。
  6. ...
  7. 最外層的中間件收回執行權以後，執行next函數後面的代碼。

const Koa = require('koa');
    const app = new Koa();
    
    const one = (ctx, next) => {
      console.log('>> one');
      next();
      console.log('<< one');
    }
    
    const two = (ctx, next) => {
      console.log('>> two');
      next();
      console.log('<< two');
    }
    
    const three = (ctx, next) => {
      console.log('>> three');
      next();
      console.log('<< three');
    }
    
    app.use(one);
    app.use(two);
    app.use(three);
    
    app.listen(3000);

若是中間件內部調用next函數，那麼執行權就不會傳遞下去

四、異步中間件

迄今爲止，全部例子的中間件都是同步的，不包含異步操做。若是有異步操做（好比讀取數據庫），中間件就必須寫成async函數

const fs = require('fs.promised');
  const Koa = require('koa');
  const app = new Koa();



  const main = async function(ctx,next){
      ctx.response.type = 'html';
      ctx.response.body = await fs.readFile('./demos/template.html','utf-8')
  }

  app.use(main);
  app.listen(3000);

fs.readFile是一個異步操做，必須寫成await fs.readFile(),而後中間件必須寫成async函數

五、中間件的合成

koa-compose模塊能夠將多箇中間件合成爲一個

const Koa = require('koa');
  const compose = require('koa-compose');
  const app = new Koa();

  const logger = (ctx,next) =>{
      console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);
      next();
  }
  const main = ctx=>{
      ctx.response.body = 'hello world2'
  }
  const middlewares = compose([logger,main])
  app.use(middlewares);
  app.listen(3000);

六、koa-bodyparser中間件

對於POST請求的處理，koa-bodyparser中間件能夠把koa2上下文的formData數據解析到ctx.request.body中

一、安裝中間件

使用npm進行安裝，須要注意的是咱們這裏要用–save，由於它在生產環境中須要使用。
npm install --save koa-bodyparser@3

二、引入使用

安裝完成後，須要在代碼中引入並使用。咱們在代碼頂部用require進行引入。
const bodyParser = require('koa-bodyparser');
而後進行使用，若是不使用是沒辦法調用的，使用代碼以下。
app.use(bodyParser());

在代碼中使用後，直接能夠用ctx.request.body進行獲取POST請求參數，中間件自動給咱們做了解析。

const Koa = require('koa');
  const app = new Koa();
  const bodyParser = require('koa-bodyparser');

  app.use(bodyParser())
  app.use(async(ctx)=>{
      //當請求是get請求時，顯示錶單讓用戶填寫
      if(ctx.url === '/' && ctx.method === 'GET'){
          let html = `
          <h1>Koa2 request post demo</h1>
          <form method="POST" action='/'>
              <p>username</p>
              <input name="username"/>  <br/>
              <p>age</p>
              <input name="age" /> <br/>
              <p>website</p>
              <input name="website" />
              <button type="submit">submit</button>
          </form>
          `;
          ctx.body = html;
          //當請求是post請求時
      }else if(ctx.url === '/' && ctx.method === 'POST'){
          let postData = ctx.request.body;
          ctx.body = postData;
      }else{
          //其餘頁面顯示404頁面
          ctx.body = '<h1>404!</h1>'
      }
  })


  app.listen(3000,()=>{
      console.log('demo server is starting at port 3000')
  })

4、錯誤處理

一、500錯誤

若是代碼運行過程當中發生錯誤，咱們須要吧錯誤信息返回給用戶。HTTP協定約定這時要返回500狀態碼。Koa提供了ctx.throw()方法，用來拋出錯誤，ctx.throw(500)錯誤。
```
const Koa = require('koa');
  const app = new Koa();

  const main = ctx => {
    ctx.throw(500);
  };

  app.use(main);
  app.listen(3000);
```

二、404錯誤

若是將ctx.response.status設置成404，就至關於ctx.throw(404),返回404錯誤

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

  const main = ctx => {
      ctx.response.status = 404;
      ctx.response.body = 'Page Not Found--404'
  }
  app.use(main);
  app.listen(3000);

三、處理錯誤的中間件

爲了方便處理錯誤，最好使用try...catch將其捕獲。可是，爲每一箇中間件都寫try...catch太麻煩，咱們可讓最外層的中間件，負責全部中間件的錯誤處理

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

  const handler = async (ctx, next) => {
      try {
          await next();
      }catch (err){
          ctx.response.status = err.statusCode || err.status || 500;
          ctx.response.body = {
              message: err.message
          };
      }
  };

  const main = ctx =>{
      ctx.throw(500);
  }
  app.use(handler);
  app.use(main);
  app.listen(3000);

四、error事件的監聽

運行過程當中一旦出錯，Koa會觸發一個error事件。監聽這個事件，也能夠處理錯誤

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

  const main = ctx => {
    ctx.throw(500);
  };

  app.on('error', (err, ctx) => {
    console.error('server error', err);
  });

  app.use(main);
  app.listen(3000);

五、釋放error事件

須要注意的是，若是被try...catch捕獲，就不會觸發error事件。這時，必須調用ctx.app.emit(),手動釋放error事件，才能讓監聽函數生效。

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

  const handler = async (ctx,next) => {
    try {
      await next();
    }catch (err) {
      ctx.response.status = err.statusCode || err.status || 500;
      ctx.response.type = 'html';
      ctx.response.body = '<p>Something wrong,please contact administrator</p>';
      ctx.app.emit('error',err,ctx);
    }
  }

  const main = ctx =>{
    ctx.throw(500);
  }

  app.on('error',function(err){
    console.log('logging error',err.message);
    console.log(err)
  })
  app.use(handler);
  app.use(main);
  app.listen(3000);

main函數拋出錯誤，被handler函數捕獲。catch代碼塊裏面使用ctx.app.emit()手動釋放error事件，才能讓監聽函數監聽到

5、Web App的功能

一、Cookies

ctx.cookies 用來讀寫Cookie

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

  const main = function(ctx){
      const n = Number(ctx.cookies.get('view') || 0)+1;
      ctx.cookies.set('view',n);
      ctx.response.body = n + 'views';
  }
  app.use(main);
  app.listen(3000);

ctx.cookies.get(name,[options]) 讀取上下文請求中的cookie
ctx.cookies.set(name,value,[options]) 在上下文中寫入cookie

domain : 寫入cookie所在的域名
path : 寫入cookie所在的路徑
maxAge： cookie最大有效時長
expires： cookie失效時間
httpOnly：是否只用http請求中得到
overwirte: 是否容許重寫

例子

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

app.use(async(ctx)=>{
    if (ctx.url === '/index'){
        ctx.cookies.set(
            'myName', 'xiaoLiLi',{
                domain: '127.0.0.1', //寫cookie所在的域名
                path: '/index',   //寫cookie所在的路徑
                maxAge: 1000*60*60*24, //cookie有效時長（一天）
                expires: new Date('2018-12-28'), //cookie失效時間
                httpOnly: false, //是否只用於http請求中獲取
                overwrite: false //是否容許重寫
            }
        )
        ctx.body = 'cookie is OK'

    }else{
        if(ctx.cookies.get('myName')){
            ctx.body = ctx.cookies.get('myName');
        }else{
            ctx.body = 'cookie is none';
        }
    }
})

app.listen(3000,()=>{
    console.log('demo server is starting at port 3000');
})

二、表單

Web應用離不開處理表單。本質上，表單就是POST方法發送到服務器的鍵值對。koa-body模塊能夠用來從POST請求的數據體裏面提取鍵值對。

const Koa = require('koa');
  const koaBody = require('koa-body');
  const app = new Koa();
  const main = async function(ctx) {
      const body = ctx.request.body;
      if(!body.name) ctx.throw(400,'.name required');
      ctx.body = {name: body.name};
  }

  app.use(koaBody());
  app.use(main);
  app.listen(3000);

三、文件上傳

koa-body 模塊還能夠用來處理文件上傳

const os = require('os');
  const path = require('path');
  const Koa = require('koa');
  const fs = require('fs');
  const koaBody = require('koa-body');

  const app = new Koa();

  const main = async function(ctx) {
    const tmpdir = os.tmpdir();
    const filePaths = [];
    const files = ctx.request.body.files || {};

    for (let key in files) {
      const file = files[key];
      const filePath = path.join(tmpdir, file.name);
      const reader = fs.createReadStream(file.path);
      const writer = fs.createWriteStream(filePath);
      reader.pipe(writer);
      filePaths.push(filePath);
    }

    ctx.body = filePaths;
  };

  app.use(koaBody({ multipart: true }));
  app.use(main);
  app.listen(3000);

打開另外一個命令行窗口，運行下面的命令，上傳一個文件。注意，/path/to/file要更換爲真實的文件路徑。

koa2的模板初始（ejs）

安裝中間件

npm install --save koa-views

安裝ejs模板引擎

npm install --save ejs

編寫模板

新建view/index.ejs

<!DOCTYPE html>
  <html>
  <head>
      <title><%= title %></title>http://jspang.com/wp-admin/post.php?post=2760&action=edit#
  </head>
  <body>
      <h1><%= title %></h1>
      <p>EJS Welcome to <%= title %></p>
  </body>
  </html>

編寫koa文件

const Koa = require('koa');
const views = require('koa-views');
const path = require('path');
const app = new Koa();

//加載模板引擎
app.use(views(path.join(__dirname,'./view'),{
    extension: 'ejs'
}))
app.use(async(ctx)=>{
    let title = 'hello koa2';
    await ctx.render('index',{
        title
    })
})

app.listen(3000,()=>{
    console.log('demo server is starting at port 3000')
})

request 請求

一、Request別名

ctx.header
ctx.headers
ctx.method
ctx.method=
ctx.url
ctx.url=
ctx.originalUrl
ctx.origin
ctx.href
ctx.path
ctx.path=
ctx.query
ctx.query=
ctx.querystring
ctx.querystring=
ctx.host
ctx.hostname
ctx.fresh
ctx.stale
ctx.socket
ctx.protocal
ctx.secure
ctx.ip
ctx.ips
ctx.subdomains
ctx.is()
ctx.accepts()
ctx.acceptsEncodings()
ctx.acceptsCharsets()
ctx.acceptsLanguages()
ctx.get()

query和querystring區別

在koa2中GET請求經過request接收，可是接受的方法有兩種：query和querystring。
query：返回的是格式化好的參數對象。
querystring：返回的是請求字符串。

二、Response 別名

ctx.body
ctx.body=
ctx.status
ctx.status=
ctx.message
ctx.message=
ctx.length=
ctx.length
ctx.type=
ctx.type
ctx.headerSent
ctx.redirect()
ctx.attachment()
ctx.set()
ctx.append()
ctx.remove()
ctx.lastModeified=
ctx.etag=

6、響應（Response）

Koa Response 對象是在node的vanilla響應對象之上的抽象，提供諸多多HTTP服務器開發有用的功能

API

響應標頭對象

二、response.headers

響應標頭對象。別名是response.header

三、response.socket

請求套接字

四、response.status

獲取響應狀態。默認狀況下，response.status設置爲404而不是像node的res.statusCode那樣默認爲200.

五、response.status =

經過數組代碼設置響應狀態

100 "continue"
101 "switching protocols"
102 "processing"
200 "ok"
201 "created"
202 "accepted"
203 "non-authoritative information"
204 "no content"
205 "reset content"
206 "partial content"
207 "multi-status"
208 "already reported"
226 "im used"
300 "multiple choices"
301 "moved permanently"
302 "found"
303 "see other"
304 "not modified"
305 "use proxy"
307 "temporary redirect"
308 "permanent redirect"
400 "bad request"
401 "unauthorized"
402 "payment required"
403 "forbidden"
404 "not found"
405 "method not allowed"
406 "not acceptable"
407 "proxy authentication required"
408 "request timeout"
409 "conflict"
410 "gone"
411 "length required"
412 "precondition failed"
413 "payload too large"
414 "uri too long"
415 "unsupported media type"
416 "range not satisfiable"
417 "expectation failed"
418 "I'm a teapot"
422 "unprocessable entity"
423 "locked"
424 "failed dependency"
426 "upgrade required"
428 "precondition required"
429 "too many requests"
431 "request header fields too large"
500 "internal server error"
501 "not implemented"
502 "bad gateway"
503 "service unavailable"
504 "gateway timeout"
505 "http version not supported"
506 "variant also negotiates"
507 "insufficient storage"
508 "loop detected"
510 "not extended"
511 "network authentication required"

六、response.message

獲取響應的狀態信息。默認狀況下，response.message與response.status關聯。

七、response.message=

將響應的狀態信息設置爲給定值

八、response.length=

將響應的Content-Length設置爲給定值

九、response.length

以數字返回相應的Content-Length，或者從ctx.body推導出來，或者undefined。

十、response.body

獲取響應主體

十一、response.body=

將響應體設置爲如下之一：

string 寫入
Buffer 寫入
Stream 管道
Object || Array JSON-字符串化
null 無內容響應
若是response.status未被設置，koa將會自動設置狀態爲200或204

(1)、String

Content-Type默認爲text/html或text/plain,同時默認字符串是utf-8。Content-Length字段也是如此

(2)、Buffer

Content-type默認爲application/octet-stream,而且Content-Length字段也是如此

(3)、Stream

Content-Type 默認爲application/octet-stream

(4)、Object

Content-Type默認爲application/json。這包括普通的對象{foo：'bar'}和數組['foo','bar']

十二、response.get(field)

不區分大小寫獲取響應頭字段值field

const etag = ctx.response.get(ETag);

1三、response.set(field,value)

設置響應頭field到value
```
ctx.set('Cache-Control','no-cache')
```

1四、response.append(field,value)

用值val附加額外的標頭field

ctx.append('Link', '<http://127.0.0.1/>');

1五、response.set(fields)

用一個對象設置多個響應標頭fields:

ctx.set({
    'Etag': '1234',
    'Last-Modified': date
  });

1六、response.remove(field)

刪除標頭field

1七、response.type

獲取響應Content-Type不含參數'charset'
```
const ct = ctx.type;
```

1八、response.type=

設置響應Content-Type經過mime字符串或文件擴展名

ctx.type = 'text/plain; charset=utf-8';
  ctx.type = 'image/png';
  ctx.type = '.png';
  ctx.type = 'png';

注意: 在適當的狀況下爲你選擇 charset, 好比 response.type = 'html' 將默認是 "utf-8". 若是你想覆蓋 charset, 使用 ctx.set('Content-Type', 'text/html') 將響應頭字段設置爲直接值。

1九、response.is(types...)

很是相似 ctx.request.is(). 檢查響應類型是不是所提供的類型之一。這對於建立操縱響應的中間件特別有用。

例如, 這是一箇中間件，能夠削減除流以外的全部HTML響應。

const minify = require('html-minifier');

  app.use(async (ctx, next) => {
    await next();

    if (!ctx.response.is('html')) return;

    let body = ctx.body;
    if (!body || body.pipe) return;

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

20、response.redirect(url, [alt])

執行 [302] 重定向到 url.

字符串「back」是特別提供Referrer支持的，當Referrer不存在時，使用 alt 或「/」。

ctx.redirect('back');
  ctx.redirect('back', '/index.html');
  ctx.redirect('/login');
  ctx.redirect('http://google.com');

要更改「302」的默認狀態，只需在該調用以前或以後分配狀態。要變動主體請在此調用以後:
```
ctx.status = 301;
  ctx.redirect('/cart');
  ctx.body = 'Redirecting to shopping cart';
```

2一、response.attachment([filename])

將 Content-Disposition 設置爲「附件」以指示客戶端提示下載。(可選)指定下載的 filename。

2二、response.headerSent

檢查是否已經發送了一個響應頭。用於查看客戶端是否可能會收到錯誤通知。

2三、response.lastModified

將 Last-Modified 標頭返回爲 Date, 若是存在。

2四、response.lastModified=

將 Last-Modified 標頭設置爲適當的 UTC 字符串。您能夠將其設置爲 Date 或日期字符串。
```
ctx.response.lastModified = new Date();
```

2五、response.etag=

設置包含 " 包裹的 ETag 響應，請注意，沒有相應的 response.etag getter。
```
ctx.response.etag = crypto.createHash('md5').update(ctx.body).digest('hex');
```

2六、response.vary(field)

在 field 上變化。

2七、response.flushHeaders()

刷新任何設置的標頭，並開始主體。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。

koa2

1、基本用法

一、架設HTTP服務

二、Content對象

三、HTTP Response的類型

四、網頁模板

五、POST請求如何接收

一、獲取POST請求的步驟

二、ctx.request和ctx.req的區別

三、ctx.method獲得請求類型

5（2）、POST請求如何接收（2）

1.解析Node原生POST參數

2.POST字符串解析JSON對象

六、get請求的接收

query和querystring區別

2.直接從ctx中獲取get請求

總結：得到GET請求的方式有兩種，一種是從request中得到，一種是一直從上下文中得到。得到的格式也有兩種：query和querystring。

2、路由

一、原生路由

二、koa-route模塊

三、靜態資源

一、安裝koa-static

二、新建static文件夾

三、使用koa-static中間件

四、重定向

五、ctx.request.url

3、中間件

一、Logger功能

二、上一個例子裏面的Logger功能，能夠拆分紅一個獨立函數

三、中間件棧

四、異步中間件

五、中間件的合成

六、koa-bodyparser中間件

一、安裝中間件

二、引入使用

4、錯誤處理

一、500錯誤

二、404錯誤

三、處理錯誤的中間件

四、error事件的監聽

五、釋放error事件

5、Web App的功能

一、Cookies

cookie 選項

例子

二、表單

三、文件上傳

koa2的模板初始（ejs）

安裝中間件

安裝ejs模板引擎

編寫模板

編寫koa文件

request 請求

一、Request別名

query和querystring區別

二、Response 別名

6、響應（Response）

API

一、response.header

二、response.headers

三、response.socket

四、response.status

五、response.status =

經過數組代碼設置響應狀態

六、response.message

七、response.message=

八、response.length=

九、response.length

十、response.body

十一、response.body=

將響應體設置爲如下之一：

(1)、String

(2)、Buffer

(3)、Stream

(4)、Object

十二、response.get(field)

1三、response.set(field,value)

1四、response.append(field,value)

1五、response.set(fields)

1六、response.remove(field)