构建 RESTful API:使用 Fastify 和 MongoDB

阅读时长 13 分钟读完

RESTful API 是现代 Web 应用的重要组成部分。它提供简单、可靠和可扩展的方式来访问和管理应用程序数据。Fastify 是一个快速和低开销的 Web 框架,而 MongoDB 是一个流行的文档型 NoSQL 数据库。在本文中,我们将探讨如何使用这两个技术构建一个 RESTful API。

前置条件

在继续之前,您需要满足以下前置条件:

  • Node.js(推荐版本为 v14.17.1 或更高版本)
  • MongoDB(推荐版本为 4.4 或更高版本)

准备工作

我们将从创建一个新的 Node.js 应用程序开始。在您选择的工作目录内,运行以下命令:

这将创建一个 package.json 文件,其中包括项目的名称、版本、描述等详细信息。接下来,我们将安装以下依赖项:

这将安装 Fastify、Fastify-CORS 和 Fastify-MongoDB 模块。

设置应用程序

现在,我们将编写一些代码来设置应用程序,包括连接到 MongoDB 数据库和启动 Fastify 应用程序。

-- -------------------- ---- -------
-- ------

----- ------- - -------------------- ------- ---- ---
----- ---- - ------------------------
----- ------- - ---------------------------

-----------------------

------------------------- -
  ----------- -----
  ---- ----------------------------
  -- ---------
  --------- -------
---

---------------- ----- ------ -- -
  ------------ -------- ------ ------- ---
---

----- ----- - ----- -- -- -
  --- -
    ----- ---------------------
    ------------------- ------- -- ---- -------
  - ----- ----- -
    -------------------
    ----------------
  -
--

--------

在上面的代码中,我们启动一个 Fastify 应用程序,并向其添加 Fastify-CORS 和 Fastify-MongoDB 插件。然后,我们创建一个简单的路由,返回 "Hello World!"。最后,我们使用 listen 方法在端口 3000 上启动服务器。

现在,如果您运行 node app.js,您将能够通过 http://localhost:3000 访问我们的应用程序,并看到返回的消息。然而,我们还没有使用 MongoDB 构建 RESTful API。

构建 RESTful API

我们将创建一个简单的 RESTful API,允许我们执行以下操作:

  • 获取所有项目
  • 获取单个项目
  • 创建项目
  • 更新项目
  • 删除项目

我们将使用 MongoDB 数据库来存储项目。

创建路由

我们首先需要创建一些路由来处理这些操作。在 app.js 文件中添加以下内容:

-- -------------------- ---- -------
-- ------

----- --------------- - -----------

-- ------
------------------------ ----- ----- ------ -- -
  ----- -------- - ----- --------------------------------------------------------------
  ------ ---------
---

-- ------
---------------------------- ----- ----- ------ -- -
  ----- - -- - - -----------
  ----- ------- - ----- ------------------------------------------------------ ---- ------------ ---
  
  -- ---------- -
    ------ ---------------------- -------- -------- --- ------ ---
  -
  
  ------ --------
---

-- ----
------------------------- ----- ----- ------ -- -
  ----- ------- - ---------
  
  ----- ------ - ----- ----------------------------------------------------------------
  ----- --------------- - ----- ------------------------------------------------------ ---- ----------------- ---
  
  ------ ----------------
---

-- ----
---------------------------- ----- ----- ------ -- -
  ----- - -- - - -----------
  ----- ------- - ---------
  
  ----- ------ - ----- -------------------------------------------------------- ---- ------------ -- - ----- ------- ---
  
  -- --------------------- --- -- -
    ------ ---------------------- -------- -------- --- ------ ---
  -
  
  ------ - -------- -------- ------- ------------- --
---

-- ----
------------------------------- ----- ----- ------ -- -
  ----- - -- - - -----------
  
  ----- ------ - ----- -------------------------------------------------------- ---- ------------ ---
  
  -- -------------------- --- -- -
    ------ ---------------------- -------- -------- --- ------ ---
  -
  
  ------ - -------- -------- ------- ------------- --
---

在上述代码中,我们定义了五个路由处理函数,分别对应五个 RESTful 操作。对于每个路由处理程序,我们都使用 fastify.mongo.db.collection 方法从 MongoDB 中获取名称为 projects 的集合。然后我们使用 MongoDB 的 CRUD 方法来执行每个操作。请注意,我们使用 ObjectID 函数将字符串 ID 转换为 MongoDB ObjectId。

