/*
 * 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;

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;
import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;

A type-safe representation of the BSON array type.
Since:3.0
/** * A type-safe representation of the BSON array type. * * @since 3.0 */
public class BsonArray extends BsonValue implements List<BsonValue>, Cloneable { private final List<BsonValue> values;
Construct an instance with the given list of values.
Params:
  • values – the list of values, none of whose members may be null.
/** * Construct an instance with the given list of values. * * @param values the list of values, none of whose members may be null. */
public BsonArray(final List<? extends BsonValue> values) { this(values, true); }
Construct an empty BsonArray
/** * Construct an empty BsonArray */
public BsonArray() { this(new ArrayList<BsonValue>(), false); } @SuppressWarnings("unchecked") BsonArray(final List<? extends BsonValue> values, final boolean copy) { if (copy) { this.values = new ArrayList<BsonValue>(values); } else { this.values = (List<BsonValue>) values; } }
Parses a string in MongoDB Extended JSON format to a BsonArray
Params:
  • json – the JSON string
See Also:
Returns:a corresponding BsonArray object
@mongodb.driver.manualreference/mongodb-extended-json/ MongoDB Extended JSON
Since:3.4
/** * 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 BsonValue objects.
Returns:the values in this array.
/** * Gets the values in this array as a list of {@code BsonValue} objects. * * @return the values in this array. */
public List<BsonValue> getValues() { return Collections.unmodifiableList(values); } @Override public BsonType getBsonType() { return BsonType.ARRAY; } @Override public int size() { return values.size(); } @Override public boolean isEmpty() { return values.isEmpty(); } @Override public boolean contains(final Object o) { return values.contains(o); } @Override public Iterator<BsonValue> iterator() { return values.iterator(); } @Override public Object[] toArray() { return values.toArray(); } @Override public <T> T[] toArray(final T[] a) { return values.toArray(a); } @Override public boolean add(final BsonValue bsonValue) { return values.add(bsonValue); } @Override public boolean remove(final Object o) { return values.remove(o); } @Override public boolean containsAll(final Collection<?> c) { return values.containsAll(c); } @Override public boolean addAll(final Collection<? extends BsonValue> c) { return values.addAll(c); } @Override public boolean addAll(final int index, final Collection<? extends BsonValue> c) { return values.addAll(index, c); } @Override public boolean removeAll(final Collection<?> c) { return values.removeAll(c); } @Override public boolean retainAll(final Collection<?> c) { return values.retainAll(c); } @Override public void clear() { values.clear(); } @Override public BsonValue get(final int index) { return values.get(index); } @Override public BsonValue set(final int index, final BsonValue element) { return values.set(index, element); } @Override public void add(final int index, final BsonValue element) { values.add(index, element); } @Override public BsonValue remove(final int index) { return values.remove(index); } @Override public int indexOf(final Object o) { return values.indexOf(o); } @Override public int lastIndexOf(final Object o) { return values.lastIndexOf(o); } @Override public ListIterator<BsonValue> listIterator() { return values.listIterator(); } @Override public ListIterator<BsonValue> listIterator(final int index) { return values.listIterator(index); } @Override public List<BsonValue> subList(final int fromIndex, final int toIndex) { return values.subList(fromIndex, toIndex); } @Override public boolean equals(final Object o) { if (this == o) { return true; } if (!(o instanceof BsonArray)) { return false; } BsonArray that = (BsonArray) o; return getValues().equals(that.getValues()); } @Override public int hashCode() { return values.hashCode(); } @Override public String toString() { return "BsonArray{" + "values=" + values + '}'; } @Override public BsonArray clone() { BsonArray to = new BsonArray(); for (BsonValue cur : this) { switch (cur.getBsonType()) { case DOCUMENT: to.add(cur.asDocument().clone()); break; case ARRAY: to.add(cur.asArray().clone()); break; case BINARY: to.add(BsonBinary.clone(cur.asBinary())); break; case JAVASCRIPT_WITH_SCOPE: to.add(BsonJavaScriptWithScope.clone(cur.asJavaScriptWithScope())); break; default: to.add(cur); } } return to; } }