DOCSP-19171: max hosts setting (#174)

* DOCSP-19171: max hosts setting

Author: Chris Cho

snooty.toml

@@ -1,5 +1,5 @@
 name = "java"
-title = "Java"
+title = "Java Sync"
 toc_landing_pages = [
     "/fundamentals/connection",
     "/fundamentals/crud",

source/fundamentals/connection/mongoclientsettings.txt

@@ -29,7 +29,7 @@ The following sections describe commonly used settings:
 MongoClient Settings
 --------------------
 
-You can control the behavior of your ``MongoClient`` by creating and passing in a 
+You can control the behavior of your ``MongoClient`` by creating and passing in a
 `MongoClientSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`__
 object to the `MongoClients.create() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoClients.html#create(com.mongodb.MongoClientSettings)>`__
 method.
@@ -52,7 +52,7 @@ settings to modify the driver's behavior:
    * - ``addCommandListener()``
      - Adds a listener for :ref:`command events <command-events-java>`.
 
-   * - ``applicationName​()``
+   * - ``applicationName()``
      - Sets the logical name of the application using the ``MongoClient``.
 
    * - ``applyConnectionString()``
@@ -74,7 +74,7 @@ settings to modify the driver's behavior:
      - Applies the ``SslSettings.Builder`` block and then sets the :ref:`TLS/SSL settings <mcs-ssl-settings>`.
 
    * - ``autoEncryptionSettings()``
-     - | Sets the :ref:`auto-encryption settings <auto-encryption-decryption-java>`. 
+     - | Sets the :ref:`auto-encryption settings <auto-encryption-decryption-java>`.
        |
        | If you omit ``keyVaultClient`` or set
        | ``bypassAutomaticEncryption`` to false in your
@@ -97,7 +97,7 @@ settings to modify the driver's behavior:
    * - ``credential()``
      - Sets the :ref:`credential <authentication-mechanisms-java>`.
 
-   * - ``readConcern​()``
+   * - ``readConcern()``
      - Sets the :manual:`read concern </reference/read-concern/>`.
 
    * - ``readPreference()``
@@ -106,10 +106,10 @@ settings to modify the driver's behavior:
    * - ``retryReads()``
      - Whether the driver should :manual:`retry reads </core/retryable-reads/>` if a network error occurs.
 
-   * - ``retryWrites​()``
+   * - ``retryWrites()``
      - Whether the driver should :manual:`retry writes </core/retryable-writes/>` if a network error occurs.
 
-   * - ``serverApi​()``
+   * - ``serverApi()``
      - Sets the :ref:`server API <versioned-api-java>` to use when sending commands to the server.
 
    * - ``streamFactoryFactory()``
@@ -118,7 +118,7 @@ settings to modify the driver's behavior:
    * - ``uuidRepresentation()``
      - Sets the UUID representation to use when encoding instances of UUID and decoding BSON binary values with subtype of 3.
 
-   * - ``writeConcern​()``
+   * - ``writeConcern()``
      - Sets the :manual:`write concern </reference/write-concern/>`.
 
 .. _connection-string-example:
@@ -186,22 +186,22 @@ settings to modify the driver's behavior:
    * - Method
      - Description
 
-   * - ``addClusterListener​()``
+   * - ``addClusterListener()``
      - Adds a listener for cluster-related events.
 
-   * - ``applyConnectionString​()``
+   * - ``applyConnectionString()``
      - Uses the settings from a ``ConnectionString`` object.
 
    * - ``applySettings()``
      - Uses the cluster settings specified in a ``ClusterSettings`` object.
 
-   * - ``hosts​()``
+   * - ``hosts()``
      - Sets all the specified locations of a Mongo server.
 
    * - ``localThreshold()``
      - Sets the amount of time that a server’s round trip can take and still be eligible for server selection.
 
-   * - ``mode​()``
+   * - ``mode()``
      - Sets how to connect to a MongoDB server.
 
    * - ``requiredClusterType()``
@@ -218,23 +218,30 @@ settings to modify the driver's behavior:
 
    * - ``srvHost()``
      - Sets the host name to use to look up an SRV DNS record to find the MongoDB hosts.
-     
+
        .. note::
-        
+
           When setting ``srvHost``, the driver does not process any
-          associated TXT records associated with the host. 
+          associated TXT records associated with the host.
 
           If you want to enable the processing of TXT records, you must
-          specify the SRV host in the connection string using the 
+          specify the SRV host in the connection string using the
           ``applyConnectionString()`` method.
 
           .. code-block:: java
              :emphasize-lines: 3
-        
+
              MongoClient mongoClient = MongoClients.create(
                 MongoClientSettings.builder()
                    .applyConnectionString(new ConnectionString("mongodb+srv://host1.acme.com")))
 
+   * - ``srvMaxHosts()``
+     - | Sets the maximum number of hosts the driver can connect to when using 
+         the DNS seedlist (SRV) connection protocol, identified by the 
+         ``mongodb+srv`` connection string prefix. 
+       |
+       | Throws an exception if you are not using the SRV connection protocol.
+
 Example
 ~~~~~~~
 
@@ -273,7 +280,7 @@ settings to modify the driver's behavior:
    * - Method
      - Description
 
-   * - ``applyConnectionString​()``
+   * - ``applyConnectionString()``
      - Uses the settings from a ``ConnectionString`` object.
 
    * - ``applySettings()``
@@ -312,7 +319,7 @@ Connection Pool Settings
 ------------------------
 
 Chain the `applyToConnectionPoolSettings() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#applyToConnectionPoolSettings(com.mongodb.Block)>`__
-method to modify the way the driver manages its' connection pool.
+method to modify the way the driver manages its connection pool.
 
 The following table describes all the methods you can chain to your
 settings to modify the driver's behavior:
@@ -324,10 +331,10 @@ settings to modify the driver's behavior:
    * - Method
      - Description
 
-   * - ``addConnectionPoolListener​()``
+   * - ``addConnectionPoolListener()``
      - Adds a listener for connection pool-related events.
 
-   * - ``applyConnectionString​()``
+   * - ``applyConnectionString()``
      - Uses the settings from a ``ConnectionString`` object.
 
    * - ``applySettings()``
@@ -354,6 +361,7 @@ settings to modify the driver's behavior:
    * - ``minSize()``
      - Sets the minimum amount of connections associated with a connection pool.
 
+
 .. note::
 
    This ``maxSize`` and ``minSize`` settings apply to each server
@@ -401,10 +409,10 @@ settings to modify the driver's behavior:
    * - ``addServerListener()``
      - Adds a listener for server-related events.
 
-   * - ``addServerMonitorListener​()``
+   * - ``addServerMonitorListener()``
      - Adds a listener for server monitor-related events.
 
-   * - ``applyConnectionString​()``
+   * - ``applyConnectionString()``
      - Uses the settings from a ``ConnectionString`` object.
 
    * - ``applySettings()``
@@ -421,7 +429,7 @@ Example
 
 This example specifies the following driver behavior in a MongoDB server:
 
-- The minimum interval for server monitoring checks to be at least ``700 MILLISECONDS`` 
+- The minimum interval for server monitoring checks to be at least ``700 MILLISECONDS``
 - The cluster monitor to attempt reaching a server every ``15 SECONDS``
 
 .. literalinclude:: /includes/fundamentals/code-snippets/mcs.java
@@ -450,7 +458,7 @@ settings to modify the driver's behavior:
    * - Method
      - Description
 
-   * - ``applyConnectionString​()``
+   * - ``applyConnectionString()``
      - Uses the settings from a ``ConnectionString`` object.
 
    * - ``applySettings()``