java.lang.Object
com.google.common.collect.ForwardingObject
com.google.common.collect.ForwardingMultimap<K,V>
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 extends @Nullable Object, V extends @Nullable Object>
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.
default method warning: This class does not forward calls to
default methods. Instead, it inherits their default implementations. When those implementations
invoke methods, they invoke methods on the ForwardingSetMultimap.
- Since:
- 3.0
- Author:
- Kurt Alfred Kluever
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected abstract SetMultimap<K, V> delegate()Returns the backing delegate instance that methods are forwarded to.entries()Returns a view collection of all key-value pairs contained in this multimap, asMap.Entryinstances.Returns a view collection of the values associated withkeyin this multimap, if any.Removes all values associated with the keykey.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 ForwardingMultimap
asMap, clear, containsEntry, containsKey, containsValue, equals, hashCode, isEmpty, keys, keySet, put, putAll, putAll, remove, size, valuesModifier and TypeMethodDescriptionMap<K, Collection<V>> asMap()Returns a view of this multimap as aMapfrom each distinct key to the nonempty collection of that key's associated values.voidclear()Removes all key-value pairs from the multimap, leaving it empty.booleancontainsEntry(@Nullable Object key, @Nullable Object value) Returnstrueif this multimap contains at least one key-value pair with the keykeyand the valuevalue.booleancontainsKey(@Nullable Object key) Returnstrueif this multimap contains at least one key-value pair with the keykey.booleancontainsValue(@Nullable Object value) Returnstrueif this multimap contains at least one key-value pair with the valuevalue.booleanCompares the specified object with this multimap for equality.inthashCode()Returns the hash code for this multimap.booleanisEmpty()Returnstrueif this multimap contains no key-value pairs.keys()Returns a view collection containing the key from each key-value pair in this multimap, without collapsing duplicates.keySet()Returns a view collection of all distinct keys contained in this multimap.booleanStores a key-value pair in this multimap.booleanStores all key-value pairs ofmultimapin this multimap, in the order returned bymultimap.entries().booleanStores a key-value pair in this multimap for each ofvalues, all using the same key,key.booleanRemoves a single key-value pair with the keykeyand the valuevaluefrom this multimap, if such exists.intsize()Returns the number of key-value pairs in this multimap.values()Returns a view collection containing the value from each key-value pair contained in this multimap, without collapsing duplicates (sovalues().size() == size()).Methods inherited from class ForwardingObject
toStringMethods inherited from interface Multimap
forEachModifier and TypeMethodDescriptiondefault voidforEach(BiConsumer<? super K, ? super V> action) Performs the given action for all key-value pairs contained in this multimap.Methods inherited from interface SetMultimap
asMap, equals
-
Constructor Details
-
ForwardingSetMultimap
public ForwardingSetMultimap()Constructor for use by subclasses.
-
-
Method Details
-
delegate
Description copied from class:ForwardingObjectReturns 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. -
entries
Description copied from interface:MultimapReturns a view collection of all key-value pairs contained in this multimap, asMap.Entryinstances.Changes to the returned collection or the entries it contains will update the underlying multimap, and vice versa. However, adding to the returned collection is not possible.
- Specified by:
entriesin interfaceMultimap<K extends @Nullable Object, V extends @Nullable Object>- Specified by:
entriesin interfaceSetMultimap<K extends @Nullable Object, V extends @Nullable Object>- Overrides:
entriesin classForwardingMultimap<K extends @Nullable Object, V extends @Nullable Object>
-
get
Description copied from interface:MultimapReturns a view collection of the values associated withkeyin 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
Description copied from interface:MultimapRemoves all values associated with the keykey.Once this method returns,
keywill not be mapped to any values, so it will not appear inMultimap.keySet(),Multimap.asMap(), or any other views.- Specified by:
removeAllin interfaceMultimap<K extends @Nullable Object, V extends @Nullable Object>- Specified by:
removeAllin interfaceSetMultimap<K extends @Nullable Object, V extends @Nullable Object>- Overrides:
removeAllin 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
Description copied from interface:MultimapStores a collection of values with the same key, replacing any existing values for that key.If
valuesis empty, this is equivalent toremoveAll(key).- Specified by:
replaceValuesin interfaceMultimap<K extends @Nullable Object, V extends @Nullable Object>- Specified by:
replaceValuesin interfaceSetMultimap<K extends @Nullable Object, V extends @Nullable Object>- Overrides:
replaceValuesin 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.
-