modify

Author: rachel-mack

source/crud/write-operations/bulk.txt

@@ -360,8 +360,8 @@ see the following API documentation:
 - `ordered() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/BulkWriteOptions.html#ordered(boolean)>`__
 
 
-BulkWrite Example
-~~~~~~~~~~~~~~~~~
+BulkWrite Example: Full File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The following code is a complete, standalone file that performs an ordered bulk
 write operation. 
@@ -622,55 +622,28 @@ Even though the write operation inserting a document with a duplicate key result
 in an error, the other operations are executed because the write operation is
 unordered.
 
-To learn more about the methods and classes mentioned in this section,
-see the following API documentation:
-
-- `ClientBulkWriteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/bulk/ClientBulkWriteOptions.html>`__
-- `ClientBulkWriteResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/bulk/ClientBulkWriteResult.html>`__
-
-Summary
--------
-
-``MongoCollection.bulkWrite()``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To perform a bulk operation, you create and pass a list of
-``WriteModel`` instances to the ``bulkWrite()`` method. 
-
-There are 6 different ``WriteModel`` subtypes: ``InsertOneModel``,
-``ReplaceOneModel``, ``UpdateOneModel``, ``UpdateManyModel``,
-``DeleteOneModel`` and ``DeleteManyModel``. 
-
-There are two ways to execute the ``bulkWrite()`` method: 
-
-- Ordered, which performs the bulk operations in order until an error occurs, if any
-- Unordered, which performs all the bulk operations in any order and reports errors
-  at the end, if any
+API Documentation
+-----------------
 
-To learn more about the collection ``bulkWrite`` command, see the 
-:manual:`db.collection.bulkWrite() </reference/method/db.collection.bulkWrite/>`
-method reference in the {+mdb-server+} Manual.
+To learn more about the methods and classes used to perform bulk write
+operations in this section, see the following API documentation:
 
-``MongoClient.bulkWrite()``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+MongoCollection
+~~~~~~~~~~~~~~~
 
-When connecting to a deployment running {+mdb-server+} version 8.0 or later, you 
-can use the ``MongoClient.bulkWrite()`` method to perform bulk operations on multiple 
-databases and collections at once.
+- `bulkWrite() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#bulkWrite(com.mongodb.client.ClientSession,java.util.List)>`__
+- `BulkWriteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/BulkWriteOptions.html>`__
+- `MongoBulkWriteException <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoBulkWriteException.html>`__
 
-To perform a client bulk operation, you create an pass a list of 
-``ClientNamespacedWriteModel`` instances to this method.
+MongoClient
+~~~~~~~~~~~
 
-There are six subtypes of ``ClientNamespacedWriteModel`` that are used to
-represent write operations. To construct these write models, you can use the
-corresponding ``ClientNamespacedWriteModel`` methods ``insertOne()``, ``updateOne()``, 
-``updateMany()``, ``replaceOne()``, ``deleteOne()``, and ``deleteMany()``. These 
-methods take a ``MongoNamespace`` object that defines which
-database and collection to write to.
+- `bulkWrite() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCluster.html#bulkWrite(com.mongodb.client.ClientSession,java.util.List)>`__
+- `ClientBulkWriteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/bulk/ClientBulkWriteOptions.html>`__
+- `ClientBulkWriteResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/bulk/ClientBulkWriteResult.html>`__
 
-The ``MongoClient.bulkWrite()`` method can also take a ``ClientBulkWriteOptions``
-object to specify different options for how the command is executed.
+Server Manual Entries
+---------------------
 
-To learn more about the client ``bulkWrite`` command, see the 
-:manual:`bulkWrite() </reference/command/bulkWrite/>` method reference in the {+mdb-server+}
-Manual.
+- :manual:`MongoCollection.bulkWrite() </reference/method/db.collection.bulkWrite/>`
+- :manual:`MongoClient.bulkWrite() </reference/command/bulkWrite/>`

source/crud/write-operations/delete.txt

@@ -148,8 +148,8 @@ collection:
     { "_id": 1, "color": "red", "qty": 5 }
     { "_id": 8, "color": "black", "qty": 8 }
 
-Delete Example
---------------
+Delete Example: Full File
+-------------------------
 
 The following code is a complete, standalone file that performs a delete one
 operation and a delete many operation. 
@@ -174,14 +174,10 @@ API documentation.
       DeleteOne document count: 1
       DeleteMany document count: 4
 
-More Information
-----------------
-
-For more information about the methods and classes mentioned in this guide,
-see the following resources:
-
 API Documentation
-~~~~~~~~~~~~~~~~~
+-----------------
+
+For additional information on the methods and classes used to delete documents, see the following API Documentation: 
 
 - `deleteOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#deleteOne(org.bson.conversions.Bson)>`__  
 - `deleteMany() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#deleteMany(org.bson.conversions.Bson)>`__ 
@@ -190,7 +186,7 @@ API Documentation
 - `FindOneAndDeleteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/FindOneAndDeleteOptions.html>`__ 
 
 Server Manual Entries
-~~~~~~~~~~~~~~~~~~~~~
+---------------------
 
 - :manual:`db.collection.deleteOne() </reference/method/db.collection.deleteMany/>`
 - :manual:`db.collection.deleteMany() </reference/method/db.collection.deleteOne/>`

source/crud/write-operations/insert.txt

@@ -163,8 +163,8 @@ The output of the preceding code resembles the following:
    60930c3aa982931c20ef6cd8] 
 
 
-Insert Example
---------------
+Insert Example: Full File
+-------------------------
 
 The following code is a complete, standalone file that performs an insert one
 operation and an insert many operation. 
