Mongoose Document prototype.replaceOne()函数

Mongoose API的prototype.replaceOne()方法用于替换集合中任意文档的字段值。我们可以在任意文档对象上使用replaceOne()方法，并将带有字段和值的对象作为参数传递给该方法。它将使用我们提供给该方法的字段和值替换现有的文档对象。该方法与update方法的操作类似，但是它替换文档值时不使用任何原子运算符，即$set。

语法：

doc.replaceOne()

参数： prototype.replaceOne() 方法接受三个参数：

• doc: 这是一个带有一个字段的对象，该字段将替换现有的字段。
• options: 这是一个带有各种属性的对象。
• callback: 这是一个回调函数，一旦执行完成就会运行。

返回值： prototype.replaceOne() 函数返回一个promise。结果包含以下键和值或属性的对象。

// Number of documents matched
res.matchedCount;

// Number of documents modified
res.modifiedCount;

// Boolean indicating everything went smoothly
res.acknowledged;

// null or an id containing a document
// that had to be upserted
res.upsertedId; 

// Number indicating how many documents
// had to be upserted. Will either be 0 or 1
res.upsertedCount;

设置 Node.js 应用程序:

步骤1: 使用以下命令创建一个 Node.js 应用程序：

npm init

步骤2： 在创建了NodeJS应用程序之后，使用以下命令安装所需的模块：

npm install mongoose

项目结构： 项目的结构将如下所示：

数据库结构： 数据库结构将如下所示，集合中包含以下文档。

示例1： 在这个示例中，我们使用mongoose建立了一个数据库连接，并在userSchema上定义了一个模型，有两个列或字段“name”和“age”。最后，我们在User模型的文档对象上使用 replaceOne() 方法，它将用我们传递的对象的属性替换文档的字段和值。

• app.js: 在app.js文件中写下以下代码：

// Require mongoose module 
const mongoose = require("mongoose"); 
  
// Set Up the Database connection 
mongoose.connect("mongodb://localhost:27017/geeksforgeeks", { 
    useNewUrlParser: true, 
    useUnifiedTopology: true, 
}); 
  
const userSchema = new mongoose.Schema({ 
    name: String, 
    age: Number, 
}); 
  
// Defining userSchema model 
const User = mongoose.model("User", userSchema); 
  
const doc = User.findById("63203694182cd3c22ea480ff"); 
  
doc.replaceOne({ name: "User1 Updated", age: 100 }) 
.then((output) => { 
    console.log(output); 
});

运行程序的步骤：

要运行该应用程序，请从项目的根目录执行以下命令：

node app.js

输出：

{
     acknowledged: true,
     modifiedCount: 1,  
     upsertedId: null,  
     upsertedCount: 0,  
     matchedCount: 1    
}

使用Robo3T GUI工具的数据库GUI表示：

示例-2： 在这个示例中，我们用只有一个字段“name”替换了文档对象。我们没有为“age”字段提供任何值。因此，在数据库中，您将看到整个文档被替换，只有“name”字段有一个值，“age”字段将有一个空值或未定义的值，因为我们用name字段替换了整个文档。

• app.js： 在app.js文件中写下如下代码：

// Require mongoose module 
const mongoose = require("mongoose"); 
  
// Set Up the Database connection 
mongoose.connect("mongodb://localhost:27017/geeksforgeeks", { 
    useNewUrlParser: true, 
    useUnifiedTopology: true, 
}); 
  
const userSchema = new mongoose.Schema({ 
    name: String, 
    age: Number, 
}); 
  
// Defining userSchema model 
const User = mongoose.model("User", userSchema); 
  
const replaceOne = async () => { 
  
    // Finding document object using doc _id 
    const doc = await User.findById( 
        "63204ad5182cd3c22ea486ae"
    ); 
      
    const output = await doc.replaceOne({  
        name: "User2 Replaced" 
    }) 
    console.log(output) 
} 
replaceOne();

运行程序的步骤： 从项目的根目录中执行以下命令来运行应用程序：

node app.js

输出：

{
      acknowledged: true,
      modifiedCount: 1,  
      upsertedId: null,  
      upsertedCount: 0,  
      matchedCount: 1    
}

Robo3T GUI工具中使用的数据库的GUI表示：

参考： https://mongoosejs.com/docs/api/document.html#document_Document-replaceOne