Node.js 使用 Mongoose

Mongoose 是一个用于 Node.js 的对象数据建模（ODM）库，它提供了一种简单的方式来定义和操作数据库中的数据模型。Mongoose 支持 MongoDB 数据库，并提供了强大的功能，如验证、中间件、插件等。

安装 Mongoose

首先，你需要安装 Mongoose 和 MongoDB 驱动程序。你可以使用 npm（Node.js 包管理器）来安装这些包：

npm install mongoose

创建连接到 MongoDB 的 Mongoose 实例

在你的 Node.js 应用中，你需要创建一个 Mongoose 实例并连接到 MongoDB 数据库。以下是一个简单的示例：

const mongoose = require('mongoose');

// 连接到 MongoDB 数据库
mongoose.connect('mongodb://localhost:27017/mydatabase', {
    useNewUrlParser: true,
    useUnifiedTopology: true
}).then(() => console.log('MongoDB connected...'))
  .catch(err => console.log(err));

这里，mydatabase 是你要连接的数据库名称。useNewUrlParser 和 useUnifiedTopology 选项是用于确保与 MongoDB 服务器的兼容性。

定义数据模型

在 Mongoose 中，你可以通过定义一个模式（Schema）来描述文档的数据结构。以下是如何定义一个用户模型：

// www.javascriptcn.com code example
const mongoose = require('mongoose');
const Schema = mongoose.Schema;

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

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

module.exports = User;

在这个例子中，我们定义了一个 userSchema 模式，它包含了 name, email, password 和 date 字段。我们还设置了 email 字段为唯一，这样可以避免重复的电子邮件地址。

使用模型进行 CRUD 操作

创建文档

// www.javascriptcn.com code example
const User = require('./models/User'); // 假设你的模型文件名为 User.js

// 创建新用户
const newUser = new User({
    name: 'John Doe',
    email: 'john@example.com',
    password: 'password123'
});

newUser.save().then(user => console.log(user))
               .catch(err => console.log(err));

读取文档

查找所有文档

User.find()
    .then(users => console.log(users))
    .catch(err => console.log(err));

根据条件查找单个文档

User.findOne({ email: 'john@example.com' })
    .then(user => console.log(user))
    .catch(err => console.log(err));

更新文档

User.updateOne({ email: 'john@example.com' }, { $set: { name: 'Jane Doe' } })
    .then(result => console.log(result))
    .catch(err => console.log(err));

删除文档

User.deleteOne({ email: 'john@example.com' })
    .then(result => console.log(result))
    .catch(err => console.log(err));

使用中间件

Mongoose 允许你在模型生命周期的不同阶段添加中间件，例如在保存、更新或删除文档之前或之后执行特定的操作。

// www.javascriptcn.com code example
userSchema.pre('save', function(next) {
    if (!this.isModified('password')) {
        return next();
    }

    bcrypt.genSalt(10, (err, salt) => {
        if (err) return next(err);

        bcrypt.hash(this.password, salt, (err, hash) => {
            if (err) return next(err);
            this.password = hash;
            next();
        });
    });
});

userSchema.methods.comparePassword = function(candidatePassword, cb) {
    bcrypt.compare(candidatePassword, this.password, (err, isMatch) => {
        if (err) return cb(err);
        cb(null, isMatch);
    });
};

在这个例子中，我们在保存用户模型之前对密码进行了哈希处理，并添加了一个方法来比较候选密码和存储的哈希密码。

插件

Mongoose 提供了插件机制，允许你向模型添加额外的功能。例如，你可以使用 mongoose-unique-validator 插件来简化唯一字段的验证。

const uniqueValidator = require('mongoose-unique-validator');

userSchema.plugin(uniqueValidator);

// 现在你的模型将自动处理唯一字段的验证错误

错误处理

在使用 Mongoose 进行数据库操作时，错误处理是非常重要的。你可以使用 try-catch 结构来捕获异步操作中的错误。

try {
    const user = await User.create({ name: 'John Doe', email: 'john@example.com', password: 'password123' });
    console.log(user);
} catch (error) {
    console.error(error);
}

通过以上步骤，你可以开始在 Node.js 应用中使用 Mongoose 来管理你的数据模型。Mongoose 的强大功能可以帮助你更有效地构建和维护应用程序。