io.wcm.sling.commons.resource

Class ImmutableValueMap

java.lang.Object

io.wcm.sling.commons.resource.ImmutableValueMap

All Implemented Interfaces:

Map<String,Object>, org.apache.sling.api.resource.ValueMap

public final class ImmutableValueMap
extends Object
implements org.apache.sling.api.resource.ValueMap

ValueMap that does not support changing its content. All methods that may change the content will throw a UnsupportedOperationException. Static convenience methods provide similar behavior as Guava ImmutableMap variants.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ImmutableValueMap.Builder Builder interface for ImmutableValueMap.

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

Map.Entry<K,V>

Field Summary

Fields inherited from interface org.apache.sling.api.resource.ValueMap

EMPTY

Method Summary

Methods

Modifier and Type	Method and Description
static ImmutableValueMap.Builder	builder() Returns a new builder.
void	clear() Deprecated. Unsupported operation
boolean	containsKey(Object key)
boolean	containsValue(Object value)
static ImmutableValueMap	copyOf(Map<String,Object> map) Returns an immutable map containing the same entries as map.
Set<Map.Entry<String,Object>>	entrySet()
Object	get(Object key)
<T> T	get(String name, Class<T> type)
<T> T	get(String name, T defaultValue)
boolean	isEmpty()
Set<String>	keySet()
static ImmutableValueMap	of() Returns the empty map.
static ImmutableValueMap	of(String k1, Object v1) Returns an immutable map containing a single entry.
static ImmutableValueMap	of(String k1, Object v1, String k2, Object v2) Returns an immutable map containing the given entries, in order.
static ImmutableValueMap	of(String k1, Object v1, String k2, Object v2, String k3, Object v3) Returns an immutable map containing the given entries, in order.
static ImmutableValueMap	of(String k1, Object v1, String k2, Object v2, String k3, Object v3, String k4, Object v4) Returns an immutable map containing the given entries, in order.
static ImmutableValueMap	of(String k1, Object v1, String k2, Object v2, String k3, Object v3, String k4, Object v4, String k5, Object v5) Returns an immutable map containing the given entries, in order.
Object	put(String key, Object value) Deprecated. Unsupported operation
void	putAll(Map<? extends String,? extends Object> m) Deprecated. Unsupported operation
Object	remove(Object key) Deprecated. Unsupported operation
int	size()
Collection<Object>	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

equals, hashCode

Method Detail

get

public <T> T get(String name,
        Class<T> type)

Specified by:

get in interface org.apache.sling.api.resource.ValueMap

get

public <T> T get(String name,
        T defaultValue)

Specified by:

get in interface org.apache.sling.api.resource.ValueMap

size

public int size()

Specified by:

size in interface Map<String,Object>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<String,Object>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,Object>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<String,Object>

get

public Object get(Object key)

Specified by:

get in interface Map<String,Object>

keySet

public Set<String> keySet()

Specified by:

keySet in interface Map<String,Object>

values

public Collection<Object> values()

Specified by:

values in interface Map<String,Object>

entrySet

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

Specified by:

entrySet in interface Map<String,Object>

put

@Deprecated
public Object put(String key,
                    Object value)

Deprecated. Unsupported operation

Specified by:

put in interface Map<String,Object>

remove

@Deprecated
public Object remove(Object key)

Deprecated. Unsupported operation

Specified by:

remove in interface Map<String,Object>

putAll

@Deprecated
public void putAll(Map<? extends String,? extends Object> m)

Deprecated. Unsupported operation

Specified by:

putAll in interface Map<String,Object>

clear

@Deprecated
public void clear()

Deprecated. Unsupported operation

Specified by:

clear in interface Map<String,Object>

of

public static ImmutableValueMap of()

Returns the empty map. This map behaves and performs comparably to Collections.emptyMap(), and is preferable mainly for consistency and maintainability of your code.

of

public static ImmutableValueMap of(String k1,
                   Object v1)

Returns an immutable map containing a single entry. This map behaves and performs comparably to Collections.singletonMap(K, V) but will not accept a null key or value. It is preferable mainly for consistency and maintainability of your code.

of

public static ImmutableValueMap of(String k1,
                   Object v1,
                   String k2,
                   Object v2)

Returns an immutable map containing the given entries, in order.

Throws:

IllegalArgumentException - if duplicate keys are provided

of

public static ImmutableValueMap of(String k1,
                   Object v1,
                   String k2,
                   Object v2,
                   String k3,
                   Object v3)

Returns an immutable map containing the given entries, in order.

Throws:

IllegalArgumentException - if duplicate keys are provided

of

public static ImmutableValueMap of(String k1,
                   Object v1,
                   String k2,
                   Object v2,
                   String k3,
                   Object v3,
                   String k4,
                   Object v4)

Returns an immutable map containing the given entries, in order.

Throws:

IllegalArgumentException - if duplicate keys are provided

of

public static ImmutableValueMap of(String k1,
                   Object v1,
                   String k2,
                   Object v2,
                   String k3,
                   Object v3,
                   String k4,
                   Object v4,
                   String k5,
                   Object v5)

Returns an immutable map containing the given entries, in order.

Throws:

IllegalArgumentException - if duplicate keys are provided

builder

public static ImmutableValueMap.Builder builder()

Returns a new builder. The generated builder is equivalent to the builder created by the ImmutableValueMap.Builder constructor.

copyOf

public static ImmutableValueMap copyOf(Map<String,Object> map)

Returns an immutable map containing the same entries as map. If map somehow contains entries with duplicate keys (for example, if it is a SortedMap whose comparator is not consistent with equals), the results of this method are undefined.

Despite the method name, this method attempts to avoid actually copying the data when it is safe to do so. The exact circumstances under which a copy will or will not be performed are undocumented and subject to change.

Throws:

NullPointerException - if any key or value in map is null