modify

Author: rachel-mack

source/crud/write-operations/modify.txt

@@ -163,6 +163,27 @@ documents match.
     see :manual:`Unique Indexes </core/index-unique/>` in the
     {+mdb-server+} manual.
 
+Update Example
+~~~~~~~~~~~~~~
+
+The following code is a complete, standalone file that performs an update one
+operation and an update many operation. 
+
+.. include:: /includes/crud/example-intro.rst
+
+.. io-code-block::
+
+   .. input:: /includes/crud/Insert.java
+      :language: java
+      :dedent:
+
+   .. output:: 
+      :language: none
+      :visible: false
+
+      InsertOne document id: BsonObjectId{value=...}
+      InsertMany document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
+
 .. _replace-operation:
 
 Replace

source/includes/crud/Delete.java

@@ -29,8 +29,8 @@ public static void main(String[] args) {
 
             try {
                 // Deletes the first document that has a "title" value of "The Garbage Pail Kids Movie"
-                DeleteResult deleteOneResult = collection.deleteOne(deleteOneQuery);
-                System.out.println("DeleteOne document count: " + deleteOneResult.getDeletedCount());
+                DeleteResult result = collection.deleteOne(deleteOneQuery);
+                System.out.println("DeleteOne document count: " + result.getDeletedCount());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {
@@ -41,10 +41,10 @@ public static void main(String[] args) {
 
             try {
                 // Deletes all documents that have an "imdb.rating" value less than 1.9
-                DeleteResult deleteManyResult = collection.deleteMany(deleteManyQuery);
+                DeleteResult result = collection.deleteMany(deleteManyQuery);
 
                 // Prints the number of deleted documents
-                System.out.println("DeleteMany document count: " + deleteManyResult.getDeletedCount());
+                System.out.println("DeleteMany document count: " + result.getDeletedCount());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {

source/includes/crud/Insert.java

@@ -26,7 +26,7 @@ public static void main(String[] args) {
 
             try {
                 // Inserts a sample document describing a movie into the collection
-                InsertOneResult iOResult = collection.insertOne(new Document()
+                InsertOneResult result = collection.insertOne(new Document()
                         .append("_id", new ObjectId())
                         .append("title", "Ski Bloopers")
                         .append("genres", Arrays.asList("Documentary", "Comedy")));

source/includes/usage-examples/code-snippets/UpdateOne.java renamed to source/includes/crud/Update.java

@@ -24,20 +24,21 @@ public static void main(String[] args) {
             MongoDatabase database = mongoClient.getDatabase("sample_mflix");
             MongoCollection<Document> collection = database.getCollection("movies");
 
-            Document query = new Document().append("title",  "Cool Runnings 2");
+            // Instructs the driver to insert a new document if none match the query
+            UpdateOptions options = new UpdateOptions().upsert(true);
+
+
+            Document updateOneQuery = new Document().append("title",  "Cool Runnings 2");
 
             // Creates instructions to update the values of three document fields
-            Bson updates = Updates.combine(
+            Bson updateOneUpdates = Updates.combine(
                     Updates.set("runtime", 99),
                     Updates.addToSet("genres", "Sports"),
                     Updates.currentTimestamp("lastUpdated"));
 
-            // Instructs the driver to insert a new document if none match the query
-            UpdateOptions options = new UpdateOptions().upsert(true);
-
             try {
                 // Updates the first document that has a "title" value of "Cool Runnings 2"
-                UpdateResult result = collection.updateOne(query, updates, options);
+                UpdateResult result = collection.updateOne(updateOneQuery, updateOneUpdates, options);
 
                 // Prints the number of updated documents and the upserted document ID, if an upsert was performed
                 System.out.println("Modified document count: " + result.getModifiedCount());
@@ -47,6 +48,25 @@ public static void main(String[] args) {
             } catch (MongoException me) {
                 System.err.println("Unable to update due to an error: " + me);
             }
+
+            Bson updateManyQuery = gt("num_mflix_comments", 50);
+
+            // Creates instructions to update the values of two document fields
+            Bson updateManyUpdates = Updates.combine(
+                    Updates.addToSet("genres", "Frequently Discussed"),
+                    Updates.currentTimestamp("lastUpdated"));
+
+            try {
+                // Updates documents that have a "num_mflix_comments" value over 50
+                UpdateResult result = collection.updateMany(updateManyQuery, updateManyUpdates);
+
+                // Prints the number of updated documents
+                System.out.println("Modified document count: " + result.getModifiedCount());
+
+            // Prints a message if any exceptions occur during the operation
+            } catch (MongoException me) {
+                System.err.println("Unable to update due to an error: " + me);
+            }
         }
     }
 }