@@ -184,12 +184,18 @@ operation and an insert many operation.
       InsertOne document id: BsonObjectId{value=...}
       InsertMany document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
 
-More Information
-----------------
+API Documentation
+-----------------
 
-For more information about the methods and classes mentioned in this section,
-see the following resources: 
+For additional information on the methods and classes used to insert documents, see the following API Documentation: 
+
+- `insertOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#insertOne(TDocument)>`__
+- `InsertOneResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/InsertOneResult.html>`__
+- `insertMany() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#insertMany(java.util.List)>`__
+- `InsertManyResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/InsertManyResult.html>`__ 
+
+Server Manual Entries
+---------------------
 
-- `insertMany() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#insertMany(java.util.List)>`__ API Documentation
-- `InsertManyResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/InsertManyResult.html>`__ API Documentation
-- Manual Explanation on :manual:`insertMany() </reference/method/db.collection.insertMany/>`
+- :manual:`db.collection.insertOne() </reference/method/db.collection.insertOne/>`
+- :manual:`db.collection.insertMany() </reference/method/db.collection.insertMany/>`

source/crud/write-operations/modify.txt

@@ -163,8 +163,8 @@ documents match.
     see :manual:`Unique Indexes </core/index-unique/>` in the
     {+mdb-server+} manual.
 
-Update Example
-~~~~~~~~~~~~~~
+Update Example: Full File
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The following code is a complete, standalone file that performs an update one
 operation and an update many operation. 
@@ -181,8 +181,10 @@ operation and an update many operation.
       :language: none
       :visible: false
 
-      InsertOne document id: BsonObjectId{value=...}
-      InsertMany document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
+      UpdateOne modified document count: 1
+      Upserted ID: null
+
+      UpdateMany modified document count: 242
 
 .. _replace-operation:
 
@@ -277,3 +279,54 @@ documents match.
     For more information about constraints on unique indexes,
     see :manual:`Unique Indexes </core/index-unique/>` in the
     {+mdb-server+} manual.
+
+ReplaceOne Example: Full File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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/ReplaceOne.java
+      :language: java
+      :dedent:
+
+   .. output:: 
+      :language: none
+      :visible: false
+
+      UpdateOne modified document count: 1
+      Upserted ID: null
+
+      UpdateMany modified document count: 242
+
+API Documentation
+-----------------
+
+For additional information on the methods and classes used to modify documents, see the following API Documentation:
+
+- `updateOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#updateOne(org.bson.conversions.Bson,java.util.List,com.mongodb.client.model.UpdateOptions)>`__
+- `updateMany() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#updateMany(org.bson.conversions.Bson,java.util.List,com.mongodb.client.model.UpdateOptions)>`__
+- `UpdateOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/UpdateOptions.html>`__
+- `replaceOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#replaceOne(org.bson.conversions.Bson,TDocument)>`__
+- `ReplaceOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/ReplaceOptions.html?is-external=true>`__
+- - `UpdateResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/UpdateResult.html>`__
+ 
+For additional information on the methods used in the examples on this
+page, see the following API Documentation:
+
+- `eq() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html#eq(java.lang.String,TItem)>`__
+- `combine() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Updates.html#combine(org.bson.conversions.Bson...)>`__
+- `set() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Updates.html#set(java.lang.String,TItem)>`__
+- `addToSet() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Updates.html#addToSet(java.lang.String,TItem)>`__
+- `currentTimestamp() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Updates.html#currentTimestamp(java.lang.String)>`__
+
+Server Manual Entries
+---------------------
+
+- :manual:`db.collection.updateOne() </reference/method/db.collection.updateOne/>`
+- :manual:`db.collection.updateMany() </reference/method/db.collection.updateMany/>`
+- :manual:`db.collection.replaceOne() </reference/method/db.collection.replaceOne/>`

source/includes/crud/Delete.java

@@ -14,7 +14,9 @@
 import com.mongodb.client.MongoDatabase;
 import com.mongodb.client.result.DeleteResult;
 
-public class DeleteOne {
+import static com.mongodb.client.model.Filters.lt;
+
+public class Delete {
 
     public static void main(String[] args) {
         // Replace the uri string with your MongoDB deployment's connection string

source/includes/crud/Insert.java

@@ -15,7 +15,9 @@
 import com.mongodb.client.result.InsertOneResult;
 import com.mongodb.client.result.InsertManyResult;
 
-public class InsertOne {
+import java.util.List;
+
+public class Insert {
     public static void main(String[] args) {
         // Replace the uri string with your MongoDB deployment's connection string
         String uri = "<connection string uri>";

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

@@ -14,7 +14,9 @@
 import com.mongodb.client.model.Updates;
 import com.mongodb.client.result.UpdateResult;
 
-public class UpdateOne {
+import static com.mongodb.client.model.Filters.gt;
+
+public class Update {
 
     public static void main(String[] args) {
         // Replace the uri string with your MongoDB deployment's connection string
@@ -41,8 +43,8 @@ public static void main(String[] args) {
                 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());
-                System.out.println("Upserted id: " + result.getUpsertedId());
+                System.out.println("UpdateOne modified document count: " + result.getModifiedCount());
+                System.out.println("Upserted ID: " + result.getUpsertedId());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {
@@ -61,7 +63,7 @@ public static void main(String[] args) {
                 UpdateResult result = collection.updateMany(updateManyQuery, updateManyUpdates);
 
                 // Prints the number of updated documents
-                System.out.println("Modified document count: " + result.getModifiedCount());
+                System.out.println("\nUpdateMany modified document count: " + result.getModifiedCount());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {