Mark new API as experimental

Author: a-TODO-rov

src/main/java/io/lettuce/core/ValueCondition.java

@@ -19,6 +19,8 @@
  */
 package io.lettuce.core;
 
+import io.lettuce.core.annotations.Experimental;
+
 /**
  * A compare condition to be used with commands that support conditional value checks (e.g. SET with IFEQ/IFNE/IFDEQ/IFDNE and
  * DELEX). This abstraction lets callers express value-based or digest-based comparisons without exploding method overloads.
@@ -28,8 +30,8 @@
  * </p>
  *
  * @param <V> value type used for value-based comparisons
- * @since 8.x
  */
+@Experimental
 public final class ValueCondition<V> {
 
     /**

src/main/java/io/lettuce/core/api/async/RedisKeyAsyncCommands.java

@@ -35,6 +35,7 @@
 import io.lettuce.core.SortArgs;
 import io.lettuce.core.StreamScanCursor;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.RedisFuture;
 import io.lettuce.core.output.KeyStreamingChannel;
 import io.lettuce.core.output.ValueStreamingChannel;
@@ -86,6 +87,7 @@ public interface RedisKeyAsyncCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return Long integer-reply the number of keys that were removed.
      */
+    @Experimental
     RedisFuture<Long> delex(K key, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/api/async/RedisStringAsyncCommands.java

@@ -30,6 +30,7 @@
 import io.lettuce.core.StrAlgoArgs;
 import io.lettuce.core.StringMatchResult;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyValueStreamingChannel;
 import io.lettuce.core.RedisFuture;
 
@@ -263,6 +264,7 @@ public interface RedisStringAsyncCommands<K, V> {
      * @param key the key.
      * @return String bulk-string-reply the hex digest of the key's value, or {@code null} when {@code key} does not exist.
      */
+    @Experimental
     RedisFuture<String> digestKey(K key);
 
     /**
@@ -390,6 +392,7 @@ public interface RedisStringAsyncCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return String simple-string-reply {@code OK} if {@code SET} was executed; {@code null} if the operation was aborted.
      */
+    @Experimental
     RedisFuture<String> set(K key, V value, ValueCondition<V> condition);
 
     /**
@@ -401,6 +404,7 @@ public interface RedisStringAsyncCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return String simple-string-reply {@code OK} if {@code SET} was executed; {@code null} if the operation was aborted.
      */
+    @Experimental
     RedisFuture<String> set(K key, V value, SetArgs setArgs, ValueCondition<V> condition);
 
     /**
@@ -411,6 +415,7 @@ public interface RedisStringAsyncCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return V bulk-string-reply the previous value if the key existed, or {@code null} when {@code key} did not exist.
      */
+    @Experimental
     RedisFuture<V> setGet(K key, V value, ValueCondition<V> condition);
 
     /**
@@ -422,6 +427,7 @@ public interface RedisStringAsyncCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return V bulk-string-reply the previous value if the key existed, or {@code null} when {@code key} did not exist.
      */
+    @Experimental
     RedisFuture<V> setGet(K key, V value, SetArgs setArgs, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/api/reactive/RedisKeyReactiveCommands.java

@@ -34,6 +34,7 @@
 import io.lettuce.core.SortArgs;
 import io.lettuce.core.StreamScanCursor;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyStreamingChannel;
 import io.lettuce.core.output.ValueStreamingChannel;
 import reactor.core.publisher.Flux;
@@ -86,6 +87,7 @@ public interface RedisKeyReactiveCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return Long integer-reply the number of keys that were removed.
      */
+    @Experimental
     Mono<Long> delex(K key, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/api/reactive/RedisStringReactiveCommands.java

@@ -29,6 +29,7 @@
 import io.lettuce.core.StrAlgoArgs;
 import io.lettuce.core.StringMatchResult;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyValueStreamingChannel;
 import io.lettuce.core.Value;
 import reactor.core.publisher.Flux;
@@ -264,6 +265,7 @@ public interface RedisStringReactiveCommands<K, V> {
      * @param key the key.
      * @return String bulk-string-reply the hex digest of the key's value, or {@code null} when {@code key} does not exist.
      */
+    @Experimental
     Mono<String> digestKey(K key);
 
     /**
@@ -394,6 +396,7 @@ public interface RedisStringReactiveCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return String simple-string-reply {@code OK} if {@code SET} was executed; {@code null} if the operation was aborted.
      */
+    @Experimental
     Mono<String> set(K key, V value, ValueCondition<V> condition);
 
     /**
@@ -405,6 +408,7 @@ public interface RedisStringReactiveCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return String simple-string-reply {@code OK} if {@code SET} was executed; {@code null} if the operation was aborted.
      */
+    @Experimental
     Mono<String> set(K key, V value, SetArgs setArgs, ValueCondition<V> condition);
 
     /**
@@ -415,6 +419,7 @@ public interface RedisStringReactiveCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return V bulk-string-reply the previous value if the key existed, or {@code null} when {@code key} did not exist.
      */
+    @Experimental
     Mono<V> setGet(K key, V value, ValueCondition<V> condition);
 
     /**
@@ -426,6 +431,7 @@ public interface RedisStringReactiveCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return V bulk-string-reply the previous value if the key existed, or {@code null} when {@code key} did not exist.
      */
+    @Experimental
     Mono<V> setGet(K key, V value, SetArgs setArgs, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/api/sync/RedisKeyCommands.java

@@ -35,6 +35,7 @@
 import io.lettuce.core.SortArgs;
 import io.lettuce.core.StreamScanCursor;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyStreamingChannel;
 import io.lettuce.core.output.ValueStreamingChannel;
 
@@ -85,6 +86,7 @@ public interface RedisKeyCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return Long integer-reply the number of keys that were removed.
      */
+    @Experimental
     Long delex(K key, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/api/sync/RedisStringCommands.java

@@ -30,6 +30,7 @@
 import io.lettuce.core.StrAlgoArgs;
 import io.lettuce.core.StringMatchResult;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyValueStreamingChannel;
 
 /**
@@ -262,6 +263,7 @@ public interface RedisStringCommands<K, V> {
      * @param key the key.
      * @return String bulk-string-reply the hex digest of the key's value, or {@code null} when {@code key} does not exist.
      */
+    @Experimental
     String digestKey(K key);
 
     /**
@@ -389,6 +391,7 @@ public interface RedisStringCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return String simple-string-reply {@code OK} if {@code SET} was executed; {@code null} if the operation was aborted.
      */
+    @Experimental
     String set(K key, V value, ValueCondition<V> condition);
 
     /**
@@ -400,6 +403,7 @@ public interface RedisStringCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return String simple-string-reply {@code OK} if {@code SET} was executed; {@code null} if the operation was aborted.
      */
+    @Experimental
     String set(K key, V value, SetArgs setArgs, ValueCondition<V> condition);
 
     /**
@@ -410,6 +414,7 @@ public interface RedisStringCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return V bulk-string-reply the previous value if the key existed, or {@code null} when {@code key} did not exist.
      */
+    @Experimental
     V setGet(K key, V value, ValueCondition<V> condition);
 
     /**
@@ -421,6 +426,7 @@ public interface RedisStringCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return V bulk-string-reply the previous value if the key existed, or {@code null} when {@code key} did not exist.
      */
+    @Experimental
     V setGet(K key, V value, SetArgs setArgs, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/cluster/api/async/NodeSelectionKeyAsyncCommands.java

@@ -33,6 +33,8 @@
 import io.lettuce.core.SortArgs;
 import io.lettuce.core.StreamScanCursor;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.KeyScanArgs;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyStreamingChannel;
 import io.lettuce.core.output.ValueStreamingChannel;
 
@@ -83,6 +85,7 @@ public interface NodeSelectionKeyAsyncCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return Long integer-reply the number of keys that were removed.
      */
+    @Experimental
     AsyncExecutions<Long> delex(K key, ValueCondition<V> condition);
 
     /**

src/main/java/io/lettuce/core/cluster/api/sync/NodeSelectionKeyCommands.java

@@ -35,6 +35,7 @@
 import io.lettuce.core.SortArgs;
 import io.lettuce.core.StreamScanCursor;
 import io.lettuce.core.ValueCondition;
+import io.lettuce.core.annotations.Experimental;
 import io.lettuce.core.output.KeyStreamingChannel;
 import io.lettuce.core.output.ValueStreamingChannel;
 
@@ -85,6 +86,7 @@ public interface NodeSelectionKeyCommands<K, V> {
      * @param condition the compare condition, must not be {@code null}.
      * @return Long integer-reply the number of keys that were removed.
      */
+    @Experimental
     Executions<Long> delex(K key, ValueCondition<V> condition);
 
     /**

src/main/kotlin/io/lettuce/core/api/coroutines/RedisKeyCoroutinesCommands.kt

@@ -35,6 +35,7 @@ import io.lettuce.core.ScanCursor
 import io.lettuce.core.SortArgs
 import io.lettuce.core.ValueCondition
 import io.lettuce.core.ExperimentalLettuceCoroutinesApi
+import io.lettuce.core.annotations.Experimental
 import kotlinx.coroutines.flow.Flow
 
 /**
@@ -85,6 +86,7 @@ interface RedisKeyCoroutinesCommands<K : Any, V : Any> {
      * @param condition the compare condition, must not be `null`.
      * @return Long integer-reply the number of keys that were removed.
      */
+    @Experimental
     suspend fun delex(key: K, condition: ValueCondition<V>): Long?
 
     /**