Mongoose Queries Model.replaceOne() 函数
查询 Model.replaceOne() 函数 是 Mongoose API 中用于用给定文档替换现有文档的函数。它只会替换返回结果中的第一个文档。
语法:
Model.replaceOne( filter, doc, options, callback )
参数: 它接受上述提到的4个参数,并分别描述如下:
- filter: 它是一个mongoose对象,用于标识待替换的现有文档。
- doc: 它是一个mongoose对象,用于替换现有文档的文档。
- options: 它是一个可选的基于Query.prototype.setOptions()的mongoose对象。
- callback: 它是一个回调函数,接受两个参数:error和res。
返回类型: 它返回一个Query对象作为响应。
设置Node.js的Mongoose模块:
步骤1: 使用以下命令创建一个Node.js应用:
npm init
步骤2: 创建NodeJS应用程序后,使用以下命令安装所需模块:
npm install mongoose
以下示例将演示 replaceOne()方法 。
示例1: 在此示例中,我们将使用此方法将名为“Luffy”的现有文档替换为一个新文档。
const mongoose = require('mongoose')
// Database connection
mongoose.connect('mongodb://localhost:27017/query-helpers',
{
dbName: 'event_db',
useNewUrlParser: true,
useUnifiedTopology: true
}, err => err ? console.log(err)
: console.log('Connected to database'));
const personSchema = new mongoose.Schema({
name: {
type: String,
select: false
},
age: {
type: Number,
}
});
const personsArray = [
{
name: 'Luffy',
age: 22
},
{
name: 'Nami',
age: 30
},
{
name: 'Zoro',
age: 15
}
]
const Person = mongoose.model('Person', personSchema);
(async () => {
await Person.insertMany(personsArray);
const res = await Person.replaceOne(
{ name: 'Luffy' },
{ name: 'Usurp', age: 23 }
);
console.log(res.matchedCount);
})()
运行应用程序的步骤: 使用以下命令从项目的根目录运行应用程序:
node main.js
输出:
Connected to database
1
使用MongoDB Compass对数据库进行GUI表示:
示例2: 在这个示例中,我们将使用这个方法来替换一个年龄为“19”的现有文档为一个新文档。
const mongoose = require('mongoose')
// Database connection
mongoose.connect('mongodb://localhost:27017/query-helpers',
{
dbName: 'event_db',
useNewUrlParser: true,
useUnifiedTopology: true
}, err => err ? console.log(err)
: console.log('Connected to database'));
const personSchema = new mongoose.Schema({
name: {
type: String,
select: false
},
age: {
type: Number,
}
});
const personsArray = [
{
name: 'Luffy',
age: 19
},
{
name: 'Nami',
age: 30
},
{
name: 'Zoro',
age: 35
}
]
const Person = mongoose.model('Person', personSchema);
(async () => {
await Person.insertMany(personsArray);
const res = await Person.replaceOne(
{ age: 19 },
{ name: 'Usurp', age: 23 }
);
console.log(res.modifiedCount);
})()
运行应用程序的步骤: 使用以下命令从项目的根目录运行应用程序:
node main.js
输出:
Connected to database
1
使用MongoDB Compass的数据库的GUI表示:
参考资料: https://mongoosejs.com/docs/api.html#model_Model-replaceOne