Fastify

生命周期

下图展示了 Fastify 的内部生命周期。
每个节点右边的分支为生命周期的下一阶段,左边的则是上一个生命周期抛出错误时产生的错误码 (请注意 Fastify 会自动处理所有的错误)

  1. Incoming Request
  2. └─▶ Routing
  3. └─▶ Instance Logger
  4. 4**/5** ◀─┴─▶ onRequest Hook
  5. 4**/5** ◀─┴─▶ preParsing Hook
  6. 4**/5** ◀─┴─▶ Parsing
  7. 4**/5** ◀─┴─▶ preValidation Hook
  8. 415 ◀─┴─▶ Validation
  9. 4**/5** ◀─┴─▶ preHandler Hook
  10. 4**/5** ◀─┴─▶ User Handler
  11. └─▶ Reply
  12. 4**/5** ◀─┴─▶ preSerialization Hook
  13. └─▶ onSend Hook
  14. 4**/5** ◀─┴─▶ Outgoing Response
  15. └─▶ onResponse Hook

用户编写的处理函数执行前或执行时,你可以调用 reply.hijack() 以使得 Fastify:

  • 终止运行所有钩子及用户的处理函数
  • 不再自动发送响应

特别注意 (*):假如使用了 reply.raw 来发送响应,则 onResponse 依旧会执行。

响应生命周期

不管用户如何处理请求,结果无非以下几种:

  • 异步函数中返回 payload
  • 异步函数中抛出 Error
  • 同步函数中发送 payload
  • 同步函数中发送 Error 实例

当响应被劫持时 (即调用了 reply.hijack()) 会跳过之后的步骤,否则,响应被提交后的数据流向如下:

  1. schema validation Error
  2. └─▶ schemaErrorFormatter
  3. reply sent ◀── JSON ─┴─ Error instance
  4. throw an Error
  5. send or return
  6. reply sent ◀── JSON ─┴─ Error instance ──▶ setErrorHandler ◀─────┘
  7. reply sent ◀── JSON ─┴─ Error instance ──▶ onError Hook
  8. └─▶ reply sent

注:reply sent 意味着 JSON payload 将会如下被序列化: