com.couchbase.lite

Class MutableDocument

java.lang.Object

com.couchbase.lite.Document

com.couchbase.lite.MutableDocument

All Implemented Interfaces:

DictionaryInterface, MutableDictionaryInterface, Iterable<String>

public final class MutableDocument
extends Document
implements MutableDictionaryInterface

A Couchbase Lite Document. A document has key/value properties like a Map.

Constructor Summary

Constructors

Constructor and Description
MutableDocument() Creates a new Document object with a new random UUID.
MutableDocument(Map<String,Object> data) Initializes a new CBLDocument object with a new random UUID and the dictionary as the content.
MutableDocument(String id) Creates a new Document object with the given ID.
MutableDocument(String id, Map<String,Object> data) Initializes a new Document object with a given ID and the dictionary as the content.

Method Summary

Modifier and Type	Method and Description
MutableArray	getArray(String key) Get a property's value as a Array, which is a mapping object of an array value.
MutableDictionary	getDictionary(String key) Get a property's value as a Dictionary, which is a mapping object of an dictionary value.
MutableDocument	remove(String key) Removes the mapping for a key from this Dictionary
MutableDocument	setArray(String key, Array value) Set an Array value for the given key
MutableDocument	setBlob(String key, Blob value) Set a Blob value for the given key
MutableDocument	setBoolean(String key, boolean value) Set a boolean value for the given key
MutableDocument	setData(Map<String,Object> data) Set a dictionary as a content.
MutableDocument	setDate(String key, Date value) Set a Date value for the given key
MutableDocument	setDictionary(String key, Dictionary value) Set a Dictionary value for the given key
MutableDocument	setDouble(String key, double value) Set a double value for the given key
MutableDocument	setFloat(String key, float value) Set a float value for the given key
MutableDocument	setInt(String key, int value) Set a integer value for the given key
MutableDocument	setLong(String key, long value) Set a long value for the given key
MutableDocument	setNumber(String key, Number value) Set a Number value for the given key
MutableDocument	setString(String key, String value) Set a String value for the given key
MutableDocument	setValue(String key, Object value) Set an object value by key.
MutableDocument	toMutable() Returns the copy of this MutableDocument object.

Methods inherited from class com.couchbase.lite.Document

contains, count, equals, getBlob, getBoolean, getDate, getDouble, getFloat, getId, getInt, getKeys, getLong, getNumber, getRevisionID, getSequence, getString, getValue, hashCode, iterator, toMap, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.couchbase.lite.DictionaryInterface

contains, count, getBlob, getBoolean, getDate, getDouble, getFloat, getInt, getKeys, getLong, getNumber, getString, getValue, toMap

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

MutableDocument

public MutableDocument()

Creates a new Document object with a new random UUID. The created document will be saved into a database when you call the Database's save(Document) method with the document object given.

MutableDocument

public MutableDocument(@Nullable
                       String id)

Creates a new Document object with the given ID. If a null ID value is given, the document will be created with a new random UUID. The created document will be saved into a database when you call the Database's save(Document) method with the document object given.

Parameters:

id - the document ID.

MutableDocument

public MutableDocument(@NonNull
                       Map<String,Object> data)

Initializes a new CBLDocument object with a new random UUID and the dictionary as the content. Allowed value types are List, Date, Map, Number, null, String, Array, Blob, and Dictionary. List and Map containers must contain only the above types. The created document will be saved into a database when you call Database.save(Document) with this document object.

Parameters:

data - the Map object

MutableDocument

public MutableDocument(@Nullable
                       String id,
                       Map<String,Object> data)

Initializes a new Document object with a given ID and the dictionary as the content. If a null ID value is given, the document will be created with a new random UUID. Allowed value types are List, Date, Map, Number, null, String, Array, Blob, and Dictionary. The List and Map must contain only the above types. The created document will be saved into a database when you call the Database's save(Document) method with the document object given.

Parameters:

id - the document ID.

data - the Map object

Method Detail

toMutable

@NonNull
public MutableDocument toMutable()

Returns the copy of this MutableDocument object.

Overrides:

toMutable in class Document

Returns:

The MutableDocument object

setData

@NonNull
public MutableDocument setData(Map<String,Object> data)

