Operaciones compuestas

Modificar el comportamiento de búsqueda y eliminación

Opcionalmente, puede modificar el comportamiento del método find_one_and_delete() pasando una instancia FineOneAndDeleteOptions como parámetro. Para usar los valores predeterminados para cada configuración, especifique el valor None en el parámetro de opciones.

La siguiente tabla describe las opciones disponibles en FineOneAndDeleteOptions:

El controlador de Rust implementa el patrón de diseño Builder para la creación de una instancia FindOneAndDeleteOptions. Puedes usar el método builder() del tipo para construir una instancia de opciones encadenando las funciones del constructor de opciones una a una.

El siguiente código muestra cómo construir una instancia FindOneAndDeleteOptions y pasarla al método find_one_and_delete():

let opts = FindOneAndDeleteOptions::builder().comment(bson!("hello")).build();
let res = my_coll.find_one_and_delete(filter, opts).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, None).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() pasando una instancia FindOneAndUpdateOptions como parámetro. Para usar los valores predeterminados para cada configuración, especifique el valor None en el parámetro de opciones.

La siguiente tabla describe las opciones disponibles en FineOneAndDeleteOptions:

El controlador de Rust implementa el patrón de diseño Builder para la creación de una instancia FindOneAndUpdateOptions. Puedes usar el método builder() del tipo para construir una instancia de opciones encadenando los métodos del constructor de opciones uno a uno.

El siguiente código muestra cómo construir una instancia FindOneAndUpdateOptions y pasarla al método find_one_and_update():

let opts = FindOneAndUpdateOptions::builder().comment(bson!("hello")).build();
let res = my_coll.find_one_and_update(filter, update, opts).await?;

Ejemplo de búsqueda y actualización

Este ejemplo muestra cómo llamar al método find_one_and_update() con los siguientes parámetros:

• Un filtro de consulta que coincide con un documento donde el valor de school es "Aurora High School"

• Un documento de actualización que establece el campo school en "Durango High School" e incrementa el campo age en 1

• Una FindOneAndUpdateOptions instancia que devuelve el documento 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 opts = FindOneAndUpdateOptions::builder()
    .return_document(Some(ReturnDocument::After))
    .build();
let res = my_coll.find_one_and_update(filter, update, opts).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() pasando una instancia FindOneAndReplaceOptions como parámetro. Para usar los valores predeterminados para cada configuración, especifique el valor None en el parámetro de opciones.

La siguiente tabla describe las opciones disponibles en FindOneAndReplaceOptions:

El controlador de Rust implementa el patrón de diseño Builder para la creación de una instancia FindOneAndReplaceOptions. Puedes usar el método builder() del tipo para construir una instancia de opciones encadenando las funciones del constructor de opciones una a una.

El siguiente código muestra cómo construir una instancia FindOneAndReplaceOptions y pasarla al método find_one_and_replace():

let opts = FindOneAndReplaceOptions::builder().comment(bson!("hello")).build();
let res = my_coll.find_one_and_replace(filter, replacement, opts).await?;

Ejemplo de buscar y reemplazar

Este ejemplo muestra cómo llamar al método find_one_and_replace() con los siguientes parámetros:

• Un filtro de consulta que coincide con un documento donde el valor de name incluye la cadena "Johnson"

• Un documento de reemplazo que describe a un nuevo estudiante

• Una instancia FindOneAndReplaceOptions que devuelve el documento después del reemplazo y proyecta solo los campos 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 opts = FindOneAndReplaceOptions::builder()
    .return_document(Some(ReturnDocument::After))
    .projection(doc! { "name": 1, "school": 1, "_id": 0 })
    .build();
let res = my_coll.find_one_and_replace(filter, replacement, opts).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