Operaciones compuestas

Modificar el comportamiento de búsqueda y eliminación

Opcionalmente, puede modificar el comportamiento del método find_one_and_delete() encadenando los métodos del generador de opciones a find_one_and_delete(). Estos métodos del generador establecen FindOneAndDeleteOptions campos de estructura.

La siguiente tabla describe las opciones disponibles en FindOneAndDeleteOptions:

El siguiente código muestra cómo establecer el campo comment encadenando el método comment() al método find_one_and_delete():

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

Ejemplo de búsqueda y eliminación

El siguiente ejemplo utiliza el método find_one_and_delete() para hacer coincidir y eliminar el primer documento donde el valor del campo age sea menor o igual a 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")}))

Modificar el comportamiento de búsqueda y actualización

Opcionalmente, puede modificar el comportamiento del método find_one_and_update() encadenando los métodos del generador de opciones a find_one_and_update(). Estos métodos del generador establecen FindOneAndUpdateOptions campos de estructura.

La siguiente tabla describe las opciones disponibles en FindOneAndUpdateOptions:

El siguiente código muestra cómo establecer el campo comment encadenando el método comment() al método find_one_and_update():

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

Ejemplo de búsqueda y actualización

Este ejemplo muestra cómo realizar las siguientes acciones:

• Llamar al método find_one_and_update()

• Pase un filtro de consulta a find_one_and_update() que coincida con un documento donde el valor de school sea "Aurora High School"

• Pase un documento de actualización a find_one_and_update() que establezca el campo school en "Durango High School" e incremente el campo age en 1

• Encadene el return_document() método a para find_one_and_update() devolver el documento coincidente después de la actualización

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")}))

Modificar el comportamiento de buscar y reemplazar

Opcionalmente, puede modificar el comportamiento del método find_one_and_replace() encadenando los métodos del generador de opciones a find_one_and_replace(). Estos métodos del generador establecen FindOneAndReplaceOptions campos de estructura.

La siguiente tabla describe las opciones disponibles en FindOneAndReplaceOptions:

El siguiente código muestra cómo establecer el campo comment encadenando el método comment() al método find_one_and_replace():

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

Ejemplo de buscar y reemplazar

Este ejemplo realiza las siguientes acciones:

• Llama al método find_one_and_replace()

• Pasa un filtro de consulta a find_one_and_replace() que coincide con un documento donde el valor de name incluye la cadena "Johnson"

• Pasa un documento de reemplazo a find_one_and_replace() que describe a un nuevo estudiante

• Encadena el método return_document() a find_one_and_replace() para devolver el documento después del reemplazo

• Encadena el método projection() a los campos find_one_and_replace()``to project only the ``name y school en la salida

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")}))

Documentación de la API

Para obtener más información sobre los métodos y tipos mencionados en esta guía, consulte la siguiente documentación de API:

• encontrar_uno_y_eliminar()

• Opciones de búsqueda y eliminación

• find_one_and_update()

• FindOneAndUpdateOptions

• Devolver documento

• encontrar_uno_y_reemplazar()

• Opciones de búsqueda y reemplazo