Set a dictionary as a content. Allowed value types are List, Date, Map, Number, null, String, Array, Blob, and Dictionary. The List and Map must contain only the above types. Setting the new dictionary content will replace the current data including the existing Array and Dictionary objects.

Specified by:

setData in interface MutableDictionaryInterface

Parameters:

data - the dictionary object.

Returns:

this Document instance

setValue

@NonNull
public MutableDocument setValue(@NonNull
                                         String key,
                                         Object value)

Set an object value by key. Allowed value types are List, Date, Map, Number, null, String, Array, Blob, and Dictionary. The List and Map must contain only the above types. An Date object will be converted to an ISO-8601 format string.

Specified by:

setValue in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the Object value.

Returns:

this Document instance

setString

@NonNull
public MutableDocument setString(@NonNull
                                          String key,
                                          String value)

Set a String value for the given key

Specified by:

setString in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the String value.

Returns:

this MutableDocument instance

setNumber

@NonNull
public MutableDocument setNumber(@NonNull
                                          String key,
                                          Number value)

Set a Number value for the given key

Specified by:

setNumber in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the Number value.

Returns:

this MutableDocument instance

setInt

@NonNull
public MutableDocument setInt(@NonNull
                                       String key,
                                       int value)

Set a integer value for the given key

Specified by:

setInt in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the integer value.

Returns:

this MutableDocument instance

setLong

@NonNull
public MutableDocument setLong(@NonNull
                                        String key,
                                        long value)

Set a long value for the given key

Specified by:

setLong in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the long value.

Returns:

this MutableDocument instance

setFloat

@NonNull
public MutableDocument setFloat(@NonNull
                                         String key,
                                         float value)

Set a float value for the given key

Specified by:

setFloat in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the float value.

Returns:

this MutableDocument instance

setDouble

@NonNull
public MutableDocument setDouble(@NonNull
                                          String key,
                                          double value)

Set a double value for the given key

Specified by:

setDouble in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the double value.

Returns:

this MutableDocument instance

setBoolean

@NonNull
public MutableDocument setBoolean(@NonNull
                                           String key,
                                           boolean value)

Set a boolean value for the given key

Specified by:

setBoolean in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the boolean value.

Returns:

this MutableDocument instance

setBlob

@NonNull
public MutableDocument setBlob(@NonNull
                                        String key,
                                        Blob value)

Set a Blob value for the given key

Specified by:

setBlob in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the Blob value.

Returns:

this MutableDocument instance

setDate

@NonNull
public MutableDocument setDate(@NonNull
                                        String key,
                                        Date value)

Set a Date value for the given key

Specified by:

setDate in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the Date value.

Returns:

this MutableDocument instance

setArray

@NonNull
public MutableDocument setArray(@NonNull
                                         String key,
                                         Array value)

Set an Array value for the given key

Specified by:

setArray in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the Array value.

Returns:

this MutableDocument instance

setDictionary

@NonNull
public MutableDocument setDictionary(@NonNull
                                              String key,
                                              Dictionary value)

Set a Dictionary value for the given key

Specified by:

setDictionary in interface MutableDictionaryInterface

Parameters:

key - the key.

value - the Dictionary value.

Returns:

this MutableDocument instance

remove

@NonNull
public MutableDocument remove(@NonNull
                                       String key)

Removes the mapping for a key from this Dictionary

Specified by:

remove in interface MutableDictionaryInterface

Parameters:

key - the key.

Returns:

this MutableDocument instance

getArray

public MutableArray getArray(@NonNull
                             String key)

Get a property's value as a Array, which is a mapping object of an array value. Returns null if the property doesn't exists, or its value is not an array.

Specified by:

getArray in interface DictionaryInterface

Specified by:

getArray in interface MutableDictionaryInterface

Overrides:

getArray in class Document

Parameters:

key - the key.

Returns:

the Array object.

getDictionary

public MutableDictionary getDictionary(@NonNull
                                       String key)

Get a property's value as a Dictionary, which is a mapping object of an dictionary value. Returns null if the property doesn't exists, or its value is not an dictionary.

Specified by:

getDictionary in interface DictionaryInterface

Specified by:

getDictionary in interface MutableDictionaryInterface

Overrides:

getDictionary in class Document

Parameters:

key - the key.

Returns:

the Dictionary object or null if the key doesn't exist.