retrieve

Author: rachel-mack

source/crud/read-operations/retrieve.txt

@@ -4,7 +4,13 @@
 Retrieve Data
 ==============
 
+.. facet::
+   :name: genre
+   :values: reference
 
+.. meta::
+   :keywords: find, findOne, findMany, get, lookup
+   :description: Learn about how to retrieve data in the {+driver-long+}.
 
 .. contents:: On this page
    :local:
@@ -84,8 +90,27 @@ The following shows the output of the preceding query:
 After the owner runs this query, they find two orders that matched the
 criteria.
 
-For a runnable ``find()`` example, see our :ref:`Find Multiple
-Documents <retrieve-find>` page.
+Find Example: Full File
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The following code is a complete, standalone file that performs a find one
+operation and a find many operation. 
+
+.. include:: /includes/crud/example-intro.rst
+
+.. io-code-block::
+
+   .. input:: /includes/crud/Find.java
+      :language: java
+      :dedent:
+
+   .. output:: 
+      :language: none
+      :visible: false
+
+      Number of documents found with find(): 101
+
+      Document found with find().first(){"title": "The Room", "imdb": {"rating": 3.5, "votes": 25673, "id": 368226}}
 
 .. _retrieve-aggregate:
 
@@ -101,7 +126,8 @@ instance of a ``MongoCollection``. This method accepts aggregation
 expressions to run in sequence. To perform aggregations, you can
 define aggregation stages that specify how to match documents, rename
 fields, and group values. For more information, see our
-:ref:`Aggregation <java-aggregation>` guide.
+:ref:`Aggregation <java-aggregation>` guide and the :ref:`Aggregation Expression
+Operations <java-aggregation-expression-operations>` page.
 
 Example
 ~~~~~~~
@@ -136,8 +162,21 @@ purchased color.
 For more information about how to construct an aggregation pipeline, see
 the {+mdb-server+} manual page on :manual:`Aggregation </aggregation>`.
 
-For additional information on the methods mentioned on this page, see
-the following API Documentation:
+API Documentation
+-----------------
+
+For additional information on the methods and classes used to retrieve documents
+on this page, see the following API Documentation:
+
+- `find() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#find()>`__
+- `first() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoIterable.html#first()>`__
+- `FindIterable <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html>`__
+- `aggregate() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#aggregate(java.util.List)>`__
+
+Server Manual Entries
+---------------------
 
-- `MongoCollection.find() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#find()>`__
-- `MongoCollection.aggregate() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#aggregate(java.util.List)>`__
+- :manual:`Collections </core/databases-and-collections/#collections>`
+- :manual:`Query Documents </tutorial/query-documents>`
+- :manual:`Aggregation </aggregation>`
+- :manual:`Aggregation stages </meta/aggregation-quick-reference/#stages>`

source/crud/write-operations/delete.txt

@@ -184,10 +184,11 @@ For additional information on the methods and classes used to delete documents,
 - `findOneAndDelete() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#findOneAndDelete(org.bson.conversions.Bson)>`__ 
 - `DeleteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/DeleteOptions.html>`__ 
 - `FindOneAndDeleteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/FindOneAndDeleteOptions.html>`__ 
+- `DeleteResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/DeleteResult.html>`__ 
 
 Server Manual Entries
 ---------------------
 
-- :manual:`db.collection.deleteOne() </reference/method/db.collection.deleteMany/>`
-- :manual:`db.collection.deleteMany() </reference/method/db.collection.deleteOne/>`
+- :manual:`db.collection.deleteOne() </reference/method/db.collection.deleteOne/>`
+- :manual:`db.collection.deleteMany() </reference/method/db.collection.deleteMany/>`
 - :manual:`db.collection.findOneAndDelete() </reference/method/db.collection.findOneAndDelete/>`

source/crud/write-operations/modify.txt

@@ -173,7 +173,7 @@ operation and an update many operation.
 
 .. io-code-block::
 
-   .. input:: /includes/crud/Insert.java
+   .. input:: /includes/crud/Update.java
       :language: java
       :dedent:
 
@@ -283,14 +283,13 @@ documents match.
 ReplaceOne Example: Full File
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The following code is a complete, standalone file that performs an update one
-operation and an update many operation. 
+The following code is a complete, standalone file that performs a replace one operation. 
 
 .. include:: /includes/crud/example-intro.rst
 
 .. io-code-block::
 
-   .. input:: /includes/crud/Replace.java
+   .. input:: /includes/crud/ReplaceOne.java
       :language: java
       :dedent:
 
@@ -313,7 +312,7 @@ For additional information on the methods and classes used to modify documents,
 - `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>`__
+- `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:

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

@@ -1,7 +1,4 @@
 // Retrieves documents that match a query filter by using the Java driver
-
-package usage.examples;
-
 import static com.mongodb.client.model.Filters.lt;
 
 import org.bson.Document;
@@ -15,6 +12,8 @@
 import com.mongodb.client.model.Projections;
 import com.mongodb.client.model.Sorts;
 
+import static com.mongodb.client.model.Filters.eq;
+
 public class Find {
     public static void main( String[] args ) {
 
@@ -36,12 +35,20 @@ public static void main( String[] args ) {
                     .sort(Sorts.descending("title")).iterator();
 
             // Prints the results of the find operation as JSON
-            try {
-                while(cursor.hasNext()) {
-                    System.out.println(cursor.next().toJson());
-                }
-            } finally {
-                cursor.close();
+            System.out.println("Number of documents found with find(): " + cursor.available() + "\n");
+            cursor.close();
+
+            // Retrieves the first matching document, applying a projection and a descending sort to the results
+            Document doc = collection.find(eq("title", "The Room"))
+                    .projection(projectionFields)
+                    .sort(Sorts.descending("imdb.rating"))
+                    .first();
+
+            // Prints a message if there are no result documents, or prints the result document as JSON
+            if (doc == null) {
+                System.out.println("No results found.");
+            } else {
+                System.out.println("Document found with find().first()" + doc.toJson());
             }
         }
     }