com.mongodb

Class BasicDBObjectBuilder

java.lang.Object

com.mongodb.BasicDBObjectBuilder

public class BasicDBObjectBuilder
extends Object

Utility for building complex objects. For example:

    BasicDBObjectBuilder.start().add( "name" , "eliot").add("number" , 17).get()
 

Constructor Summary

Constructors

Constructor and Description
BasicDBObjectBuilder() Creates a builder intialized with an empty document.

Method Summary

Modifier and Type	Method and Description
BasicDBObjectBuilder	add(String key, Object val) Same as append
BasicDBObjectBuilder	append(String key, Object val) Appends the key/value to the active object
DBObject	get() Gets the top level document.
boolean	isEmpty() Returns true if no key/value was inserted into the top level document.
BasicDBObjectBuilder	pop() Pops the active object, which means that the parent object becomes active
BasicDBObjectBuilder	push(String key) Creates an new empty object and inserts it into the current object with the given key.
static BasicDBObjectBuilder	start() Creates a builder intialized with an empty document.
static BasicDBObjectBuilder	start(Map documentAsMap) Creates an object builder from an existing map of key value pairs.
static BasicDBObjectBuilder	start(String key, Object val) Creates a builder initialized with the given key/value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BasicDBObjectBuilder

public BasicDBObjectBuilder()

Creates a builder intialized with an empty document.

Method Detail

start

public static BasicDBObjectBuilder start()

Creates a builder intialized with an empty document.

Returns:

The new empty builder

start

public static BasicDBObjectBuilder start(String key,
                                         Object val)

Creates a builder initialized with the given key/value.

Parameters:

key - The field name

val - The value

Returns:

the new builder

start

public static BasicDBObjectBuilder start(Map documentAsMap)

Creates an object builder from an existing map of key value pairs.

Parameters:

documentAsMap - a document in Map form.

Returns:

the new builder

append

public BasicDBObjectBuilder append(String key,
                                   Object val)

Appends the key/value to the active object

Parameters:

key - the field name

val - the value of the field

Returns:

this so calls can be chained

add

public BasicDBObjectBuilder add(String key,
                                Object val)

Same as append

Parameters:

key - the field name

val - the value of the field

Returns:

this so calls can be chained

See Also:

append(String, Object)

push

public BasicDBObjectBuilder push(String key)

Creates an new empty object and inserts it into the current object with the given key. The new child object becomes the active one.

Parameters:

key - the field name

Returns:

this so calls can be chained

pop

public BasicDBObjectBuilder pop()

Pops the active object, which means that the parent object becomes active

Returns:

this so calls can be chained

get

public DBObject get()

Gets the top level document.

Returns:

The base object

isEmpty

public boolean isEmpty()

Returns true if no key/value was inserted into the top level document.

Returns:

true if empty