Node.js 与数据库：使用 MongoDB 构建一个简单的 CRUD 应用

本文链接：https://blog.youkuaiyun.com/mmc123125/article/details/144281899

Node.js 与数据库：使用 MongoDB 构建一个简单的 CRUD 应用

在这里插入图片描述

1. 引言：为什么选择 MongoDB 与 Node.js？

Node.js 是一个基于事件驱动、非阻塞式 I/O 模型的高效应用开发平台，特别适用于构建高并发的应用。而 MongoDB 是一个基于文档存储的 NoSQL 数据库，能够灵活地存储结构化和非结构化的数据，非常适合与 Node.js 一起使用，尤其是在开发需要快速原型的应用时。MongoDB 的文档模型非常适合动态和频繁变化的数据结构，与 Node.js 的异步特性完美契合。

在这篇教程中，我们将使用 Node.js 与 MongoDB 搭建一个简单的 CRUD（增删改查）应用，帮助你了解如何将两者结合使用。

2. 环境搭建

安装 Node.js

首先，需要确保系统中安装了 Node.js。可以从 Node.js 官网下载并安装 Node.js。

在终端中运行以下命令来检查 Node.js 是否安装成功：

node -v
npm -v

安装 MongoDB

你可以选择本地安装 MongoDB 或使用 MongoDB Atlas（云端数据库）。我们以本地安装为例。

Windows 用户可以通过 MongoDB 官网下载并安装 MongoDB。

macOS 用户可以通过 Homebrew 安装 MongoDB：

brew tap mongodb/brew
brew install mongodb-community@5.0

安装完 MongoDB 后，启动数据库：

mongod

MongoDB 会在默认端口 27017 上运行。

3. 创建 Node.js 项目

接下来，我们来创建一个简单的 Node.js 项目。

步骤 1：初始化项目

在你想要创建项目的文件夹中，打开终端并运行以下命令来初始化一个新的 Node.js 项目：

mkdir node-mongo-crud
cd node-mongo-crud
npm init -y

步骤 2：安装依赖

我们需要安装一些依赖，包括 express（用于搭建服务器）和 mongoose（用于与 MongoDB 进行交互）：

npm install express mongoose

4. 集成 MongoDB 到 Node.js 应用

步骤 1：创建一个简单的服务器

在项目根目录下创建一个 server.js 文件，编写基础的 Node.js 服务器代码：

const express = require('express');
const mongoose = require('mongoose');

// 创建 Express 应用
const app = express();

// 连接到 MongoDB
mongoose.connect('mongodb://localhost:27017/crudApp', {
    useNewUrlParser: true,
    useUnifiedTopology: true
}).then(() => {
    console.log("MongoDB connected successfully");
}).catch(err => {
    console.log("MongoDB connection error:", err);
});

// 启动服务器
app.listen(3000, () => {
    console.log("Server is running on http://localhost:3000");
});

步骤 2：创建一个 MongoDB 模型

在项目中创建一个 models 文件夹，并在其中创建一个 User.js 文件来定义数据模型。我们将创建一个简单的用户模型，包括 name 和 email 字段。

const mongoose = require('mongoose');

// 定义用户模型
const userSchema = new mongoose.Schema({
    name: { type: String, required: true },
    email: { type: String, required: true, unique: true }
});

// 创建模型
const User = mongoose.model('User', userSchema);

module.exports = User;

5. CRUD 操作实现

创建数据（Create）

我们来实现一个 POST 路由来创建新用户。

app.use(express.json());  // 中间件，解析请求体中的 JSON 数据

const User = require('./models/User');

// 创建用户
app.post('/users', async (req, res) => {
    try {
        const { name, email } = req.body;
        const newUser = new User({ name, email });
        await newUser.save();
        res.status(201).json(newUser);
    } catch (error) {
        res.status(400).json({ error: error.message });
    }
});

读取数据（Read）

接下来，我们实现一个 GET 路由来获取所有用户。

// 获取所有用户
app.get('/users', async (req, res) => {
    try {
        const users = await User.find();
        res.status(200).json(users);
    } catch (error) {
        res.status(400).json({ error: error.message });
    }
});

如果需要获取单个用户的详细信息，可以使用如下路由：

// 获取单个用户
app.get('/users/:id', async (req, res) => {
    try {
        const user = await User.findById(req.params.id);
        if (!user) {
            return res.status(404).json({ error: 'User not found' });
        }
        res.status(200).json(user);
    } catch (error) {
        res.status(400).json({ error: error.message });
    }
});

更新数据（Update）

实现一个 PUT 路由来更新用户信息：

// 更新用户
app.put('/users/:id', async (req, res) => {
    try {
        const { name, email } = req.body;
        const updatedUser = await User.findByIdAndUpdate(req.params.id, { name, email }, { new: true });
        if (!updatedUser) {
            return res.status(404).json({ error: 'User not found' });
        }
        res.status(200).json(updatedUser);
    } catch (error) {
        res.status(400).json({ error: error.message });
    }
});

删除数据（Delete）

实现一个 DELETE 路由来删除用户：

// 删除用户
app.delete('/users/:id', async (req, res) => {
    try {
        const deletedUser = await User.findByIdAndDelete(req.params.id);
        if (!deletedUser) {
            return res.status(404).json({ error: 'User not found' });
        }
        res.status(200).json({ message: 'User deleted successfully' });
    } catch (error) {
        res.status(400).json({ error: error.message });
    }
});