Fastify 是一个快速、低开销、可扩展且支持异步的 Node.js Web 应用框架，它的优点在于速度快、内存占用少，目前在社区中得到了广泛的认可和使用。如果你正在寻找一个简单易用的框架来构建 Web API，那么 Fastify 是一个值得考虑的选择。
在本文中，我们将通过一个实际的示例来介绍如何使用 Fastify 框架快速构建 Web API，并探索一些 Fastify 框架的关键特性。
建立项目
首先，由于我们使用 Node.js，所以需要在本地安装 Node.js 环境。然后，我们通过 npm 创建一个新的项目并安装 Fastify：
--- ---- -- --- ------- ------- ------
创建 Web API
创建 Web API 需要以下步骤：
- 初始化 Fastify 框架
- 添加 API 路由
- 启动 Fastify 服务器
初始化 Fastify 框架
打开 index.js 文件，引入并初始化 Fastify 框架：
----- ------- - -------------------- -- -- ------- --- ------- ---- -- ------ --
上面的代码引入了 Fastify 模块并创建了一个 Fastify 实例。通过 logger 配置项启用日志功能，可以在终端输出访问日志，方便调试。
添加 API 路由
通过 Fastify 实例，我们可以添加 Web API 路由。在这里，我们添加了一个简单的路由，返回 “Hello world”：
---------------- --------- ------ -- - ------------ ------ ------- -- --
上面的代码监听根路由 /，当客户端访问该路由时，返回 JSON 格式的 “Hello world” 字段。
启动 Fastify 服务器
在添加完路由后，我们需要启动 Fastify 服务器：
-------------------- ----- -------- -- -
-- ----- -
----------------------
---------------
-
------------------------ --------- -- ------------
--上面的代码指定 Fastify 监听本地的 3000 端口，并打印启动成功后的访问地址。运行 node index.js 命令启动服务。
完整的 index.js 文件代码如下：
----- ------- - --------------------
------- ----
--
---------------- --------- ------ -- -
------------ ------ ------- --
--
-------------------- ----- -------- -- -
-- ----- -
----------------------
---------------
-
------------------------ --------- -- ------------
--测试 Web API
在浏览器中访问 http://localhost:3000/，可以看到返回的结果如下：
- -------- ------- -
这就是我们实现的一个简单的 Web API。
Fastify 框架特性
以上介绍了 Fastify 框架的基本用法，接下来，我们将探索一些 Fastify 框架的特性和功能。
HTTP 异常处理
在 Fastify 中，使用 try / catch 块来捕获错误和异常。此外，我们可以使用 onError 方法来处理全局的异常。
--------------------- --------- ------ -- -
--- -
----- --- -------------
- ----- ----- -
---------------
-
--
-------------------------------- ------- -------- ------ -
------------------------ -------- ------------- --
--上面的代码定义了一个抛出异常的路由 /error，并使用 setErrorHandle 处理全局的异常。
校验请求参数
Fastify 内置了一个插件 fastify-schema，可以用来验证和校验请求参数。我们可以在路由定义时添加 JSON Schema 校验规则：
----- ---------- - -
----- ---------
----------- -
----- - ----- -------- --
------ - ----- --------- ------- ------- -
--
--------- -------- --------
-
-------------------- -
------- -
------------ ----------
-
-- --------- ------ -- -
----- - ----- ----- - - -------------
------------ ----- ----- --
--上面的代码定义了一个查询用户信息的路由 /user，并添加了 JSON Schema 校验规则进行请求参数的校验。
异步支持
Fastify 对异步的支持很好，可以使用 async/await 关键字、Promise 和回调函数等方式来处理异步操作。
--------------------- ----- --------- ------ -- - ----- ------ - ----- ----------------- ------------------ --
上面的代码定义了一个异步路由 /async，使用 async/await 关键字来处理异步操作。
结论
在本文中，我们学习了如何使用 Fastify 框架来构建 Web API。Fastify 框架的优点在于速度快、内存占用少、支持异步等特性，同时还有丰富的插件和生态系统。如果你正在寻找一个快速、可扩展的 Node.js Web 框架，那么 Fastify 就是一个不错的选择。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/67399141f24bea3e38acedad