4.0 annotations (#1070)

 JAVA-4799

Author: katcharov

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

@@ -264,6 +264,7 @@ public interface Expression {
      * {@linkplain EntryExpression entries}, and the
      * {@linkplain Expressions#ofNull() null value}.
      *
+     * @mongodb.server.release 4.0
      * @see StringExpression#parseDate()
      * @see StringExpression#parseInteger()
      * @return the resulting value.

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

@@ -109,6 +109,7 @@ default IntegerExpression subtract(final int other) {
      * The {@linkplain DateExpression date} corresponding to {@code this} value
      * when taken to be the number of milliseconds since the Unix epoch.
      *
+     * @mongodb.server.release 4.0
      * @return the resulting value.
      */
     DateExpression millisecondsToDate();

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

@@ -127,6 +127,7 @@ default StringExpression substrBytes(final int start, final int length) {
      *
      * <p>This will cause an error if this string does not represent an integer.
      *
+     * @mongodb.server.release 4.0
      * @return the resulting value.
      */
     IntegerExpression parseInteger();
@@ -146,6 +147,7 @@ default StringExpression substrBytes(final int start, final int length) {
      * Converts {@code this} string to a {@linkplain DateExpression date},
      * using the specified {@code format}.
      *
+     * @mongodb.server.release 4.0
      * @mongodb.driver.manual reference/operator/aggregation/dateToString/#std-label-format-specifiers Format Specifiers
      * @param format the format.
      * @return the resulting value.

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

@@ -173,6 +173,7 @@ public void isMapOrTest() {
 
     @Test
     public void asStringTest() {
+        assumeTrue(serverVersionAtLeast(4, 0));
         // https://www.mongodb.com/docs/manual/reference/operator/aggregation/toString/
         // asString, since toString conflicts
         assertExpression("false", of(false).asString(), "{'$toString': [false]}");
@@ -198,6 +199,7 @@ public void asStringTest() {
 
     @Test
     public void dateAsStringTest() {
+        assumeTrue(serverVersionAtLeast(4, 0));
         // https://www.mongodb.com/docs/manual/reference/operator/aggregation/dateToString/
         final Instant instant = Instant.parse("2007-12-03T10:15:30.005Z");
         DateExpression date = of(instant);
@@ -229,6 +231,7 @@ public void dateAsStringTest() {
 
     @Test
     public void parseDateTest() {
+        assumeTrue(serverVersionAtLeast(4, 0));
         // https://www.mongodb.com/docs/manual/reference/operator/aggregation/dateToString/
         String dateString = "2007-12-03T10:15:30.005Z";
         assertExpression(
@@ -253,6 +256,7 @@ public void parseDateTest() {
 
     @Test
     public void parseIntegerTest() {
+        assumeTrue(serverVersionAtLeast(4, 0));
         // https://www.mongodb.com/docs/manual/reference/operator/aggregation/toInt/
         // https://www.mongodb.com/docs/manual/reference/operator/aggregation/toLong/
         assertExpression(
@@ -292,6 +296,7 @@ public void parseIntegerTest() {
 
     @Test
     public void millisecondsToDateTest() {
+        assumeTrue(serverVersionAtLeast(4, 0));
         // https://www.mongodb.com/docs/manual/reference/operator/aggregation/toDate/
         assertExpression(
                 Instant.ofEpochMilli(1234),