Skip to content

Commit 79cd686

Browse files
committed
Rename MultiDatabaseConnectionProvider to MultiDbConnectionProvider
1 parent 12d50a4 commit 79cd686

32 files changed

+219
-241
lines changed

src/main/java/redis/clients/jedis/MultiDbClient.java

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
import redis.clients.jedis.mcf.MultiClusterPipeline;
1010
import redis.clients.jedis.mcf.MultiClusterTransaction;
1111
import redis.clients.jedis.providers.ConnectionProvider;
12-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider;
12+
import redis.clients.jedis.mcf.MultiDbConnectionProvider;
1313

1414
import java.util.Set;
1515

@@ -76,7 +76,7 @@
7676
* </p>
7777
* @author Ivo Gaydazhiev
7878
* @since 5.2.0
79-
* @see MultiDatabaseConnectionProvider
79+
* @see MultiDbConnectionProvider
8080
* @see CircuitBreakerCommandExecutor
8181
* @see MultiDbConfig
8282
*/
@@ -91,7 +91,7 @@ public class MultiDbClient extends UnifiedJedis {
9191
* {@link #builder()} to create instances.
9292
* </p>
9393
* @param commandExecutor the command executor (typically CircuitBreakerCommandExecutor)
94-
* @param connectionProvider the connection provider (typically MultiDatabaseConnectionProvider)
94+
* @param connectionProvider the connection provider (typically MultiDbConnectionProvider)
9595
* @param commandObjects the command objects
9696
* @param redisProtocol the Redis protocol version
9797
* @param cache the client-side cache (may be null)
@@ -102,16 +102,16 @@ public class MultiDbClient extends UnifiedJedis {
102102
}
103103

104104
/**
105-
* Returns the underlying MultiDatabaseConnectionProvider.
105+
* Returns the underlying MultiDbConnectionProvider.
106106
* <p>
107107
* This provides access to multi-cluster specific operations like manual failover, health status
108108
* monitoring, and cluster switch event handling.
109109
* </p>
110110
* @return the multi-cluster connection provider
111-
* @throws ClassCastException if the provider is not a MultiDatabaseConnectionProvider
111+
* @throws ClassCastException if the provider is not a MultiDbConnectionProvider
112112
*/
113-
private MultiDatabaseConnectionProvider getMultiDatabaseConnectionProvider() {
114-
return (MultiDatabaseConnectionProvider) this.provider;
113+
private MultiDbConnectionProvider getMultiDbConnectionProvider() {
114+
return (MultiDbConnectionProvider) this.provider;
115115
}
116116

117117
/**
@@ -123,7 +123,7 @@ private MultiDatabaseConnectionProvider getMultiDatabaseConnectionProvider() {
123123
* @param endpoint the endpoint to switch to
124124
*/
125125
public void setActiveDatabase(Endpoint endpoint) {
126-
getMultiDatabaseConnectionProvider().setActiveDatabase(endpoint);
126+
getMultiDbConnectionProvider().setActiveDatabase(endpoint);
127127
}
128128

129129
/**
@@ -136,7 +136,7 @@ public void setActiveDatabase(Endpoint endpoint) {
136136
* @param databaseConfig the pre-configured database configuration
137137
*/
138138
public void addEndpoint(DatabaseConfig databaseConfig) {
139-
getMultiDatabaseConnectionProvider().add(databaseConfig);
139+
getMultiDbConnectionProvider().add(databaseConfig);
140140
}
141141

142142
/**
@@ -155,7 +155,7 @@ public void addEndpoint(Endpoint endpoint, float weight, JedisClientConfig clien
155155
DatabaseConfig databaseConfig = DatabaseConfig.builder(endpoint, clientConfig).weight(weight)
156156
.build();
157157

158-
getMultiDatabaseConnectionProvider().add(databaseConfig);
158+
getMultiDbConnectionProvider().add(databaseConfig);
159159
}
160160

161161
/**
@@ -166,7 +166,7 @@ public void addEndpoint(Endpoint endpoint, float weight, JedisClientConfig clien
166166
* @return the set of all configured endpoints
167167
*/
168168
public Set<Endpoint> getEndpoints() {
169-
return getMultiDatabaseConnectionProvider().getEndpoints();
169+
return getMultiDbConnectionProvider().getEndpoints();
170170
}
171171

172172
/**
@@ -178,7 +178,7 @@ public Set<Endpoint> getEndpoints() {
178178
* @return the health status of the endpoint
179179
*/
180180
public boolean isHealthy(Endpoint endpoint) {
181-
return getMultiDatabaseConnectionProvider().isHealthy(endpoint);
181+
return getMultiDbConnectionProvider().isHealthy(endpoint);
182182
}
183183

184184
/**
@@ -194,7 +194,7 @@ public boolean isHealthy(Endpoint endpoint) {
194194
* healthy clusters available
195195
*/
196196
public void removeEndpoint(Endpoint endpoint) {
197-
getMultiDatabaseConnectionProvider().remove(endpoint);
197+
getMultiDbConnectionProvider().remove(endpoint);
198198
}
199199

200200
/**
@@ -210,7 +210,7 @@ public void removeEndpoint(Endpoint endpoint) {
210210
* or doesn't exist
211211
*/
212212
public void forceActiveEndpoint(Endpoint endpoint, long forcedActiveDurationMs) {
213-
getMultiDatabaseConnectionProvider().forceActiveDatabase(endpoint, forcedActiveDurationMs);
213+
getMultiDbConnectionProvider().forceActiveDatabase(endpoint, forcedActiveDurationMs);
214214
}
215215

216216
/**
@@ -223,7 +223,7 @@ public void forceActiveEndpoint(Endpoint endpoint, long forcedActiveDurationMs)
223223
*/
224224
@Override
225225
public MultiClusterPipeline pipelined() {
226-
return new MultiClusterPipeline(getMultiDatabaseConnectionProvider(), commandObjects);
226+
return new MultiClusterPipeline(getMultiDbConnectionProvider(), commandObjects);
227227
}
228228

229229
/**
@@ -236,8 +236,7 @@ public MultiClusterPipeline pipelined() {
236236
*/
237237
@Override
238238
public MultiClusterTransaction multi() {
239-
return new MultiClusterTransaction((MultiDatabaseConnectionProvider) provider, true,
240-
commandObjects);
239+
return new MultiClusterTransaction((MultiDbConnectionProvider) provider, true, commandObjects);
241240
}
242241

243242
/**
@@ -251,12 +250,11 @@ public MultiClusterTransaction transaction(boolean doMulti) {
251250
"It is not allowed to create Transaction from this " + getClass());
252251
}
253252

254-
return new MultiClusterTransaction(getMultiDatabaseConnectionProvider(), doMulti,
255-
commandObjects);
253+
return new MultiClusterTransaction(getMultiDbConnectionProvider(), doMulti, commandObjects);
256254
}
257255

258256
public Endpoint getActiveEndpoint() {
259-
return getMultiDatabaseConnectionProvider().getDatabase().getEndpoint();
257+
return getMultiDbConnectionProvider().getDatabase().getEndpoint();
260258
}
261259

262260
/**

src/main/java/redis/clients/jedis/MultiDbConfig.java

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
* This configuration enables seamless failover between multiple Redis clusters, databases, or
2222
* endpoints by providing comprehensive settings for retry logic, circuit breaker behavior, health
2323
* checks, and failback mechanisms. It is designed to work with
24-
* {@link redis.clients.jedis.mcf.MultiDatabaseConnectionProvider} to provide high availability and
24+
* {@link redis.clients.jedis.mcf.MultiDbConnectionProvider} to provide high availability and
2525
* disaster recovery capabilities.
2626
* </p>
2727
* <p>
@@ -61,14 +61,14 @@
6161
* .gracePeriod(10000).build();
6262
*
6363
* // Use with connection provider
64-
* MultiDatabaseConnectionProvider provider = new MultiDatabaseConnectionProvider(config);
64+
* MultiDbConnectionProvider provider = new MultiDbConnectionProvider(config);
6565
* }
6666
* </pre>
6767
* <p>
6868
* The configuration leverages <a href="https://resilience4j.readme.io/docs">Resilience4j</a> for
6969
* circuit breaker and retry implementations, providing battle-tested fault tolerance patterns.
7070
* </p>
71-
* @see redis.clients.jedis.mcf.MultiDatabaseConnectionProvider
71+
* @see redis.clients.jedis.mcf.MultiDbConnectionProvider
7272
* @see redis.clients.jedis.mcf.HealthCheckStrategy
7373
* @see redis.clients.jedis.mcf.EchoStrategy
7474
* @see redis.clients.jedis.mcf.LagAwareStrategy
@@ -451,7 +451,7 @@ public static interface StrategySupplier {
451451
public MultiDbConfig(DatabaseConfig[] databaseConfigs) {
452452

453453
if (databaseConfigs == null || databaseConfigs.length < 1) throw new JedisValidationException(
454-
"DatabaseClientConfigs are required for MultiDatabaseConnectionProvider");
454+
"DatabaseClientConfigs are required for MultiDbConnectionProvider");
455455

456456
for (DatabaseConfig databaseConfig : databaseConfigs) {
457457
if (databaseConfig == null)
@@ -976,8 +976,7 @@ public DatabaseConfig build() {
976976
}
977977

978978
/**
979-
* Builder class for creating MultiDbConfig instances with comprehensive configuration
980-
* options.
979+
* Builder class for creating MultiDbConfig instances with comprehensive configuration options.
981980
* <p>
982981
* The Builder provides a fluent API for configuring all aspects of multi-cluster failover
983982
* behavior, including retry logic, circuit breaker settings, and failback mechanisms. It uses
@@ -1509,8 +1508,7 @@ public Builder delayInBetweenFailoverAttempts(int delayInBetweenFailoverAttempts
15091508
*/
15101509
public MultiDbConfig build() {
15111510

1512-
MultiDbConfig config = new MultiDbConfig(
1513-
this.databaseConfigs.toArray(new DatabaseConfig[0]));
1511+
MultiDbConfig config = new MultiDbConfig(this.databaseConfigs.toArray(new DatabaseConfig[0]));
15141512

15151513
// Copy retry configuration
15161514
config.retryMaxAttempts = this.retryMaxAttempts;

src/main/java/redis/clients/jedis/UnifiedJedis.java

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
import redis.clients.jedis.json.JsonObjectMapper;
3535
import redis.clients.jedis.mcf.CircuitBreakerCommandExecutor;
3636
import redis.clients.jedis.mcf.MultiClusterPipeline;
37-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider;
37+
import redis.clients.jedis.mcf.MultiDbConnectionProvider;
3838
import redis.clients.jedis.mcf.MultiClusterTransaction;
3939
import redis.clients.jedis.params.*;
4040
import redis.clients.jedis.providers.*;
@@ -240,7 +240,7 @@ public UnifiedJedis(ConnectionProvider provider, int maxAttempts, Duration maxTo
240240
* <p>
241241
*/
242242
@Experimental
243-
public UnifiedJedis(MultiDatabaseConnectionProvider provider) {
243+
public UnifiedJedis(MultiDbConnectionProvider provider) {
244244
this(new CircuitBreakerCommandExecutor(provider), provider);
245245
}
246246

@@ -5099,8 +5099,8 @@ public List<Double> tdigestByRevRank(String key, long... ranks) {
50995099
public PipelineBase pipelined() {
51005100
if (provider == null) {
51015101
throw new IllegalStateException("It is not allowed to create Pipeline from this " + getClass());
5102-
} else if (provider instanceof MultiDatabaseConnectionProvider) {
5103-
return new MultiClusterPipeline((MultiDatabaseConnectionProvider) provider, commandObjects);
5102+
} else if (provider instanceof MultiDbConnectionProvider) {
5103+
return new MultiClusterPipeline((MultiDbConnectionProvider) provider, commandObjects);
51045104
} else {
51055105
return new Pipeline(provider.getConnection(), true, commandObjects);
51065106
}
@@ -5120,8 +5120,8 @@ public AbstractTransaction multi() {
51205120
public AbstractTransaction transaction(boolean doMulti) {
51215121
if (provider == null) {
51225122
throw new IllegalStateException("It is not allowed to create Transaction from this " + getClass());
5123-
} else if (provider instanceof MultiDatabaseConnectionProvider) {
5124-
return new MultiClusterTransaction((MultiDatabaseConnectionProvider) provider, doMulti, commandObjects);
5123+
} else if (provider instanceof MultiDbConnectionProvider) {
5124+
return new MultiClusterTransaction((MultiDbConnectionProvider) provider, doMulti, commandObjects);
51255125
} else {
51265126
return new Transaction(provider.getConnection(), doMulti, true, commandObjects);
51275127
}

src/main/java/redis/clients/jedis/builders/MultiDbClientBuilder.java

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
import redis.clients.jedis.executors.CommandExecutor;
88
import redis.clients.jedis.mcf.CircuitBreakerCommandExecutor;
99
import redis.clients.jedis.mcf.ClusterSwitchEventArgs;
10-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider;
10+
import redis.clients.jedis.mcf.MultiDbConnectionProvider;
1111
import redis.clients.jedis.providers.ConnectionProvider;
1212

1313
/**
@@ -113,7 +113,7 @@ protected ConnectionProvider createDefaultConnectionProvider() {
113113
}
114114

115115
// Create the multi-cluster connection provider
116-
MultiDatabaseConnectionProvider provider = new MultiDatabaseConnectionProvider(multiDbConfig);
116+
MultiDbConnectionProvider provider = new MultiDbConnectionProvider(multiDbConfig);
117117

118118
// Set database switch listener if provided
119119
if (this.databaseSwitchListener != null) {
@@ -126,8 +126,7 @@ protected ConnectionProvider createDefaultConnectionProvider() {
126126
@Override
127127
protected CommandExecutor createDefaultCommandExecutor() {
128128
// For multi-db clients, we always use CircuitBreakerCommandExecutor
129-
return new CircuitBreakerCommandExecutor(
130-
(MultiDatabaseConnectionProvider) this.connectionProvider);
129+
return new CircuitBreakerCommandExecutor((MultiDbConnectionProvider) this.connectionProvider);
131130
}
132131

133132
@Override

src/main/java/redis/clients/jedis/mcf/CircuitBreakerCommandExecutor.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
import redis.clients.jedis.annots.Experimental;
1010
import redis.clients.jedis.exceptions.JedisConnectionException;
1111
import redis.clients.jedis.executors.CommandExecutor;
12-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider.Database;
12+
import redis.clients.jedis.mcf.MultiDbConnectionProvider.Database;
1313

1414
/**
1515
* @author Allen Terleto (aterleto)
@@ -24,7 +24,7 @@
2424
public class CircuitBreakerCommandExecutor extends CircuitBreakerFailoverBase
2525
implements CommandExecutor {
2626

27-
public CircuitBreakerCommandExecutor(MultiDatabaseConnectionProvider provider) {
27+
public CircuitBreakerCommandExecutor(MultiDbConnectionProvider provider) {
2828
super(provider);
2929
}
3030

src/main/java/redis/clients/jedis/mcf/CircuitBreakerFailoverBase.java

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
import java.util.concurrent.locks.ReentrantLock;
77

88
import redis.clients.jedis.annots.Experimental;
9-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider.Database;
9+
import redis.clients.jedis.mcf.MultiDbConnectionProvider.Database;
1010
import redis.clients.jedis.util.IOUtils;
1111

1212
/**
@@ -23,9 +23,9 @@
2323
public class CircuitBreakerFailoverBase implements AutoCloseable {
2424
private final Lock lock = new ReentrantLock(true);
2525

26-
protected final MultiDatabaseConnectionProvider provider;
26+
protected final MultiDbConnectionProvider provider;
2727

28-
public CircuitBreakerFailoverBase(MultiDatabaseConnectionProvider provider) {
28+
public CircuitBreakerFailoverBase(MultiDbConnectionProvider provider) {
2929
this.provider = provider;
3030
}
3131

src/main/java/redis/clients/jedis/mcf/CircuitBreakerFailoverConnectionProvider.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
import redis.clients.jedis.Connection;
88
import redis.clients.jedis.annots.Experimental;
9-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider.Database;
9+
import redis.clients.jedis.mcf.MultiDbConnectionProvider.Database;
1010

1111
/**
1212
* ConnectionProvider with built-in retry, circuit-breaker, and failover to another cluster/database
@@ -16,7 +16,7 @@
1616
@Experimental
1717
public class CircuitBreakerFailoverConnectionProvider extends CircuitBreakerFailoverBase {
1818

19-
public CircuitBreakerFailoverConnectionProvider(MultiDatabaseConnectionProvider provider) {
19+
public CircuitBreakerFailoverConnectionProvider(MultiDbConnectionProvider provider) {
2020
super(provider);
2121
}
2222

src/main/java/redis/clients/jedis/mcf/CircuitBreakerThresholdsAdapter.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@
99
* <p>
1010
* This adapter sets maximum values for failure rate (100%) and minimum calls (Integer.MAX_VALUE) to
1111
* effectively disable Resilience4j's automatic circuit breaker transitions, allowing
12-
* {@link MultiDatabaseConnectionProvider.Database#evaluateThresholds(boolean)} to control when the
12+
* {@link MultiDbConnectionProvider.Database#evaluateThresholds(boolean)} to control when the
1313
* circuit breaker opens based on both minimum failure count AND failure rate.
1414
* </p>
15-
* @see MultiDatabaseConnectionProvider.Database#evaluateThresholds(boolean)
15+
* @see MultiDbConnectionProvider.Database#evaluateThresholds(boolean)
1616
*/
1717
class CircuitBreakerThresholdsAdapter {
1818
/** Maximum failure rate threshold (100%) to disable Resilience4j evaluation */

src/main/java/redis/clients/jedis/mcf/ClusterSwitchEventArgs.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
package redis.clients.jedis.mcf;
22

33
import redis.clients.jedis.Endpoint;
4-
import redis.clients.jedis.mcf.MultiDatabaseConnectionProvider.Database;
4+
import redis.clients.jedis.mcf.MultiDbConnectionProvider.Database;
55

66
public class ClusterSwitchEventArgs {
77

src/main/java/redis/clients/jedis/mcf/JedisFailoverException.java

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,7 @@ public JedisFailoverException() {
2929
* <p>
3030
* See the configuration properties
3131
* {@link redis.clients.jedis.MultiDbConfig#maxNumFailoverAttempts} and
32-
* {@link redis.clients.jedis.MultiDbConfig#delayInBetweenFailoverAttempts} for more
33-
* details.
32+
* {@link redis.clients.jedis.MultiDbConfig#delayInBetweenFailoverAttempts} for more details.
3433
*/
3534
public static class JedisPermanentlyNotAvailableException extends JedisFailoverException {
3635
public JedisPermanentlyNotAvailableException(String s) {
@@ -50,8 +49,7 @@ public JedisPermanentlyNotAvailableException() {
5049
* <p>
5150
* See the configuration properties
5251
* {@link redis.clients.jedis.MultiDbConfig#maxNumFailoverAttempts} and
53-
* {@link redis.clients.jedis.MultiDbConfig#delayInBetweenFailoverAttempts} for more
54-
* details.
52+
* {@link redis.clients.jedis.MultiDbConfig#delayInBetweenFailoverAttempts} for more details.
5553
*/
5654
public static class JedisTemporarilyNotAvailableException extends JedisFailoverException {
5755

0 commit comments

Comments
 (0)