Update reference docs for legacy MongoClient API to use MongoClientSettings and ConnectionString

JAVA-3659

Author: jyemin

docs/reference/content/driver/getting-started/quick-start-pojo.md

@@ -30,7 +30,7 @@ that can be found with the driver source on github.
 ```java
 import com.mongodb.Block;
 import com.mongodb.MongoClient;
-import com.mongodb.MongoClientURI;
+import com.mongodb.MongoClientSettings;
 import com.mongodb.client.MongoCollection;
 import com.mongodb.client.MongoDatabase;
 import com.mongodb.client.result.DeleteResult;

docs/reference/content/driver/getting-started/quick-start.md

@@ -35,7 +35,7 @@ Legacy MongoClient API:
 
 ```java
 import com.mongodb.MongoClient;
-import com.mongodb.MongoClientURI;
+import com.mongodb.ConnectionString;
 ```
 
 And the common elements between the legacy and new APIs:
@@ -130,21 +130,13 @@ MongoClient mongoClient = new MongoClient();
 - You can explicitly specify the hostname to connect to a MongoDB instance running on the specified host on port ``27017``:
 
 ```java
-MongoClient mongoClient = new MongoClient( "hostOne" );
-```
-
-- You can explicitly specify the hostname and the port:
-
-```java
-MongoClient mongoClient = new MongoClient( "hostOne" , 27018 );
+MongoClient mongoClient = new MongoClient("mongodb://hostOne");
 ```
 
-- You can specify the
-[`MongoClientURI`]({{< apiref "mongodb-driver-core" "com/mongodb/MongoClientURI.html" >}}) connection string:
+- You can explicitly specify the hostname and port:
 
 ```java
- MongoClientURI connectionString = new MongoClientURI("mongodb://hostOne:27017,hostTwo:27017");
- MongoClient mongoClient = new MongoClient(connectionString);
+MongoClient mongoClient = new MongoClient("mongodb://hostOne:27018");
 ```
 
 The connection string mostly follows [RFC 3986](http://tools.ietf.org/html/rfc3986), with the exception of the domain name. For MongoDB, 

docs/reference/content/driver/reference/monitoring.md

@@ -49,7 +49,7 @@ The driver implements the
 [command monitoring specification](https://github.com/mongodb/specifications/blob/master/source/command-monitoring/command-monitoring.rst),
 allowing an application to be notified when a command starts and when it either succeeds or fails.
 
-An application registers command listeners with a `MongoClient` by configuring `MongoClientOptions` with instances of classes
+An application registers command listeners with a `MongoClient` by configuring `MongoClientSettings` with instances of classes
 that implement the [`CommandListener`]({{< apiref "mongodb-driver-core" "com/mongodb/event/CommandListener" >}}) interface. Consider the following, somewhat
 simplistic, implementation of the `CommandListener` interface:
 
@@ -113,7 +113,7 @@ The driver implements the
 [SDAM Monitoring specification](https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring-monitoring.rst),
 allowing an application to be notified when the driver detects changes to the topology of the MongoDB cluster to which it is connected.
 
-An application registers listeners with a `MongoClient` by configuring  `MongoClientOptions` with instances of classes that
+An application registers listeners with a `MongoClient` by configuring `MongoClientSettings` with instances of classes that
 implement any of the [`ClusterListener`]({{< apiref "mongodb-driver-core" "com/mongodb/event/ClusterListener" >}}),
  [`ServerListener`]({{< apiref "mongodb-driver-core" "com/mongodb/event/ServerListener" >}}),
 or [`ServerMonitorListener`]({{< apiref "mongodb-driver-core" "com/mongodb/event/ServerMonitorListener" >}}) interfaces.
@@ -194,7 +194,7 @@ and when that MongoClient is closed.  In addition, it will print a message when
 
 The driver supports monitoring of connection pool-related events.
 
-An application registers listeners with a `MongoClient` by configuring `MongoClientOptions` with instances of classes that
+An application registers listeners with a `MongoClient` by configuring `MongoClientSettings` with instances of classes that
 implement the [`ConnectionPoolListener`]({{< apiref "mongodb-driver-core" "com/mongodb/event/ConnectionPoolListener" >}}) interface.
 
 Consider the following, simplistic, example of a connection pool listener:

docs/reference/content/driver/tutorials/authentication.md

@@ -31,15 +31,16 @@ Legacy MongoClient API:
 
 ```java
 import com.mongodb.MongoClient;
