refactor(jedis): migrate to Jedis 7.2 API with RedisClient

Replace all deprecated Jedis classes with the new unified Jedis 7.2 API:

- Upgrade Jedis dependency from 7.0.0 to 7.2.0
- Replace JedisPool/JedisPooled with RedisClient.create()
- Replace JedisSentinelPool with RedisSentinelClient.builder()
- Remove JedisPoolConfig dependency from RedisConnectionConfig
- Update SearchIndex to use unified getUnifiedJedis() method
- Update VCR infrastructure (VCRContext, VCRRegistry, VCRCassetteStore)
- Update all test base classes to use RedisClient
- Update LangChain4J stores and documentation examples
- Update demo applications (rag-multimodal, standalone)

The new Jedis 7.2 API provides:
- RedisClient for standalone connections
- RedisSentinelClient for HA deployments
- RedisClusterClient for cluster mode
- All extend UnifiedJedis for backwards compatibility

This removes deprecation warnings and modernizes the codebase
to use the recommended Jedis connection patterns.

Author: bsbodden

core/build.gradle.kts

@@ -8,8 +8,8 @@ plugins {
 description = "RedisVL - Vector Library for Java"
 
 dependencies {
-    // Redis client
-    api("redis.clients:jedis:7.0.0")
+    // Redis client - upgraded to 7.2.0 for new RedisClient/RedisSentinelClient API
+    api("redis.clients:jedis:7.2.0")
 
     // JSON processing
     implementation("com.fasterxml.jackson.core:jackson-databind:2.18.2")

core/src/main/java/com/redis/vl/index/SearchIndex.java

@@ -20,7 +20,7 @@
 import javax.annotation.Nonnull;
 import lombok.Getter;
 import lombok.extern.slf4j.Slf4j;
-import redis.clients.jedis.Jedis;
+import redis.clients.jedis.RedisClient;
 import redis.clients.jedis.UnifiedJedis;
 import redis.clients.jedis.search.FTCreateParams;
 import redis.clients.jedis.search.FTSearchParams;
@@ -48,7 +48,6 @@ public final class SearchIndex {
   private final IndexSchema schema;
 
   private final BaseStorage storage;
-  private Jedis client;
   private UnifiedJedis unifiedClient;
   @Getter private boolean validateOnLoad = false;
 
@@ -91,40 +90,6 @@ public SearchIndex(IndexSchema schema, boolean validateOnLoad) {
     }
     this.connectionManager = null;
     this.schema = schema;
-    this.client = null;
-    this.unifiedClient = null;
-    this.validateOnLoad = validateOnLoad;
-    this.storage = initializeStorage(schema);
-  }
-
-  /**
-   * Create a SearchIndex with schema and Jedis client
-   *
-   * @param schema Index schema definition
-   * @param client Jedis client for Redis operations
-   */
-  public SearchIndex(IndexSchema schema, Jedis client) {
-    this(schema, client, false);
-  }
-
-  /**
-   * Create a SearchIndex with schema, Jedis client, and validateOnLoad option
-   *
-   * @param schema Index schema definition
-   * @param client Jedis client for Redis operations
-   * @param validateOnLoad Whether to validate documents on load
-   */
-  public SearchIndex(IndexSchema schema, Jedis client, boolean validateOnLoad) {
-    if (schema == null) {
-      throw new IllegalArgumentException("Must provide a valid IndexSchema object");
-    }
-    if (client == null) {
-      throw new IllegalArgumentException("Jedis client cannot be null");
-    }
-    this.connectionManager = null;
-    this.schema = schema;
-    // Store the client - this is the expected usage pattern for this library
-    this.client = client;
     this.unifiedClient = null;
     this.validateOnLoad = validateOnLoad;
     this.storage = initializeStorage(schema);
@@ -156,10 +121,9 @@ public SearchIndex(IndexSchema schema, String redisUrl, boolean validateOnLoad)
     }
     this.connectionManager = null;
     this.schema = schema;
-    this.client = null;
     this.validateOnLoad = validateOnLoad;
-    // Create UnifiedJedis from URL
-    this.unifiedClient = new UnifiedJedis(redisUrl);
+    // Create RedisClient (extends UnifiedJedis) from URL - Jedis 7.2+ API
+    this.unifiedClient = RedisClient.create(redisUrl);
     this.storage = initializeStorage(schema);
   }
 
@@ -189,7 +153,6 @@ public SearchIndex(IndexSchema schema, UnifiedJedis unifiedClient, boolean valid
     }
     this.connectionManager = null;
     this.schema = schema;
-    this.client = null;
     this.validateOnLoad = validateOnLoad;
     // Store the client - this is the expected usage pattern for this library
     this.unifiedClient = unifiedClient;
@@ -439,24 +402,19 @@ public static SearchIndex fromExisting(String indexName, UnifiedJedis client) {
     return new SearchIndex(schema, client);
   }
 
-  /** Get Jedis connection from either connectionManager or direct client */
-  private Jedis getJedis() {
-    if (client != null) {
-      return client;
-    } else if (connectionManager != null) {
-      return connectionManager.getJedis();
-    } else {
-      throw new IllegalStateException("No Redis connection available for document operations");
-    }
-  }
-
-  /** Get UnifiedJedis for RediSearch operations */
+  /**
+   * Get UnifiedJedis for Redis operations.
+   *
+   * <p>Returns the client from either the direct unifiedClient field or from the connectionManager.
+   */
   private UnifiedJedis getUnifiedJedis() {
     if (unifiedClient != null) {
       return unifiedClient;
+    } else if (connectionManager != null) {
+      return connectionManager.getClient();
     } else {
       throw new IllegalStateException(
-          "RediSearch operations require UnifiedJedis client. Please use SearchIndex(schema, unifiedJedis) constructor.");
+          "No Redis connection available. Use SearchIndex(schema, unifiedJedis) or SearchIndex(connectionManager, schema) constructor.");
     }
   }
 
