Package com.couchbase.client.java.datastructures.collections

Class CouchbaseMap<V>

java.lang.Object

java.util.AbstractMap<String,V>

com.couchbase.client.java.datastructures.collections.CouchbaseMap<V>

Type Parameters:

V - the type of values in the map (restricted to JsonObject.

All Implemented Interfaces:

Map<String,V>

@Committed
@Public
public class CouchbaseMap<V>
extends AbstractMap<String,V>

A CouchbaseMap is a Map backed by a Couchbase document (more specifically a JSON object). Null keys are NOT permitted, and keys are restricted to String. Values in a CouchbaseMap are restricted to the types that a JSON objects can contain. JSON sub-objects and sub-arrays can be represented as JsonObject and JsonArray respectively.

Since:

2.3.6

Author:

Simon Baslé, Subhashni Balakrishnan

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K extends Object,V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object,V extends Object>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Constructor Summary

Constructors

Constructor	Description
CouchbaseMap(String id, Bucket bucket)	Create a new CouchbaseMap, backed by the document identified by id in the given Couchbase bucket.
CouchbaseMap(String id, Bucket bucket, Map<String,? extends V> data)	Create a new CouchbaseMap, backed by the document identified by id in the given Couchbase bucket.

Method Summary

Modifier and Type	Method	Description
void	clear()
boolean	containsKey(Object key)
boolean	containsValue(Object value)
Set<Map.Entry<String,V>>	entrySet()
V	get(Object key)
V	put(String key, V value)
V	remove(Object key)
int	size()

Methods inherited from class java.util.AbstractMap

clone, equals, hashCode, isEmpty, keySet, putAll, toString, values

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

CouchbaseMap

public CouchbaseMap(String id,
                    Bucket bucket)

Create a new CouchbaseMap, backed by the document identified by id in the given Couchbase bucket. Note that if the document already exists, its content will be used as initial content for this collection. Otherwise it is created empty.

Parameters:

id - the id of the Couchbase document to back the map.

bucket - the Bucket through which to interact with the document.

CouchbaseMap

public CouchbaseMap(String id,
                    Bucket bucket,
                    Map<String,? extends V> data)

Create a new CouchbaseMap, backed by the document identified by id in the given Couchbase bucket. Note that if the document already exists, its content is reset to the values copied from the given data Map. A null or empty data map will re-initialize any pre-existing document to an empty content.

Parameters:

id - the id of the Couchbase document to back the list.

bucket - the Bucket through which to interact with the document.

data - Map of the elements to initially store in the CouchbaseMap.

Method Detail

put

public V put(String key,
             V value)

Specified by:

put in interface Map<String,V>

Overrides:

put in class AbstractMap<String,V>

get

public V get(Object key)

Specified by:

get in interface Map<String,V>

Overrides:

get in class AbstractMap<String,V>

remove

public V remove(Object key)

Specified by:

remove in interface Map<String,V>

Overrides:

remove in class AbstractMap<String,V>

clear

public void clear()

Specified by:

clear in interface Map<String,V>

Overrides:

clear in class AbstractMap<String,V>

entrySet

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

Specified by:

entrySet in interface Map<String,V>

Specified by:

entrySet in class AbstractMap<String,V>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,V>

Overrides:

containsKey in class AbstractMap<String,V>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<String,V>

Overrides:

containsValue in class AbstractMap<String,V>

size

public int size()

Specified by:

size in interface Map<String,V>

Overrides:

size in class AbstractMap<String,V>