insert

Author: rachel-mack

source/crud/write-operations/bulk.txt

@@ -360,21 +360,17 @@ see the following API documentation:
 - `ordered() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/BulkWriteOptions.html#ordered(boolean)>`__
 
 
-BulkWrite Example File 
-~~~~~~~~~~~~~~~~~~~~~~
+BulkWrite Example
+~~~~~~~~~~~~~~~~~
+
+The following code is a complete, standalone file that performs an ordered bulk
+write operation. 
 
-This code example is a complete, standalone file that performs an ordered bulk
-write operation. It uses the ``movies`` collection in the
-``sample_mflix`` database included in the :atlas:`sample datasets
-</sample-data?jmp=docs_driver_java>` provided by Atlas. You can load them into
-your database on the free tier of MongoDB Atlas by following the :atlas:`Get
-Started with Atlas Guide </getting-started/#atlas-getting-started?jmp=docs_driver_java>`
+.. include:: /includes/crud/example-intro.rst
 
 This example call to ``bulkWrite()`` includes examples of the ``InsertOneModel``,
 ``UpdateOneModel``, ``DeleteOneModel``, and ``ReplaceOneModel``. 
 
-.. include:: /includes/connect-guide-note.rst
-
 .. io-code-block::
 
    .. input:: /includes/crud/BulkWrite.java

source/crud/write-operations/delete.txt

@@ -148,23 +148,19 @@ collection:
     { "_id": 1, "color": "red", "qty": 5 }
     { "_id": 8, "color": "black", "qty": 8 }
 
-Delete Example File
--------------------
+Delete Example
+--------------
 
-This code example is a complete, standalone file that performs a delete one
-operation and a delete many operation. It uses the ``movies`` collection in the
-``sample_mflix`` database included in the :atlas:`sample datasets
-</sample-data?jmp=docs_driver_java>` provided by Atlas. You can load them into
-your database on the free tier of MongoDB Atlas by following the :atlas:`Get
-Started with Atlas Guide </getting-started/#atlas-getting-started?jmp=docs_driver_java>`
+The following code is a complete, standalone file that performs a delete one
+operation and a delete many operation. 
 
-This example used the ``eq()`` and ``lt()`` filters to query documents. For more
+.. include:: /includes/crud/example-intro.rst
+
+The query uses the ``eq()`` and ``lt()`` filters to query documents. For more
 information about filters, see the `Filters Class
 <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html>`__
 API documentation.
 
-.. include:: /includes/connect-guide-note.rst
-
 .. io-code-block::
 
    .. input:: /includes/crud/Delete.java

source/crud/write-operations/insert.txt

@@ -159,26 +159,37 @@ The output of the preceding code resembles the following:
 .. code-block::
    :copyable: false
 
-   Inserted documents with the following ids: [60930c3aa982931c20ef6cd7, 60930c3aa982931c20ef6cd8] 
+   Inserted documents with the following ids: [60930c3aa982931c20ef6cd7,
+   60930c3aa982931c20ef6cd8] 
 
-For more information about the methods and classes mentioned in this section,
-see the following resources: 
 
-- `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/>`
-- Runnable :ref:`Insert Multiple Documents Example <java-usage-insertmany>`
+Insert Example
+--------------
+
+The following code is a complete, standalone file that performs an insert one
+operation and an insert many operation. 
+
+.. include:: /includes/crud/example-intro.rst
+
+.. io-code-block::
 
-Summary
--------
+   .. input:: /includes/crud/Insert.java
+      :language: java
+      :dedent:
 
-There are three ways to perform an insert operation, but we focused on two:
+   .. output:: 
+      :language: none
+      :visible: false
 
-- The ``insertOne()`` method inserts a single document.
-- The ``insertMany()`` method inserts multiple documents.
+      InsertOne document id: BsonObjectId{value=...}
+      InsertMany document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
 
-Both methods automatically generate an ``_id`` if you omit the field in
-your document. 
+More Information
+----------------
+
+For more information about the methods and classes mentioned in this section,
+see the following resources: 
 
-If the insertion is successful, both methods return an instance
-representing the ``_id`` of each new document.
+- `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/>`

source/includes/crud/Delete.java

@@ -30,7 +30,7 @@ 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("Deleted document count: " + deleteOneResult.getDeletedCount());
+                System.out.println("DeleteOne document count: " + deleteOneResult.getDeletedCount());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {
@@ -44,7 +44,7 @@ public static void main(String[] args) {
                 DeleteResult deleteManyResult = collection.deleteMany(deleteManyQuery);
 
                 // Prints the number of deleted documents
-                System.out.println("Deleted document count: " + deleteManyResult.getDeletedCount());
+                System.out.println("DeleteMany document count: " + deleteManyResult.getDeletedCount());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {

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

@@ -13,6 +13,7 @@
 import com.mongodb.client.MongoCollection;
 import com.mongodb.client.MongoDatabase;
 import com.mongodb.client.result.InsertOneResult;
+import com.mongodb.client.result.InsertManyResult;
 
 public class InsertOne {
     public static void main(String[] args) {
@@ -25,13 +26,30 @@ public static void main(String[] args) {
 
             try {
                 // Inserts a sample document describing a movie into the collection
-                InsertOneResult result = collection.insertOne(new Document()
+                InsertOneResult iOResult = collection.insertOne(new Document()
                         .append("_id", new ObjectId())
                         .append("title", "Ski Bloopers")
                         .append("genres", Arrays.asList("Documentary", "Comedy")));
 
                 // Prints the ID of the inserted document
-                System.out.println("Success! Inserted document id: " + result.getInsertedId());
+                System.out.println("InsertOne document id: " + result.getInsertedId());
+            
+            // Prints a message if any exceptions occur during the operation
+            } catch (MongoException me) {
+                System.err.println("Unable to insert due to an error: " + me);
+            }
+
+            // Creates two sample documents containing a "title" field
+            List<Document> movieList = Arrays.asList(
+                    new Document().append("title", "Short Circuit 3"),
+                    new Document().append("title", "The Lego Frozen Movie"));
+
+            try {
+                // Inserts sample documents describing movies into the collection
+                InsertManyResult result = collection.insertMany(movieList);
+
+                // Prints the IDs of the inserted documents
+                System.out.println("InsertMany document ids: " + result.getInsertedIds());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {

source/includes/crud/example-intro.rst

@@ -0,0 +1,8 @@
+This example connects to an instance of MongoDB using a connection URI. To learn
+more about connecting to your MongoDB instance, see the :ref:`connection guide
+<connect-to-mongodb>`. It also uses the ``movies`` collection in the
+``sample_mflix`` database included in the :atlas:`sample datasets
+</sample-data?jmp=docs_driver_java>` provided by Atlas. You can load them into
+your database on the free tier of MongoDB Atlas by following the :atlas:`Get
+Started with Atlas Guide
+</getting-started/#atlas-getting-started?jmp=docs_driver_java>`.