Package com.google.common.collect
Class ForwardingListMultimap<K extends @Nullable Object,V extends @Nullable Object>
- java.lang.Object
-
- com.google.common.collect.ForwardingObject
-
- com.google.common.collect.ForwardingMultimap<K,V>
-
- com.google.common.collect.ForwardingListMultimap<K,V>
-
- All Implemented Interfaces:
ListMultimap<K,V>
,Multimap<K,V>
@GwtCompatible public abstract class ForwardingListMultimap<K extends @Nullable Object,V extends @Nullable Object> extends ForwardingMultimap<K,V> implements ListMultimap<K,V>
A list multimap which forwards all its method calls to another list multimap. Subclasses should override one or more methods to modify the behavior of the backing multimap as desired per the decorator pattern.default
method warning: This class does not forward calls todefault
methods. Instead, it inherits their default implementations. When those implementations invoke methods, they invoke methods on theForwardingListMultimap
.- Since:
- 3.0
- Author:
- Kurt Alfred Kluever
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
ForwardingListMultimap()
Constructor for use by subclasses.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected abstract ListMultimap<K,V>
delegate()
Returns the backing delegate instance that methods are forwarded to.List<V>
get(K key)
Returns a view collection of the values associated withkey
in this multimap, if any.List<V>
removeAll(Object key)
Removes all values associated with the keykey
.List<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, entries, 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.ListMultimap
asMap, equals
-
-
-
-
Constructor Detail
-
ForwardingListMultimap
protected ForwardingListMultimap()
Constructor for use by subclasses.
-
-
Method Detail
-
delegate
protected abstract ListMultimap<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 asForwardingSet.delegate()
. Concrete subclasses override this method to supply the instance being decorated.
-
get
public List<V> get(K key)
Description copied from interface:Multimap
Returns a view collection of the values associated withkey
in this multimap, if any. Note that whencontainsKey(key)
is false, this returns an empty collection, notnull
.Changes to the returned collection will update the underlying multimap, and vice versa.
-
removeAll
@CanIgnoreReturnValue public List<V> removeAll(@CheckForNull Object key)
Description copied from interface:Multimap
Removes all values associated with the keykey
.Once this method returns,
key
will not be mapped to any values, so it will not appear inMultimap.keySet()
,Multimap.asMap()
, or any other views.- Specified by:
removeAll
in interfaceListMultimap<K extends @Nullable Object,V extends @Nullable Object>
- Specified by:
removeAll
in interfaceMultimap<K extends @Nullable Object,V extends @Nullable Object>
- Overrides:
removeAll
in classForwardingMultimap<K extends @Nullable Object,V extends @Nullable Object>
- 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
@CanIgnoreReturnValue public List<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.If
values
is empty, this is equivalent toremoveAll(key)
.- Specified by:
replaceValues
in interfaceListMultimap<K extends @Nullable Object,V extends @Nullable Object>
- Specified by:
replaceValues
in interfaceMultimap<K extends @Nullable Object,V extends @Nullable Object>
- Overrides:
replaceValues
in classForwardingMultimap<K extends @Nullable Object,V extends @Nullable Object>
- 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.
-
-