Delete Documents

Overview

En esta guía, puedes aprender a utilizar el controlador Java Reactive Streams para borrar documentos de una colección de MongoDB realizando operaciones de borrado.

Una operación de eliminación elimina uno o más documentos de una colección de MongoDB. Puedes realizar una operación de eliminación usando los métodos deleteOne() o deleteMany().

Operaciones de borrar

Puedes realizar operaciones de eliminación en MongoDB utilizando los siguientes métodos:

• deleteOne()que elimina el primer documento que coincida con los criterios de búsqueda

• deleteMany(), que borra todos los documentos que cumplen con los criterios de búsqueda

Cada método de borrado requiere un filtro de query, que especifica los criterios de búsqueda que determinan qué documentos seleccionar para borrar. Para obtener más información sobre los filtros de query, consulta la sección Documentos de filtros de query en el manual de MongoDB Server.

Borrar un documento

Para eliminar un solo documento de una colección de MongoDB, llama al método deleteOne() y pasa tu filtro de query. Luego, pasa el resultado deleteOne() al método estático Mono.from de Mono. Mono es una clase de la biblioteca Project Reactor. En Java Reactive Streams, los métodos del driver devuelven instancias Publisher frías, lo que significa que la operación correspondiente no ocurre a menos que te suscribas a la instancia de Publisher retornada. Esta guía utiliza la biblioteca Project Reactor para consumirlos. Para aprender más sobre Mono, consulta Mono en la documentación de Project Reactor.

El siguiente ejemplo elimina un documento de la colección restaurants que tiene un valor de name de "Ready Penny Inn":

Publisher<DeleteResult> deletePublisher = restaurants.deleteOne(
        eq("name", "Ready Penny Inn"));
Mono.from(deletePublisher).block();

Borra varios documentos

Para eliminar varios documentos de una colección de MongoDB, llama al método deleteMany() y pasa tu filtro de query. Luego, pasa el resultado deleteMany() al método estático Mono.from desde Mono. Mono es una clase de la librería Project Reactor. En Java Reactive Streams, los métodos del controlador devuelven instancias frías de Publisher, lo que significa que la operación correspondiente no se realiza a menos que te suscribas al Publisher devuelto. Esta guía utiliza la biblioteca Proyecto Reactor para consumirlos. Para obtener más información sobre Mono, consulta Mono en la documentación del Project Reactor.

El siguiente ejemplo remueve todos los documentos en la colección restaurants que tengan un valor borough de "Brooklyn":

Publisher<DeleteResult> deletePublisher = restaurants.deleteMany(
        eq("borough", "Brooklyn"));
Mono.from(deletePublisher).block();

Personaliza la operación de borrar

La clase DeleteOptions contiene métodos que modifican el comportamiento de los métodos de eliminación. Para usar la clase DeleteOptions, crea una nueva instancia de la clase y, a continuación, llama a uno o más de sus métodos para modificar la operación de eliminación. Puede encadenar estas llamadas de método juntas. Para modificar el comportamiento de la operación de borrar, pasa la instancia de la clase y las llamadas a métodos encadenadas como segundo argumento al método deleteOne() o deleteMany().

Puedes utilizar los siguientes métodos en la clase DeleteOptions para modificar un método de eliminación. Todos los métodos son opcionales.

Publisher<DeleteResult> deletePublisher = restaurants.deleteMany(
        regex("name", "Mongo"),
        new DeleteOptions().comment("Deleting Mongo restaurants"));
Mono.from(deletePublisher).block();

Información Adicional

Para ver ejemplos de código ejecutables sobre cómo insertar documentos con el controlador Java Reactive Streams, consulte la guía de operaciones CRUD.