Substituir um documento

Você pode substituir um único documento usando o método replaceOne() em um objeto MongoCollection . Esse método remove todos os campos e valores existentes de um documento (exceto o campo _id ) e o substitui pelo documento de substituição.

O método replaceOne() aceita um filtro de query que corresponde ao documento que você deseja substituir e um documento de substituição que contém os dados que você deseja salvar no lugar do documento correspondente. O método replaceOne() substitui somente o primeiro documento que corresponde ao filtro.

Opcionalmente, você pode passar uma instância de ReplaceOptions para o método replaceOne() para especificar o comportamento do método. Por exemplo, se você definir o upsert campo do ReplaceOptions objeto como true, a operação inserirá um novo documento dos campos no documento de substituição se nenhum documento corresponder ao filtro de query. Consulte o link para a documentação da API de ReplaceOptions na parte inferior desta página para obter mais informações.

Após a execução bem-sucedida, o método replaceOne() gera uma instância de UpdateResult. Você pode recuperar informações, como o número de documentos modificados, chamando o método getModifiedCount() . Você também pode recuperar o valor do campo _id do documento chamando o método getUpsertedId() se tiver definido upsert(true) na instância ReplaceOptions e a operação tiver resultado na inserção de um novo documento.

Se a sua operação de substituição falhar, o driver emitirá uma exceção. Por exemplo, se você tentar especificar um valor para o campo imutável _id em seu documento de substituição que difere do documento original, o método lançará um MongoWriteException com a mensagem:

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

Se o seu documento de substituição contiver uma alteração que viole as regras do índice único, o método lançará um MongoWriteException com uma mensagem de erro que deve ser semelhante a esta:

E11000 duplicate key error collection: ...

Para obter mais informações sobre os tipos de exceções geradas em condições específicas, consulte a documentação da API para replaceOne(), cujo link está no final desta página.

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

Modified document count: 1
Upserted id: null

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

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