Document (mongo-java-driver 3.0.0-beta2 API)

java.lang.Object
- org.bson.Document

All Implemented Interfaces:

Serializable, Map<String,Object>
```
public class Document
extends Object
implements Map<String,Object>, Serializable
```
A representation of a document as a Map. All iterators will traverse the elements in insertion order, as with LinkedHashMap.

Since:

3.0.0

See Also:

Serialized Form

MongoDB documentation

document

Nested Class Summary
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

Constructor Summary

Constructors
Constructor and Description
`Document()` Creates an empty Document instance.
`Document(Map<String,Object> map)` Creates a Document instance initialized with the given map.
`Document(String key, Object value)` Create a Document instance initialized with the given key/value pair.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Document`	`append(String key, Object value)` Put the given key/value pair into this Document and return this.
`void`	`clear()`
`boolean`	`containsKey(Object key)`
`boolean`	`containsValue(Object value)`
`Set<Map.Entry<String,Object>>`	`entrySet()`
`boolean`	`equals(Object o)`
`Object`	`get(Object key)`
`<T> T`	`get(Object key, Class<T> clazz)` Gets the value of the given key, casting it to the given `Class<T>`.
`Boolean`	`getBoolean(Object key)` Gets the value of the given key as a Boolean.
`boolean`	`getBoolean(Object key, boolean defaultValue)` Gets the value of the given key as a primitive boolean.
`Date`	`getDate(Object key)` Gets the value of the given key as a Date.
`Double`	`getDouble(Object key)` Gets the value of the given key as a Double.
`Integer`	`getInteger(Object key)` Gets the value of the given key as an Integer.
`int`	`getInteger(Object key, int defaultValue)` Gets the value of the given key as a primitive int.
`Long`	`getLong(Object key)` Gets the value of the given key as a Long.
`ObjectId`	`getObjectId(Object key)` Gets the value of the given key as an ObjectId.
`String`	`getString(Object key)` Gets the value of the given key as a String.
`int`	`hashCode()`
`boolean`	`isEmpty()`
`Set<String>`	`keySet()`
`Object`	`put(String key, Object value)`
`void`	`putAll(Map<? extends String,?> map)`
`Object`	`remove(Object key)`
`int`	`size()`
`String`	`toString()`
`static Document`	`valueOf(String s)` Converts a string in JSON format to a `Document`
`Collection<Object>`	`values()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Constructor Detail
  - Document
```
public Document()
```
    Creates an empty Document instance.
  - Document
```
public Document(String key,
                Object value)
```
    Create a Document instance initialized with the given key/value pair.
    
    Parameters:
    
    key - key
    
    value - value
  - Document
```
public Document(Map<String,Object> map)
```
    Creates a Document instance initialized with the given map.
    
    Parameters:
    
    map - initial map
- Method Detail
  - valueOf
```
public static Document valueOf(String s)
```
    Converts a string in JSON format to a Document
    
    Parameters:
    
    s - document representation in JSON format that conforms JSON RFC specifications.
    
    Returns:
    
    a corresponding Document object
  - append
```
public Document append(String key,
                       Object value)
```
    Put the given key/value pair into this Document and return this. Useful for chaining puts in a single expression, e.g.
```
 doc.append("a", 1).append("b", 2)}
 
```
    Parameters:
    
    key - key
    
    value - value
    
    Returns:
    
    this
  - get
```
public <T> T get(Object key,
                 Class<T> clazz)
```
    Gets the value of the given key, casting it to the given Class<T>. This is useful to avoid having casts in client code, though the effect is the same. So to get the value of a key that is of type String, you would write String name = doc.get("name", String.class) instead of String name = (String) doc.get("x") .
    
    Type Parameters:
    
    T - the type of the class
    
    Parameters:
    
    key - the key
    
    clazz - the class to cast the value to
    
    Returns:
    
    the value of the given key, or null if the instance does not contain this key.
    
    Throws:
    
    ClassCastException - if the value of the given key is not of type T
  - getInteger
```
public Integer getInteger(Object key)
```
    Gets the value of the given key as an Integer.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as an integer, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an integer
  - getInteger
```
public int getInteger(Object key,
                      int defaultValue)
```
    Gets the value of the given key as a primitive int.
    
    Parameters:
    
    key - the key
    
    defaultValue - what to return if the value is null
    
    Returns:
    
    the value as an integer, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an integer
  - getLong
```
public Long getLong(Object key)
```
    Gets the value of the given key as a Long.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as a long, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an long
  - getDouble
```
public Double getDouble(Object key)
```
    Gets the value of the given key as a Double.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as a double, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an double
  - getString
```
public String getString(Object key)
```
    Gets the value of the given key as a String.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as a String, which may be null
    
    Throws:
    
    ClassCastException - if the value is not a String
  - getBoolean
```
public Boolean getBoolean(Object key)
```
    Gets the value of the given key as a Boolean.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as a double, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an double
  - getBoolean
```
public boolean getBoolean(Object key,
                          boolean defaultValue)
```
    Gets the value of the given key as a primitive boolean.
    
    Parameters:
    
    key - the key
    
    defaultValue - what to return if the value is null
    
    Returns:
    
    the value as a double, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an double
  - getObjectId
```
public ObjectId getObjectId(Object key)
```
    Gets the value of the given key as an ObjectId.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as an ObjectId, which may be null
    
    Throws:
    
    ClassCastException - if the value is not an ObjectId
  - getDate
```
public Date getDate(Object key)
```
    Gets the value of the given key as a Date.
    
    Parameters:
    
    key - the key
    
    Returns:
    
    the value as a Date, which may be null
    
    Throws:
    
    ClassCastException - if the value is not a Date
  - size
```
public int size()
```
    Specified by:
    
    size in interface Map<String,Object>
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface Map<String,Object>
  - containsValue
```
public boolean containsValue(Object value)
```
    Specified by:
    
    containsValue in interface Map<String,Object>
  - containsKey
```
public boolean containsKey(Object key)
```
    Specified by:
    
    containsKey in interface Map<String,Object>
  - get
```
public Object get(Object key)
```
    Specified by:
    
    get in interface Map<String,Object>
  - put
```
public Object put(String key,
                  Object value)
```
    Specified by:
    
    put in interface Map<String,Object>
  - remove
```
public Object remove(Object key)
```
    Specified by:
    
    remove in interface Map<String,Object>
  - putAll
```
public void putAll(Map<? extends String,?> map)
```
    Specified by:
    
    putAll in interface Map<String,Object>
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Map<String,Object>
  - keySet
```
public Set<String> keySet()
```
    Specified by:
    
    keySet in interface Map<String,Object>
  - values
```
public Collection<Object> values()
```
    Specified by:
    
    values in interface Map<String,Object>
  - entrySet
```
public Set<Map.Entry<String,Object>> entrySet()
```
    Specified by:
    
    entrySet in interface Map<String,Object>
  - equals
```
public boolean equals(Object o)
```
    Specified by:
    
    equals in interface Map<String,Object>
    
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Map<String,Object>
    
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class Document

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

Document

Document

Document

Method Detail

valueOf

append

get

getInteger

getInteger

getLong

getDouble

getString

getBoolean

getBoolean

getObjectId

getDate

size

isEmpty

containsValue

containsKey

get

put

remove

putAll

clear

keySet

values

entrySet

equals

hashCode

toString