内置对象

Request & Response

可以在 Context 的实例上获取到当前请求的 Request( ctx.request ) 和 Response( ctx.response ) 实例。

ctx.response.body= 和 ctx.body= 是等价的。

[!] 需要注意的是，获取 POST 的 body 应该使用 ctx.request.body ，而不是 ctx.body

Controller

框架提供了一∩个 Controller 基类，并推荐所有的 Controller 都继承于该基类实现。这个 Controller 基类有下列属性:

ctx - 当前请求的 Context 实例。

app - 应用的 Application 实例。

config - 应用的 配置 。

service - 应用所有的 service 。

logger - 为当前 controller 封装的 logger 对象。

Service

框架提供了一个 Service 基类，并推荐所有的 Service 都继承于该基类实现。 Service 基类的属性和 Controller 基类属性一致，访问方式也类似

中间件

编※写中间件

一个中间件是一个放置在 app/middleware 目录下的单独文件，它需要 exports 一个普通的 function，接受两个参数：

options: 中间件的配置项，框架会将 app.config[${middlewareName}] 传递进来。

app: 当前应用 Application 的实例。

// app/middleware/error_handler.js

module.exports = () => {

  return async function errorHandler(ctx, next) {

    try {

      await next();

    } catch (err) {

      // 所有的异常都在 app 上触发一个 error 事件，框架会记录◤一条错误日志

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

      const status = err.status || 500;

      // 生产环境时 500 错误的详细错误内容不返回给客户端，因为可能包含敏感信息

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

        ? 'Internal Server Error'

        : err.message;

      // 从 error 对象上读ω出各个属性，设置到响应中

      if (status === 422) {

        ctx.body = {

          code: ctx.ERROR_CODE,

          data: error,

          msg: '参数错误'+status

         };

      }

      if (status === 500) {

        ctx.body = {

          code: 500,

          data: '',

          msg: '服务端错误①-----'+error

         };

      }

      ctx.status = 200;

    }

  };

};复制代码

使用

在应用中使用中间件

在应用中，我们可以完全通过配置来加载自定义的中间件，并决定它们的顺序◆。

如果我们需要加载上面的 gzip 中间件，在 config.default.js 中加入下面的配置就完↑成了中间件的开启和配置：

// 加载 errorHandler 中间件

  config.middleware = ['errorHandler']复制代码