CoderWithAI LogoCoderWithAI

MongoDB 与 Mongoose 教程

1. 概述

在本教程中，我们将深入探讨如何使用 MongoDB 和 Mongoose 来管理 Node.js 应用程序中的数据。MongoDB 是一个 NoSQL 数据库，而 Mongoose 是一个用于 MongoDB 的对象数据建模（ODM）库。通过本教程，你将学会如何设置 MongoDB 数据库、使用 Mongoose 进行数据建模、执行 CRUD 操作以及处理数据库连接。

2. MongoDB 简介

2.1 什么是 MongoDB？

MongoDB 是一个开源的 NoSQL 数据库，它以文档的形式存储数据。与传统的关系型数据库不同，MongoDB 使用类似 JSON 的 BSON 格式来存储数据，这使得它非常适合处理非结构化数据。

2.2 MongoDB 的核心概念

  • 文档：MongoDB 中的基本数据单元，类似于关系型数据库中的行。
  • 集合：一组文档的容器，类似于关系型数据库中的表。
  • 数据库：一组集合的容器，类似于关系型数据库中的数据库。

2.3 安装 MongoDB

你可以通过以下步骤在本地安装 MongoDB：

  1. 下载 MongoDB 安装包：MongoDB 下载页面
  2. 按照安装向导进行安装。
  3. 启动 MongoDB 服务。

3. Mongoose 简介

3.1 什么是 Mongoose？

Mongoose 是一个用于 MongoDB 的对象数据建模（ODM）库。它提供了一种在 Node.js 应用程序中与 MongoDB 交互的方式，使得数据建模和操作更加简单和直观。

3.2 Mongoose 的核心概念

  • Schema：定义了文档的结构和字段类型。
  • Model：基于 Schema 创建的构造函数，用于与数据库中的集合进行交互。
  • Document：Model 的实例，代表数据库中的一个文档。

4. 环境搭建

4.1 安装 Node.js 和 npm

确保你已经安装了 Node.js 和 npm。你可以通过以下命令检查安装情况：

node -v
npm -v

4.2 创建项目目录

创建一个新的项目目录并初始化 npm：

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

4.3 安装 Mongoose

使用 npm 安装 Mongoose：

npm install mongoose

5. 连接 MongoDB

5.1 创建数据库连接

在你的项目根目录下创建一个 db.js 文件，并编写以下代码来连接 MongoDB：

const mongoose = require('mongoose');

const connectDB = async () => {
  try {
    await mongoose.connect('mongodb://localhost:27017/mydatabase', {
      useNewUrlParser: true,
      useUnifiedTopology: true,
    });
    console.log('MongoDB connected');
  } catch (err) {
    console.error(err.message);
    process.exit(1);
  }
};

module.exports = connectDB;

5.2 在应用中使用数据库连接

在你的主应用程序文件（例如 app.js）中引入并调用 connectDB 函数：

const express = require('express');
const connectDB = require('./db');

const app = express();

// Connect to MongoDB
connectDB();

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

const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

6. 定义 Schema 和 Model

6.1 创建 Schema

在你的项目中创建一个 models 目录，并在其中创建一个 User.js 文件：

const mongoose = require('mongoose');

const UserSchema = new mongoose.Schema({
  name: {
    type: String,
    required: true,
  },
  email: {
    type: String,
    required: true,
    unique: true,
  },
  password: {
    type: String,
    required: true,
  },
  date: {
    type: Date,
    default: Date.now,
  },
});

module.exports = mongoose.model('User', UserSchema);

6.2 使用 Model

在你的主应用程序文件中引入并使用 User 模型：

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

app.post('/register', async (req, res) => {
  const { name, email, password } = req.body;

  try {
    let user = new User({
      name,
      email,
      password,
    });

    await user.save();
    res.send('User registered');
  } catch (err) {
    console.error(err.message);
    res.status(500).send('Server error');
  }
});

7. 执行 CRUD 操作

7.1 创建（Create）

使用 save() 方法将新文档插入数据库：

const newUser = new User({ name: 'John Doe', email: '[email protected]', password: '123456' });
await newUser.save();

7.2 读取（Read）

使用 find() 方法查询文档：

const users = await User.find();
console.log(users);

7.3 更新（Update）

使用 findOneAndUpdate() 方法更新文档：

await User.findOneAndUpdate({ email: '[email protected]' }, { name: 'John Smith' });

7.4 删除（Delete）

使用 findOneAndDelete() 方法删除文档：

await User.findOneAndDelete({ email: '[email protected]' });

8. 实践练习

8.1 创建一个简单的用户管理系统

  1. 创建一个 Express 应用。
  2. 连接到 MongoDB 数据库。
  3. 定义一个 User 模型。
  4. 实现用户注册、登录、更新和删除功能。

8.2 代码示例

const express = require('express');
const connectDB = require('./db');
const User = require('./models/User');

const app = express();
app.use(express.json());

// Connect to MongoDB
connectDB();

// Register a new user
app.post('/register', async (req, res) => {
  const { name, email, password } = req.body;

  try {
    let user = new User({
      name,
      email,
      password,
    });

    await user.save();
    res.send('User registered');
  } catch (err) {
    console.error(err.message);
    res.status(500).send('Server error');
  }
});

// Get all users
app.get('/users', async (req, res) => {
  try {
    const users = await User.find();
    res.json(users);
  } catch (err) {
    console.error(err.message);
    res.status(500).send('Server error');
  }
});

// Update a user
app.put('/users/:id', async (req, res) => {
  const { name, email, password } = req.body;

  try {
    await User.findByIdAndUpdate(req.params.id, { name, email, password });
    res.send('User updated');
  } catch (err) {
    console.error(err.message);
    res.status(500).send('Server error');
  }
});

// Delete a user
app.delete('/users/:id', async (req, res) => {
  try {
    await User.findByIdAndDelete(req.params.id);
    res.send('User deleted');
  } catch (err) {
    console.error(err.message);
    res.status(500).send('Server error');
  }
});

const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

9. 总结

通过本教程，你已经学会了如何使用 MongoDB 和 Mongoose 来管理 Node.js 应用程序中的数据。你了解了 MongoDB 和 Mongoose 的基本概念，学会了如何连接数据库、定义 Schema 和 Model，以及执行 CRUD 操作。希望这些知识能够帮助你在实际项目中更好地使用 MongoDB 和 Mongoose。

10. 进一步学习

  • 深入学习 MongoDB 的高级功能，如索引、聚合管道和复制集。
  • 探索 Mongoose 的高级功能，如虚拟字段、中间件和插件。
  • 学习如何在生产环境中部署和监控 MongoDB 数据库。

继续探索和实践，你将能够更熟练地使用 MongoDB 和 Mongoose 来构建强大的应用程序。

← Previous: 04. 数据库集成Next: SQL 数据库入门：MySQL 与 PostgreSQL 基础教程 →