-import com.mongodb.MongoClientURI;
+import com.mongodb.ConnectionString;
 ```
 
 An authentication credential is represented as an instance of the
 [`MongoCredential`]({{< apiref "mongodb-driver-core" "com/mongodb/MongoCredential.html" >}}) class. The [`MongoCredential`]({{< apiref "mongodb-driver-core" "com/mongodb/MongoCredential.html" >}}) class includes static
 factory methods for each of the supported authentication mechanisms.
 
-You can also use a [`MongoClientURI`]({{< apiref "mongodb-driver-core" "com/mongodb/MongoClientURI.html" >}}) and pass it to a
-[`MongoClient()`]({{< apiref "mongodb-driver-sync" "com/mongodb/client/MongoClient.html" >}}) constructor that takes a `MongoClientURI` parameter.
+You can also use a [`ConnectionString`]({{< apiref "mongodb-driver-core" "com/mongodb/ConnectionString.html" >}}) and pass it to a
+[`MongoClient()`]({{< apiref "mongodb-driver-legacy" "com/mongodb/MongoClient.html" >}}) constructor that takes a `ConnectionString` 
+parameter.
 
 ## Default Authentication Mechanism
 
@@ -76,7 +77,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string without explicitly specifying the authentication mechanism. Using the new MongoClient API:
@@ -88,8 +94,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://user1:pwd1@host1/?authS
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://user1:pwd1@host1/?authSource=db1");
-MongoClient mongoClient = new MongoClient(uri);
+MongoClient mongoClient = new MongoClient("mongodb://user1:pwd1@host1/?authSource=db1");
 ```
 
 For challenge and response mechanisms, using the default authentication mechanism is the recommended approach as it will make upgrading
@@ -136,7 +141,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string that explicitly specifies the `authMechanism=SCRAM-SHA-256`. Using the new MongoClient API:
@@ -148,8 +158,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://user1:pwd1@host1/?authS
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=SCRAM-SHA-256");
-MongoClient mongoClient = new MongoClient(uri);
+MongoClient mongoClient = new MongoClient("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=SCRAM-SHA-256");
 ```
 
 
@@ -181,7 +190,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string that explicitly specifies the `authMechanism=SCRAM-SHA-1`. Using the new MongoClient API:
@@ -193,8 +207,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://user1:pwd1@host1/?authS
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=SCRAM-SHA-1");
-MongoClient mongoClient = new MongoClient(uri);
+MongoClient mongoClient = new MongoClient("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=SCRAM-SHA-1");
 ```
 
 ## MONGODB-CR
@@ -232,7 +245,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string that explicitly specifies the `authMechanism=MONGODB-CR`. Using the new MongoClient API:
@@ -244,8 +262,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://user1:pwd1@host1/?authS
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=MONGODB-CR");
-MongoClient mongoClient = new MongoClient(uri);
+MongoClient mongoClient = new MongoClient("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=MONGODB-CR");
 ```
 
 {{% note %}}
@@ -285,8 +302,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClientOptions options = MongoClientOptions.builder().sslEnabled(true).build();
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential, options);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string that explicitly specifies the `authMechanism=MONGODB-X509`. Using the new MongoClient API:
@@ -298,8 +319,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://subjectName@host1/?auth
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://subjectName@host1/?authMechanism=MONGODB-X509&ssl=true");
-MongoClient mongoClient = new MongoClient(uri);
+MongoClient mongoClient = new MongoClient("mongodb://subjectName@host1/?authMechanism=MONGODB-X509&ssl=true");
 ```
 
 See the MongoDB server [x.509 tutorial]({{<docsref "tutorial/configure-x509-client-authentication/#add-x-509-certificate-subject-as-a-user" >}})
@@ -434,7 +454,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string that explicitly specifies the `authMechanism=GSSAPI`. Using the new MongoClient API:
@@ -446,7 +471,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://username%40REALM.ME@hos
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://username%40REALM.ME@host1/?authMechanism=GSSAPI");
+MongoClient mongoClient = new MongoClient("mongodb://username%40REALM.ME@host1/?authMechanism=GSSAPI");
 ```
 {{% note %}}
 
@@ -528,7 +553,12 @@ MongoClient mongoClient = MongoClients.create(
 or using the legacy MongoClient API:
 
 ```java
-MongoClient mongoClient = new MongoClient(new ServerAddress("host1", 27017), credential);
+MongoClient mongoClient = new MongoClient(
+        MongoClientSettings.builder()
+                .applyToClusterSettings(builder ->
+                        builder.hosts(Arrays.asList(new ServerAddress("host1", 27017))))
+                .credential(credential)
+                .build());
 ```
 
 Or use a connection string that explicitly specifies the `authMechanism=PLAIN`.  Using the new MongoClient API:
@@ -540,7 +570,7 @@ MongoClient mongoClient = MongoClients.create("mongodb://user1@host1/?authSource
 or using the legacy MongoClient API:
 
 ```java
-MongoClientURI uri = new MongoClientURI("mongodb://user1@host1/?authSource=$external&authMechanism=PLAIN");
+MongoClient mongoClient = new MongoClient("mongodb://user1@host1/?authSource=$external&authMechanism=PLAIN");
 ```
 
 {{% note %}}

docs/reference/content/driver/tutorials/compression.md

@@ -21,7 +21,7 @@ release.
 The driver will negotiate which, if any, compression algorithm is used based on capabilities advertised by the server in
 the [ismaster]({{<docsref "reference/command/isMaster/" >}}) command response. 
 
-### Specify compression via `MongoClientURI`
+### Specify compression via `ConnectionString`
 
 ```java
 import com.mongodb.ConnectionString;