WIP

Author: rustagir

source/atlas-search.txt

@@ -123,11 +123,15 @@ Learn more about this helper from the
 
 .. _java-atlas-search-helpers:
 
-Building a Pipeline Search Stage
---------------------------------
+Create Pipeline Search Stages
+-----------------------------
 
 .. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
 
+   .. replacement:: as-idx-link
+
+      the :ref:`java-search-indexes` section of the Indexes guide
+
    .. replacement:: atlas-query-operators-example
 
       .. io-code-block::
@@ -141,13 +145,9 @@ Building a Pipeline Search Stage
          .. output::
             :language: console
             :visible: false
-
-            Document{{_id=573a1397f29313caabce86db, genres=[Drama, Sport], cast=[Sylvester Stallone, Talia Shire, Burt Young, Carl Weathers], title=Rocky III, year=1982}}
-            Document{{_id=573a1398f29313caabce9af0, genres=[Drama, Sport], cast=[Sylvester Stallone, Talia Shire, Burt Young, Carl Weathers], title=Rocky IV, year=1985}}
-
-   .. replacement:: searchoperator-interface-api-docs
-
-      the `SearchOperator Interface API documentation <{+core-api+}/client/model/search/SearchOperator.html>`__
+            
+            {"_id": ..., "genres": ["Comedy", "Romance"], "title": "Love at First Bite", "year": 1979}
+            {"_id": ..., "genres": ["Comedy", "Drama"], "title": "Love Affair", "year": 1994}
 
 Additional Information
 ----------------------
@@ -164,4 +164,4 @@ the following API documentation:
 - `MongoCollection.aggregate() <{+driver-api+}/MongoCollection.html#aggregate(java.util.List)>`__
 - `Aggregates.search() <{+core-api+}/client/model/Aggregates.html#search(com.mongodb.client.model.search.SearchCollector)>`__
 - `Aggregates.project() <{+core-api+}/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`__
-- `SearchOperator <{+core-api+}/client/model/search/SearchOperator.html>`__
+- `SearchOperator <{+core-api+}/client/model/search/SearchOperator.html>`__

source/crud/read-write-config.txt

@@ -333,10 +333,10 @@ API Documentation
 To learn more about any of the methods or types discussed in this
 guide, see the following API documentation:
 
-- `MongoClient <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoClient.html>`__
-- `MongoClientSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`__
-- `TransactionOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/TransactionOptions.html>`_
-- `startTransaction() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/ClientSession.html#startTransaction()>`_
-- `MongoDatabase <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoDatabase.html>`__
-- `MongoCollection <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html>`__
-- `TagSet <{+api+}/apidocs/mongodb-driver-core/com/mongodb/TagSet.html>`_
+- `MongoClient <{+driver-api+}/MongoClient.html>`__
+- `MongoClientSettings <{+core-api+}/MongoClientSettings.html>`__
+- `TransactionOptions <{+core-api+}/TransactionOptions.html>`_
+- `startTransaction() <{+driver-api+}/ClientSession.html#startTransaction()>`_
+- `MongoDatabase <{+driver-api+}/MongoDatabase.html>`__
+- `MongoCollection <{+driver-api+}/MongoCollection.html>`__
+- `TagSet <{+core-api+}/TagSet.html>`_

source/includes/fundamentals/code-snippets/builders/AggregateSearchBuilderExample.java

@@ -60,33 +60,25 @@ private static void runAtlasTextSearch(MongoCollection<Document> collection) {
      */
     private static void runAtlasSearchWithSearchHelperMethods(MongoCollection<Document> collection) {
         // begin atlasHelperMethods
-        Bson searchStageFilters = Aggregates.search(
+        List<Bson> pipeline = new ArrayList<>();
+
+        pipeline.add(Aggregates.search(
                 SearchOperator.compound()
                         .filter(
-                                List.of(
-                                        SearchOperator.text(fieldPath("genres"), "Drama"),
-                                        SearchOperator.phrase(fieldPath("cast"), "sylvester stallone"),
-                                        SearchOperator.numberRange(fieldPath("year")).gtLt(1980, 1989),
-                                        SearchOperator.wildcard(fieldPath("title"),"Rocky *")
-                                )));
-        
-        Bson projection = Aggregates.project(Projections.fields(
-                Projections.include("title", "year", "genres", "cast")
+                                Arrays.asList(
+                                        SearchOperator.in(fieldPath("genres"), Arrays.asList("Comedy")),
+                                        SearchOperator.phrase(fieldPath("fullplot"), "new york"),
+                                        SearchOperator.numberRange(fieldPath("year")).gtLt(1950, 2000),
+                                        SearchOperator.wildcard(fieldPath("title"), "Love *")
+                                ))));
+
+        pipeline.add(Aggregates.project(
+                Projections.include("title", "year", "genres")
         ));
 
-        List<Bson> aggregateStages = List.of(searchStageFilters, projection);
-        collection.aggregate(aggregateStages).forEach(System.out::println);
-
+        AggregateIterable<Document> results = collection.aggregate(pipeline);
+        results.forEach(doc -> System.out.println(doc.toJson()));
         // end atlasHelperMethods
-
-        // To condense result data, add this projection into the pipeline
-        // Bson projection = Aggregates.project(Projections.fields(Projections.include("title", "released")));
-
-        List<Bson> aggregateStages = List.of(searchStageFilters);
-        System.out.println("aggregateStages: " + aggregateStages);
-
-        System.out.println("explain:\n" + collection.aggregate(aggregateStages).explain());
-        collection.aggregate(aggregateStages).forEach(result -> System.out.println(result));
     }
 
     /*
@@ -137,8 +129,9 @@ public static void main(String[] args) {
             // Uncomment the methods that correspond to what you're testing
             // runMatch(collection);
             // runAtlasTextSearch(collection);
-            runAtlasSearch(collection);
+            // runAtlasSearch(collection);
             // runAtlasTextSearchMeta(collection);
+            // runAtlasSearchWithSearchHelperMethods(collection);
         }
     }
 }

source/references/whats-new.txt

@@ -58,7 +58,7 @@ and features:
 
    .. replacement:: atlas-query-operators
 
-      the :ref:`java-atlas-search-helpers` section of the Atlas Search page.
+      the :ref:`java-atlas-search-helpers` section of the Atlas Search guide
 
 .. _java-version-5.3: