Node.js 是一个非常流行的 JavaScript 运行环境，广泛应用于后端开发。而 Express.js 是 Node.js 中最流行的 Web 框架之一，它提供了强大、灵活且易于使用的 API，便于开发人员构建 RESTful API 和其他 Web 应用程序。
本篇文章将介绍如何使用 Express.js 开发 Node.js 后端 API 接口。
安装 Express.js
首先，我们需要安装 Node.js。在安装 Node.js 后，我们可以使用 npm 命令来安装 Express.js。
--- ------- ------- ------
注：--save 参数将 Express.js 作为依赖项添加到项目中的 package.json 文件中。
创建 Express.js 应用程序
创建 Express.js 应用程序非常简单，只需要在文件中引入 Express.js 并实例化一个应用程序对象即可：
----- ------- - ------------------- ----- --- - ----------
创建 API 接口
接下来，我们需要创建 API 接口。一个基本的 API 接口通常由请求路径、请求方法和处理函数组成。我们可以使用 Express.js 的路由功能来定义这些内容。
------------ ------------- ---- - --------------- -------- ---
上述代码将会创建一个 GET 请求路径为 / 的 API 接口，当用户访问该路径时，API 接口会返回一个字符串 "Hello World"。
请求参数
在实际开发中，我们常常需要接收用户传递的参数，例如查询参数、表单参数和 JSON 参数。我们可以使用 req 对象来读取这些参数：
----------------- ------------- ---- - ----- ---- - --------------- ----- --- - -------------- -- ------- ---
上述代码将会创建一个 GET 请求路径为 /users 的 API 接口，当用户访问该路径并传递查询参数 name 和 age 时，API 接口会将这些值读取到并存储在变量中，供开发人员进行处理。
响应格式
在开发 API 接口时，我们需要为数据设置正确的响应格式，以便客户端能够正确解析返回的数据。常见的响应格式包括 JSON、XML 和 HTML 等。
在 Express.js 中，我们可以使用 res 对象来设置响应格式：
----------------- ------------- ---- -
----- ----- - -
- ----- -------- ---- -- --
- ----- ------ ---- -- --
--
----------------
---上述代码将会创建一个 GET 请求路径为 /users 的 API 接口，当用户访问该路径时，API 接口会返回一个 JSON 格式的数据，包含两个用户的信息。
中间件
中间件是 Express.js 中非常重要的概念，它允许我们在请求到达目标处理函数之前对请求进行处理，例如身份验证、日志记录和错误处理等。
在 Express.js 中，我们可以使用 app.use() 函数来应用中间件：
--------------------- ---- ----- - -------------------- ------------ ------- ---
上述代码将会创建一个中间件来记录请求的时间戳，并将请求传递给下一个处理函数。使用 next() 函数可以将请求传递给下一个处理函数，否则请求不会继续处理。
错误处理
在开发 API 接口时，错误处理也是非常重要的。如果 API 接口出现异常情况而未处理，很可能会导致系统崩溃或数据泄露等严重后果。
在 Express.js 中，我们可以使用 app.use() 函数注册一个错误处理中间件：
--------------------- ---- ---- ----- - ------------------------- ------------------------------- --------- ---
上述代码将会创建一个错误处理中间件来捕获所有异常情况，并返回一个 500 状态码以及错误信息给客户端。
示例代码
下面是一个完整的示例代码，实现了一个简单的用户管理 API 接口：
----- ------- - -------------------
----- --- - ----------
------------------------
----- ----- - -
- --- -- ----- -------- ---- -- --
- --- -- ----- ------ ---- -- --
--
----------------- ------------- ---- -
----------------
---
--------------------- ------------- ---- -
----- -- - ------------------------
----- ---- - ------------ -- ---- --- ----
-- ------- -
------ -------------------------- --- --------
-
---------------
---
------------------ ------------- ---- -
----- ---- - -
--- ------------ - --
----- --------------
---- -------------
--
-----------------
---------------
---
--------------------- ------------- ---- -
----- -- - ------------------------
----- ---- - ------------ -- ---- --- ----
-- ------- -
------ -------------------------- --- --------
-
--------- - --------------
-------- - -------------
---------------
---
------------------------ ------------- ---- -
----- -- - ------------------------
----- ----- - ----------------- -- ---- --- ----
-- ------ --- --- -
------ -------------------------- --- --------
-
------------------- ---
---------------
---
--------------------- ---- ---- ----- -
-------------------------
------------------------------- ---------
---
---------------- ---------- -
---------------- --------- -- ---- -------
---结论
在本文中，我们学习了如何使用 Express.js 开发 Node.js 后端 API 接口。我们介绍了创建 Express.js 应用程序、定义 API 接口、使用中间件和错误处理等重要概念，并提供了一个完整的示例代码，希望对您在实际开发中有所帮助。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/66ff806e1b0bf82c71cad7d2