com.google.common.collect
Class ForwardingSetMultimap<K,V>

java.lang.Object
  extended by com.google.common.collect.ForwardingObject
      extended by com.google.common.collect.ForwardingMultimap<K,V>
          extended by com.google.common.collect.ForwardingSetMultimap<K,V>
All Implemented Interfaces:
Multimap<K,V>, SetMultimap<K,V>
Direct Known Subclasses:
ForwardingSortedSetMultimap

@GwtCompatible
public abstract class ForwardingSetMultimap<K,V>
extends ForwardingMultimap<K,V>
implements SetMultimap<K,V>

A set multimap which forwards all its method calls to another set multimap. Subclasses should override one or more methods to modify the behavior of the backing multimap as desired per the decorator pattern.

Since:
3
Author:
Kurt Alfred Kluever

Constructor Summary
ForwardingSetMultimap()
           
 
Method Summary
protected abstract  SetMultimap<K,V> delegate()
          Returns the backing delegate instance that methods are forwarded to.
 Set<Map.Entry<K,V>> entries()
          Returns a collection of all key-value pairs.
 Set<V> get(K key)
          Returns a collection view of all values associated with a key.
 Set<V> removeAll(Object key)
          Removes all values associated with a given key.
 Set<V> replaceValues(K key, 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.ForwardingMultimap
asMap, clear, containsEntry, containsKey, containsValue, equals, hashCode, isEmpty, keys, keySet, put, putAll, putAll, 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.SetMultimap
asMap, equals
 
Methods inherited from interface com.google.common.collect.Multimap
clear, containsEntry, containsKey, containsValue, hashCode, isEmpty, keys, keySet, put, putAll, putAll, remove, size, values
 

Constructor Detail

ForwardingSetMultimap

public ForwardingSetMultimap()
Method Detail

delegate

protected abstract SetMultimap<K,V> delegate()
Description copied from class: ForwardingObject
Returns the backing delegate instance that methods are forwarded to. Abstract subclasses generally override this method with an abstract method that has a more specific return type, such as ForwardingSet.delegate(). Concrete subclasses override this method to supply the instance being decorated.

Specified by:
delegate in class ForwardingMultimap<K,V>

entries

public Set<Map.Entry<K,V>> entries()
Description copied from interface: Multimap
Returns a collection of all key-value pairs. Changes to the returned collection will update the underlying multimap, and vice versa. The entries collection does not support the add or addAll operations.

Specified by:
entries in interface Multimap<K,V>
Specified by:
entries in interface SetMultimap<K,V>
Overrides:
entries in class ForwardingMultimap<K,V>
Returns:
collection of map entries consisting of key-value pairs

get

public Set<V> get(@Nullable
                  K key)
Description copied from interface: Multimap
Returns a collection view of all values associated with a key. If no mappings in the multimap have the provided key, an empty collection is returned.

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

Specified by:
get in interface Multimap<K,V>
Specified by:
get in interface SetMultimap<K,V>
Overrides:
get in class ForwardingMultimap<K,V>
Parameters:
key - key to search for in multimap
Returns:
the collection of values that the key maps to

removeAll

public Set<V> removeAll(@Nullable
                        Object key)
Description copied from interface: Multimap
Removes all values associated with a given key.

Specified by:
removeAll in interface Multimap<K,V>
Specified by:
removeAll in interface SetMultimap<K,V>
Overrides:
removeAll in class ForwardingMultimap<K,V>
Parameters:
key - key of entries to remove from the multimap
Returns:
the collection of removed values, or an empty collection if no values were associated with the provided key. The collection may be modifiable, but updating it will have no effect on the multimap.

replaceValues

public Set<V> replaceValues(K key,
                            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.

Specified by:
replaceValues in interface Multimap<K,V>
Specified by:
replaceValues in interface SetMultimap<K,V>
Overrides:
replaceValues in class ForwardingMultimap<K,V>
Parameters:
key - key to store in the multimap
values - values to store in the multimap
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.