JVMCBC-1667 TEST: Make IgnoreWhen Repeatable

Motivation
----------
Prerequisite for using IgnoreWhen as a meta-annotation.

Modifications
-------------
Annotate `IgnoreWhen` as `Repeatable`, and add
the necessary container annotation.

Modify ClusterInvocationProvider.evaluateExecutionCondition
to process a list of IgnoreWhen annotations instead of just zero/one.

Change-Id: Idaf223a543ffe5607c4267472802f8aec227c115
Reviewed-on: https://review.couchbase.org/c/couchbase-jvm-clients/+/230063
Tested-by: Build Bot <[email protected]>
Reviewed-by: Michael Reiche <[email protected]>

Author: dnault

test-utils/src/main/java/com/couchbase/client/test/ClusterInvocationProvider.java

@@ -23,7 +23,7 @@
 import org.junit.jupiter.api.extension.ParameterResolver;
 import org.junit.platform.commons.support.AnnotationSupport;
 
-import java.util.Optional;
+import java.util.List;
 
 /**
  * This invocation provider starts and stops the couchbase cluster before and after
@@ -81,10 +81,9 @@ public Object resolveParameter(final ParameterContext pCtx, final ExtensionConte
   public ConditionEvaluationResult evaluateExecutionCondition(ExtensionContext context) {
     TestCluster testCluster = accessAndMaybeInitTestCluster(context);
 
-    Optional<IgnoreWhen> annotation = AnnotationSupport
-      .findAnnotation(context.getElement(), IgnoreWhen.class);
-    if (annotation.isPresent()) {
-      IgnoreWhen found = annotation.get();
+    List<IgnoreWhen> annotations = AnnotationSupport
+      .findRepeatableAnnotations(context.getElement(), IgnoreWhen.class);
+    for (IgnoreWhen found : annotations) {
       for (ClusterType type : found.clusterTypes()) {
         if (testCluster.type().equals(type)) {
           return ConditionEvaluationResult.disabled("Test disabled on this ClusterType ("

test-utils/src/main/java/com/couchbase/client/test/IgnoreWhen.java

@@ -16,12 +16,14 @@
 package com.couchbase.client.test;
 
 import java.lang.annotation.ElementType;
+import java.lang.annotation.Repeatable;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.TYPE })
 @Retention(RetentionPolicy.RUNTIME)
+@Repeatable(IgnoreWhenContainer.class)
 public @interface IgnoreWhen {
   ClusterType[] clusterTypes() default {};
 

test-utils/src/main/java/com/couchbase/client/test/IgnoreWhenContainer.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2025 Couchbase, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.couchbase.client.test;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.TYPE })
+@Retention(RetentionPolicy.RUNTIME)
+public @interface IgnoreWhenContainer {
+  IgnoreWhen[] value();
+}