WIP

Author: rustagir

examples/src/test/kotlin/AggregatesBuilderTest.kt

@@ -56,6 +56,7 @@ class AggregatesBuilderTest {
         val genres: List<String>,
         val rated: String,
         val plot: String,
+        val fullplot: String,
         val runtime: Int,
         val imdb: IMDB
     ){
@@ -951,6 +952,37 @@ class AggregatesBuilderTest {
         assertEquals("Back to the Future", results.first().title)
     }
 
+    /* NOTE: Test is not run by default. FTS requires the creation of a text index on the collection before running
+    (see note at top of file for additional setup requirements for FTS).
+     */
+    @Ignore
+    fun atlasSearchOperatorTest() = runBlocking {
+        // :snippet-start: atlas-search-pipeline
+        val searchStage = Aggregates.search(
+            SearchOperator.compound()
+                .filter(
+                    listOf(
+                        SearchOperator.`in`(SearchPath.fieldPath(Movie::genres.name), listOf("Comedy")),
+                        SearchOperator.phrase(SearchPath.fieldPath(Movie::fullplot.name), "new york"),
+                        SearchOperator.numberRange(SearchPath.fieldPath(Movie::year.name)).gtLt(1950, 2000),
+                        SearchOperator.wildcard(SearchPath.fieldPath(Movie::title.name), "Love *")
+                    )
+                )
+        )
+
+        val projectStage = Aggregates.project(
+            Projections.include("title", "year", "genres", "cast"))
+
+        val pipeline = listOf(searchStage, projectStage)
+        val resultsFlow = ftsCollection.aggregate(pipeline)
+
+        resultsFlow.collect { println(it) }
+        // :snippet-end:
+
+        val result = resultsFlow.toList()
+        assertEquals(2, result.size)
+    }
+
     /* NOTE: Test is not run by default. FTS requires the creation of a text index on the collection before running
     (see note at top of file for additional setup requirements for FTS).
      */

examples/src/test/kotlin/AggregationTest.kt

@@ -245,35 +245,4 @@ class AggregationTest {
         assertEquals(method1, method2)
 
     }
-
-    /* NOTE: Test is not run by default. FTS requires the creation of a text index on the collection before running.
-     */
-    @Ignore
-    fun atlasSearchOperatorTest() = runBlocking {
-        val collection = mongoClient.getDatabase("sample_mflix").getCollection<Document>("movies")
-        // :snippet-start: atlas-search-pipeline
-        val searchStage = Aggregates.search(
-            SearchOperator.compound()
-                .filter(
-                    listOf(
-                        SearchOperator.`in`(fieldPath("genres"), listOf("Comedy")),
-                        SearchOperator.phrase(fieldPath("fullplot"), "new york"),
-                        SearchOperator.numberRange(fieldPath("year")).gtLt(1950, 2000),
-                        SearchOperator.wildcard(fieldPath("title"), "Love *")
-                    )
-                )
-        )
-
-        val projectStage = Aggregates.project(
-            Projections.include("title", "year", "genres", "cast"))
-
-        val pipeline = listOf(searchStage, projectStage)
-        val resultsFlow = collection.aggregate(pipeline)
-
-        resultsFlow.collect { println(it) }
-        // :snippet-end:
-
-        val result = resultsFlow.toList()
-        assertEquals(2, result.size)
-    }
 }

source/examples/generated/AggregatesBuilderTest.snippet.atlas-search-pipeline.kt

@@ -0,0 +1,19 @@
+val searchStage = Aggregates.search(
+    SearchOperator.compound()
+        .filter(
+            listOf(
+                SearchOperator.`in`(SearchPath.fieldPath(Movie::genres.name), listOf("Comedy")),
+                SearchOperator.phrase(SearchPath.fieldPath(Movie::fullplot.name), "new york"),
+                SearchOperator.numberRange(SearchPath.fieldPath(Movie::year.name)).gtLt(1950, 2000),
+                SearchOperator.wildcard(SearchPath.fieldPath(Movie::title.name), "Love *")
+            )
+        )
+)
+
+val projectStage = Aggregates.project(
+    Projections.include("title", "year", "genres", "cast"))
+
+val pipeline = listOf(searchStage, projectStage)
+val resultsFlow = ftsCollection.aggregate(pipeline)
+
+resultsFlow.collect { println(it) }

