实现一个完整的Node.js RESTful API的示例

完整实现一个Node.js RESTful API的攻略：

1. 确定API的功能和路由设计

首先，需要确定API的功能和路由设计。例如，一个图书管理系统的API需要提供创建、更新、获取和删除图书信息的功能，可以设计以下路由：

• POST /books：创建一本图书
• GET /books：获取所有图书信息
• GET /books/:id：获取特定图书信息
• PUT /books/:id：更新特定图书信息

• DELETE /books/:id：删除特定图书信息

• 初始化项目并安装依赖

使用命令行工具初始化项目，并在package.json中添加所需的依赖，例如：

npm init
npm install express body-parser --save

其中，express是一个流行的Node.js框架，可简化路由和请求处理的开发，而body-parser则方便地解析请求体的内容。

1. 创建应用和路由

根据API路由设计创建应用和路由，如下所示：

const express = require('express');
const bodyParser = require('body-parser');

// 创建应用
const app = express();
// 添加中间件
app.use(bodyParser.json());

// 添加GET路由，获取所有图书信息
app.get('/books', (req, res) => {
  res.send('TODO: Get all books');
});

// 添加POST路由，创建一本图书
app.post('/books', (req, res) => {
  res.send('TODO: Create a book');
});

// 添加GET路由，获取特定图书信息
app.get('/books/:id', (req, res) => {
  res.send(`TODO: Get book ${req.params.id}`);
});

// 添加PUT路由，更新特定图书信息
app.put('/books/:id', (req, res) => {
  res.send(`TODO: Update book ${req.params.id}`);
});

// 添加DELETE路由，删除特定图书信息
app.delete('/books/:id', (req, res) => {
  res.send(`TODO: Delete book ${req.params.id}`);
});

// 启动应用
app.listen(3000, () => {
  console.log('App listening on port 3000');
});

1. 实现路由的处理函数

针对每个路由，实现相应的请求处理逻辑。例如，对于创建一本图书的路由，可以实现如下处理函数：

app.post('/books', (req, res) => {
  const { title, author, price } = req.body;
  // TODO: 将图书信息保存到数据库
  res.send('Book created successfully');
});

其中，req.body中包含了传输的JSON格式的请求体内容。

1. 连接数据库并实现持久层逻辑

如果需要将图书信息保存到数据库中，则需要连接数据库，并实现相应的持久层逻辑。例如，使用MongoDB数据库，可以使用mongoose库连接并实现图书模型和CRUD操作：

const mongoose = require('mongoose');

// 创建图书模型
const bookSchema = new mongoose.Schema({
  title: String,
  author: String,
  price: Number,
});
const Book = mongoose.model('Book', bookSchema);

// 创建连接
mongoose.connect('mongo://localhost:27017/books');

// 实现创建图书的持久层逻辑
app.post('/books', (req, res) => {
  const { title, author, price } = req.body;
  const book = new Book({ title, author, price });
  book.save((err) => {
    if (err) {
      res.status(500).send('Failed to create book');
    } else {
      res.send('Book created successfully');
    }
  });
});

// 实现获取所有图书信息的持久层逻辑
app.get('/books', (req, res) => {
  Book.find((err, books) => {
    if (err) {
      res.status(500).send('Failed to get books');
    } else {
      res.send(books);
    }
  });
});

// 实现获取特定图书信息的持久层逻辑
app.get('/books/:id', (req, res) => {
  Book.findById(req.params.id, (err, book) => {
    if (err) {
      res.status(500).send('Failed to get book');
    } else if (!book) {
      res.status(404).send('Book not found');
    } else {
      res.send(book);
    }
  });
});

// 实现更新特定图书信息的持久层逻辑
app.put('/books/:id', (req, res) => {
  Book.findByIdAndUpdate(
    req.params.id,
    req.body,
    { new: true },
    (err, book) => {
      if (err) {
        res.status(500).send('Failed to update book');
      } else if (!book) {
        res.status(404).send('Book not found');
      } else {
        res.send(book);
      }
    }
  );
});

// 实现删除特定图书信息的持久层逻辑
app.delete('/books/:id', (req, res) => {
  Book.findByIdAndRemove(req.params.id, (err, book) => {
    if (err) {
      res.status(500).send('Failed to delete book');
    } else if (!book) {
      res.status(404).send('Book not found');
    } else {
      res.send('Book deleted successfully');
    }
  });
});

通过以上步骤，就完成了一个简单的Node.js RESTful API，具备创建、更新、获取和删除图书信息的功能，且实现了持久化存储。

示例说明：

1. 创建一个用于管理用户信息的API。包括创建用户、获取用户、更新用户、删除用户等功能。其中，创建用户需要上传JSON格式的用户信息，每个用户包括姓名、年龄、性别三个属性。

2. 创建一个用于查询股票信息的API。包括根据股票代码查股票价格、查看特定股票历史价格列表等功能。提供的路由包括：

3. GET /stocks/:code/price：获取特定股票的实时价格

4. GET /stocks/:code/history：获取特定股票的历史价格列表