CLIENT-3603 Allow Replica.RANDOM on writes.

Author: paul-brackin

client/src/com/aerospike/client/cluster/Cluster.java

@@ -113,10 +113,10 @@ public class Cluster implements Runnable, Closeable {
 	// Password in hashed format in bytes.
 	private byte[] passwordHash;
 
-	// Random node index.
+	// Random node index counter.
 	private final AtomicInteger nodeIndex;
 
-	// Random partition replica index.
+	// Random partition replica index counter.
 	final AtomicInteger replicaIndex;
 
 	// Count of connections in recover queue.

client/src/com/aerospike/client/cluster/Partition.java

@@ -207,8 +207,9 @@ public Node getNodeWrite(Cluster cluster) {
 
 		case MASTER:
 		case MASTER_PROLES:
-		case RANDOM:
 			return getMasterNode(cluster);
+		case RANDOM:
+			return cluster.getRandomNode();
 		}
 	}
 

client/src/com/aerospike/client/policy/Replica.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2023 Aerospike, Inc.
+ * Copyright 2012-2025 Aerospike, Inc.
  *
  * Portions may be licensed to Aerospike, Inc. under one or more contributor
  * license agreements WHICH ARE COMPATIBLE WITH THE APACHE LICENSE, VERSION 2.0.
@@ -49,11 +49,16 @@ public enum Replica {
 	PREFER_RACK,
 
 	/**
-	 * Distribute reads across all nodes in cluster in round-robin fashion.
+	 * Distribute reads and writes across all nodes in cluster in round-robin fashion.
 	 * Writes always use node containing key's master partition.
 	 * <p>
-	 * This option is useful when the replication factor equals the number
+	 * This option is useful on reads when the replication factor equals the number
 	 * of nodes in the cluster and the overhead of requesting proles is not desired.
+	 * <p>
+	 * This option could temporarily be useful on writes when the client can't connect
+	 * to a node, but that node is reachable via a proxy from a different node.
+	 * <p>
+	 * This option can also be used to test server proxies.
 	 */
 	RANDOM;
 }