Modificar documentos

Atualizar parâmetros de operação

Os métodos updateOne() e updateMany() têm os seguintes parâmetros:

• query especifica um filtro de consulta com os critérios para corresponder aos documentos a serem atualizados em sua coleção.

• update especifica os campos e valores a serem modificados no documento ou documentos correspondentes. Os exemplos nesta seção usam os Construtores de Atualizações para criar o documento de atualização.

• (Opcional) updateOptions especifica opções que você pode definir para personalizar como o driver executa a operação de atualização. Para saber mais sobre esse tipo, consulte a documentação da API para UpdateOptions.

Você pode criar o updateDocument utilizando um construtor Updates como segue:

Bson update = Updates.operator(<field>, <value>);

Para visualizar uma lista completa de construtores de atualizações e seu uso,consulte Atualizações na documentação da API.

Atualizar um exemplo

O exemplo a seguir demonstra como alterar o valor do campo color no primeiro documento correspondente em que o valor de qty é 0:

Bson filter = Filters.eq("qty", 0);
Bson update = Updates.set("color", "dandelion");
// Updates first matching document
UpdateResult result = collection.updateOne(filter, update);

Se vários documentos corresponderem ao filtro de query especificado no método updateOne(), ele atualizará o primeiro resultado. Você pode especificar uma classificação em uma instância do UpdateOptions para aplicar um pedido aos documentos correspondentes antes que o driver execute a operação de atualização, conforme mostrado no código a seguir:

UpdateOptions options = UpdateOptions.sort(ascending("color"));
UpdateResult result = collection.updateOne(filter, document, options);

Atualizar muitos exemplos

A loja de tintas recebe uma nova remessa e precisa atualizar seu estoque. A remessa contém 20 latas de cada cor de tinta.

Para atualizar o inventário, chame o método updateMany() especificando o seguinte:

• Filtro de query que corresponde a todas as cores

• Atualizar documento que contém instruções para incrementar o campo qty até 20

Bson filter = Filters.empty();
Bson update = Updates.inc("qty", 20);
// Updates all documents and prints the number of matched and modified documents
UpdateResult result = collection.updateMany(filter, update);
System.out.println("Matched document count: " + result.getMatchedCount());
System.out.println("Modified document count: " + result.getModifiedCount());

A saída do código anterior se assemelha ao seguinte:

 Matched document count: 5
 Modified document count: 5

O seguinte mostra os documentos atualizados na coleção paint_inventory :

 { "_id": 1, "color": "red", "qty": 25 }
 { "_id": 2, "color": "purple", "qty": 28 }
 { "_id": 3, "color": "yellow", "qty": 20 }
 { "_id": 4, "color": "green", "qty": 26 }
 { "_id": 5, "color": "pink", "qty": 20 }

Se zero documentos corresponderem ao filtro de query na operação de atualização, updateMany() não fará alterações nos documentos na coleção. Consulte nosso guia upsert para saber como inserir um novo documento em vez de atualizar um se nenhum documento corresponder.

Substituir parâmetros de operação

O método replaceOne() tem os seguintes parâmetros:

• query especifica um filtro de query com os critérios para corresponder a um documento a ser substituído em sua coleção.

• replacement especifica campos e valores de um novo objeto Document para substituir o documento correspondente.

• (Opcional) replaceOptions especifica opções que você pode definir para personalizar como o driver executa a operação de substituição. Para saber mais sobre esse tipo, consulte a documentação da API para ReplaceOptions.

Substituir um exemplo

A loja de tintas entende que deve atualizar seu estoque novamente. O que eles pensaram ser 20 latas de tinta laranja é, na verdade, 25 latas de tinta laranja.

Para atualizar o inventário, chame o método replaceOne() especificando o seguinte:

• Um filtro de query que corresponda a documentos onde o color é "pink"

• Um documento de substituição em que o color é "orange" e o qty é "25"

Bson filter = Filters.eq("color", "pink");
Document document = new Document("color", "orange").append("qty", 25);
// Replaces the first document that matches the filter with a new document
UpdateResult result = collection.replaceOne(filter, document);
// Prints the number of matched and modified documents
System.out.println("Matched document count: " + result.getMatchedCount());
System.out.println("Modified document count: " + result.getModifiedCount());

A saída do código anterior se assemelha ao seguinte:

 Matched document count: 1
 Modified document count: 1

A seguir, mostra o documento atualizado:

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

Se vários documentos corresponderem ao filtro de query especificado no método replaceOne(), ele substituirá o primeiro resultado. Você pode especificar uma classificação em uma instância do ReplaceOptions para aplicar um pedido aos documentos correspondentes antes que o driver execute a operação de substituição, conforme mostrado no código a seguir:

ReplaceOptions options = ReplaceOptions.sort(ascending("qty"));
UpdateResult result = collection.replaceOne(filter, document, options);

Se zero documentos corresponderem ao filtro de query na operação de substituição, replaceOne() não fará alterações nos documentos na coleção. Consulte nosso guia upsert para saber como inserir um novo documento em vez de substituir um se nenhum documento corresponder.