內(nèi)置對(duì)象

Request & Response

可以在 Context 的實(shí)例上獲取到當(dāng)前請(qǐng)求的 Request( ctx.request ) 和 Response( ctx.response ) 實(shí)例。

ctx.response.body= 和 ctx.body= 是等價(jià)的。

[!] 需要注意的是，獲取 POST 的 body 應(yīng)該使用 ctx.request.body ，而不是 ctx.body

Controller

框架提供了一個(gè) Controller 基類，并推薦所有的 Controller 都繼承于該基類實(shí)現(xiàn)。這個(gè) Controller 基類有下列屬性:

ctx - 當(dāng)前請(qǐng)求的 Context 實(shí)例。

app - 應(yīng)用的 Application 實(shí)例。

config - 應(yīng)用的 配置 。

service - 應(yīng)用所有的 service 。

logger - 為當(dāng)前 controller 封裝的 logger 對(duì)象。

Service

框架提供了一個(gè) Service 基類，并推薦所有的 Service 都繼承于該基類實(shí)現(xiàn)。 Service 基類的屬性和 Controller 基類屬性一致，訪問方式也類似

中間件

編寫中間件

一個(gè)中間件是一個(gè)放置在 app/middleware 目錄下的單獨(dú)文件，它需要 exports 一個(gè)普通的 function，接受兩個(gè)參數(shù)：

options: 中間件的配置項(xiàng)，框架會(huì)將 app.config[${middlewareName}] 傳遞進(jìn)來。

app: 當(dāng)前應(yīng)用 Application 的實(shí)例。

// app/middleware/error_handler.js

module.exports = () => {

  return async function errorHandler(ctx, next) {

    try {

      await next();

    } catch (err) {

      // 所有的異常都在 app 上觸發(fā)一個(gè) error 事件，框架會(huì)記錄一條錯(cuò)誤日志

      ctx.app.emit('error', err, ctx);

      const status = err.status || 500;

      // 生產(chǎn)環(huán)境時(shí) 500 錯(cuò)誤的詳細(xì)錯(cuò)誤內(nèi)容不返回給客戶端，因?yàn)榭赡馨舾行畔?/span>

      const error = status === 500 && ctx.app.config.env === 'prod'

        ? 'Internal Server Error'

        : err.message;

      // 從 error 對(duì)象上讀出各個(gè)屬性，設(shè)置到響應(yīng)中

      if (status === 422) {

        ctx.body = {

          code: ctx.ERROR_CODE,

          data: error,

          msg: '參數(shù)錯(cuò)誤'+status

         };

      }

      if (status === 500) {

        ctx.body = {

          code: 500,

          data: '',

          msg: '服務(wù)端錯(cuò)誤-----'+error

         };

      }

      ctx.status = 200;

    }

  };

};復(fù)制代碼

使用

在應(yīng)用中使用中間件

在應(yīng)用中，我們可以完全通過配置來加載自定義的中間件，并決定它們的順序。

如果我們需要加載上面的 gzip 中間件，在 config.default.js 中加入下面的配置就完成了中間件的開啟和配置：

// 加載 errorHandler 中間件

  config.middleware = ['errorHandler']復(fù)制代碼