@SerializeWith(value=ArrayExternalizer.class) public class BasicArray extends Object implements MutableArray
ordered array of values for use as a value within a
BSON Object. Instances of this type are designed to be unmodifiable from a client's perspective, since clients
always modify the instances using an editor. There are several internal* methods that do modify the contents, but
these may not be used by client applications.
Since BSON and JSON documents can be simple arrays of values, this class implements the Document interface, where the
object's names are expected to be string values of integer indexes. This class also implements List interface, but only
supports the read methods.
| Modifier and Type | Class and Description |
|---|---|
static class |
BasicArray.BasicEntry |
protected static class |
BasicArray.IndexEntry |
protected static class |
BasicArray.UnmodifiableListIterator |
Array.EntryDocument.Field, Document.ValueTransformer| Constructor and Description |
|---|
BasicArray() |
BasicArray(int initialCapacity) |
BasicArray(List<Object> values) |
BasicArray(Object... values) |
| Modifier and Type | Method and Description |
|---|---|
void |
add(int index,
Object element) |
boolean |
add(Object e) |
boolean |
addAll(Collection<? extends Object> c) |
boolean |
addAll(int index,
Collection<? extends Object> c) |
boolean |
addAllValues(Collection<?> values)
Modifiable method that adds the supplied values at the end of this array.
|
boolean |
addAllValues(int index,
Collection<?> values)
Modifiable method that adds the supplied values at the supplied index, shifting any existing values to the next higher
index value.
|
void |
addValue(int index,
Object value)
Modifiable method that adds the supplied value at the supplied index, shifting any existing values to the next higher index
value.
|
int |
addValue(Object value)
Modifiable method that adds the supplied value.
|
boolean |
addValueIfAbsent(Object value)
Modifiable method that adds the supplied value if not already in the array.
|
void |
clear() |
Array |
clone()
Obtain a clone of this array.
|
boolean |
contains(Object o) |
boolean |
containsAll(Collection<?> c) |
boolean |
containsAll(Document document)
Checks if this object contains all of the fields in the supplied document.
|
boolean |
containsField(String name)
Checks if this object contains a field with the given name.
|
boolean |
equals(Object obj) |
Iterable<Document.Field> |
fields()
Obtain an iterator over the
Document.Fields in this object. |
Object |
get(int index) |
Object |
get(String name)
Gets the value in this document for the given field name.
|
List<?> |
getArray(String name)
Get the array value in this document for the given field name.
|
Binary |
getBinary(String name)
Get the
Binary value in this document for the given field name. |
Boolean |
getBoolean(String name)
Get the boolean value in this document for the given field name.
|
boolean |
getBoolean(String name,
boolean defaultValue)
Get the boolean value in this document for the given field name.
|
Code |
getCode(String name)
Get the
Code value in this document for the given field name. |
CodeWithScope |
getCodeWithScope(String name)
Get the
CodeWithScope value in this document for the given field name. |
Document |
getDocument(String name)
Get the document value in this document for the given field name.
|
Double |
getDouble(String name)
Get the double value in this document for the given field name.
|
double |
getDouble(String name,
double defaultValue)
Get the double value in this document for the given field name.
|
Iterable<Array.Entry> |
getEntries()
Get the entries in this array.
|
Integer |
getInteger(String name)
Get the integer value in this document for the given field name.
|
int |
getInteger(String name,
int defaultValue)
Get the integer value in this document for the given field name.
|
Long |
getLong(String name)
Get the integer value in this document for the given field name.
|
long |
getLong(String name,
long defaultValue)
Get the long value in this document for the given field name.
|
MaxKey |
getMaxKey(String name)
Get the
MaxKey value in this document for the given field name. |
MinKey |
getMinKey(String name)
Get the
MinKey value in this document for the given field name. |
Number |
getNumber(String name)
Get the number value in this document for the given field name.
|
Number |
getNumber(String name,
Number defaultValue)
Get the number value in this document for the given field name.
|
ObjectId |
getObjectId(String name)
Get the
ObjectId value in this document for the given field name. |
Pattern |
getPattern(String name)
Get the
Pattern value in this document for the given field name. |
String |
getString(String name)
Get the string value in this document for the given field name.
|
String |
getString(String name,
String defaultValue)
Get the string value in this document for the given field name.
|
Symbol |
getSymbol(String name)
Get the
Symbol value in this document for the given field name. |
int |
getType(String name)
Get the
Bson.Type constant that describes the type of value for the given field name. |
UUID |
getUuid(String name)
Get the
UUID value in this document for the given field name. |
UUID |
getUuid(String name,
UUID defaultValue)
Get the
UUID value in this document for the given field name. |
int |
hashCode() |
protected int |
indexFrom(String name) |
int |
indexOf(Object o) |
boolean |
isEmpty()
Return whether this document contains no fields and is therefore empty.
|
boolean |
isNull(String name)
Determine whether this object has a pair with the given the name and the value is null.
|
boolean |
isNullOrMissing(String name)
Determine whether this object has a pair with the given the name and the value is null, or if this object has no field with
the given name.
|
protected boolean |
isValidIndex(int index) |
Iterator<Object> |
iterator() |
Set<String> |
keySet()
Returns this object's fields' names
|
int |
lastIndexOf(Object o) |
ListIterator<Object> |
listIterator() |
ListIterator<Object> |
listIterator(int index) |
protected Object |
put(int index,
Object value) |
Object |
put(String name,
Object value)
Sets a name/value pair in this object.
|
void |
putAll(Document object)
Sets on this object all name/value pairs from the supplied object.
|
void |
putAll(Map<? extends String,? extends Object> map)
Sets on this object all key/value pairs from the supplied map.
|
Object |
remove(int index) |
boolean |
remove(Object o) |
Object |
remove(String name)
Removes from this object the name/value pair with the given name.
|
void |
removeAll()
Modifiable method that removes all of the values from this array.
|
boolean |
removeAll(Collection<?> c) |
List<Array.Entry> |
removeAllValues(Collection<?> valuesToBeRemoved)
Modifiable method that removes all of the supplied values from this array.
|
Object |
removeValue(int index)
Modifiable method that removes the value at the supplied index.
|
boolean |
removeValue(Object value)
Modifiable method that removes the supplied value.
|
boolean |
retainAll(Collection<?> c) |
List<Array.Entry> |
retainAllValues(Collection<?> valuesToBeRetained)
Modifiable method that removes all of the values in this array except the supplied values.
|
Object |
set(int index,
Object element) |
Object |
setValue(int index,
Object value)
Modifiable method that sets the supplied value at the given index.
|
int |
size()
Return the number of name-value pairs in this object.
|
List<Object> |
subList(int fromIndex,
int toIndex) |
Object[] |
toArray() |
<T> T[] |
toArray(T[] a) |
Map<String,?> |
toMap()
Returns a map representing this BSONObject.
|
String |
toString() |
protected Object |
unwrap(Object value) |
Array |
with(Document.ValueTransformer transformer)
Obtain a clone of this document, but with the field values transformed using the supplied
Document.ValueTransformer. |
Array |
with(Map<String,Object> changedFields)
Obtain a clone of this document, but with the supplied fields replaced.
|
Document |
with(String fieldName,
Object newValue)
Obtain a clone of this document, but with the supplied fields replaced.
|
Array |
withVariablesReplaced(Properties properties)
Obtain a clone of this document, but with all variables in string field values replaced with the referenced values from the
supplied properties.
|
Array |
withVariablesReplacedWithSystemProperties()
Obtain a clone of this document, but with all variables in string field values replaced with the referenced values from the
System properties.
|
public BasicArray()
public BasicArray(int initialCapacity)
public BasicArray(Object... values)
public Object get(String name)
Documentpublic boolean containsField(String name)
DocumentcontainsField in interface Documentname - The name of the pair for which to checkpublic boolean containsAll(Document document)
DocumentcontainsAll in interface Documentdocument - The document with the fields that should be in this documentpublic Set<String> keySet()
Documentpublic Map<String,?> toMap()
Documentpublic Iterable<Document.Field> fields()
DocumentDocument.Fields in this object.public int size()
Documentpublic boolean contains(Object o)
public boolean containsAll(Collection<?> c)
containsAll in interface Collection<Object>containsAll in interface List<Object>public int hashCode()
public boolean equals(Object obj)
public boolean isEmpty()
Documentpublic int lastIndexOf(Object o)
lastIndexOf in interface List<Object>public Object[] toArray()
public <T> T[] toArray(T[] a)
public Iterable<Array.Entry> getEntries()
ArraygetEntries in interface Arraypublic Boolean getBoolean(String name)
DocumentgetBoolean in interface Documentname - The name of the pairpublic boolean getBoolean(String name, boolean defaultValue)
DocumentgetBoolean in interface Documentname - The name of the pairdefaultValue - the default value to return if there is no such pair or if the value is not a booleandefaultValue if there is no such pair or if the value is not a
booleanpublic Integer getInteger(String name)
DocumentgetInteger in interface Documentname - The name of the pairpublic int getInteger(String name, int defaultValue)
DocumentgetInteger in interface Documentname - The name of the pairdefaultValue - the default value to return if there is no such pair or if the value is not a integerdefaultValue if there is no such pair or if the value is not a
integerpublic Long getLong(String name)
Documentpublic long getLong(String name, long defaultValue)
DocumentgetLong in interface Documentname - The name of the pairdefaultValue - the default value to return if there is no such pair or if the value is not a long valuedefaultValue if there is no such pair or if the value is not a long
valuepublic Double getDouble(String name)
Documentpublic double getDouble(String name, double defaultValue)
Documentpublic Number getNumber(String name)
Documentpublic Number getNumber(String name, Number defaultValue)
Documentpublic String getString(String name)
DocumentSymbol.public String getString(String name, String defaultValue)
DocumentSymbol.public List<?> getArray(String name)
Documentpublic Document getDocument(String name)
DocumentgetDocument in interface Documentname - The name of the pairpublic boolean isNull(String name)
Documentthis.get(name) instanceof Null;
isNull in interface Documentname - The name of the pairtrue if the field has been set to a Null value, or false otherwiseDocument.isNullOrMissing(String)public boolean isNullOrMissing(String name)
DocumentNull.matches(this.get(name));
isNullOrMissing in interface Documentname - The name of the pairtrue if the field value for the name is null or if there is no such field.Document.isNull(String)public MaxKey getMaxKey(String name)
DocumentMaxKey value in this document for the given field name.public MinKey getMinKey(String name)
DocumentMinKey value in this document for the given field name.public Code getCode(String name)
DocumentCode value in this document for the given field name.public CodeWithScope getCodeWithScope(String name)
DocumentCodeWithScope value in this document for the given field name.getCodeWithScope in interface Documentname - The name of the pairCodeWithScope field value, if found, or null if there is no such pair or if the value is not a
CodeWithScopepublic ObjectId getObjectId(String name)
DocumentObjectId value in this document for the given field name.getObjectId in interface Documentname - The name of the pairObjectId field value, if found, or null if there is no such pair or if the value is not a
ObjectIdpublic Binary getBinary(String name)
DocumentBinary value in this document for the given field name.public Symbol getSymbol(String name)
DocumentSymbol value in this document for the given field name.public Pattern getPattern(String name)
DocumentPattern value in this document for the given field name.getPattern in interface Documentname - The name of the pairPattern field value, if found, or null if there is no such pair or if the value is not a
Patternpublic UUID getUuid(String name)
DocumentUUID value in this document for the given field name.public UUID getUuid(String name, UUID defaultValue)
DocumentUUID value in this document for the given field name.getUuid in interface Documentname - The name of the pairdefaultValue - the default value to return if there is no such pair or if the value is not a stringUUID field value if found, or defaultValue if there is no such pair or if the value is not
a UUID (or a string that is convertable from a UUID)public int getType(String name)
DocumentBson.Type constant that describes the type of value for the given field name.public ListIterator<Object> listIterator()
listIterator in interface List<Object>public ListIterator<Object> listIterator(int index)
listIterator in interface List<Object>public boolean add(Object e)
public boolean addAll(Collection<? extends Object> c)
public boolean addAll(int index,
Collection<? extends Object> c)
public void clear()
public boolean remove(Object o)
public boolean removeAll(Collection<?> c)
public boolean retainAll(Collection<?> c)
protected final int indexFrom(String name)
protected final boolean isValidIndex(int index)
public boolean addValueIfAbsent(Object value)
MutableArrayaddValueIfAbsent in interface MutableArrayvalue - the value to be addedpublic int addValue(Object value)
MutableArrayaddValue in interface MutableArrayvalue - the value to be addedpublic void addValue(int index,
Object value)
MutableArrayaddValue in interface MutableArrayindex - the indexvalue - the value to be addedpublic Object setValue(int index, Object value)
MutableArraysetValue in interface MutableArrayindex - the indexvalue - the value to be addedpublic boolean removeValue(Object value)
MutableArrayremoveValue in interface MutableArrayvalue - the value to be removedpublic Object removeValue(int index)
MutableArrayremoveValue in interface MutableArrayindex - the index of the value to be removedpublic boolean addAllValues(Collection<?> values)
MutableArrayaddAllValues in interface MutableArrayvalues - the values to be addedpublic boolean addAllValues(int index,
Collection<?> values)
MutableArrayaddAllValues in interface MutableArrayindex - the index at which the values are to be insertedvalues - the values to be addedpublic List<Array.Entry> removeAllValues(Collection<?> valuesToBeRemoved)
MutableArrayremoveAllValues in interface MutableArrayvaluesToBeRemoved - the values to be removedpublic List<Array.Entry> retainAllValues(Collection<?> valuesToBeRetained)
MutableArrayretainAllValues in interface MutableArrayvaluesToBeRetained - the values to be kept, while all others are removedpublic Object remove(String name)
MutableDocumentremove in interface MutableDocumentname - The name of the pair to removepublic void removeAll()
MutableArrayremoveAll in interface MutableArrayremoveAll in interface MutableDocumentpublic Object put(String name, Object value)
MutableDocumentput in interface MutableDocumentname - The name; may not be nullvalue - The value; may be nullpublic void putAll(Document object)
MutableDocumentputAll in interface MutableDocumentobject - the object containing the name/value pairs to be set on this objectpublic void putAll(Map<? extends String,? extends Object> map)
MutableDocumentputAll in interface MutableDocumentmap - the map containing the name/value pairs to be set on this objectpublic Array with(Map<String,Object> changedFields)
Documentpublic Document with(String fieldName, Object newValue)
Documentpublic Array with(Document.ValueTransformer transformer)
DocumentDocument.ValueTransformer.public Array withVariablesReplaced(Properties properties)
DocumentVariables may appear anywhere within a string value, and multiple variables can be used within the same value. Variables take the form:
variable := '${' variableNames [ ':' defaultValue ] '}'
variableNames := variableName [ ',' variableNames ]
variableName := /* any characters except ',' and ':' and '}'
defaultValue := /* any characters except
Note that variableName is the name used to look up the Properties property.
Notice that the syntax supports multiple variables. The logic will process the variables from let to right,
until an existing System property is found. And at that point, it will stop and will not attempt to find values for the
other variables.
withVariablesReplaced in interface Documentproperties - the properties keyed by variable nameDocument.withVariablesReplacedWithSystemProperties(),
Document.with(ValueTransformer),
SchemaLibrary.convertValues(Document, String)public Array withVariablesReplacedWithSystemProperties()
DocumentVariables may appear anywhere within a string value, and multiple variables can be used within the same value. Variables take the form:
variable := '${' variableNames [ ':' defaultValue ] '}'
variableNames := variableName [ ',' variableNames ]
variableName := /* any characters except ',' and ':' and '}'
defaultValue := /* any characters except
Note that variableName is the name used to look up a System property via System.getProperty(String).
Notice that the syntax supports multiple variables. The logic will process the variables from let to right,
until an existing System property is found. And at that point, it will stop and will not attempt to find values for the
other variables.
Because only string values can contain variables, the resulting values are left as strings. This may not be valid according
to the document's JSON Schema, so see SchemaLibrary.convertValues(Document, String) to convert the string values
after variable substitution into the expected non-string types.
withVariablesReplacedWithSystemProperties in interface DocumentDocument.withVariablesReplaced(Properties),
Document.with(ValueTransformer),
SchemaLibrary.convertValues(Document, String)Copyright © 2008-2014 JBoss, a division of Red Hat. All Rights Reserved.