Operaciones de escritura

Filtros

Puede pasar un documento de filtro a los métodos para especificar qué documentos actualizar. La especificación del documento de filtro es la misma que para las operaciones de lectura. Para facilitar la creación de objetos de filtro, el controlador proporciona la clase auxiliar Filters.

Para especificar un filtro vacío y hacer coincidir todos los documentos de una colección, utilice un objeto Document vacío como filtro.

Operadores de actualización

Para cambiar un campo en un documento, MongoDB proporciona operadores de actualización. Para especificar la modificación que se debe realizar utilizando los operadores de actualización, cree un documento de actualización. Para obtener más información sobre los operadores de actualización, consulte Operadores de actualización en el Manual del servidor.

Para facilitar la creación de documentos de actualización, el controlador proporciona la clase auxiliar Updates.

Actualiza un solo documento

El método updateOne() actualiza un solo documento, incluso si la condición de filtro coincide con varios documentos de la colección.

La siguiente operación en la colección restaurants actualiza un documento en el que el valor del campo id es ObjectId("57506d62f57802807471dd41"):

collection.updateOne(
    eq("_id", new ObjectId("57506d62f57802807471dd41")),
    combine(set("stars", 1), set("contact.phone", "228-555-9999"), currentDate("lastModified"))
).subscribe(new ObservableSubscriber<UpdateResult>());

Específicamente, la operación utiliza los siguientes métodos:

• Updates.set() para establecer el valor del campo stars en 1 y el valor del campo contact.phone en "228-555-9999"

• Updates.currentDate() Para modificar el campo lastModified a la fecha actual. Si el campo lastModified no existe, el operador lo añade al documento.

Actualiza varios documentos

El método updateMany() actualiza todos los documentos que coinciden con la condición de filtro.

La siguiente operación en la colección restaurants actualiza todos los documentos en los que el valor del campo stars es 2:

collection.updateMany(
    eq("stars", 2),
    combine(set("stars", 0), currentDate("lastModified"))
).subscribe(new ObservableSubscriber<UpdateResult>());

Específicamente, la operación utiliza los siguientes métodos:

• Updates.set() para establecer el valor del campo stars en 0

• Updates.currentDate() Para establecer el campo lastModified con la fecha actual. Si el campo lastModified no existe, el operador lo añade al documento.

Update Options

Al usar los métodos updateOne() y updateMany(), puedes incluir un documento UpdateOptions para especificar la opción upsert o la opción bypassDocumentationValidation:

collection.updateOne(
    eq("_id", 1),
    combine(set("name", "Fresh Breads and Tulips"), currentDate("lastModified")),
    new UpdateOptions().upsert(true).bypassDocumentValidation(true)
).subscribe(new ObservableSubscriber<UpdateResult>());

Filtros

Puede pasar un documento de filtro al método replaceOne() para especificar qué documento reemplazar. La especificación del documento de filtro es la misma que para las operaciones de lectura. Para facilitar la creación de objetos de filtro, el controlador proporciona la clase auxiliar Filters.

Para especificar un filtro vacío y hacer coincidir todos los documentos de una colección, utilice un objeto Document vacío como filtro.

El método replaceOne() reemplaza como máximo un solo documento, incluso si la condición del filtro coincide con varios documentos de la colección.

Reemplazar un documento

Para reemplazar un documento, pasa un nuevo documento al método replaceOne().

La siguiente operación en la colección restaurants reemplaza el documento en el que el valor del campo id es ObjectId("57506d62f57802807471dd41"):

collection.replaceOne(
    eq("_id", new ObjectId("57506d62f57802807471dd41")),
    new Document("name", "Green Salads Buffet")
        .append("contact", "TBD")
        .append("categories", Arrays.asList("Salads", "Health Foods", "Buffet"))
).subscribe(new ObservableSubscriber<UpdateResult>());

Update Options

Al utilizar el método replaceOne(), puede incluir un documento UpdateOptions para especificar la opción upsert o la opción bypassDocumentationValidation:

collection.replaceOne(
    eq("name", "Orange Patisserie and Gelateria"),
    new Document("stars", 5)
        .append("contact", "TBD")
        .append("categories", Arrays.asList("Cafe", "Pastries", "Ice Cream")),
    new UpdateOptions().upsert(true).bypassDocumentValidation(true)
).subscribe(new ObservableSubscriber<UpdateResult>());

Filtros

Puede pasar un documento de filtro a los métodos para especificar qué documentos eliminar. La especificación del documento de filtro es la misma que para las operaciones de lectura. Para facilitar la creación de objetos de filtro, el controlador proporciona la clase auxiliar Filters.

Para especificar un filtro vacío y hacer coincidir todos los documentos de una colección, utilice un objeto Document vacío como filtro.

Borrar un único documento

El método deleteOne() elimina como máximo un solo documento, incluso si la condición del filtro coincide con varios documentos de la colección.

La siguiente operación en la colección restaurants elimina un documento en el que el valor del campo _id es ObjectId("57506d62f57802807471dd41"):

collection
    .deleteOne(eq("_id", new ObjectId("57506d62f57802807471dd41")))
    .subscribe(new ObservableSubscriber<DeleteResult>());

Borra varios documentos

El método deleteMany() elimina todos los documentos que coinciden con la condición de filtro.

La siguiente operación en la colección restaurants elimina todos los documentos en los que el valor del campo stars es 4:

collection
    .deleteMany(eq("stars", 4))
    .subscribe(new ObservableSubscriber<DeleteResult>());