update many

Author: norareidy

source/includes/usage-examples/code-snippets/update-many-async.rs

@@ -2,12 +2,27 @@ use std::env;
 use mongodb::{ bson::doc, Client, Collection };
 use bson::Document;
 
+#[derive(Debug, Serialize, Deserialize)]
+struct Address {
+    street: String,
+    city: String,
+}
+
+#[derive(Serialize, Deserialize, Debug)]
+struct Restaurant {
+    name: String,
+    borough: String,
+    address: Address,
+}
+
 #[tokio::main]
 async fn main() -> mongodb::error::Result<()> {
     let uri = "<connection string>";
 
     let client = Client::with_uri_str(uri).await?;
-    let my_coll: Collection<Document> = client
+
+    // Replace <T> with the <Document> or <Restaurant> type parameter
+    let my_coll: Collection<T> = client
         .database("sample_restaurants")
         .collection("restaurants");
 

source/includes/usage-examples/code-snippets/update-many-sync.rs

@@ -4,11 +4,26 @@ use mongodb::{
     sync::{ Client, Collection } 
 };
 
+#[derive(Debug, Serialize, Deserialize)]
+struct Address {
+    street: String,
+    city: String,
+}
+
+#[derive(Serialize, Deserialize, Debug)]
+struct Restaurant {
+    name: String,
+    borough: String,
+    address: Address,
+}
+
 fn main() -> mongodb::error::Result<()> {
     let uri = "<connection string>";
 
     let client = Client::with_uri_str(uri)?;
-    let my_coll: Collection<Document> = client
+
+    // Replace <T> with the <Document> or <Restaurant> type parameter
+    let my_coll: Collection<T> = client
         .database("sample_restaurants")
         .collection("restaurants");
 

source/usage-examples/updateMany.txt

@@ -26,11 +26,18 @@ Example
 -------
 
 This example updates a document in the ``restaurants`` collection of
-the ``sample_restaurants`` database.
+the ``sample_restaurants`` database. The ``update_many()`` method adds
+the ``near_me`` field to documents in which the value of the ``address.street``
+field is ``"Sullivan Street"`` and the ``borough`` field is ``"Manhattan"``.
 
-The following code adds the ``near_me`` field to documents in which the
-value of the ``address.street`` field is ``"Sullivan Street"`` and the
-``borough`` field is ``"Manhattan"``.
+You can access the documents in the ``restaurants`` collection as instances
+of the BSON data type or a custom data type. To specify which data type represents
+the collection's data, replace the ``<T>`` type parameter on the highlighted
+line with one of the following values:
+
+- ``<Document>``: Accesses collection documents as BSON documents.
+- ``<Restaurant>``: Accesses collection documents as instances of the ``Restaurant``
+  struct, defined at the top of the code
 
 Select the :guilabel:`Asynchronous` or :guilabel:`Synchronous` tab to
 see the corresponding code for each runtime:
@@ -45,6 +52,7 @@ see the corresponding code for each runtime:
 
          .. input:: /includes/usage-examples/code-snippets/update-many-async.rs
             :language: rust
+            :emphasize-lines: 25
             :dedent:
 
          .. output::
@@ -62,6 +70,7 @@ see the corresponding code for each runtime:
 
          .. input:: /includes/usage-examples/code-snippets/update-many-sync.rs
             :language: rust
+            :emphasize-lines: 26
             :dedent:
 
          .. output::