Fastify

生命周期

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

  1. Incoming Request
  2.   │
  3.   └─▶ Routing
  4.         │
  5.         └─▶ Instance Logger
  6.              │
  7.    4**/5** ◀─┴─▶ onRequest Hook
  8.                   │
  9.         4**/5** ◀─┴─▶ preParsing Hook
  10.                         │
  11.               4**/5** ◀─┴─▶ Parsing
  12.                              │
  13.                    4**/5** ◀─┴─▶ preValidation Hook
  14.                                   │
  15.                             400 ◀─┴─▶ Validation
  16.                                         │
  17.                               4**/5** ◀─┴─▶ preHandler Hook
  18.                                               │
  19.                                     4**/5** ◀─┴─▶ User Handler
  20.                                                     │
  21.                                                     └─▶ Reply
  22.                                                           │
  23.                                                 4**/5** ◀─┴─▶ preSerialization Hook
  24.                                                                 │
  25.                                                                 └─▶ onSend Hook
  26.                                                                       │
  27.                                                             4**/5** ◀─┴─▶ Outgoing Response
  28.                                                                             │
  29.                                                                             └─▶ onResponse Hook

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

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

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

响应生命周期

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

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

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

  1.                         ★ schema validation Error
  2.                                     │
  3.                                     └─▶ schemaErrorFormatter
  4.                                                │
  5.                           reply sent ◀── JSON ─┴─ Error instance
  6.                                                       │
  7.                                                       │         ★ throw an Error
  8.                      ★ send or return                 │                 │
  9.                             │                         │                 │
  10.                             │                         ▼                 │
  11.        reply sent ◀── JSON ─┴─ Error instance ──▶ setErrorHandler ◀─────┘
  12.                                                       │
  13.                                  reply sent ◀── JSON ─┴─ Error instance ──▶ onError Hook
  14.                                                                                 │
  15.                                                                                 └─▶ reply sent

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