Menu Docs
Página inicial do Docs
/
Línguas
/
Java
/
Java síncrono
/
Exemplos de uso
/
Excluir operações

Excluir um documento

Você pode excluir um único documento de uma collection usando o método deleteOne() em um objeto MongoCollection . O método aceita um filtro de query que corresponde ao documento que você deseja excluir. Se você não especificar um filtro, o MongoDB corresponderá ao primeiro documento da collection. O método deleteOne() exclui apenas o primeiro documento correspondente.

Este método retorna uma instância de DeleteResult que contém informações, incluindo quantos documentos foram excluídos como resultado da operação.

Se a sua operação de exclusão falhar, o driver emitirá uma exceção. Para obter mais informações sobre os tipos de exceções geradas em condições específicas, consulte a documentação da API para deleteOne(), cujo link está no final desta página.

Exemplo

O trecho a seguir exclui um único documento da collection movies do reconhecimento de data center sample_mflix . O exemplo usa o filtro eq() para corresponder a filmes com title correspondendo exatamente ao texto 'The Garbage Pail Kids Movie'.

Observação

Esse exemplo se conecta a uma instância do MongoDB usando um URI de conexão. Para saber mais sobre como se conectar à sua instância do MongoDB, consulte oguia de conexão .

// Deletes a document from a collection by using the Java driver
package usage.examples;
import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import org.bson.conversions.Bson;
import com.mongodb.MongoException;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.result.DeleteResult;
public class DeleteOne {
    public static void main(String[] args) {
        // Replace the uri string with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Bson query = eq("title", "The Garbage Pail Kids Movie");
            try {
                // Deletes the first document that has a "title" value of "The Garbage Pail Kids Movie"
                DeleteResult result = collection.deleteOne(query);
                System.out.println("Deleted document count: " + result.getDeletedCount());
            // Prints a message if any exceptions occur during the operation
            } catch (MongoException me) {
                System.err.println("Unable to delete due to an error: " + me);
            }
        }
    }
}

Ao executar o exemplo, se o filtro de query que você passou na sua chamada para deleteOne() corresponder a um documento e removê-lo, você deverá ver um resultado parecido com este:

Deleted document count: 1

Se a sua query não corresponder a um documento na sua collection, a sua chamada para deleteOne() não removerá nenhum documento e retornará o seguinte:

Deleted document count: 0

Dica

Legacy API

Se você estiver usando a API herdada, consulte nossa página de perguntas frequentes para saber quais alterações devem ser feitas nesse exemplo de código.

Para obter mais informações sobre as classes e métodos mencionados nesta página, consulte a seguinte documentação da API:

  • DeleteOne()

  • DeleteResult

  • eq()

Voltar

Excluir operações