Summary

This PR refactors the MultiDb API to improve clarity and maintainability through two major changes:

1. Renamed endpoint-related methods to use database-centric terminology
2. Encapsulated retry and circuit breaker configuration into dedicated nested config classes

Changes

1. Endpoint → Database Terminology (Commits: "Rename MultiDbClient endpoint related methods", "Methods Renamed in MultiDbConfig.Builder")

Renamed all endpoint-related methods to use "database" terminology for better clarity:

MultiDbClient methods:

• addEndpoint() → addDatabase()
• removeEndpoint() → removeDatabase()
• forceActiveEndpoint() → forceActiveDatabase()
• getActiveEndpoint() → getActiveDatabaseEndpoint()
• getEndpoints() → getDatabaseEndpoints()

MultiDbConfig.Builder methods:

• endpoint() → database() (both overloaded variants)

2. RetryConfig Encapsulation

• Created MultiDbConfig.RetryConfig nested class with builder pattern
• Removed individual retry fields and methods:
  • retryMaxAttempts → RetryConfig.maxAttempts
  • retryWaitDuration → RetryConfig.waitDuration
  • retryWaitDurationExponentialBackoffMultiplier → RetryConfig.exponentialBackoffMultiplier
  • retryIncludedExceptionList → RetryConfig.includedExceptionList
  • retryIgnoreExceptionList → RetryConfig.ignoreExceptionList
• Added single commandRetry property with commandRetry(RetryConfig) builder method

3. CircuitBreakerConfig Encapsulation

• Created MultiDbConfig.CircuitBreakerConfig nested class with builder pattern
• Removed individual circuit breaker fields and methods:
  • circuitBreakerFailureRateThreshold → CircuitBreakerConfig.failureRateThreshold
  • circuitBreakerSlidingWindowSize → CircuitBreakerConfig.slidingWindowSize
  • circuitBreakerMinNumOfFailures → CircuitBreakerConfig.minNumOfFailures
  • circuitBreakerIncludedExceptionList → CircuitBreakerConfig.includedExceptionList
  • circuitBreakerIgnoreExceptionList → CircuitBreakerConfig.ignoreExceptionList
• Added single failureDetector property with failureDetector(CircuitBreakerConfig) builder method

4. Implementation Updates

• Updated MultiDbConnectionProvider with helper methods:
  • buildRetryConfig() - converts Jedis RetryConfig to Resilience4j RetryConfig
  • buildCircuitBreakerConfig() - converts Jedis CircuitBreakerConfig to Resilience4j CircuitBreakerConfig
• Updated CircuitBreakerThresholdsAdapter to use new API
• Preserved all original javadoc documentation with cross-references updated

5. Documentation Updates

• Updated all code examples in javadoc (4 files)
• Updated docs/failover.md with new API examples
• Maintained all inline comments and explanations

6. Test Updates

• Updated all test files to use new terminology and configuration API
• All tests pass successfully

API Changes

Endpoint → Database Renaming

Before:

MultiDbClient client = ...;
client.addEndpoint(databaseConfig);
client.removeEndpoint(endpoint);
client.forceActiveEndpoint(endpoint);
Endpoint active = client.getActiveEndpoint();
List<Endpoint> endpoints = client.getEndpoints();

MultiDbConfig.builder()
    .endpoint(databaseConfig)
    .build();

After:

MultiDbClient client = ...;
client.addDatabase(databaseConfig);
client.removeDatabase(endpoint);
client.forceActiveDatabase(endpoint);
Endpoint active = client.getActiveDatabaseEndpoint();
List<Endpoint> endpoints = client.getDatabaseEndpoints();

MultiDbConfig.builder()
    .database(databaseConfig)
    .build();

Configuration changes

Before

MultiDbConfig.builder()
    .retryMaxAttempts(3)
    .retryWaitDuration(500)
    .retryWaitDurationExponentialBackoffMultiplier(2)
    .circuitBreakerSlidingWindowSize(3)
    .circuitBreakerMinNumOfFailures(2)
    .circuitBreakerFailureRateThreshold(50f)
    .build();

After (New API):

MultiDbConfig.builder()
    .commandRetry(MultiDbConfig.RetryConfig.builder()
        .maxAttempts(3)
        .waitDuration(500)
        .exponentialBackoffMultiplier(2)
        .build())
    .failureDetector(MultiDbConfig.CircuitBreakerConfig.builder()
        .slidingWindowSize(3)
        .minNumOfFailures(2)
        .failureRateThreshold(50f)
        .build())
    .build();