Operações compostas

Encontrar e atualizar

Para localizar e atualizar um documento, utilize o método findOneAndUpdate() da classe MongoCollection . O método findOneAndUpdate() retorna o documento encontrado ou null se nenhum documento corresponder à sua query.

// <MongoCollection set up code here>
// Creates a projection to exclude the "_id" field from the retrieved documents
Bson projection = Projections.excludeId();
// Creates a filter to match documents with a "color" value of "green"
Bson filter = Filters.eq("color", "green");
// Creates an update document to set the value of "food" to "pizza"
Bson update = Updates.set("food", "pizza");
// Defines options that specify projected fields, permit an upsert and limit execution time
FindOneAndUpdateOptions options = new FindOneAndUpdateOptions().
        projection(projection).
        upsert(true).
        maxTime(5, TimeUnit.SECONDS);
// Updates the first matching document with the content of the update document, applying the specified options
Document result = collection.findOneAndUpdate(filter, update, options);
// Prints the matched document in its state before the operation
System.out.println(result.toJson());

{"food": "pizza", "color": "green"}

Encontrar e substituir

Para localizar e substituir um documento, use o método findOneAndReplace() da classe MongoCollection . O método findOneAndReplace() retorna o documento encontrado ou null se nenhum documento corresponder à sua query.

{"music": "classical", "color": "green"}

// <MongoCollection set up code here>
// Creates instructions to replace the matching document with a new document
Bson filter = Filters.eq("color", "green");
Document replace = new Document("music", "classical").append("color", "green");
// Defines options specifying that the operation should return a document in its post-operation state
FindOneAndReplaceOptions options = new FindOneAndReplaceOptions().
        returnDocument(ReturnDocument.AFTER);
// Atomically finds and replaces the matching document and prints the replacement document
Document result = collection.findOneAndReplace(filter, replace, options);
System.out.println(result.toJson());

{"_id": 1, "music": "classical", "color": "green"}

Localize e exclua

Para localizar e excluir um documento, use o método findOneAndDelete() da classe MongoCollection . O método findOneAndDelete() retorna o documento encontrado ou null se nenhum documento corresponder à sua query.

// <MongoCollection set up code here>
Bson sort = Sorts.descending("_id");
// Creates an empty filter to match all documents in the collection
Bson filter = Filters.empty();
// Defines options that specify a descending sort on the "_id" field
FindOneAndDeleteOptions options = new FindOneAndDeleteOptions().
        sort(sort);
// Deletes the document containing the highest "_id" value and prints the deleted document
Document result = collection.findOneAndDelete(filter, options);
System.out.println(result.toJson());

{"_id": 2, "food": "pear", "color": "yellow"}

Exemplo com condição de corrida

Digamos que nosso aplicativo use esse método bookARoom para fazer o checkout do nosso quarto para um convidado:

public void bookARoom() {
    // Creates a filter to match documents representing available rooms
    Bson filter = Filters.eq("reserved", false);
    // Retrieves a document that represents the first available room
    Document myRoom = this.collection.find(filter).first();
    // Prints a message if no documents representing available rooms are found
    if (myRoom == null){
        System.out.println("Sorry, we are booked " + this.guest);
        return;
    }
    String myRoomName = myRoom.getString("room");
    // Prints a message that guest that successfully booked the room
    System.out.println("You got the " + myRoomName + " " + this.guest);
    // Creates an update document to mark a room as reserved
    Bson update = Updates.combine(Updates.set("reserved", true), Updates.set("guest", guest));
    
    // Creates a filter that matches the "_id" field of the first available room
    Bson roomFilter = Filters.eq("_id", myRoom.get("_id", Integer.class));
    // Updates the first matching document to mark it as reserved
    this.collection.updateOne(roomFilter, update);
}

Imagine dois convidados separados, Jane e Ana, tentando agendar o quarto com esse método ao mesmo tempo.

Jane vê esta saída:

You got the Blue Room Jan

EPat vê esta saída:

You got the Blue Room Pat

Quando analisamos nosso reconhecimento de data center, vemos o seguinte:

 {"_id": 1, "guest": "Jan", "room": "Blue Room", "reserved": true}

Pat ficará chateada. QuandoPapa aparecer em nosso hotel,Jan estará ocupando o quarto dela. O que deu errado?

Aqui está a sequência de eventos que aconteceram da perspectiva de nossa instância do MongoDB:

• Encontre e devolva um quarto vazio para janeiro

• Encontre e devolva um quarto vazio paraPat

• Atualizar o quarto para reservado para Pat

• Atualize o quarto como reservado para janeiro

Observe que, por um breve momento, Ana reservou a divisão, mas como a operação de atualização de Janeiro foi a última a executar, nosso documento tem "Jan" como convidado.

Exemplo sem condição de corrida

Vamos usar uma operação composta para evitar a condição de corrida e sempre dar aos nossos usuários a mensagem correta.

public void bookARoom(){
    // Creates an update document to mark a room as reserved
    Bson update = Updates.combine(Updates.set("reserved", true), Updates.set("guest", guest));
    
    // Creates a filter to match a document representing an available room
    Bson filter = Filters.eq("reserved", false);
    // Updates the first document that matches the filter to mark it as reserved
    Document myRoom = this.collection.findOneAndUpdate(filter, update);
   
    // Prints a message when there are no available rooms
    if (myRoom == null){
        System.out.println("Sorry, we are booked " + this.guest);
        return;
    }
    // Prints the name of the guest that successfully booked the room
    String myRoomName = myRoom.getString("room");
    System.out.println("You got the " + myRoomName + " " + this.guest);
}

Imagine dois convidados separados, Jane e Ana, tentando agendar o quarto com esse método ao mesmo tempo.

Jane vê esta saída:

You got the Blue Room Jan

EPat vê esta saída:

Sorry, we are booked Pat

Quando analisamos nosso reconhecimento de data center, vemos o seguinte:

 {"_id":1, "guest":"Jan", "room":"Blue Room", "reserved":true}

Pat recebeu a mensagem correta. Embora possa estar triste por não ter conseguido a reserva, pelo menos sabe que não deve viajar para o nosso hotel.

Aqui está a sequência de eventos que aconteceram da perspectiva de nossa instância do MongoDB:

• Encontre um quarto vazio para Jane e reserve-o.

• Tente encontrar um quarto vazio paraPat e reservá-lo. Como não há mais salas, devolva null.

Para obter informações sobre a classe Updates , consulte nosso guia sobre o construtor de atualizações.

Para obter mais informações sobre a classe Filters , consulte nosso guia sobre o construtor de filtros.

Para obter mais informações sobre o findOneAndUpdate() método , consulte a documentação da API para a classe MongoCollection.