Fastify 是一个效率极高的 Web 框架，它基于 Node.js，可以帮助我们快速构建高效率、高性能的 RESTful API。在这篇文章中，我们会介绍如何使用 Fastify 构建 RESTful API，包括基本用法和进阶用法。
基本用法
安装
我们可以使用 npm 来安装 Fastify：
npm install fastify
创建服务
接着，我们可以创建一个服务来监听请求：
-- -------------------- ---- -------
----- ------- - -------------------- ------- ---- --
---------------- ----- --------- ------ -- -
------ - -------- ------ ------ -
--
-------------------- ----- -------- -- -
-- ----- -
----------------------
---------------
-
------------------------ --------- -- ------------
--我们创建了一个 fastify 实例，并使用 fastify.get 方法定义了一个路由，以响应浏览器发来的 HTTP GET 请求。fastify.listen 方法用于启动服务，并监听 3000 端口。
请求和响应
Fastify 的请求和响应都是基于 Node.js 的 http.IncomingMessage 和 Node.js 的 http.ServerResponse 的，但是 Fastify 的 API 提供了更多的快捷方式和便利方法。
例如，我们可以使用 reply.send 方法来响应一个 JSON 格式的数据：
fastify.get('/', async (request, reply) => {
reply.send({ message: 'Hello world' })
})reply.send 方法会自动将 JavaScript 对象转换为 JSON 字符串，并将其发送给客户端。此外，我们还可以使用链式调用来设置 HTTP 状态码和响应头：
fastify.get('/', async (request, reply) => {
reply
.code(200)
.header('Content-Type', 'application/json; charset=utf-8')
.send({ message: 'Hello world' })
})错误处理
当出现错误时，我们可以使用 reply.code 方法来设置相应的 HTTP 状态码，并使用 reply.send 方法来向客户端发送错误信息：
-- -------------------- ---- -------
---------------- ----- --------- ------ -- -
--- -
-- -- ---------
------ - -------- ------ ------ -
- ----- ----- -
-----
----------
------- ------ --------- ------ ------ --
-
--路由参数
我们可以使用 /:param 形式的 URL 模式来捕获请求中的参数：
fastify.get('/:name', async (request, reply) => {
const { name } = request.params
reply.send({ message: `Hello ${name}` })
})路由前缀
我们可以使用 fastify.route 方法来创建路由，并使用 prefix 选项来设置路由前缀：
-- -------------------- ---- -------
---------------
------- ------
---- ---------------
-------- ----- --------- ------ -- -
----- - ---- - - --------------
------ - -------- ------ -------- -
--
------- ---------
--在上面的例子中，我们创建了一个 /api/v1/hello/:name 的路由。
进阶用法
插件系统
Fastify 提供了一个插件系统，可以用于扩展框架的功能。我们可以将路由、中间件等封装为插件，然后使用 fastify.register 方法来注册插件：
-- -------------------- ---- -------
----- ----------- - ----- --------- -------- ----- -- -
--------------------------- ----- --------- ------ -- -
----- - ---- - - --------------
------ - -------- ------ -------- -
--
------
-
----------------------------- - ------- --------- --校验请求参数
Fastify 提供了一个 AJV 插件来校验请求的参数。我们可以使用 fastify.addSchema 方法来定义数据模型，并使用 .body 方法来校验请求体的参数：
-- -------------------- ---- -------
----------------- -
------- -
----- -
----- ---------
----------- -
----- - ----- -------- --
---- - ----- -------- -
--
--------- -------- ------
-
-
-- ----- --------- ------ -- -
----- - ----- --- - - ------------
------ - -------- ------ -------- --- --- ------ ----- ----- -
--控制器模式
我们可以将路由处理程序单独封装为一个控制器，以便进行进一步的处理和测试。
const helloController = async (request, reply) => {
const { name } = request.params
return { message: `Hello ${name}` }
}
fastify.get('/hello/:name', helloController)数据库查询
Fastify 不提供特定的数据库操作库，但是我们可以使用第三方库来处理数据库查询。例如，我们可以使用 mysql2 和 fastify-mysql 来进行 MySQL 数据库的查询：
-- -------------------- ---- ------- ----- ----- - ------------------------- ----- ------------ - ------------------------ ------------------------------ - -------- ----- ----------------- -------------------------------------------- -- --------------------- ----- --------- ------ -- - ----- ---- - ----- ----------------------------- ----- ------ - ----- ------------------ - ---- ------- -------------- ------ ---- --
// users 数据表结构 // +----+-----------+------+ // | id | name | age | // +----+-----------+------+ // | 1 | Alice | 25 | // | 2 | Bob | 30 | // | 3 | Charlie | 35 | // +----+-----------+------+
在上面的例子中，我们使用 fastify-mysql 插件来连接 MySQL 数据库，并在路由处理程序中使用 conn.query 方法来查询数据。
总结
Fastify 提供了一种简单、高效的方式来构建 RESTful API，它具有快速、灵活、易用等优点，适用于各种规模的 Web 应用程序。本文介绍了 Fastify 的基本用法和进阶用法，希望对前端开发人员有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64ad2d6248841e98949567e0