安装

建立项目，并安装fastify

Chaim:examp1 Chaim$ npm init
Chaim:examp1 Chaim$ npm install fastify --save

server.js

// Require the framework and instantiate it
const fastify = require('fastify')({ logger: true })

// Declare a route
fastify.get('/', async (request, reply) => {
  return { hello: 'world' }
})

// Run the server!
const start = async () => {
  try {
    await fastify.listen(3000)
    fastify.log.info(`server listening on ${fastify.server.address().port}`)
  } catch (err) {
    fastify.log.error(err)
    process.exit(1)
  }
}
start()

启动服务

Chaim:examp1 Chaim$ node server
{"level":30,"time":1557508003756,"pid":3401,"hostname":"Chaim.local","msg":"Server listening at http://127.0.0.1:3000","v":1}
{"level":30,"time":1557508003756,"pid":3401,"hostname":"Chaim.local","msg":"server listening on 3000","v":1}

看起来在3000端口监听了，浏览器打开"http://127.0.0.1:3000/" ，可以看到返回信息

{"hello":"world"}

日志功能默认是关闭的，测试例子中已经打开日志功能，如下：

const fastify = require('fastify')({
  logger: true
})

路由

类似以下方式注册一个路由

fastify.route({
  method: 'POST',
  url: '/api/log/jsons',
  handler: (req, res) => {
    req.body.on('data', d => console.log(d)) // log every incoming object
  }
})

method

支持的method：'DELETE', 'GET', 'HEAD', 'PATCH', 'POST', 'PUT' 和 'OPTIONS'。

url

url支持格式：https://github.com/delvedor/find-my-way#supported-path-formats

schema

一个包含请求和响应模式的对象。

需要符合 JSON Schema 的格式。

        schema: {
          description: '管理员登录',
          tags: ['admin'],
          body: {
           type: 'object',
           properties: {
             username: { type: 'string' },
             password: { type: 'string' },
           }
          }

注意：Fastify 只支持 application/json 内容类型，如果想解析其他类型可以查看社区插件，fastify-formbody 可以解析 x-www-form-urlencoded 请求类型，使用 fastify-multipart 处理 form-data 类型请求。或者使用 ContentTypeParser 方法自定义内容类型解析器。

Express/Restify

fastify 支持类似 Express/Restify 的路由语法：

fastify.get(path, [options], handler)
fastify.head(path, [options], handler)
fastify.post(path, [options], handler)
fastify.put(path, [options], handler)
fastify.delete(path, [options], handler)
fastify.options(path, [options], handler)
fastify.patch(path, [options], handler)
fastify.all(path, [options], handler)

如下

    fastify.post('/login', {
        schema: {
          description: '管理员登录',
          tags: ['admin'],
          body: {
           type: 'object',
           properties: {
             username: { type: 'string' },
             password: { type: 'string' },
           }
          }
        }
    }, login);

生命周期

这个整理的图不错，很清晰表达了整个过程，抄录下

Incoming Request (请求到达)
  │
  └─▶ Instance Logger (实例化 Logger)
        │
        └─▶ Routing （路由匹配）
             │
       404 ◀─┴─▶ onRequest Hook (onRequest钩子)
                  │
        4**/5** ◀─┴─▶ run Middlewares （执行中间件）
                        │
              4**/5** ◀─┴─▶ Parsing （解析请求对象）
                             │
                       415 ◀─┴─▶ Validation (验证)
                                   │
                             400 ◀─┴─▶ preHandler Hook (preHandler钩子)
                                         │
                               4**/5** ◀─┴─▶ beforeHandler
                                               │
                                     4**/5** ◀─┴─▶ User Handler
                                                     │
                                                     └─▶ Reply （响应）
                                                          │ │
                                                          │ └─▶ Outgoing Response （发出响应）
                                                          │
                                                          └─▶ onResponse Hook （onResponese钩子