迹忆客 专注技术分享

本文将介绍MongoDB中的findOneAndUpdate()方法。 我们将使用此方法更新第一个匹配和嵌入的文档。

在 MongoDB 中使用 findOneAndUpdate() 方法

db.collection.findOneAndUpdate() 方法根据选择标准更新集合的匹配文档。 如果有多个文档匹配，此方法将仅更新与选择条件匹配的第一个文档。

更新文档时 _id 字段的值不会更改。

此方法将返回原始文档； 但是，如果要返回更新后的文档，则必须将 returnNewDocument 参数的值指定为 true。

您可以使用此方法替换嵌入的文档。 这种方法也可以用于多文档事务。

语法：

db.collection.findOneAndUpdate(

selection_criteria: <document>,

update_data: <document>,
{
   projection: <document>,

    sort: <document>,

    maxTimeMS: <number>,

    upsert: <boolean>,

    returnNewDocument: <boolean>,

    collation: <document>,

    arrayFilters: [ <filterdocument1>, … ]
})

参数:

1. 第一个参数 selection_criteria 是更新的选择标准。 此参数的类型是文档。
2. 第二个参数update_data是要更新的文档。 此参数的类型是文档。
3. 第三个参数是可选的。

可选参数：

1. projection：此参数的类型是文档。 projection 参数将确定将哪些字段返回到匹配文档。

   本文档采用以下值：

   { field1: <boolean>, field2: <boolean> ... }
   

   如果该字段的值为 1 或 true，则表示包含该字段，如果该字段的值为 0 或 false，则表示排除该字段。
2. sort：如果查询选择多个文档，这将确定操作将修改哪个文档。 db.collection.findOneAndUpdate() 方法将按照此参数指定的排序顺序更新第一个文档。

   此参数的类型是文档。

3. maxTimeMS：此参数的类型为数字。 它将指定操作必须完成的时间限制（以毫秒为单位）。

   如果超过时间限制，它将返回错误。

4. upsert：该参数默认值为false。

   假设此选项的值设置为 true 并且没有文档匹配给定的过滤器查询。 在这种情况下，此方法会创建一个新文档。

   它返回空值（在插入新文档后），除非 returnNewDocument 选项的值设置为 true。 或者，如果此 upsert 选项的值设置为 true，则此方法将更新与给定过滤器查询匹配的文档。

5. returnNewDocument：这个参数类型是一个布尔值。 默认情况下，此方法将返回原始文档。

   使用 returnNewDocument 参数并将其值设置为 true 以返回更新后的文档。

6. Collation：它指定使用排序规则进行操作。 它允许用户确定特定于语言的字符串比较规则，例如字母大小写和重音符号的规则。

   此参数的类型是文档。

7. arrayFilters：一个过滤器文档数组，指示要为数组字段上的更新操作修改哪些数组元素。 此参数的类型是数组。

它将返回原始文档，但如果要返回更新后的文档，则必须将 returnNewDocument 参数的值设置为 true。

在以下示例中，您将使用以下数据库。 您将创建一个名为 students 的集合，其中包含包含学生详细信息的文档。

数据库如下：

db={
  "students": [
    {
      id: 1,
      name: "Ali",
      language: "JavaScript",
      score: 82
    },
    {
      id: 2,
      name: "Haris",
      language: "Python",
      score: 91
    },
    {
      id: 3,
      name: "Hamza",
      language: "Python",
      score: {
        "Physics": 84,
        "Math": 85
      }
    }
  ]
}

使用 findOneAndUpdate() 方法更新第一个匹配的文档

对于此示例，您将使用下面给出的查询：

db.students.findOneAndUpdate({name:"Ali"},{$inc:{score:4}})

在这里，您将根据选择标准（即名称：“Ali”）更新第一个匹配的文档（即 {$inc:{score:4}}）。score 字段的值增加了 四，它返回原始文档。

输出：

更新文档后，它将返回此输出。

使用 findOneAndUpdate() 方法更新嵌入文档的值

对于此示例，您将使用下面给出的查询：

db.student.findOneAndUpdate({name:"Hamza"},{$inc:{"score.Math":5}})

在这里，您将更新嵌入文档中 Math 字段的值。 Math 字段的值增加了 5。

输出：

使用 findOneAndUpdate() 方法更新第一个匹配的文档并返回更新后的文档

对于此示例，您将使用下面给出的查询：

db.student.findOneAndUpdate({name:"Ali"},{$inc:{score:5}},{returnNewDocument:true})

在这里，您将根据选择标准（即名称：“Ali”）更新第一个匹配的文档（即 {$inc:{score:5}} 。score 字段的值增加了 五。

它返回新更新的文档，因为我们将 returnNewDocument 的值设置为 true。

输出：

总结

通过这篇 MongoDB 教程文章的帮助，您了解了如何使用 db.collection.findOneAndUpdate() 方法，该方法用于更新集合中符合选择条件的第一个匹配文档。 您也可以使用此方法来替换嵌入的文档，也可以在多文档事务中使用它。