使用 Node.js 和 Express 构建 RESTful API 服务器
Node.js 是一个基于 Chrome V8 JavaScript 引擎的 JavaScript 运行环境，它允许开发者使用 JavaScript 编写服务器端的应用程序。Express 则是一个基于 Node.js 的 Web 应用框架，它简化了 Web 应用的开发过程。在本文中，我们将构建一个简单的 RESTful API 服务器，该服务器能够处理 CRUD 操作（创建、读取、更新、删除）。
1. 环境准备
首先，确保你的开发环境中已经安装了 Node.js。接下来，我们需要创建一个新的 Node.js 项目。
打开终端或命令提示符，执行以下命令来创建一个新的项目目录：
mkdir express-api-server
cd express-api-server
npm init -y
2. 安装依赖
我们需要安装 express 作为我们的 Web 框架，以及 body-parser 来解析请求体中的 JSON 数据。
npm install express body-parser
3. 创建服务器
接下来，我们将创建一个简单的 HTTP 服务器。在项目根目录下创建一个名为 server.js 的文件，并添加以下代码：
const express = require('express');
const bodyParser = require('body-parser');
// 创建 Express 应用实例
const app = express();
// 使用 body-parser 中间件来解析 JSON 请求体
app.use(bodyParser.json());
// 设置监听端口
const PORT = process.env.PORT || 3000;
// 启动服务器
app.listen(PORT, () => {
console.log(`Server is running on port ${
PORT}`);
});
4. 设计数据模型
我们将使用一个简单的内存数组来模拟数据库操作。在 server.js 中添加一个模拟数据模型：
let todos = [
{
id: 1, title: '学习 Node.js', completed: false },
{
id: 2, title: '练习 Express', completed: true },
];
// 用于生成唯一 ID 的辅助函数
function generateId() {
return Math.floor(Math.random() * 100000);
}
5. 实现 RESTful API
接下来，我们将为 CRUD 操作实现对应的 HTTP 路由。
GET 请求
首先，实现一个 GET 请求来获取所有的待办事项：
app.get('/todos', (req, res) => {
res.status(200).json(todos);
});
POST 请求
接着，实现一个 POST 请求来添加新的待办事项：
app.post('/todos', (req, res) => {
const newTodo = {
id: generateId(),
title: req.body.title,
completed: false,
};
todos.push(newTodo);
res.status(201).json(newTodo);
});
PUT 请求
实现一个 PUT 请求来更新现有的待办事项：
app.put('/todos/:id', (req, res) => {
const id = parseInt(req.params.id, 10);
const updatedTodo = req.body;
const todoIndex = todos.findIndex(todo => todo.id === id);
if (todoIndex !== -1) {
todos[todoIndex] = {
...todos[todoIndex], ...updatedTodo };
res.status(200).json(todos[todoIndex]);
} else {
res.status(404).send('Todo not found');
}
});
DELETE 请求
最后，实现一个 DELETE 请求来删除特定的待办事项：
app.delete('/todos/:id', (req, res) => {
const id = parseInt(req.params.id, 10);
const todoIndex = todos.findIndex(todo => todo.id === id);
if (todoIndex !== -1) {
todos.splice(todoIndex, 1);
res.status(204).send();
} else {
res.status(404).send('Todo not found');
}
});
6. 测试 API
启动服务器：
node server.js
现在，你可以使用 Postman 或者 curl 等工具来测试这些 API。
例如，使用 curl 发送一个 POST 请求：
curl -X POST http://localhost:3000/todos -H "Content-Type: application/json" -d '{"title":"学习 Express"}'
7. 总结
通过这篇文章，我们成功地使用 Node.js 和 Express 构建了一个简单的 RESTful API 服务器，它能够处理基本的 CRUD 操作。这个例子展示了如何创建一个 HTTP 服务器，如何接收和发送 JSON 数据，以及如何使用中间件来处理请求体。
