DOCSP-46772: sort option for client bw - updateone & replaceone (#113)

Author: rustagir

source/includes/write/client-bulk-write.java

@@ -39,6 +39,22 @@ public static void main(String[] args) {
             );
             // end-insert-models
 
+            // start-update-models
+            ClientNamespacedUpdateOneModel personUpdate = ClientNamespacedWriteModel
+                    .updateOne(
+                            new MongoNamespace("db", "people"),
+                            Filters.eq("name", "Freya Polk"),
+                            Updates.inc("age", 1)
+                    );
+
+            ClientNamespacedUpdateManyModel thingUpdate = ClientNamespacedWriteModel
+                    .updateMany(
+                            new MongoNamespace("db", "things"),
+                            Filters.eq("category", "electronic"),
+                            Updates.set("manufacturer", "Premium Technologies")
+                    );
+            // end-update-models
+
             // start-replace-models
             ClientNamespacedReplaceOneModel personReplacement = ClientNamespacedWriteModel
                     .replaceOne(

source/whats-new.txt

@@ -20,13 +20,30 @@ What's New
 Learn about new features, improvements, and fixes introduced in the
 following versions of the {+driver-long+}:
 
+* :ref:`Version 5.4 <javars-version-5.4>`
 * :ref:`Version 5.3 <javars-version-5.3>`
 * :ref:`Version 5.2 <javars-version-5.2>`
 * :ref:`Version 5.1.3 <javars-version-5.1.3>`
 * :ref:`Version 5.1.2 <javars-version-5.1.2>`
 * :ref:`Version 5.1.1 <javars-version-5.1.1>`
 * :ref:`Version 5.1 <javars-version-5.1>`
 
+.. _javars-version-5.4:
+
+What's New in 5.4
+-----------------
+
+The 5.4 driver release includes the following changes, fixes,
+and features:
+
+.. sharedinclude:: dbx/jvm/v5.4-wn-items.rst
+
+   .. replacement:: sort-option-link
+
+      the :ref:`java-rs-client-bulk-write-update` and
+      :ref:`java-rs-client-bulk-write-replace` sections of the Bulk
+      Write Operations guide
+
 .. _javars-version-5.3:
 
 What's New in 5.3
@@ -125,4 +142,5 @@ What's New in 5.1
    release and will be removed in the v5.2 release of the driver.
 
 To learn about other changes introduced in v5.1, see the :driver:`What's
-New </java/sync/current/whats-new/>` guide in the Java Sync Driver documentation.
+New </java/sync/current/whats-new/>` guide in the Java Sync Driver
+documentation.

source/write/bulk-writes.txt

@@ -116,7 +116,7 @@ The following example creates an instance of ``UpdateOneModel``:
 If multiple documents match the query filter specified in
 the ``UpdateOneModel`` instance, the operation updates the first
 result. You can specify a sort in an ``UpdateOptions`` instance to apply
-an order to matched documents before the driver performs the update
+an order to matched documents before the server performs the update
 operation, as shown in the following code:
 
 .. code-block:: java
@@ -156,7 +156,7 @@ The following example creates an instance of ``ReplaceOneModel``:
 If multiple documents match the query filter specified in
 the ``ReplaceOneModel`` instance, the operation replaces the first
 result. You can specify a sort in a ``ReplaceOptions`` instance to apply
-an order to matched documents before the driver performs the replace
+an order to matched documents before the server performs the replace
 operation, as shown in the following code:
 
 .. code-block:: java
@@ -428,6 +428,43 @@ each write operation applies to.
    :copyable:
    :dedent:
 
+.. _java-rs-client-bulk-write-update:
+
+Update Operations
+~~~~~~~~~~~~~~~~~
+
+The following example shows how to use the ``bulkWrite()`` method to update
+existing documents in the ``db.people`` and
+``db.things`` collections:
+
+.. literalinclude:: /includes/write/client-bulk-write.java
+   :start-after: start-update-models
+   :end-before: end-update-models
+   :language: java
+   :copyable:
+   :dedent:
+
+This example increments the value of the ``age`` field by ``1`` in the
+document that has a ``name`` value of ``"Freya Polk"`` in the ``people``
+collection. It also sets the value of the ``manufacturer`` field to
+``"Premium Technologies"`` in all documents that have a ``category``
+value of ``"electronic"`` in the ``things`` collection.
+
+If multiple documents match the query filter specified in
+a ``ClientNamespacedUpdateOneModel`` instance, the operation updates the
+first result. You can specify a sort order in a `ClientUpdateOneOptions
+<{+core-api+}/client/model/bulk/ClientUpdateOneOptions.html>`__
+instance to apply an order to matched documents before the server
+performs the update operation, as shown in the following code:
+
+.. code-block:: java
+
+   ClientUpdateOneOptions options = ClientUpdateOneOptions
+           .clientUpdateOneOptions()
+           .sort(Sorts.ascending("_id"));
+
+.. _java-rs-client-bulk-write-replace:
+
 Replace Operations
 ~~~~~~~~~~~~~~~~~~
 
@@ -446,6 +483,19 @@ in the ``people`` collection is replaced with a new document. The document in
 the ``things`` collection that has an ``_id`` value of ``1`` 
 is replaced with a new document.
 
+If multiple documents match the query filter specified in
+a ``ClientNamespacedReplaceOneModel`` instance, the operation replaces the
+first result. You can specify a sort order in a `ClientReplaceOneOptions
+<{+core-api+}/client/model/bulk/ClientReplaceOneOptions.html>`__
+instance to apply an order to matched documents before the server
+performs the replace operation, as shown in the following code:
+
+.. code-block:: java
+
+   ClientReplaceOneOptions options = ClientReplaceOneOptions
+           .clientReplaceOneOptions()
+           .sort(Sorts.ascending("_id"));
+
 Perform the Bulk Operation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~