Package com.mongodb

Class LazyDBObject

java.lang.Object

org.bson.LazyBSONObject

com.mongodb.LazyDBObject

All Implemented Interfaces:

DBObject, BSONObject

@Immutable
public class LazyDBObject
extends LazyBSONObject
implements DBObject

An immutable DBObject backed by a byte buffer that lazily provides keys and values on request. This is useful for transferring BSON documents between servers when you don't want to pay the performance penalty of encoding or decoding them fully.

Constructor Summary

Constructors

Constructor and Description
LazyDBObject(byte[] bytes, int offset, LazyBSONCallback callback) Construct an instance.
LazyDBObject(byte[] bytes, LazyBSONCallback callback) Construct an instance.

Method Summary

Modifier and Type	Method and Description
boolean	isPartialObject() Whether DBObject.markAsPartialObject() was ever called only matters if you are going to upsert and do not want to risk losing fields.
void	markAsPartialObject() If this object was retrieved with only some fields (using a field filter) this method will be called to mark it as such.

Methods inherited from class org.bson.LazyBSONObject

containsField, containsKey, entrySet, equals, get, getBSONSize, getBytes, getOffset, hashCode, isEmpty, keySet, pipe, put, putAll, putAll, removeField, toMap, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.bson.BSONObject

containsField, containsKey, get, keySet, put, putAll, putAll, removeField, toMap

Constructor Detail

LazyDBObject

public LazyDBObject(byte[] bytes,
                    LazyBSONCallback callback)

Construct an instance.

Parameters:

bytes - the raw bytes

callback - the callback to use to construct nested values

LazyDBObject

public LazyDBObject(byte[] bytes,
                    int offset,
                    LazyBSONCallback callback)

Construct an instance.

Parameters:

bytes - the raw bytes

offset - the offset into the raw bytes

callback - the callback to use to construct nested values

Method Detail

markAsPartialObject

public void markAsPartialObject()

Description copied from interface: DBObject

If this object was retrieved with only some fields (using a field filter) this method will be called to mark it as such.

Specified by:

markAsPartialObject in interface DBObject

isPartialObject

public boolean isPartialObject()

Description copied from interface: DBObject

Whether DBObject.markAsPartialObject() was ever called only matters if you are going to upsert and do not want to risk losing fields.

Specified by:

isPartialObject in interface DBObject

Returns:

true if this has been marked as a partial object