Mongoose Document prototype.replaceOne()用法及代碼示例

Mongoose API 的原型.replaceOne() 方法用於替換集合中存在的任何文檔的字段值。我們可以在任何文檔對象上使用replaceOne()，並將帶有字段和值的對象作為參數傳遞給該方法。它將用我們提供給該方法的字段和值替換現有的文檔對象。此方法的用法方式與 update 方法相同，但它用現有文檔值替換文檔值，而不使用任何原子運算符，即 $set。

用法:

doc.replaceOne()

參數： 原型.replaceOne()方法接受三個參數：

• doc:它是一個帶有字段的對象，該字段將替換現有字段。
• options:它是一個具有各種屬性的對象。
• callback:它是一個回調函數，一旦執行完成就會運行。

返回值： 原型.replaceOne()函數返回一個承諾。結果包含一個具有以下鍵和值或屬性的對象。

// 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”。最後，我們使用的是replaceOne()User 模型的文檔對象上的方法，它將用我們作為對象傳遞給的屬性替換文檔字段和值replaceOne()。

• 應用程序.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” 字段將具有 null 或未定義值，因為我們已將整個文檔替換為 name 字段。

• 應用程序.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