DOCSP-27922: connection updates atlas (#338)

* DOCSP-27922: update connection guide to have stableapi

* error msg fix

* CC PR fixes 1

* Chris feedback

* Chris feedback 2

* monospace

---------

Co-authored-by: Jordan Smith <[email protected]>

Author: rustagir

source/fundamentals/connection/connect.txt

@@ -77,12 +77,31 @@ In the example, we set two connection options: ``maxPoolSize=20`` and
 
 .. _connect-atlas-java-driver:
 
-The following code shows how you can use the sample connection URI in a client
-to connect to MongoDB.
+Atlas Connection Example
+------------------------
+
+To connect to a MongoDB deployment on Atlas, create a client. You can
+create a client that uses your connection string and other 
+client options by passing a ``MongoClientSettings`` object to the
+``MongoClients.create()`` method.
+
+To instantiate a ``MongoClientSettings`` object, use the builder method to specify
+your connection string and any other client options, and then call the ``build()``
+method. Chain the ``applyConnectionString()`` method to the builder to specify your
+connection URI.
+
+You can set the {+stable-api+} version client option to avoid
+breaking changes when you upgrade to a new server version. To 
+learn more about the {+stable-api+} feature, see the :ref:`{+stable-api+} page
+<stable-api-java>`.
+
+The following code shows how you can specify the connection string and
+the {+stable-api+} client option when connecting to a MongoDB
+deployment on Atlas and verify that the connection is successful:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/srv.java
    :language: java
-   :emphasize-lines: 17
+   :emphasize-lines: 16
 
 .. _java-other-ways-to-connect:
 

source/includes/fundamentals/code-snippets/srv.java

@@ -1,31 +1,40 @@
 package fundamentals;
 
+import com.mongodb.*;
 import org.bson.BsonDocument;
 import org.bson.BsonInt64;
 import org.bson.Document;
 import org.bson.conversions.Bson;
 
-import com.mongodb.MongoClientSettings;
-import com.mongodb.MongoException;
 import com.mongodb.client.MongoClient;
 import com.mongodb.client.MongoClients;
 import com.mongodb.client.MongoDatabase;
 
 public class MongoClientConnectionExample {
     public static void main(String[] args) {
-        // Replace the uri string with your MongoDB deployment's connection string
-        String uri = "mongodb://user:[email protected]:27017/?maxPoolSize=20&w=majority";
+        // Replace the placeholders with your credentials and hostname
+        String uri = "mongodb+srv://<username>:<password>@<hostname>/?retryWrites=true&w=majority";
 
-        try (MongoClient mongoClient = MongoClients.create(uri)) {
+        // Construct a ServerApi instance using the ServerApi.builder() method
+        ServerApi serverApi = ServerApi.builder()
+                .version(ServerApiVersion.V1)
+                .build();
 
-            MongoDatabase database = mongoClient.getDatabase("admin");
+        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("admin");
             try {
+                // Send a ping to confirm a successful connection
                 Bson command = new BsonDocument("ping", new BsonInt64(1));
                 Document commandResult = database.runCommand(command);
-                System.out.println("Connected successfully to server.");
+                System.out.println("Pinged your deployment. You successfully connected to MongoDB!");
             } catch (MongoException me) {
-                System.err.println("An error occurred while attempting to run a command: " + me);
+                System.err.println(me);
             }
         }
     }