【Node.js】使用fastify搭建一个web服务

前言

目前使用node.js搭建web服务，可以使用原生的http模块进行搭建，也有express、restify和fastify。fastify框架相对于前两中框架，更加轻巧、数据解析能力更强。先用fastify框架搭建一个web服务。

---

API

搭建之前先说下将要使用到的API。

fastify.register(plugin, [options])

在fastify框架中，它将一切资源都认为是一个插件，包括静态资源、路由、服务等。register将会创建一个新的作用域，如果你需要在register中使用decorate，这个变化将不会在register实例上展现。下文将讲述，如何处理这种情况。

fastify.decorate(attr,expression)

使用decorate可以对register实例的属性进行修改。

---

Server

//app.jsconst fastify = require('fastify')();fastify.addHook('onRequest', (req, res, next) => {    console.log(req.url);    next();})fastify.register(require('./route/our-db-connector'), {    url: 'mongodb://***'});fastify.register(require('./route/our-first-route'),{ prefix: '/v1' });fastify.listen(3000, function (err) {    if (err) throw err    fastify.log.info(`server listening on ${fastify.server.address().port}`)})

• fastify提供有hook机制，可以对request、response、send等进行监听。
• register注册两个插件，数据库实例和路由实例
• 监听3000端口

---

连接MongoDB数据库

//our-db-connector.jsconst fp = require('fastify-plugin')const MongoClient = require('mongodb').MongoClient;async function db (fastify, options) {  const url = options.url  delete options.url  const db = await MongoClient.connect(url, options)  fastify.decorate('mongo', db)}module.exports = fp(db)

在这里需要注意的是decorate这个API的使用，因为register会创建新的作用域，但同时需要在fastify实例（即app.js）上绑定db对象。如果想要在register中使用decorate扩展基础服务中的fastify，你需要告诉fastify不再创建新的作用域，这里有两种解决方案。

方案一：使用fastify-plugin模块

const fp = require('fastify-plugin')module.exports = fp(function (fastify, opts, next) {  fastify.decorate('utility', () => {})  next()}, '0.x')

方案二：使用’skip-override’

function yourPlugin (fastify, opts, next) {  fastify.decorate('utility', () => {})  next()}yourPlugin[Symbol.for('skip-override')] = truemodule.exports = yourPlugin

在这里推荐使用方案一，便于维护。本文使用的是方案一。

---

路由

//our-first-route.jslet opts = {    name:{        schema:{            body:{                type:'string',            }        }    }}async function routes (fastify,options,next) {    const collection = fastify.mongo.collection('user')    fastify.get('/', async (request, reply) => {        return { hello: 'world' }    })    fastify.get('/name/:name',opts.name,async (request,reply) =>{        return {name:name}    })}module.exports = routes

• 调用app.js的fastify实例上的数据库，即fastify.mongo。
• fastify支持async/await，这种情况下，只需要return，请求就会结束。
• fastify支持schame，即我们看到的/name/:name后面的参数，用户可以预先定义请求的参数类型，以及返回的数据类型。若，数据类型不匹配时，会报错。这一机制，也是fastify在请求处理比express、restify都快的原因所在。

---

运行

node app.js
打开浏览器，在地址栏输入127.0.0.1:3000/v1。
为什么是v1？这是在app.js中有设置前置的原因，fastify.register(require(‘./route/our-first-route’),{ prefix: ‘/v1’ });