DOCSP-39685: Indexes landing page

source/includes/usage-examples/index-code-examples.java

@@ -0,0 +1,117 @@
+import com.mongodb.ConnectionString;
+import com.mongodb.MongoClientSettings;
+import com.mongodb.ServerApi;
+import com.mongodb.ServerApiVersion;
+
+import com.mongodb.client.model.ClusteredIndexOptions;
+import com.mongodb.client.model.CreateCollectionOptions;
+import com.mongodb.client.model.IndexOptions;
+import com.mongodb.client.model.Indexes;
+import com.mongodb.reactivestreams.client.*;
+import org.bson.Document;
+import org.reactivestreams.Publisher;
+import reactor.core.publisher.Flux;
+import reactor.core.publisher.Mono;
+
+public class IndexExamples {
+    public static void main(String[] args) {
+        // Replace the placeholder with your Atlas connection string
+        String uri = "<connection string URI>";
+
+        // Construct a ServerApi instance using the ServerApi.builder() method
+        ServerApi serverApi = ServerApi.builder()
+                .version(ServerApiVersion.V1)
+                .build();
+
+        MongoClientSettings settings = MongoClientSettings.builder()
+                .applyConnectionString(new ConnectionString(uri))
+                .serverApi(serverApi)
+                .build();
+
+        // Create a new client and connect to the server
+        try (MongoClient mongoClient = MongoClients.create(settings)) {
+            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
+            MongoCollection<Document> collection = database.getCollection("movies");
+
+            // start-single-field
+            Publisher<String> publisher = collection.createIndex(Indexes.ascending("<field name>"));
+            Mono.from(publisher).block();
+            // end-single-field
+
+            // start-compound
+            Publisher<String> publisher = collection.createIndex(Indexes.ascending("<field name 1>", "<field name 2>"));
+            Mono.from(publisher).block();
+            // end-compound
+
+            // start-multikey
+            Publisher<String> publisher = collection.createIndex(Indexes.ascending("<array field name>"));
+            Mono.from(publisher).block();
+            // end-multikey
+
+            // start-search-create
+            Document index = new Document("mappings", new Document("dynamic", true));
+            Publisher<String> publisher = collection.createSearchIndex("<index name>", index);
+            Mono.from(publisher).block();
+            // end-search-create
+
+            // start-search-list
+            ListSearchIndexesPublisher<Document> listIndexesPublisher = collection.listSearchIndexes();
+
+            Flux.from(listIndexesPublisher)
+                    .doOnNext(System.out::println)
+                    .blockLast();
+            // end-search-list
+
+            // start-search-update
+            Document newIndex = new Document("mappings", new Document("dynamic", true));
+            Publisher<Void> publisher = collection.updateSearchIndex("<index name>", newIndex);
+            Mono.from(publisher).block();
+            // end-search-update
+
+            // start-search-delete
+            Publisher<Void> publisher = collection.dropIndex("<index name>");
+            Mono.from(publisher).block();
+            // end-search-delete
+
+            // start-text
+            Publisher<String> publisher = collection.createIndex(Indexes.text("<field name>"));
+            Mono.from(publisher).block();
+            // end-text
+
+            // start-geo
+            Publisher<String> publisher = collection.createIndex(Indexes.geo2dsphere("<GeoJSON object field>"));
+            Mono.from(publisher).block();
+            // end-geo
+
+            // start-unique
+            IndexOptions indexOptions = new IndexOptions().unique(true);
+            Publisher<String> publisher = collection.createIndex(Indexes.ascending("<field name>"), indexOptions);
+            Mono.from(publisher).block();
+            // end-unique
+
+            // start-wildcard
+            Publisher<String> publisher = collection.createIndex(Indexes.ascending("$**"));
+            Mono.from(publisher).block();
+            // end-wildcard
+
+            // start-clustered
+            ClusteredIndexOptions clusteredIndexOptions = new ClusteredIndexOptions(
+                    Indexes.ascending("_id"),
+                    true
+            );
+
+            CreateCollectionOptions createCollectionOptions= new CreateCollectionOptions()
+                    .clusteredIndexOptions(clusteredIndexOptions);
+
+            Publisher<Void> clusteredCollection = database.createCollection("<collection name>",
+                    createCollectionOptions);
+            Mono.from(clusteredCollection).block();
+            // end-clustered
+
+            // start-remove
+            Publisher<Void> publisher = collection.dropIndex("<index name>");
+            Mono.from(publisher).block();
+            // end-remove
+        }
+    }
+}

source/includes/usage-examples/sample-index-app-intro.rst

@@ -0,0 +1,11 @@
+You can use the following sample application to test the code examples on this
+page. To use the sample application, perform the following steps:
+
+1. Create a new Java project in your IDE.
+#. Install the {+driver-short+} in your Java project.
+#. Install the `Project Reactor library
+   <https://projectreactor.io/docs/core/release/reference/#getting>`__ in your
+   Java project.
+#. Copy the following code and paste it into a new Java file named ``IndexApp.java``.
+#. Copy a code example from this page and paste it on the specified lines in the
+   file.

source/includes/usage-examples/sample-index-application.java

@@ -0,0 +1,41 @@
+import com.mongodb.ConnectionString;
+import com.mongodb.MongoClientSettings;
+import com.mongodb.ServerApi;
+import com.mongodb.ServerApiVersion;
+
+import com.mongodb.client.model.ClusteredIndexOptions;
+import com.mongodb.client.model.CreateCollectionOptions;
+import com.mongodb.client.model.IndexOptions;
+import com.mongodb.client.model.Indexes;
+import com.mongodb.reactivestreams.client.*;
+import org.bson.Document;
+import org.reactivestreams.Publisher;
+import reactor.core.publisher.Flux;
+import reactor.core.publisher.Mono;
+
+public class IndexApp {
+    public static void main(String[] args) {
+        // Replace the placeholder with your Atlas connection string
+        String uri = "<connection string URI>";
+
+        // Construct a ServerApi instance using the ServerApi.builder() method
+        ServerApi serverApi = ServerApi.builder()
+                .version(ServerApiVersion.V1)
+                .build();
+
+        MongoClientSettings settings = MongoClientSettings.builder()
+                .applyConnectionString(new ConnectionString(uri))
+                .serverApi(serverApi)
+                .build();
+
+        // Create a new client and connect to the server
+        try (MongoClient mongoClient = MongoClients.create(settings)) {
+            MongoDatabase database = mongoClient.getDatabase("<database name>");
+            MongoCollection<Document> collection = database.getCollection("<collection name>");
+
+            // Start example code here
+
+            // End example code here
+        }
+    }
+}