Atualizar um documento

Você pode atualizar um único documento usando o método updateOne() em um objeto MongoCollection. O método aceita um filtro que corresponde ao documento que você deseja atualizar e uma instrução de atualização que instrui o driver como alterar o documento correspondente. O método updateOne() atualiza somente o primeiro documento que corresponde ao filtro.

Para realizar uma atualização com o método updateOne(), você deve utilizar um filtro de query e um documento de atualização. O filtro de query especifica os critérios para determinar em qual documento realizar a atualização e o documento de atualização fornece instruções sobre quais alterações devem ser feitas nele.

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

Após a execução bem-sucedida, o método updateOne() gera uma instância de UpdateResult. Você pode recuperar informações como o número de documentos modificados chamando o método getModifiedCount() ou o valor do campo _id chamando o método getUpsertedId() se tiver especificado upsert(true) em uma instância UpdateOptions .

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

Performing an update on the path '_id' would modify the immutable field '_id'

Se o documento de atualização contiver uma alteração que viole as regras de í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 updateOne(), cujo link está no final desta página.

package usage.examples;
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.model.UpdateOptions;
import com.mongodb.client.model.Updates;
import com.mongodb.client.result.UpdateResult;
public class UpdateOne {
    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");
            Document query = new Document().append("title",  "Cool Runnings 2");
            Bson updates = Updates.combine(
                    Updates.set("runtime", 99),
                    Updates.addToSet("genres", "Sports"),
                    Updates.currentTimestamp("lastUpdated"));
            UpdateOptions options = new UpdateOptions().upsert(true);
            try {
                UpdateResult result = collection.updateOne(query, updates, options);
                System.out.println("Modified document count: " + result.getModifiedCount());
                System.out.println("Upserted id: " + result.getUpsertedId()); // only contains a value when an upsert is performed
            } catch (MongoException me) {
                System.err.println("Unable to update due to an error: " + me);
            }
        }
    }
}

Modified document count: 1
Upserted id: null

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

Document {
  { _id=...,
    plot=...,
    genres=[Adventure, Comedy, Family, Sports],
    runtime=99,
    ...
    lastUpdated=Timestamp{...}
  }
}