@@ -762,60 +720,8 @@ public String addDocument(String docId, Map<String, Object> document) {
     Map<String, Object> processedDocument = preprocessDocument(document);
     // Always validate document against schema when adding directly
     validateDocument(processedDocument);
-    // Use UnifiedJedis if available for consistency
-    if (unifiedClient != null) {
-      return addDocumentWithUnified(docId, processedDocument);
-    }
-
-    Jedis jedis = getJedis();
-    try {
-      if (getStorageType() == IndexSchema.StorageType.JSON) {
-        // For JSON storage, use RedisJSON commands
-
-        // Use JSON.SET command - Jedis doesn't have jsonSet, need UnifiedJedis
-        throw new IllegalStateException(
-            "JSON storage requires UnifiedJedis client. Use SearchIndex(schema, unifiedJedis) constructor.");
-      } else {
-        // For HASH storage - handle vectors specially
-        for (Map.Entry<String, Object> entry : processedDocument.entrySet()) {
-          String key = entry.getKey();
-          Object value = entry.getValue();
-
-          BaseField field = (schema != null) ? schema.getField(key) : null;
-          if (field instanceof VectorField && value != null) {
-            // Store vectors as binary data
-            byte[] vectorBytes = null;
-            if (value instanceof byte[]) {
-              // Already in byte array format
-              vectorBytes = (byte[]) value;
-            } else if (value instanceof float[]) {
-              vectorBytes = ArrayUtils.floatArrayToBytes((float[]) value);
-            } else if (value instanceof double[]) {
-              float[] floats = ArrayUtils.doubleArrayToFloats((double[]) value);
-              vectorBytes = ArrayUtils.floatArrayToBytes(floats);
-            }
-            if (vectorBytes != null) {
-              jedis.hset(
-                  docId.getBytes(StandardCharsets.UTF_8),
-                  key.getBytes(StandardCharsets.UTF_8),
-                  vectorBytes);
-            }
-          } else if (value != null) {
-            // Store other fields as strings
-            jedis.hset(docId, key, value.toString());
-          }
-        }
-      }
-
-      return docId;
-    } catch (Exception e) {
-      throw new RuntimeException("Failed to add document: " + e.getMessage(), e);
-    } finally {
-      // Close connection if we don't have a persistent client
-      if (client == null && connectionManager != null) {
-        jedis.close();
-      }
-    }
+    // Use the unified method for all document operations
+    return addDocumentWithUnified(docId, processedDocument);
   }
 
   private String addDocumentWithUnified(String docId, Map<String, Object> document) {
@@ -838,8 +744,8 @@ private String addDocumentWithUnified(String docId, Map<String, Object> document
         // Use JSON.SET command to store the document as an object
         // Path2.ROOT_PATH is the root JSON path "$"
         String result =
-            unifiedClient.jsonSetWithEscape(
-                docId, redis.clients.jedis.json.Path2.ROOT_PATH, jsonDocument);
+            getUnifiedJedis()
+                .jsonSetWithEscape(docId, redis.clients.jedis.json.Path2.ROOT_PATH, jsonDocument);
         log.debug("Stored JSON document {}: {}", docId, result);
       } else {
         // For HASH storage - handle vectors specially
@@ -874,11 +780,11 @@ private String addDocumentWithUnified(String docId, Map<String, Object> document
 
         // Store binary fields
         if (!binaryFields.isEmpty()) {
-          unifiedClient.hset(docId.getBytes(StandardCharsets.UTF_8), binaryFields);
+          getUnifiedJedis().hset(docId.getBytes(StandardCharsets.UTF_8), binaryFields);
         }
         // Store string fields
         if (!stringFields.isEmpty()) {
-          unifiedClient.hset(docId, stringFields);
+          getUnifiedJedis().hset(docId, stringFields);
         }
       }
 

core/src/main/java/com/redis/vl/langchain4j/RedisVLChatMemoryStore.java

@@ -22,7 +22,7 @@
  *
  * <pre>{@code
  * // Create chat memory store
- * UnifiedJedis jedis = new JedisPooled("localhost", 6379);
+ * UnifiedJedis jedis = RedisClient.create("localhost", 6379);
  * ChatMemoryStore memoryStore = new RedisVLChatMemoryStore(jedis);
  *
  * // Use with LangChain4J chat memory

core/src/main/java/com/redis/vl/langchain4j/RedisVLDocumentStore.java

@@ -22,7 +22,7 @@
  *
  * <pre>{@code
  * // Create document store
- * UnifiedJedis jedis = new JedisPooled("localhost", 6379);
+ * UnifiedJedis jedis = RedisClient.create("localhost", 6379);
  * RedisVLDocumentStore store = new RedisVLDocumentStore(jedis, "docs:");
  *
  * // Store a document

core/src/main/java/com/redis/vl/redis/RedisConnectionConfig.java

@@ -2,9 +2,12 @@
 
 import lombok.Builder;
 import lombok.Getter;
-import redis.clients.jedis.JedisPoolConfig;
 
-/** Configuration for Redis connections. */
+/**
+ * Configuration for Redis connections.
+ *
+ * <p>Used with {@link RedisConnectionManager} to configure connection parameters.
+ */
 @Getter
 @Builder
 public class RedisConnectionConfig {
@@ -89,20 +92,4 @@ public static RedisConnectionConfig fromUri(String uri) {
   public static RedisConnectionConfig fromHostPort(String host, int port) {
     return RedisConnectionConfig.builder().host(host).port(port).build();
   }
-
-  /**
-   * Create a JedisPoolConfig from this configuration.
-   *
-   * @return JedisPoolConfig with settings from this configuration
-   */
-  public JedisPoolConfig toJedisPoolConfig() {
-    JedisPoolConfig config = new JedisPoolConfig();
-    config.setMaxTotal(maxTotal);
-    config.setMaxIdle(maxIdle);
-    config.setMinIdle(minIdle);
-    config.setTestOnBorrow(testOnBorrow);
-    config.setTestOnReturn(testOnReturn);
-    config.setTestWhileIdle(testWhileIdle);
-    return config;
-  }
 }