Lab：创建时间与用户信息 API

在本次 Lab 中，我们将通过一个动手操作来熟悉 Express 的路由处理和 GET 请求 API 开发。我们会创建一个简单的 Express 应用，包含三个 GET 接口：

• ​ /api/time ​：返回当前时间的 JSON 数据。
• ​ /api/user/:id ​：根据 URL 中的用户 ID 返回对应的用户信息（模拟数据）。
• ​ /api/items ​：根据查询参数返回不同类别的项目列表。

Lab 任务目标

• 掌握 Express 路由的定义方法。
• 学习如何处理路径参数和查询参数。
• 实现并测试不同的 GET 请求 API 接口。

---

Step-by-Step 实现步骤

1. 项目初始化：

   • 在项目文件夹中运行以下命令，创建新项目并安装 Express：

     npm init -y
     npm install express

2. 创建主文件 server.js ​：

   • 在项目根目录下新建一个文件 server.js ​，用于配置 Express 应用和定义 API 路由。

3. 设置基本的 Express 服务器：

   • 在 server.js ​ 中引入 Express 并创建服务器实例：

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

4. 定义数据对象：

   • 在代码中添加模拟数据，用于 /api/user/:id ​和 /api/items ​接口。

     // 模拟用户数据
     const users = [
       { id: 1, name: "Alice", age: 25 },
       { id: 2, name: "Bob", age: 30 },
       { id: 3, name: "Charlie", age: 35 }
     ];
     
     // 模拟项目数据
     const items = [
       { id: 1, category: "electronics", name: "Laptop" },
       { id: 2, category: "electronics", name: "Smartphone" },
       { id: 3, category: "furniture", name: "Chair" },
       { id: 4, category: "furniture", name: "Table" }
     ];

5. 创建 /api/time ​ 路由：

   • 这个路由会返回当前时间的数据。

   • 使用 JavaScript 的 Date ​对象获取当前时间，并通过 res.json() ​将其返回给客户端。

     // 返回当前时间
     app.get('/api/time', (req, res) => {
       const currentTime = new Date().toISOString();
       res.json({ time: currentTime });
     });

6. 创建 /api/user/:id ​ 路由：

   • 这个路由通过路径参数 id ​ 获取用户信息。

   • 使用 req.params ​对象获取路径中的 id ​参数，并在 users ​数组中查找匹配的用户数据。

     // 根据用户ID返回用户信息
     app.get('/api/user/: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).json({ error: "User not found" });
       }
     });

7. 创建 /api/items ​ 路由：

   • 这个路由支持查询参数 category ​，用于返回特定类别的项目。

   • 使用 req.query ​对象获取查询参数，并在 items ​数组中过滤符合条件的数据。

     // 根据类别返回项目列表
     app.get('/api/items', (req, res) => {
       const category = req.query.category;
       const filteredItems = category ? items.filter(item => item.category === category) : items;
       res.json(filteredItems);
     });

8. 启动服务器：

   • 使用 app.listen() ​方法启动服务器，使其监听在指定端口上。

     // 启动服务器
     app.listen(PORT, () => {
       console.log(`服务器正在运行在 http://localhost:${PORT}`);
     });

完整代码

// server.js

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

// 模拟用户数据
const users = [
  { id: 1, name: "Alice", age: 25 },
  { id: 2, name: "Bob", age: 30 },
  { id: 3, name: "Charlie", age: 35 }
];

// 模拟项目数据
const items = [
  { id: 1, category: "electronics", name: "Laptop" },
  { id: 2, category: "electronics", name: "Smartphone" },
  { id: 3, category: "furniture", name: "Chair" },
  { id: 4, category: "furniture", name: "Table" }
];

// 当前时间接口
app.get('/api/time', (req, res) => {
  const currentTime = new Date().toISOString();
  res.json({ time: currentTime });
});

// 用户信息接口
app.get('/api/user/: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).json({ error: "User not found" });
  }
});

// 项目列表接口
app.get('/api/items', (req, res) => {
  const category = req.query.category;
  const filteredItems = category ? items.filter(item => item.category === category) : items;
  res.json(filteredItems);
});

// 启动服务器
app.listen(PORT, () => {
  console.log(`服务器正在运行在 http://localhost:${PORT}`);
});

测试 API 接口

1. 启动服务器： 在项目目录下运行以下命令，启动服务器：

   node server.js

   控制台输出：

   服务器正在运行在 http://localhost:3000

2. 测试 /api/time ​ 接口： 在浏览器或 Postman 中访问 http://localhost:3000/api/time ​，你将看到返回的当前时间数据，例如：

   { "time": "2023-10-05T14:30:00.000Z" }

3. 测试 /api/user/:id ​ 接口： 访问 http://localhost:3000/api/user/1 ​，你将看到用户 ID 为 1 的用户数据：

   { "id": 1, "name": "Alice", "age": 25 }

4. 测试 /api/items ​ 接口： 访问 http://localhost:3000/api/items?category=electronics ​，你将看到电子产品类别的项目列表：

   [
     { "id": 1, "category": "electronics", "name": "Laptop" },
     { "id": 2, "category": "electronics", "name": "Smartphone" }
   ]

---