Package org.bson

Class BasicBSONObject

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Cloneable, java.util.Map<java.lang.String,​java.lang.Object>, BSONObject
    Direct Known Subclasses:
    BasicDBObject

    public class BasicBSONObject
    extends java.util.LinkedHashMap<java.lang.String,​java.lang.Object>
    implements BSONObject
    A simple implementation of DBObject. A DBObject can be created as follows, using this class: DBObject obj = new BasicBSONObject(); obj.put( "foo", "bar" );
    See Also:
    Serialized Form
    • Nested Class Summary

      • Nested classes/interfaces inherited from class java.util.AbstractMap

        java.util.AbstractMap.SimpleEntry<K extends java.lang.Object,​V extends java.lang.Object>, java.util.AbstractMap.SimpleImmutableEntry<K extends java.lang.Object,​V extends java.lang.Object>
    • Constructor Summary

      Constructors 
      Constructor Description
      BasicBSONObject()
      Creates an empty object.
      BasicBSONObject​(int size)
      Creates an empty object.
      BasicBSONObject​(java.lang.String key, java.lang.Object value)
      Creates a BSONObject initialised with a single key/value pair.
      BasicBSONObject​(java.util.Map map)
      Creates a DBObject from a map.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      BasicBSONObject append​(java.lang.String key, java.lang.Object val)
      Add a key/value pair to this object
      boolean containsField​(java.lang.String field)
      Checks if this object contains a given field
      boolean containsKey​(java.lang.String key)
      Deprecated.
      boolean equals​(java.lang.Object o)
      Compares two documents according to their serialized form, ignoring the order of keys.
      java.lang.Object get​(java.lang.String key)
      Gets a value from this object
      boolean getBoolean​(java.lang.String key)
      Returns the value of a field as a boolean.
      boolean getBoolean​(java.lang.String key, boolean def)
      Returns the value of a field as a boolean
      java.util.Date getDate​(java.lang.String field)
      Returns the date or null if not set.
      java.util.Date getDate​(java.lang.String field, java.util.Date def)
      Returns the date or def if not set.
      double getDouble​(java.lang.String key)
      Returns the value of a field as a double.
      double getDouble​(java.lang.String key, double def)
      Returns the value of a field as an double.
      int getInt​(java.lang.String key)
      Returns the value of a field as an int.
      int getInt​(java.lang.String key, int def)
      Returns the value of a field as an int.
      long getLong​(java.lang.String key)
      Returns the value of a field as a long.
      long getLong​(java.lang.String key, long def)
      Returns the value of a field as an long.
      ObjectId getObjectId​(java.lang.String field)
      Returns the object id or null if not set.
      ObjectId getObjectId​(java.lang.String field, ObjectId def)
      Returns the object id or def if not set.
      java.lang.String getString​(java.lang.String key)
      Returns the value of a field as a string
      java.lang.String getString​(java.lang.String key, java.lang.String def)
      Returns the value of a field as a string
      int hashCode()  
      void putAll​(java.util.Map m)
      Sets all key/value pairs from a map into this object
      void putAll​(BSONObject o)
      Sets all key/value pairs from an object into this object
      java.lang.Object removeField​(java.lang.String key)
      Deletes a field from this object.
      java.util.Map toMap()
      Converts a DBObject to a map.
      • Methods inherited from class java.util.LinkedHashMap

        clear, containsValue, entrySet, forEach, get, getOrDefault, keySet, replaceAll, values
      • Methods inherited from class java.util.HashMap

        clone, compute, computeIfAbsent, computeIfPresent, containsKey, isEmpty, merge, put, putIfAbsent, remove, remove, replace, replace, size
      • Methods inherited from class java.util.AbstractMap

        toString
      • Methods inherited from class java.lang.Object

        getClass, notify, notifyAll, wait, wait, wait
      • Methods inherited from interface java.util.Map

        compute, computeIfAbsent, computeIfPresent, containsKey, isEmpty, merge, put, putIfAbsent, remove, remove, replace, replace, size
    • Constructor Detail

      • BasicBSONObject

        public BasicBSONObject()
        Creates an empty object.
      • BasicBSONObject

        public BasicBSONObject​(int size)
        Creates an empty object.
        Parameters:
        size - the initial capacity for the Map storing this document.
      • BasicBSONObject

        public BasicBSONObject​(java.lang.String key,
                               java.lang.Object value)
        Creates a BSONObject initialised with a single key/value pair.
        Parameters:
        key - key under which to store
        value - value to store
      • BasicBSONObject

        public BasicBSONObject​(java.util.Map map)
        Creates a DBObject from a map.
        Parameters:
        map - map to convert
    • Method Detail

      • toMap

        public java.util.Map toMap()
        Converts a DBObject to a map.
        Specified by:
        toMap in interface BSONObject
        Returns:
        the DBObject
      • removeField

        public java.lang.Object removeField​(java.lang.String key)
        Deletes a field from this object.
        Specified by:
        removeField in interface BSONObject
        Parameters:
        key - the field name to remove
        Returns:
        the object removed
      • containsField

        public boolean containsField​(java.lang.String field)
        Checks if this object contains a given field
        Specified by:
        containsField in interface BSONObject
        Parameters:
        field - field name
        Returns:
        if the field exists
      • containsKey

        @Deprecated
        public boolean containsKey​(java.lang.String key)
        Deprecated.
        Description copied from interface: BSONObject
        Deprecated
        Specified by:
        containsKey in interface BSONObject
        Parameters:
        key - the key to check
        Returns:
        True if the key is present
      • get

        public java.lang.Object get​(java.lang.String key)
        Gets a value from this object
        Specified by:
        get in interface BSONObject
        Parameters:
        key - field name
        Returns:
        the value
      • getInt

        public int getInt​(java.lang.String key)
        Returns the value of a field as an int.
        Parameters:
        key - the field to look for
        Returns:
        the field value (or default)
      • getInt

        public int getInt​(java.lang.String key,
                          int def)
        Returns the value of a field as an int.
        Parameters:
        key - the field to look for
        def - the default to return
        Returns:
        the field value (or default)
      • getLong

        public long getLong​(java.lang.String key)
        Returns the value of a field as a long.
        Parameters:
        key - the field to return
        Returns:
        the field value
      • getLong

        public long getLong​(java.lang.String key,
                            long def)
        Returns the value of a field as an long.
        Parameters:
        key - the field to look for
        def - the default to return
        Returns:
        the field value (or default)
      • getDouble

        public double getDouble​(java.lang.String key)
        Returns the value of a field as a double.
        Parameters:
        key - the field to return
        Returns:
        the field value
      • getDouble

        public double getDouble​(java.lang.String key,
                                double def)
        Returns the value of a field as an double.
        Parameters:
        key - the field to look for
        def - the default to return
        Returns:
        the field value (or default)
      • getString

        public java.lang.String getString​(java.lang.String key)
        Returns the value of a field as a string
        Parameters:
        key - the field to look up
        Returns:
        the value of the field, converted to a string
      • getString

        public java.lang.String getString​(java.lang.String key,
                                          java.lang.String def)
        Returns the value of a field as a string
        Parameters:
        key - the field to look up
        def - the default to return
        Returns:
        the value of the field, converted to a string
      • getBoolean

        public boolean getBoolean​(java.lang.String key)
        Returns the value of a field as a boolean.
        Parameters:
        key - the field to look up
        Returns:
        the value of the field, or false if field does not exist
      • getBoolean

        public boolean getBoolean​(java.lang.String key,
                                  boolean def)
        Returns the value of a field as a boolean
        Parameters:
        key - the field to look up
        def - the default value in case the field is not found
        Returns:
        the value of the field, converted to a string
      • getObjectId

        public ObjectId getObjectId​(java.lang.String field)
        Returns the object id or null if not set.
        Parameters:
        field - The field to return
        Returns:
        The field object value or null if not found (or if null :-^).
      • getObjectId

        public ObjectId getObjectId​(java.lang.String field,
                                    ObjectId def)
        Returns the object id or def if not set.
        Parameters:
        field - The field to return
        def - the default value in case the field is not found
        Returns:
        The field object value or def if not set.
      • getDate

        public java.util.Date getDate​(java.lang.String field)
        Returns the date or null if not set.
        Parameters:
        field - The field to return
        Returns:
        The field object value or null if not found.
      • getDate

        public java.util.Date getDate​(java.lang.String field,
                                      java.util.Date def)
        Returns the date or def if not set.
        Parameters:
        field - The field to return
        def - the default value in case the field is not found
        Returns:
        The field object value or def if not set.
      • putAll

        public void putAll​(java.util.Map m)
        Description copied from interface: BSONObject
        Sets all key/value pairs from a map into this object
        Specified by:
        putAll in interface BSONObject
        Specified by:
        putAll in interface java.util.Map<java.lang.String,​java.lang.Object>
        Overrides:
        putAll in class java.util.HashMap<java.lang.String,​java.lang.Object>
        Parameters:
        m - the map
      • putAll

        public void putAll​(BSONObject o)
        Description copied from interface: BSONObject
        Sets all key/value pairs from an object into this object
        Specified by:
        putAll in interface BSONObject
        Parameters:
        o - the object
      • append

        public BasicBSONObject append​(java.lang.String key,
                                      java.lang.Object val)
        Add a key/value pair to this object
        Parameters:
        key - the field name
        val - the field value
        Returns:
        this
      • equals

        public boolean equals​(java.lang.Object o)
        Compares two documents according to their serialized form, ignoring the order of keys.
        Specified by:
        equals in interface java.util.Map<java.lang.String,​java.lang.Object>
        Overrides:
        equals in class java.util.AbstractMap<java.lang.String,​java.lang.Object>
        Parameters:
        o - the document to compare to, which must be an instance of BSONObject.
        Returns:
        true if the documents have the same serialized form, ignoring key order.
      • hashCode

        public int hashCode()
        Specified by:
        hashCode in interface java.util.Map<java.lang.String,​java.lang.Object>
        Overrides:
        hashCode in class java.util.AbstractMap<java.lang.String,​java.lang.Object>