复合运算符

修改查找和删除行为

您可以选择通过将选项构建器方法链接到find_one_and_delete()来修改find_one_and_delete()方法的行为。 这些构建器方法设立FindOneAndDeleteOptions结构体字段。

下表描述了FindOneAndDeleteOptions中可用的选项：

以下代码展示了如何通过将comment()方法链接到find_one_and_delete()方法来设立comment字段：

let res = my_coll.find_one_and_delete(filter)
    .comment(bson!("hello"))
    .await?;

查找和删除示例

以下示例使用find_one_and_delete()方法匹配并删除age字段的值小于或等于10的第一个文档：

let filter = doc! { "age": doc! { "$lte": 10 } };
let res = my_coll.find_one_and_delete(filter).await?;
println!("Deleted document:\n{:?}", res);

Deleted document:
Some(Document({"_id": ObjectId("..."),
"name": String("Deanna Porowski"), "age": Int32(10), "school":
String("Lakeside Elementary")}))

修改查找和更新行为

您可以选择通过将选项构建器方法链接到find_one_and_update()来修改find_one_and_update()方法的行为。 这些构建器方法设立FindOneAndUpdateOptions结构体字段。

下表描述了FindOneAndUpdateOptions中可用的选项：

以下代码展示了如何通过将comment()方法链接到find_one_and_update()方法来设立comment字段：

let res = my_coll.find_one_and_update(filter, update)
    .comment(bson!("hello"))
    .await?;

查找和更新示例

此示例演示如何执行以下操作：

• 调用find_one_and_update()方法

• 将查询过滤传递给find_one_and_update() ，以匹配school值为"Aurora High School"的文档

• 将更新文档传递给find_one_and_update() ，将school字段设置为"Durango High School" ，并将age字段递增1

• 将return_document()方法链接到find_one_and_update()以在更新后返回匹配的文档

let filter = doc! { "school": "Aurora High School" };
let update =
    doc! { "$set": doc! { "school": "Durango High School" },
           "$inc": doc! { "age": 1 } };
let res = my_coll.find_one_and_update(filter, update)
    .return_document(ReturnDocument::After)
    .await?;
println!("Updated document:\n{:?}", res);

Updated document:
Some(Document({"_id": ObjectId("..."),
"name": String("Ben Joseph"), "age": Int32(17), "school":
String("Durango High School")}))

修改查找和替换行为

您可以选择通过将选项构建器方法链接到find_one_and_replace()来修改find_one_and_replace()方法的行为。 这些构建器方法设立FindOneAndReplaceOptions结构体字段。

下表描述了FindOneAndReplaceOptions中可用的选项：

以下代码展示了如何通过将comment()方法链接到find_one_and_replace()方法来设立comment字段：

let res = my_coll.find_one_and_replace(filter, replacement)
    .comment(bson!("hello"))
    .await?;

查找和替换示例

此示例将执行以下动作：

• 调用find_one_and_replace()方法

• 将查询过滤传递给 find_one_and_replace()，以匹配 name 的值包含string "Johnson" 的文档

• 将描述新学生的替换文档传递给find_one_and_replace()

• 将return_document()方法链接到find_one_and_replace()以返回替换后的文档

• 将projection()方法链接到输出中的find_one_and_replace()``to project only the ``name和school字段

let filter = doc! { "name": doc! { "$regex": "Johnson" } };
let replacement =
    doc! { "name": "Toby Fletcher", 
           "age": 14,
           "school": "Durango High School" };
let res = my_coll.find_one_and_replace(filter, replacement)
    .return_document(ReturnDocument::After)
    .projection(doc! { "name": 1, "school": 1, "_id": 0 })
    .await?;
println!("Document after replacement:\n{:?}", res);

Document after replacement:
Some(Document({"name": String("Toby Fletcher"), "school":
String("Durango High School")}))

API 文档

要进一步了解本指南所提及的方法和类型，请参阅以下 API 文档：

• find_one_and_delete()

• FindOneAndDeleteOptions

• find_one_and_update()

• FindOneAndUpdateOptions

• returnDocument

• find_one_and_replace()

• FindOneAndReplaceOptions