编写测试用例

现在,我们已经创建了 RESTful API,我们需要编写测试用例来确保它能按预期工作。在根目录下创建 test 文件夹,并在其中创建一个 api.test.js 文件。下面是测试用例代码:

-- -------------------- ---- -------
-- -----------

----- - ------------ -------- - - -------------------
----- - ----- - - ------------------

--------------- -- -- -
  --- -----------
  --- ---
  --- ----

  ----- --------------- - -----------

  --------------- -- -- -
    ---------- - ----- -------------------------------------------------
    -- - ----- -----------------------
    ----- ------------------------------------------- -- ----
    --- - ----------------- ----
    ----- ------------
  ---

  -------------- -- -- -
    ----- -------------------
    ----- ------------
  ---

  --------------- -- -- -
    ----- ------------------------------------------- -- ----
  ---

  ------------ ------ - --------- ----- -- -- -
    ----- ------- - -
      ----- -------- ---
      ------------ ----- -- ------- --
    --

    ----- -------- - ----- ------------
      ------- -------
      ---- ------------
      -------- -------
    ---

    --------------------------------------
    ---------------------------------------
      ----- -------- ---
      ------------ ----- -- ------- --
    ---
  ---

  ------------ --- --- ---------- ----- -- -- -
    ----- -------- - -
      -
        ----- -------- ---
        ------------ ----- -- ------- --
      --
      -
        ----- -------- ---
        ------------ ----- -- ------- --
      -
    --

    ----- ----------------------------------------------------

    ----- -------- - ----- ------------
      ------- ------
      ---- -----------
    ---

    --------------------------------------
    ------------------------------------------------
  ---

  ------------ --- - ------- -- ---- ----- -- -- -
    ----- ------- - -
      ----- -------- ---
      ------------ ----- -- ------- --
    --

    ----- - ----------- -- - - ----- --------------------------------------------------

    ----- -------- - ----- ------------
      ------- ------
      ---- -----------------
    ---

    --------------------------------------
    -----------------------------------------------
  ---

  ------------ ------ - ------- -- ---- ----- -- -- -
    ----- ------- - -
      ----- -------- ---
      ------------ ----- -- ------- --
    --

    ----- - ----------- -- - - ----- --------------------------------------------------

    ----- -------- - ----- ------------
      ------- ------
      ---- ------------------
      -------- -
        ----- -------- ---
        ------------ ----- -- ------- --
      -
    ---

    --------------------------------------
    --------------------------------------- -------- -------- ------- ------------- ---

    ----- -------------- - ----- ---------------------------------------- ---- ------------ ---

    --------------------------------------
      ----- -------- ---
      ------------ ----- -- ------- --
    ---
  ---

  ------------ ------ - ------- -- ---- ----- -- -- -
    ----- ------- - -
      ----- -------- ---
      ------------ ----- -- ------- --
    --

    ----- - ----------- -- - - ----- --------------------------------------------------

    ----- -------- - ----- ------------
      ------- ---------
      ---- -----------------
    ---

    --------------------------------------
    --------------------------------------- -------- -------- ------- ------------- ---

    ----- -------------- - ----- ---------------------------------------- ---- ------------ ---

    -----------------------------------
  ---
---

在测试用例中,我们使用 Fastify Test Utils 来测试 RESTful API 中的每个操作。对于每个测试用例,我们首先准备一个数据库,并为每次测试重新创建一个空的集合。然后,我们使用 HTTP 请求(POST、GET、PUT、DELETE)向 API 发送请求,并断言响应结果是否是我们预期的。

运行测试

现在我们已经写好了测试用例,我们可以运行所有测试,确保我们的 API 可以按预期工作。在终端中运行以下命令:

如果所有的测试都通过了,那么我们现在已经成功地构建了一个 RESTful API,它使用 Fastify 和 MongoDB 来存储和检索数据。

总结

在本文中,我们学习了如何使用 Fastify 和 MongoDB 构建 RESTful API。我们首先创建了一个 Fastify 应用程序,然后向其添加了 Fastify-CORS 和 Fastify-MongoDB 插件。接下来,我们编写了一些路由来处理 CRUD 操作,并编写了测试用例以确保它们可以按预期工作。现在,您可以使用这套工具来创建高效且可靠的 RESTful API。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/648e5da348841e9894cb7b77

纠错
反馈