Clarify behavior when "me" field doesn't match any values in "hosts" array

JAVA-3602

Author: rozza

driver-core/src/main/com/mongodb/internal/connection/AbstractMultiServerCluster.java

@@ -261,7 +261,8 @@ private boolean handleReplicaSetMemberChanged(final ServerDescription newDescrip
         ensureServers(newDescription);
 
         if (newDescription.getCanonicalAddress() != null
-                && !newDescription.getAddress().equals(new ServerAddress(newDescription.getCanonicalAddress()))) {
+                && !newDescription.getAddress().equals(new ServerAddress(newDescription.getCanonicalAddress()))
+                && !newDescription.isPrimary()) {
             if (LOGGER.isInfoEnabled()) {
                 LOGGER.info(format("Canonical address %s does not match server address.  Removing %s from client view of cluster",
                                    newDescription.getCanonicalAddress(), newDescription.getAddress()));

driver-core/src/test/resources/server-discovery-and-monitoring/rs/primary_mismatched_me_not_removed.json

@@ -0,0 +1,77 @@
+{
+  "description": "Primary mismatched me is not removed",
+  "uri": "mongodb://localhost:27017,localhost:27018/?replicaSet=rs",
+  "phases": [
+    {
+      "responses": [
+        [
+          "localhost:27017",
+          {
+            "ok": 1,
+            "hosts": [
+              "localhost:27017",
+              "localhost:27018"
+            ],
+            "ismaster": true,
+            "setName": "rs",
+            "primary": "localhost:27017",
+            "me": "a:27017",
+            "minWireVersion": 0,
+            "maxWireVersion": 7
+          }
+        ]
+      ],
+      "outcome": {
+        "servers": {
+          "localhost:27017": {
+            "type": "RSPrimary",
+            "setName": "rs"
+          },
+          "localhost:27018": {
+            "type": "Unknown",
+            "setName": null
+          }
+        },
+        "topologyType": "ReplicaSetWithPrimary",
+        "logicalSessionTimeoutMinutes": null,
+        "setName": "rs"
+      }
+    },
+    {
+      "responses": [
+        [
+          "localhost:27018",
+          {
+            "ok": 1,
+            "hosts": [
+              "localhost:27017",
+              "localhost:27018"
+            ],
+            "ismaster": false,
+            "secondary": true,
+            "setName": "rs",
+            "primary": "localhost:27017",
+            "me": "localhost:27018",
+            "minWireVersion": 0,
+            "maxWireVersion": 7
+          }
+        ]
+      ],
+      "outcome": {
+        "servers": {
+          "localhost:27017": {
+            "type": "RSPrimary",
+            "setName": "rs"
+          },
+          "localhost:27018": {
+            "type": "RSSecondary",
+            "setName": "rs"
+          }
+        },
+        "topologyType": "ReplicaSetWithPrimary",
+        "logicalSessionTimeoutMinutes": null,
+        "setName": "rs"
+      }
+    }
+  ]
+}