JAVA-5950 Update Transactions Convenient API with exponential backoff on retries

.evergreen/.evg.yml

@@ -112,7 +112,7 @@ functions:
             # If this was a patch build, doing a fresh clone would not actually test the patch
             cp -R ${PROJECT_DIRECTORY}/ $DRIVERS_TOOLS
           else
-            git clone https://github.com/mongodb-labs/drivers-evergreen-tools.git $DRIVERS_TOOLS
+            git clone --depth 1 https://github.com/mongodb-labs/drivers-evergreen-tools.git $DRIVERS_TOOLS
           fi
           echo "{ \"releases\": { \"default\": \"$MONGODB_BINARIES\" }}" > $MONGO_ORCHESTRATION_HOME/orchestration.config
 

.evergreen/ssdlc-report.sh

@@ -71,6 +71,10 @@ printf "\nSpotBugs created the following SARIF reports\n"
 IFS=$'\n'
 declare -a SARIF_PATHS=($(find "${RELATIVE_DIR_PATH}/.." -path "*/spotbugs/*.sarif"))
 unset IFS
+if [ ${#SARIF_PATHS[@]} -eq 0 ]; then
+   printf "\nERROR: No SARIF files found matching pattern */spotbugs/*.sarif\n"
+   exit 1
+fi
 for SARIF_PATH in "${SARIF_PATHS[@]}"; do
     GRADLE_PROJECT_NAME="$(basename "$(dirname "$(dirname "$(dirname "$(dirname "${SARIF_PATH}")")")")")"
     NEW_SARIF_PATH="${SSDLC_STATIC_ANALYSIS_REPORTS_PATH}/${GRADLE_PROJECT_NAME}_$(basename "${SARIF_PATH}")"

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "specifications"]
-	path = driver-core/src/test/resources/specifications
+	path = testing/resources/specifications
 	url = https://github.com/mongodb/specifications

bson/build.gradle.kts

@@ -25,6 +25,11 @@ plugins {
 
 base.archivesName.set("bson")
 
+tasks.processTestResources {
+    from("${rootProject.projectDir}/testing/resources")
+    into("${layout.buildDirectory.get()}/resources/test")
+}
+
 configureMavenPublication {
     pom {
         name.set("BSON")

bson/src/main/org/bson/BinaryVector.java

@@ -18,9 +18,8 @@
 
 import org.bson.annotations.Beta;
 import org.bson.annotations.Reason;
-
-import static org.bson.assertions.Assertions.isTrueArgument;
-import static org.bson.assertions.Assertions.notNull;
+import org.bson.diagnostics.Logger;
+import org.bson.diagnostics.Loggers;
 
 /**
  * Binary Vectors are densely packed arrays of numbers, all the same type, which are stored and retrieved efficiently using the BSON Binary
@@ -33,6 +32,7 @@
  * @since 5.3
  */
 public abstract class BinaryVector {
+    protected static final Logger LOGGER = Loggers.getLogger("BinaryVector");
     private final DataType dataType;
 
     BinaryVector(final DataType dataType) {
@@ -64,9 +64,6 @@ public abstract class BinaryVector {
      */
     @Beta(Reason.SERVER)
     public static PackedBitBinaryVector packedBitVector(final byte[] data, final byte padding) {
-        notNull("data", data);
-        isTrueArgument("Padding must be between 0 and 7 bits. Provided padding: " + padding, padding >= 0 && padding <= 7);
-        isTrueArgument("Padding must be 0 if vector is empty. Provided padding: " + padding, padding == 0 || data.length > 0);
         return new PackedBitBinaryVector(data, padding);
     }
 
@@ -83,7 +80,6 @@ public static PackedBitBinaryVector packedBitVector(final byte[] data, final byt
      * @return A {@link Int8BinaryVector} instance with the {@link DataType#INT8} data type.
      */
     public static Int8BinaryVector int8Vector(final byte[] data) {
-        notNull("data", data);
         return new Int8BinaryVector(data);
     }
 
@@ -99,7 +95,6 @@ public static Int8BinaryVector int8Vector(final byte[] data) {
      * @return A {@link Float32BinaryVector} instance with the {@link DataType#FLOAT32} data type.
      */
     public static Float32BinaryVector floatVector(final float[] data) {
-        notNull("data", data);
         return new Float32BinaryVector(data);
     }
 

bson/src/main/org/bson/Float32BinaryVector.java

@@ -18,7 +18,7 @@
 
 import java.util.Arrays;
 
-import static org.bson.assertions.Assertions.assertNotNull;
+import static org.bson.assertions.Assertions.notNull;
 
 /**
  * Represents a vector of 32-bit floating-point numbers, where each element in the vector is a float.
@@ -35,9 +35,9 @@ public final class Float32BinaryVector extends BinaryVector {
 
     private final float[] data;
 
-    Float32BinaryVector(final float[] vectorData) {
+    Float32BinaryVector(final float[] data) {
         super(DataType.FLOAT32);
-        this.data = assertNotNull(vectorData);
+        this.data = notNull("data", data);
     }
 
     /**
@@ -49,7 +49,7 @@ public final class Float32BinaryVector extends BinaryVector {
      * @return the underlying float array representing this {@link Float32BinaryVector} vector.
      */
     public float[] getData() {
-        return assertNotNull(data);
+        return data;
     }
 
     @Override

bson/src/main/org/bson/Int8BinaryVector.java

@@ -19,7 +19,7 @@
 import java.util.Arrays;
 import java.util.Objects;
 
-import static org.bson.assertions.Assertions.assertNotNull;
+import static org.bson.assertions.Assertions.notNull;
 
 /**
  * Represents a vector of 8-bit signed integers, where each element in the vector is a byte.
@@ -38,7 +38,7 @@ public final class Int8BinaryVector extends BinaryVector {
 
     Int8BinaryVector(final byte[] data) {
         super(DataType.INT8);
-        this.data = assertNotNull(data);
+        this.data = notNull("data", data);
     }
 
     /**
@@ -50,7 +50,7 @@ public final class Int8BinaryVector extends BinaryVector {
      * @return the underlying byte array representing this {@link Int8BinaryVector} vector.
      */
     public byte[] getData() {
-        return assertNotNull(data);
+        return data;
     }
 
     @Override

bson/src/main/org/bson/PackedBitBinaryVector.java

@@ -23,6 +23,8 @@
 import java.util.Objects;
 
 import static org.bson.assertions.Assertions.assertNotNull;
+import static org.bson.assertions.Assertions.isTrueArgument;
+import static org.bson.assertions.Assertions.notNull;
 
 /**
  * Represents a packed bit vector, where each element of the vector is represented by a single bit (0 or 1).
@@ -43,8 +45,17 @@ public final class PackedBitBinaryVector extends BinaryVector {
 
     PackedBitBinaryVector(final byte[] data, final byte padding) {
         super(DataType.PACKED_BIT);
-        this.data = assertNotNull(data);
+        this.data = notNull("data", data);
         this.padding = padding;
+        isTrueArgument("Padding must be between 0 and 7 bits. Provided padding: " + padding, padding >= 0 && padding <= 7);
+        isTrueArgument("Padding must be 0 if vector is empty. Provided padding: " + padding, padding == 0 || data.length > 0);
+        if (padding > 0) {
+            int mask = (1 << padding) - 1;
+            if ((data[data.length - 1] & mask) != 0) {
+                // JAVA-5848 in version 6.0.0 will convert this logging into an IllegalArgumentException
+                LOGGER.warn("The last " + padding + " padded bits should be zero in the final byte.");
+            }
+        }
     }
 
     /**

bson/src/main/org/bson/json/ExtendedJsonDoubleConverter.java

@@ -21,7 +21,7 @@ class ExtendedJsonDoubleConverter implements Converter<Double> {
     public void convert(final Double value, final StrictJsonWriter writer) {
         writer.writeStartObject();
         writer.writeName("$numberDouble");
-        writer.writeString(Double.toString(value));
+        writer.writeString(JsonDoubleHelper.toString(value));
         writer.writeEndObject();
 
     }

bson/src/main/org/bson/json/JsonDoubleConverter.java

@@ -19,6 +19,6 @@
 class JsonDoubleConverter implements Converter<Double> {
     @Override
     public void convert(final Double value, final StrictJsonWriter writer) {
-        writer.writeNumber(Double.toString(value));
+        writer.writeNumber(JsonDoubleHelper.toString(value));
     }
 }

bson/src/main/org/bson/json/JsonDoubleHelper.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2008-present MongoDB, 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 org.bson.json;
+
+import java.util.regex.Pattern;
+
+final class JsonDoubleHelper {
+
+    private static final Pattern POSITIVE_EXPONENT_PATTERN = Pattern.compile("E(\\d+)");
+    private static final String POSITIVE_EXPONENT_REPLACER = "E+$1";
+
+    static String toString(final double value) {
+        String doubleString = Double.toString(value);
+        return POSITIVE_EXPONENT_PATTERN.matcher(doubleString).replaceAll(POSITIVE_EXPONENT_REPLACER);
+    }
+
+    private JsonDoubleHelper() {
+    }
+}

bson/src/main/org/bson/json/RelaxedExtendedJsonDoubleConverter.java

@@ -24,7 +24,7 @@ public void convert(final Double value, final StrictJsonWriter writer) {
         if (value.isNaN() || value.isInfinite()) {
             FALLBACK_CONVERTER.convert(value, writer);
         } else {
-            writer.writeNumber(Double.toString(value));
+            writer.writeNumber(JsonDoubleHelper.toString(value));
         }
     }
 }