org.bson

Class LazyBSONObject

java.lang.Object

org.bson.LazyBSONObject

All Implemented Interfaces:

BSONObject

Direct Known Subclasses:

KeyCachingLazyBSONObject, LazyBSONList, LazyDBObject

public class LazyBSONObject
extends Object
implements BSONObject

Author:

antoine, brendan, scotthernandez, Kilroy Wuz Here

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	LazyBSONObject.LazyBSONKeySet Deprecated. This class is NOT a part of public API and will be dropped in 3.x versions.

Field Summary

Fields

Modifier and Type	Field and Description
protected LazyBSONCallback	_callback Deprecated. This field is NOT a part of public API and will be dropped in 3.x versions.
protected int	_doc_start_offset Deprecated. Please use getOffset() instead.
protected BSONByteBuffer	_input Deprecated. Please use getBytes() to access underlying bytes.

Constructor Summary

Constructors

Constructor and Description
LazyBSONObject(BSONByteBuffer buffer, int offset, LazyBSONCallback callback)
LazyBSONObject(BSONByteBuffer buffer, LazyBSONCallback callback)
LazyBSONObject(byte[] data, int offset, LazyBSONCallback callback)
LazyBSONObject(byte[] data, LazyBSONCallback callback)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsField(String s) Checks if this object contains a field with the given name.
boolean	containsKey(String s) Deprecated.
Set<Map.Entry<String,Object>>	entrySet() This method will be more efficient than using a combination of keySet() and get(String key)
boolean	equals(Object o)
Object	get(String key) Gets a field from this object by a given name.
int	getBSONSize()
protected byte[]	getBytes()
protected int	getElementBSONSize(int offset) Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.
protected byte	getElementType(int offset) Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.
protected Object	getElementValue(org.bson.LazyBSONObject.ElementRecord record) Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.
protected int	getOffset()
int	hashCode()
protected boolean	isElementEmpty(int offset) Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.
boolean	isEmpty()
Set<String>	keySet() Returns this object's fields' names
int	pipe(OutputStream os)
Object	put(String key, Object v) Sets a name/value pair in this object.
void	putAll(BSONObject o) Sets all key/value pairs from an object into this object
void	putAll(Map m) Sets all key/value pairs from a map into this object
Object	removeField(String key) Removes a field with a given name from this object.
protected int	sizeCString(int offset) Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.
Map	toMap() Returns a map representing this BSONObject.
String	toString() Returns a JSON serialization of this object

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

_doc_start_offset

@Deprecated
protected final int _doc_start_offset

Deprecated. Please use getOffset() instead.

_input

@Deprecated
protected final BSONByteBuffer _input

Deprecated. Please use getBytes() to access underlying bytes.

_callback

@Deprecated
protected final LazyBSONCallback _callback

Deprecated. This field is NOT a part of public API and will be dropped in 3.x versions.

Constructor Detail

LazyBSONObject

public LazyBSONObject(byte[] data,
              LazyBSONCallback callback)

LazyBSONObject

public LazyBSONObject(byte[] data,
              int offset,
              LazyBSONCallback callback)

LazyBSONObject

public LazyBSONObject(BSONByteBuffer buffer,
              LazyBSONCallback callback)

LazyBSONObject

public LazyBSONObject(BSONByteBuffer buffer,
              int offset,
              LazyBSONCallback callback)

Method Detail

put

public Object put(String key,
         Object v)

Description copied from interface: BSONObject

Sets a name/value pair in this object.

Specified by:

put in interface BSONObject

Parameters:

key - Name to set

v - Corresponding value

Returns:

v

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

putAll

public void putAll(Map m)

Description copied from interface: BSONObject

Sets all key/value pairs from a map into this object

Specified by:

putAll in interface BSONObject

Parameters:

m - the map

get

public Object get(String key)

Description copied from interface: BSONObject

Gets a field from this object by a given name.

Specified by:

get in interface BSONObject

Parameters:

key - The name of the field fetch

Returns:

The field, if found

toMap

public Map toMap()

Description copied from interface: BSONObject

Returns a map representing this BSONObject.

Specified by:

toMap in interface BSONObject

Returns:

the map

removeField

public Object removeField(String key)

Description copied from interface: BSONObject

Removes a field with a given name from this object.

Specified by:

removeField in interface BSONObject

Parameters:

key - The name of the field to remove

Returns:

The value removed from this object

containsKey

@Deprecated
public boolean containsKey(String s)

Deprecated.

Description copied from interface: BSONObject

Deprecated

Specified by:

containsKey in interface BSONObject

Returns:

True if the key is present

containsField

public boolean containsField(String s)

Description copied from interface: BSONObject

Checks if this object contains a field with the given name.

Specified by:

containsField in interface BSONObject

Parameters:

s - Field name for which to check

Returns:

True if the field is present

keySet

public Set<String> keySet()

Description copied from interface: BSONObject

Returns this object's fields' names

Specified by:

keySet in interface BSONObject

Returns:

the set of all keys in the document

entrySet

public Set<Map.Entry<String,Object>> entrySet()

This method will be more efficient than using a combination of keySet() and get(String key)

Returns:

the set of entries (key, value) in the document

isElementEmpty

@Deprecated
protected boolean isElementEmpty(int offset)

Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.

isEmpty

public boolean isEmpty()

getBSONSize

public int getBSONSize()

pipe

public int pipe(OutputStream os)
         throws IOException

Throws:

IOException

getElementType

@Deprecated
protected byte getElementType(int offset)

Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.

getElementBSONSize

@Deprecated
protected int getElementBSONSize(int offset)

Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.

sizeCString

@Deprecated
protected int sizeCString(int offset)

Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.

Returns the size of the BSON cstring at the given offset in the buffer

Parameters:

offset - the offset into the buffer

Returns:

the size of the BSON cstring, including the null terminator

getElementValue

@Deprecated
protected Object getElementValue(org.bson.LazyBSONObject.ElementRecord record)

Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.

getOffset

protected int getOffset()

getBytes

protected byte[] getBytes()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Returns a JSON serialization of this object

Overrides:

toString in class Object

Returns:

JSON serialization