source/examples/generated/AggregatesBuilderTest.snippet.movie-data-class.kt

@@ -4,6 +4,7 @@ data class Movie(
     val genres: List<String>,
     val rated: String,
     val plot: String,
+    val fullplot: String,
     val runtime: Int,
     val imdb: IMDB
 ){

source/examples/generated/AggregationTest.snippet.atlas-search-pipeline.kt

@@ -215,43 +215,6 @@ first element in the ``categories`` field.
       Results(name=456 Cookies Shop, firstCategory=Bakery)
       Results(name=XYZ Steak Buffet, firstCategory=Steak)
 
-.. _kotlin-cr-atlas-search-stage:
-
-Pipelines Stages for Atlas Search
----------------------------------
-
-:atlas:`Atlas Search </atlas-search>` queries take the form of an aggregation pipeline stage. Atlas
-Search provides ``$search`` and ``$searchMeta`` stages, both of which must be the first
-stage in any query pipeline. For more information about Atlas pipeline stages,
-see the :atlas:`Choose the Aggregation Pipeline Stage
-</atlas-search/query-syntax/>` page in the Atlas
-manual.
-
-.. tip:: Aggregates Builders
-
-   This example in this section uses helper methods from the
-   :ref:`Aggregates <aggregates-builders>` builder class.
-
-.. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
-
-   .. replacement:: as-idx-link
-
-      the :ref:`kotlin-search-indexes` section of the Indexes guide
-
-   .. replacement:: atlas-query-operators-example
-
-      .. io-code-block::
-
-         .. input:: /examples/generated/AggregationTest.snippet.atlas-search-pipeline.kt
-            :language: kotlin
-
-         .. output::
-            :language: console
-            :visible: false
-
-            Document{{_id=573a1397f29313caabce734c, genres=[Comedy, Romance], cast=[George Hamilton, Susan Saint James, Richard Benjamin, Dick Shawn], title=Love at First Bite, year=1979}}
-            Document{{_id=573a1399f29313caabcee81e, genres=[Comedy, Drama], cast=[Warren Beatty, Annette Bening, Katharine Hepburn, Garry Shandling], title=Love Affair, year=1994}}
-
 API Documentation
 -----------------
 
@@ -262,4 +225,3 @@ see the following API Documentation:
 - `$group <{+core-api+}/client/model/Aggregates.html#group(TExpression,java.util.List)>`__
 - `$project <{+core-api+}/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`__
 - `Projections <{+core-api+}/client/model/Projections.html>`__
-- `SearchOperator <{+core-api+}/com/mongodb/client/model/search/SearchOperator.html>`__

source/fundamentals/aggregation.txt

@@ -887,6 +887,31 @@ field in the ``movies`` collection for text that contains the word "Future":
 Learn more about the builders from the
 `search package API documentation <{+core-api+}/client/model/search/package-summary.html>`__.
 
+.. _kotlin-cr-atlas-search-stage:
+
+Search Operator Methods
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
+
+   .. replacement:: as-idx-link
+
+      the :ref:`kotlin-search-indexes` section of the Indexes guide
+
+   .. replacement:: atlas-query-operators-example
+
+      .. io-code-block::
+
+         .. input:: /examples/generated/AggregatesBuilderTest.snippet.atlas-search-pipeline.kt
+            :language: kotlin
+
+         .. output::
+            :language: console
+            :visible: false
+
+            Document{{_id=573a1397f29313caabce734c, genres=[Comedy, Romance], cast=[George Hamilton, Susan Saint James, Richard Benjamin, Dick Shawn], title=Love at First Bite, year=1979}}
+            Document{{_id=573a1399f29313caabcee81e, genres=[Comedy, Drama], cast=[Warren Beatty, Annette Bening, Katharine Hepburn, Garry Shandling], title=Love Affair, year=1994}}
+
 Atlas Search Metadata
 ---------------------