Package com.google.common.collect

Class MapConstraints.ConstrainedListMultimap<K,V>

java.lang.Object

com.google.common.collect.ForwardingObject

com.google.common.collect.ForwardingMultimap<K,V>

com.google.common.collect.MapConstraints.ConstrainedMultimap<K,V>

com.google.common.collect.MapConstraints.ConstrainedListMultimap<K,V>

All Implemented Interfaces:

ListMultimap<K,V>, Multimap<K,V>, java.io.Serializable

Enclosing class:

MapConstraints

private static class MapConstraints.ConstrainedListMultimap<K,V>
extends MapConstraints.ConstrainedMultimap<K,V>
implements ListMultimap<K,V>

Field Summary

Fields inherited from class com.google.common.collect.MapConstraints.ConstrainedMultimap

asMap, constraint, delegate, entries

Constructor Summary

Constructors

Constructor	Description
ConstrainedListMultimap(ListMultimap<K,V> delegate, MapConstraint<? super K,? super V> constraint)

Method Summary

Modifier and Type	Method	Description
java.util.List<V>	get(K key)	Returns a view collection of the values associated with key in this multimap, if any.
java.util.List<V>	removeAll(java.lang.Object key)	Removes all values associated with the key key.
java.util.List<V>	replaceValues(K key, java.lang.Iterable<? extends V> values)	Stores a collection of values with the same key, replacing any existing values for that key.

Methods inherited from class com.google.common.collect.MapConstraints.ConstrainedMultimap

asMap, delegate, entries, put, putAll, putAll

Methods inherited from class com.google.common.collect.ForwardingMultimap

clear, containsEntry, containsKey, containsValue, equals, hashCode, isEmpty, keys, keySet, remove, size, values

Methods inherited from class com.google.common.collect.ForwardingObject

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.common.collect.ListMultimap

asMap, equals

Methods inherited from interface com.google.common.collect.Multimap

clear, containsEntry, containsKey, containsValue, entries, hashCode, isEmpty, keys, keySet, put, putAll, putAll, remove, size, values

Constructor Detail

ConstrainedListMultimap

ConstrainedListMultimap(ListMultimap<K,V> delegate,
                        MapConstraint<? super K,? super V> constraint)

Method Detail

get

public java.util.List<V> get(K key)

Description copied from interface: Multimap

Returns a view collection of the values associated with key in this multimap, if any. Note that when containsKey(key) is false, this returns an empty collection, not null.

Changes to the returned collection will update the underlying multimap, and vice versa.

Specified by:

get in interface ListMultimap<K,V>

Specified by:

get in interface Multimap<K,V>

Overrides:

get in class MapConstraints.ConstrainedMultimap<K,V>

removeAll

public java.util.List<V> removeAll(java.lang.Object key)

Description copied from interface: Multimap

Removes all values associated with the key key.

Once this method returns, key will not be mapped to any values, so it will not appear in Multimap.keySet(), Multimap.asMap(), or any other views.

Specified by:

removeAll in interface ListMultimap<K,V>

Specified by:

removeAll in interface Multimap<K,V>

Overrides:

removeAll in class ForwardingMultimap<K,V>

Returns:

the values that were removed (possibly empty). The returned collection may be modifiable, but updating it will have no effect on the multimap.

replaceValues

public java.util.List<V> replaceValues(K key,
                                       java.lang.Iterable<? extends V> values)

Description copied from interface: Multimap

Stores a collection of values with the same key, replacing any existing values for that key.

If values is empty, this is equivalent to removeAll(key).

Specified by:

replaceValues in interface ListMultimap<K,V>

Specified by:

replaceValues in interface Multimap<K,V>

Overrides:

replaceValues in class MapConstraints.ConstrainedMultimap<K,V>

Returns:

the collection of replaced values, or an empty collection if no values were previously associated with the key. The collection may be modifiable, but updating it will have no effect on the multimap.