Reemplazar Documentos

Overview

En esta guía, aprenderá a usar el controlador Kotlin para reemplazar documentos en una colección de MongoDB. Una operación de reemplazo utiliza un filtro de consulta para encontrar un documento en una colección y luego lo reemplaza por uno nuevo.

Reemplazar un documento

El El métodoreplaceOne() elimina todos los campos y valores existentes en el documento coincidente (excepto el _id campo) e inserta los campos y valores del documento de reemplazo.

Puede llamar al método replaceOne() en una instancia MongoCollection de la siguiente manera:

collection.replaceOne(<query>, <replacementDocument>)

Si varios documentos coinciden con el filtro de consulta especificado en el método replaceOne(), la operación reemplaza el primer resultado. Puede especificar una ordenación en una instancia ReplaceOptions para aplicar un orden a los documentos coincidentes antes de que el controlador realice la operación de reemplazo, como se muestra en el siguiente código:

val opts = ReplaceOptions().sort(Sorts.ascending(PaintOrder::color.name))

Si ningún documento coincide con el filtro de consulta en la operación de reemplazo, replaceOne() no realiza cambios en los documentos de la colección. Consulte la Guía de inserción y actualización para aprender a insertar un nuevo documento en lugar de reemplazar uno si no hay documentos coincidentes.

After applying the update, the (immutable) field '_id' was found to have been altered to _id: ObjectId('...)

E11000 duplicate key error collection: ...

Reemplazar un ejemplo

Una tienda de pinturas vende cinco colores diferentes. Los documentos de la siguiente colección representan los colores de pintura en el inventario de la tienda:

{ "_id": 1, "color": "red", "qty": 5 }
{ "_id": 2, "color": "purple", "qty": 8 }
{ "_id": 3, "color": "yellow", "qty": 0 }
{ "_id": 4, "color": "green", "qty": 6 }
{ "_id": 5, "color": "pink", "qty": 20 }

La siguiente clase de datos de Kotlin modela estos datos:

data class PaintOrder(
    @BsonId val id: Int,
    val color: String,
    val qty: Int
)

La tienda de pinturas debe actualizar su inventario para reemplazar 20 latas de pintura rosa con 25 latas de pintura naranja.

Para actualizar el inventario, llame al método replaceOne():

val filter = Filters.eq(PaintOrder::color.name, "pink")
val update = PaintOrder(5, "orange", 25)
val result = collection.replaceOne(filter, update)
println("Matched document count: $result.matchedCount")
println("Modified document count: $result.modifiedCount")

  Matched document count: 1
  Modified document count: 1

La operación de reemplazo anterior crea el siguiente documento:

 { "_id": 5, "color": "orange", "qty": 25 }

Ejemplo de reemplazo avanzado

En el siguiente ejemplo, el replaceOne() método reemplaza la primera coincidencia del filtro de consulta en la movies colección del conjunto de datos Atlas sample_mflix.movies con un documento de reemplazo. La operación elimina todos los campos excepto _id del documento original e inserta los campos del documento de reemplazo. La siguiente Movie clase de datos modela los documentos de esta colección para su uso con el controlador Kotlin:

data class Movie(
    val title: String,
    val year: Int,
    val genres: List<String>,
    val rated: String,
    val plot: String,
    val runtime: Int,
    val imdb: IMDB,
    val fullplot: String? = "No full plot",
){
    data class IMDB(
        val rating: Double
    )
}

Antes de ejecutar la operación replaceOne(), el documento original contiene varios campos que describen la película. Tras ejecutar la operación, el documento resultante contiene únicamente los campos especificados por el documento de reemplazo (title y fullplot) y el campo _id.

El siguiente ejemplo utiliza los siguientes objetos y métodos:

• Un filtro de consulta que se pasa al replaceOne() método. El eq filtro solo encuentra películas cuyo título coincida exactamente con el "Music of the Heart" texto.

• Un documento de reemplazo que contiene el documento que reemplaza al documento coincidente, si existe.

• Un objeto ReplaceOptions con la upsert opción establecida true en. Esta opción especifica que el método inserta los datos del documento de reemplazo si el filtro de consulta no coincide con ningún documento.

import com.mongodb.MongoException
import com.mongodb.client.model.Filters
import com.mongodb.client.model.ReplaceOptions
import com.mongodb.kotlin.client.coroutine.MongoClient
import kotlinx.coroutines.runBlocking
data class Movie(val title: String, val fullplot: String)
fun main() = runBlocking {
    // Replace the uri string with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    try {
        val query = Filters.eq("title", "Music of the Heart")
        val replaceDocument = Movie( "50 Violins", " A dramatization of the true story of Roberta Guaspari who co-founded the Opus 118 Harlem School of Music")
        val options = ReplaceOptions().upsert(true)
        val result = collection.replaceOne(query, replaceDocument, options)
        println("Modified document count: " + result.modifiedCount)
        println("Upserted id: " + result.upsertedId) // only contains a non-null value when an upsert is performed
    } catch (e: MongoException) {
        System.err.println("Unable to replace due to an error: $e")
    }
    mongoClient.close()
}

El ejemplo anterior devuelve el siguiente resultado:

Modified document count: 1
Upserted id: null

Si el ejemplo anterior resultó en una inserción, el código devuelve la siguiente salida:

Modified document count: 0
Upserted id: BsonObjectId{value=...}

Si consulta el documento reemplazado, la consulta devuelve el siguiente resultado:

Movie(title=50 Violins, fullplot= A dramatization of the true story of Roberta Guaspari
who co-founded the Opus 118 Harlem School of Music)

Información Adicional

Para obtener más información sobre los métodos y clases utilizados en esta página, consulte la siguiente documentación de API:

• Reemplazar uno

• Reemplazar opciones

• UpdateResult

• eq()