JAVA-1929: Add static parse method to BsonArray

Author: jyemin

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

@@ -16,6 +16,10 @@
 
 package org.bson;
 
+import org.bson.codecs.BsonArrayCodec;
+import org.bson.codecs.DecoderContext;
+import org.bson.json.JsonReader;
+
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
@@ -48,6 +52,20 @@ public BsonArray() {
         values = new ArrayList<BsonValue>();
     }
 
+    /**
+     * Parses a string in MongoDB Extended JSON format to a {@code BsonArray}
+     *
+     * @param json the JSON string
+     * @return a corresponding {@code BsonArray} object
+     * @see org.bson.json.JsonReader
+     * @mongodb.driver.manual reference/mongodb-extended-json/ MongoDB Extended JSON
+     *
+     * @since 3.4
+     */
+    public static BsonArray parse(final String json) {
+        return new BsonArrayCodec().decode(new JsonReader(json), DecoderContext.builder().build());
+    }
+
     /**
      * Gets the values in this array as a list of {@code BsonValue} objects.
      *

bson/src/main/org/bson/codecs/BsonArrayCodec.java

@@ -27,15 +27,28 @@
 import java.util.List;
 
 import static org.bson.assertions.Assertions.notNull;
+import static org.bson.codecs.configuration.CodecRegistries.fromProviders;
 
 /**
  * A codec for BsonArray instances.
  *
  * @since 3.0
  */
 public class BsonArrayCodec implements Codec<BsonArray> {
+
+    private static final CodecRegistry DEFAULT_REGISTRY = fromProviders(new BsonValueCodecProvider());
+
     private final CodecRegistry codecRegistry;
 
+    /**
+     * Creates a new instance with a default codec registry that uses the {@link BsonValueCodecProvider}.
+     *
+     * @since 3.4
+     */
+    public BsonArrayCodec() {
+        this(DEFAULT_REGISTRY);
+    }
+
     /**
      * Construct an instance with the given registry
      *

bson/src/test/unit/org/bson/BsonArraySpecification.groovy

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2016 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
+
+import spock.lang.Specification
+
+class BsonArraySpecification extends Specification {
+
+    def 'should be array type'() {
+        expect:
+        new BsonArray().getBsonType() == BsonType.ARRAY
+    }
+
+    def 'should construct empty array'() {
+        when:
+        def array = new BsonArray()
+
+        then:
+        array.isEmpty()
+        array.size() == 0
+        array.getValues().isEmpty()
+    }
+
+    def 'should construct from a list'() {
+        given:
+        def list = [BsonBoolean.TRUE, BsonBoolean.FALSE]
+
+        when:
+        def array = new BsonArray(list)
+
+        then:
+        !array.isEmpty()
+        array.size() == 2
+        array.getValues() == list
+    }
+
+    def 'should parse json'() {
+        expect:
+        BsonArray.parse('[1, true]') == new BsonArray([new BsonInt32(1), BsonBoolean.TRUE])
+    }
+}