Operaciones compuestas

Modificar el comportamiento de búsqueda y borrar

Opcionalmente, se puede modificar el comportamiento del método find_one_and_delete() pasando una instancia FineOneAndDeleteOptions como parámetro. Para utilizar los valores por defecto para cada configuración, especifica el valor None para 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 del Builder para la creación de una instancia de FindOneAndDeleteOptions. Puedes usar el método builder() del tipo para construir una instancia de opciones encadenando funciones de construcción de opciones una a la vez.

El siguiente código ilustra cómo construir una instancia de 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?;

Buscar y borrar ejemplo

El siguiente ejemplo utiliza el método find_one_and_delete() para buscar y borrar el primer documento donde el valor del campo age es 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, se puede modificar el comportamiento del método find_one_and_update() pasando una instancia FindOneAndUpdateOptions como parámetro. Para utilizar los valores por defecto para cada configuración, especifica el valor None para 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 de FindOneAndUpdateOptions . Puedes usar el método builder() del tipo para construir una instancia de opciones encadenando los métodos del generador de opciones uno a uno.

El siguiente código ilustra cómo construir una instancia de 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?;

Encontrar y actualizar ejemplo

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

• Un filtro de query 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" y aumenta el campo age en 1

• Una instancia de FindOneAndUpdateOptions 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, se puede modificar el comportamiento del método find_one_and_replace() pasando una instancia FindOneAndReplaceOptions como parámetro. Para utilizar los valores por defecto para cada configuración, especifica el valor None para 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 del Builder para la creación de una instancia de FindOneAndReplaceOptions. Puedes usar el método builder() del tipo para construir una instancia de opciones encadenando funciones de construcción de opciones una a la vez.

El siguiente código ilustra cómo construir una instancia de 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 en el que el valor de name incluye la string "Johnson"

• Un documento de reemplazo que describe a un estudiante nuevo

• Una instancia de FindOneAndReplaceOptions que devuelve el documento tras el reemplazo y proyecta únicamente 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, vea la siguiente documentación de la API:

• find_one_and_delete()

• FindOneAndDeleteOptions

• find_one_and_update()

• FindOneAndUpdateOptions

• ReturnDocument

• find_one_and_replace()

• FindOneAndReplaceOptions