org.bson

Class LazyBSONObject

java.lang.Object

org.bson.LazyBSONObject

All Implemented Interfaces:

BSONObject

Direct Known Subclasses:

KeyCachingLazyBSONObject, LazyBSONList, LazyDBObject

public class LazyBSONObject
extends java.lang.Object
implements BSONObject

Author:

antoine, brendan, scotthernandez, Kilroy Wuz Here

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	LazyBSONObject.LazyBSONKeySet

Field Summary

Fields

Modifier and Type	Field and Description
protected LazyBSONCallback	_callback
protected int	_doc_start_offset
protected BSONByteBuffer	_input

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(java.lang.String s) Checks if this object contains a field with the given name.
boolean	containsKey(java.lang.String s) Deprecated.
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	entrySet() This method will be more efficient than using a combination of keySet() and get(String key)
boolean	equals(java.lang.Object o)
java.lang.Object	get(java.lang.String key) Gets a field from this object by a given name.
int	getBSONSize()
protected int	getElementBSONSize(int offset)
protected byte	getElementType(int offset)
protected java.lang.Object	getElementValue(org.bson.LazyBSONObject.ElementRecord record)
int	hashCode()
protected boolean	isElementEmpty(int offset)
boolean	isEmpty()
java.util.Set<java.lang.String>	keySet() Returns this object's fields' names
int	pipe(java.io.OutputStream os)
java.lang.Object	put(java.lang.String key, java.lang.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(java.util.Map m) Sets all key/value pairs from a map into this object
java.lang.Object	removeField(java.lang.String key) Removes a field with a given name from this object.
protected int	sizeCString(int offset) Returns the size of the BSON cstring at the given offset in the buffer
java.util.Map	toMap() Returns a map representing this BSONObject.
java.lang.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

protected final int _doc_start_offset

_input

protected final BSONByteBuffer _input

_callback

protected final LazyBSONCallback _callback

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 java.lang.Object put(java.lang.String key,
                   java.lang.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(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

Parameters:

m - the map

get

public java.lang.Object get(java.lang.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 java.util.Map toMap()

Description copied from interface: BSONObject

Returns a map representing this BSONObject.

Specified by:

toMap in interface BSONObject

Returns:

the map

removeField

public java.lang.Object removeField(java.lang.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(java.lang.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(java.lang.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 java.util.Set<java.lang.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 java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.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

protected boolean isElementEmpty(int offset)

isEmpty

public boolean isEmpty()

getBSONSize

public int getBSONSize()

pipe

public int pipe(java.io.OutputStream os)
         throws java.io.IOException

Throws:

java.io.IOException

getElementType

protected byte getElementType(int offset)

getElementBSONSize

protected int getElementBSONSize(int offset)

sizeCString

protected int sizeCString(int offset)

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

protected java.lang.Object getElementValue(org.bson.LazyBSONObject.ElementRecord record)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Returns a JSON serialization of this object

Overrides:

toString in class java.lang.Object

Returns:

JSON serialization