Docsp 16379 mongo client settings (#117)

Co-authored-by: Nathan <[email protected]>
Co-authored-by: Chris Cho <[email protected]>

Author: 3 people

source/faq.txt

@@ -41,6 +41,26 @@ For applications that require a mix of the new and legacy APIs, ``com.mongodb.Mo
 - Configuration with ``MongoClientSettings`` and ``ConnectionString``, the only difference being that you create instances via constructors instead of a factory class.
 - CRUD API using ``MongoDatabase``, and from there, ``MongoCollection``.  You can access this API via the ``getDatabase()`` method.
 
+How do I use the ``MongoClientSettings`` class?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can use the ``MongoClientSettings`` class to specify configurations for
+``MongoClient`` instances. To construct ``MongoClientSettings`` instances, use the
+``MongoClientSettings.Builder`` class. 
+
+Here are the sections of our documentation that show how to perform different
+tasks with the ``MongoClientSettings`` class:
+
+- :ref:`Specify Multiple Hosts <mongo-client-settings-multiple-hosts>`
+- :ref:`Enable TLS/SSL <tls-enable>`
+- :ref:`Authenticate with Credentials <mongo-client-setting-with-mongo-credential-example>`
+- :ref:`Enable Compression <enable-compression>`
+- :ref:`Add Listeners For Driver and Database Events <listener-mongo-client-settings-example>`
+- :ref:`Get the Default Codec Registry <get-default-codec-registry-example>`
+
+For more information on the ``MongoClientSettings`` class, see the 
+:java-docs:`API Documentation for MongoClientSettings <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`.
+
 POJOs
 -----
 

source/fundamentals/auth.txt

@@ -72,6 +72,8 @@ Select the :guilabel:`Connection String` or the :guilabel:`MongoCredential`
 tab below for instructions and sample code for specifying this authentication
 mechanism:
 
+.. _mongo-client-setting-with-mongo-credential-example:
+
 .. tabs::
 
    .. tab::

source/fundamentals/connection.txt

@@ -126,6 +126,37 @@ replica set named "myRs".
 
    mongodb://host1:27017,host2:27017,host3:27017
 
+.. _mongo-client-settings-multiple-hosts:
+
+The following examples show how to specify multiple hosts to a ``MongoClient``
+instance using either the ``ConnectionString`` or ``MongoClientSettings`` class.
+Select the tab corresponding to the code snippet you would like to see:
+
+.. tabs::
+
+   .. tab:: ConnectionString
+      :tabid: connectionstring
+
+      .. code-block:: java
+
+         ConnectionString connectionString = new ConnectionString("mongodb://host1:27017,host2:27017,host3:27017");
+         MongoClient mongoClient = MongoClients.create(connectionString);
+
+   .. tab:: MongoClientSettings
+      :tabid: mongoclientsettings
+
+      .. code-block:: java
+      
+         ServerAddress seed1 = new ServerAddress("host1", 27017);
+         ServerAddress seed2 = new ServerAddress("host2", 27017);
+         ServerAddress seed3 = new ServerAddress("host3", 27017);
+         MongoClientSettings settings = MongoClientSettings.builder()
+                 .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(seed1, seed2, seed3)))
+                 .build();
+         MongoClient mongoClient = MongoClients.create(settings);
+
+
 .. note::
 
    Although it is possible to connect to a replica set deployment by

source/fundamentals/data-formats/document-data-format-pojo.txt

@@ -153,6 +153,8 @@ requirements:
    - ``getDefaultCodecRegistry()`` to retrieve a ``CodecRegistry`` instance from a list of codec providers
    - ``fromProviders()`` to create a ``CodecRegistry`` instance from the ``PojoCodecProvider``
 
+   .. _get-default-codec-registry-example:
+
    See the code below to see how to instantiate the ``CodecRegistry``:
 
    .. code-block:: java

source/fundamentals/monitoring.txt

@@ -123,6 +123,8 @@ The following code adds an instance of the ``CommandCounter`` class to a
 ``MongoClientSettings`` object. The code then runs some database commands to test the
 counter.
 
+.. _listener-mongo-client-settings-example:
+
 .. literalinclude:: /includes/fundamentals/code-snippets/Monitoring.java
    :language: java
    :dedent: