Node.js 怎么使用 Express 框架写后端接口

在现代 Web 开发中，Node.js 是一个非常流行的后端开发平台，而 Express 框架则是 Node.js 中最常用的 Web 框架之一。Express 提供了简洁的 API 和强大的功能，使得开发者可以快速构建高效的后端服务。本文将介绍如何使用 Express 框架编写后端接口。

1. 安装 Node.js 和 Express

首先，确保你已经安装了 Node.js。你可以通过以下命令检查是否已经安装：

node -v

如果未安装，请前往 Node.js 官网 下载并安装。

接下来，创建一个新的项目目录并初始化 Node.js 项目：

mkdir my-express-app
cd my-express-app
npm init -y

然后，安装 Express 框架：

npm install express

2. 创建基本的 Express 应用

在项目目录中创建一个 app.js 文件，并编写以下代码：

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

这段代码创建了一个简单的 Express 应用，监听 3000 端口，并在根路径 (/) 上返回 “Hello World!“。

3. 编写 RESTful API

接下来，我们将编写一个简单的 RESTful API，支持对资源的增删改查操作。

3.1 定义数据模型

假设我们要管理一个用户列表，我们可以定义一个简单的数组来存储用户数据：

let users = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' }
];

3.2 获取所有用户

我们可以通过 GET /users 接口获取所有用户：

app.get('/users', (req, res) => {
  res.json(users);
});

3.3 获取单个用户

通过 GET /users/:id 接口获取指定 ID 的用户：

app.get('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  const user = users.find(u => u.id === userId);
  if (user) {
    res.json(user);
  } else {
    res.status(404).send('User not found');
  }
});

3.4 创建新用户

通过 POST /users 接口创建新用户：

app.use(express.json());

app.post('/users', (req, res) => {
  const newUser = {
    id: users.length + 1,
    name: req.body.name
  };
  users.push(newUser);
  res.status(201).json(newUser);
});

3.5 更新用户

通过 PUT /users/:id 接口更新指定 ID 的用户：

app.put('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  const user = users.find(u => u.id === userId);
  if (user) {
    user.name = req.body.name;
    res.json(user);
  } else {
    res.status(404).send('User not found');
  }
});

3.6 删除用户

通过 DELETE /users/:id 接口删除指定 ID 的用户：

app.delete('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  const userIndex = users.findIndex(u => u.id === userId);
  if (userIndex !== -1) {
    users.splice(userIndex, 1);
    res.status(204).send();
  } else {
    res.status(404).send('User not found');
  }
});

4. 运行应用

完成上述代码后，你可以通过以下命令启动应用：

node app.js

然后，你可以使用 Postman 或 curl 等工具测试这些 API 接口。

5. 总结

本文介绍了如何使用 Express 框架编写后端接口。通过 Express，我们可以轻松地创建 RESTful API，处理 HTTP 请求，并返回 JSON 数据。Express 的简洁性和灵活性使得它成为 Node.js 开发者的首选框架之一。希望本文能帮助你快速上手 Express，并开始构建自己的后端服务。