5.2 annotations (#1070)

 JAVA-4799

Author: katcharov

driver-core/src/main/com/mongodb/client/model/expressions/ArrayExpression.java

@@ -105,6 +105,7 @@ public interface ArrayExpression<T extends Expression> extends Expression {
      * The {@linkplain #gt(Expression) largest} value all the values of
      * {@code this} array, or the {@code other} value if this array is empty.
      *
+     * @mongodb.server.release 5.2
      * @param other the other value.
      * @return the resulting value.
      */
@@ -114,6 +115,7 @@ public interface ArrayExpression<T extends Expression> extends Expression {
      * The {@linkplain #lt(Expression) smallest} value all the values of
      * {@code this} array, or the {@code other} value if this array is empty.
      *
+     * @mongodb.server.release 5.2
      * @param other the other value.
      * @return the resulting value.
      */
@@ -124,6 +126,7 @@ public interface ArrayExpression<T extends Expression> extends Expression {
      * {@code this} array, or all elements if the array contains fewer than
      * {@code n} elements.
      *
+     * @mongodb.server.release 5.2
      * @param n the number of elements.
      * @return the resulting value.
      */
@@ -134,6 +137,7 @@ public interface ArrayExpression<T extends Expression> extends Expression {
      * {@code this} array, or all elements if the array contains fewer than
      * {@code n} elements.
      *
+     * @mongodb.server.release 5.2
      * @param n the number of elements.
      * @return the resulting value.
      */

driver-core/src/main/com/mongodb/client/model/expressions/Expression.java

@@ -175,6 +175,7 @@ public interface Expression {
      * {@code this} is an integer, or the {@code other} integer value if
      * {@code this} is null, or is missing, or is of any other non-integer type.
      *
+     * @mongodb.server.release 5.2
      * @param other the other value.
      * @return the resulting value.
      */

driver-core/src/test/functional/com/mongodb/client/model/expressions/ArrayExpressionsFunctionalTest.java

@@ -29,6 +29,7 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
+import static com.mongodb.ClusterFixture.serverVersionAtLeast;
 import static com.mongodb.client.model.expressions.Expressions.of;
 import static com.mongodb.client.model.expressions.Expressions.ofArray;
 import static com.mongodb.client.model.expressions.Expressions.ofBooleanArray;
@@ -37,6 +38,7 @@
 import static com.mongodb.client.model.expressions.Expressions.ofNumberArray;
 import static com.mongodb.client.model.expressions.Expressions.ofStringArray;
 import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
 
 @SuppressWarnings({"Convert2MethodRef"})
 class ArrayExpressionsFunctionalTest extends AbstractExpressionsFunctionalTest {
@@ -141,6 +143,7 @@ public void sortTest() {
 
     @SuppressWarnings("unchecked")
     private static ArrayExpression<? extends NumberExpression> sort(final ArrayExpression<? extends NumberExpression> array) {
+        assumeTrue(serverVersionAtLeast(5, 2)); // due to sort
         MqlExpression<? extends NumberExpression> mqlArray = (MqlExpression<? extends NumberExpression>) array;
         return mqlArray.sort();
     }
@@ -215,6 +218,7 @@ public void reduceMultiplyTest() {
 
     @Test
     public void reduceMaxTest() {
+        assumeTrue(serverVersionAtLeast(5, 2));
         assertExpression(
                 3,
                 ofIntegerArray(1, 2, 3).max(of(9)),
@@ -227,6 +231,7 @@ public void reduceMaxTest() {
 
     @Test
     public void reduceMinTest() {
+        assumeTrue(serverVersionAtLeast(5, 2));
         assertExpression(
                 1,
                 ofIntegerArray(1, 2, 3).min(of(9)),
@@ -239,6 +244,7 @@ public void reduceMinTest() {
 
     @Test
     public void reduceMaxNTest() {
+        assumeTrue(serverVersionAtLeast(5, 2));
         assertExpression(
                 Arrays.asList(3, 2),
                 ofIntegerArray(3, 1, 2).maxN(of(2)));
@@ -253,6 +259,7 @@ public void reduceMaxNTest() {
 
     @Test
     public void reduceMinNTest() {
+        assumeTrue(serverVersionAtLeast(5, 2));
         assertExpression(
                 Arrays.asList(1, 2),
                 ofIntegerArray(3, 1, 2).minN(of(2)));

driver-core/src/test/functional/com/mongodb/client/model/expressions/ControlExpressionsFunctionalTest.java

@@ -22,11 +22,13 @@
 import java.time.Instant;
 import java.util.function.Function;
 
+import static com.mongodb.ClusterFixture.serverVersionAtLeast;
 import static com.mongodb.client.model.expressions.Expressions.of;
 import static com.mongodb.client.model.expressions.Expressions.ofArray;
 import static com.mongodb.client.model.expressions.Expressions.ofIntegerArray;
 import static com.mongodb.client.model.expressions.Expressions.ofMap;
 import static com.mongodb.client.model.expressions.Expressions.ofNull;
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
 
 class ControlExpressionsFunctionalTest extends AbstractExpressionsFunctionalTest {
 
@@ -107,6 +109,8 @@ public void switchInferenceTest() {
 
     @Test
     public void switchTypesTest() {
+        // isIntegerOr relies on switch short-circuiting, which only happens after 5.2
+        assumeTrue(serverVersionAtLeast(5, 2));
         Function<Expression, StringExpression> label = expr -> expr.switchOn(on -> on
                 .isBoolean(v -> v.asString().concat(of(" - bool")))
                 // integer should be checked before string

driver-core/src/test/functional/com/mongodb/client/model/expressions/TypeExpressionsFunctionalTest.java

@@ -28,12 +28,14 @@
 import java.time.ZonedDateTime;
 import java.util.Arrays;
 
+import static com.mongodb.ClusterFixture.serverVersionAtLeast;
 import static com.mongodb.client.model.expressions.Expressions.of;
 import static com.mongodb.client.model.expressions.Expressions.ofIntegerArray;
 import static com.mongodb.client.model.expressions.Expressions.ofMap;
 import static com.mongodb.client.model.expressions.Expressions.ofNull;
 import static java.time.format.DateTimeFormatter.ISO_LOCAL_DATE_TIME;
 import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
 
 class TypeExpressionsFunctionalTest extends AbstractExpressionsFunctionalTest {
     // https://www.mongodb.com/docs/manual/reference/operator/aggregation/#type-expression-operators
@@ -67,6 +69,8 @@ public void isNumberOrTest() {
 
     @Test
     public void isIntegerOr() {
+        // isIntegerOr relies on switch short-circuiting, which only happens after 5.2
+        assumeTrue(serverVersionAtLeast(5, 2));
         assertExpression(
                 1,
                 of(1).isIntegerOr(of(99)),