文章目录
- 介绍
- 特点：
- Mongoose 使用：
- 创建项目并安装：
- 连接到 MongoDB：
- 定义 Schema：
- 创建模型并操作数据库：
- 创建文档：
- 查询文档：
- 更新文档：
- 删除文档：
- 使用钩子（Hooks）：
- 数据验证：
- 使用虚拟属性（Virtuals）
- 设置选项：
介绍
Mongoose 是一个 MongoDB 对象模型库（ODM），它为 Node.js 应用程序提供了一个直白、简洁和富有表现力的数据建模工具.
特点：
- Mongoose 通过定义模型（Model），这些模型对应于 MongoDB 中的集合（Collection）。
- Mongoose 通过定义结构（Schema），你可以指定集合中文档（Document）的结构和类型。
- Mongoose 提供了强大的数据验证机制，确保在保存到数据库之前，数据符合预定义的模式和规则。
- Mongoose 允许你在数据保存或查询之前或之后执行中间件，这可以用来执行如数据加密、日志记录等操作。
- Mongoose 支持虚拟属性，这些属性在 MongoDB 中不存储，但可以在应用层使用，常用于计算字段或隐藏某些字段。
- Mongoose 提供了多个生命周期钩子，如
save、validate、index等，允许你在文档的生命周期中的特定点执行自定义代码。
Mongoose 使用：
api 使用操作详见上一篇文章
先介绍下 mongoose 的一些概念、然后以常见功能开发，来举例实现一些 api 介绍，如子文档嵌套、关联查询、查询密码隐藏、默认值设置、MD5 加密、文档数组更新
创建项目并安装：
在 Node.js 项目中，你可以通过 npm 来安装 Mongoose , crypto-js包方便我们进行密码的加密,也可以用 node 自己的 crypto
mkdir mongoose-demo && cd mongoose-demopnpm initpnpm init mongoose crypto-js连接到 MongoDB：
创建 main.js，在文件中引入 mongoose ， 调用其 connect 进行连接,可使用用户名密码或直接连接
// 直连
await mongoose.connect('mongodb://127.0.0.1:27017/test')
// 添加用户认证
await mongoose.connect('mongodb://root:123456@localhost:8017/test?authSource=admin')
const mongoose = require('mongoose')const connect = async () => {try {db = await mongoose.connect('mongodb://root:123456@localhost:8017/test?authSource=admin')console.log('Connected to MongoDB')} catch (error) {console.log(error.message)}
}
// 调用
connect()
定义 Schema：
-
在这里使用 Schema 定义 MongoDB 集合的结构，在这里我们定义一个用户结构 （UserSchema） 和地址结构(AddrSchema)：
-
这里使用
default设置字段默认值，使用select来设置在find和findOne的返回结构中是否展示，避免将密码等敏感字符暴露出接口，
使用set方法，在数据保存进库之前进行一些操作（如加密）， -
使用 ref 来进行嵌套子文档查询，这里的
user是 model 的名称，不是 Schema -
这里我们使用 children 来进行
一对多的查询
const UserSchema = new mongoose.Schema({name: String,age: String,phone: {type: String,default: '1848****222' // 设置默认值},password: {type: String,// select: false,set: val => {return Crypto.MD5(val)}},children: [{type: mongoose.Schema.Types.ObjectId,ref: 'addr'}]
})
const AddrSchema = new mongoose.Schema({province: String,city: String,area: String,detail: String,user_id: { type: mongoose.Schema.Types.ObjectId, ref: 'user' }
})
创建模型并操作数据库：
将 Schema 编译成 Model，用于操作数据库：
const userModel = mongoose.model('user', UserSchema, 'users')
const addrModel = mongoose.model('addr', AddrSchema, 'addrs')
创建文档：
使用模型创建文档（即数据库中的记录）, 创建add方法，来实现 新增操作
const add = async (name, password) => {try {let user = new userModel({ name, password })let _user = await user.save()console.log('用户保存成功', _user)let addr = new addrModel({province: '四川',city: '成都',area: '高新',user_id: _user._id})let _addr = await addr.save()console.log('地址保存成功', _addr)let update = await userModel.updateOne({ _id: _user._id }, { $push: { children: _addr._id } })console.log('更新成功：', _user._id, _addr._id, update)} catch (error) {console.log(error)}
}const connect = async () => {try {db = await mongoose.connect('mongodb://root:123456@localhost:8017/test?authSource=admin')console.log('Connected to MongoDB')// 在這裡添加操作add('ziyu', 'ziyu')} catch (error) {console.log(error.message)}
}
查询文档：
查询数据库中的文档,新增 query方法，这里用到一个populate方法
Mongoose 的 populate 功能 是一种用于填充引用字段的方法，它允许我们在查询结果中获取关联文档的详细信息。使用 populate 方法可以将关联字段的引用值替换为实际的对象值，从而方便地获取关联对象的详细信息。
// find() // 默认查询全部
// findOne() // 查询一个const query = async () => {let findUser = await userModel.findOne({ name: /ziyu/ }).populate('children').exec()console.log('查询用户', findUser)// let findUser = await addrModel.find({}).populate("user_id").exec();// console.log("查询地址", findUser);
}
更新文档：
更新数据库中的文档, 创建update方法
const update = async () => {try {let update = await userModel.updateOne({ _id: '675fd59091847b07acc95fbc' }, { $push: { children: '675fd5b7d62dd41f6e8d88c4' } })console.log('更新成功：', update)} catch (error) {console.log(error)}
}
删除文档：
从数据库中删除文档：
const update = async () => {try {await userModel.deleteOne({ name: 'jty' })console.log('删除成功：', update)} catch (error) {console.log(error)}
}
使用钩子（Hooks）：
Mongoose 允许你在文档的生命周期中的特定点执行代码，例如在保存前加密密码：
userSchema.pre('save', function (next) {this.password = Crypto.MD5(this.password)next()
})
数据验证：
Mongoose 提供了强大的数据验证功能，确保保存到数据库的数据是有效的：
userSchema.path('email').validate(function (value) {return validator.isEmail(value)
}, 'Invalid email')
使用虚拟属性（Virtuals）
虚拟属性允许你定义不存储在 MongoDB 中的属性，但可以在查询时使用：
schema.path('name').get(function (v) {return v + ' is my name'
})
schema.set('toJSON', { getters: true })
设置选项：
Mongoose 提供了多种选项来自定义模型的行为，例如 `strict`、`typeKey` 和 `validateBeforeSave`：
cosnt schema = new UserSchema({// ...},{ strict: true, typeKey: '$type', validateBeforeSave: false }
)
