Adding BsonArray constructor that allocates an ArrayList with known capacity

JAVA-3613

Signed-off-by: Gaspard Petit <[email protected]>
Co-authored-by: Jeff Yemin <[email protected]>

Author: Gaspard Petit

bson/src/main/org/bson/BsonArray.java

@@ -52,6 +52,18 @@ public BsonArray() {
         this(new ArrayList<BsonValue>(), false);
     }
 
+    /**
+     * Construct an empty BsonArray with the specified initial capacity.
+     *
+     * @param  initialCapacity  the initial capacity of the BsonArray
+     * @throws IllegalArgumentException if the specified initial capacity
+     *         is negative
+     * @since 4.3
+     */
+    public BsonArray(final int initialCapacity) {
+        this(new ArrayList<BsonValue>(initialCapacity), false);
+    }
+
     @SuppressWarnings("unchecked")
     BsonArray(final List<? extends BsonValue> values, final boolean copy) {
         if (copy) {