[AETHER-72] Add bulk update to ConsistentMultimap
Change-Id: I61e9f0c2ed5ab368777c64b6fb4aa2c8dd31d081
diff --git a/core/api/src/main/java/org/onosproject/store/service/ConsistentMultimap.java b/core/api/src/main/java/org/onosproject/store/service/ConsistentMultimap.java
index 99045a8..8aabca7 100644
--- a/core/api/src/main/java/org/onosproject/store/service/ConsistentMultimap.java
+++ b/core/api/src/main/java/org/onosproject/store/service/ConsistentMultimap.java
@@ -149,6 +149,18 @@
Versioned<Collection<? extends V>> removeAll(K key);
/**
+ * Removes the set of key-value pairs with the specified key and values if they
+ * exist. In implementations that allow duplicates each instance of a key
+ * will remove one matching entry, which one is not defined. Equivalent to
+ * repeated calls to {@code remove()} for each key value pair but more
+ * efficient.
+ *
+ * @param mapping the keys-values to be removed
+ * @return true if the map changes because of this call, false otherwise.
+ */
+ boolean removeAll(Map<K, Collection<? extends V>> mapping);
+
+ /**
* Adds the set of key-value pairs of the specified key with each of the
* values in the iterable if each key-value pair does not already exist,
* if the pair does exist the behavior is implementation specific.
@@ -162,6 +174,18 @@
boolean putAll(K key, Collection<? extends V> values);
/**
+ * Adds the set of key-value pairs of the specified mapping with each of
+ * the values in the iterable if each key-value pair does not already exist,
+ * if the pair does exist the behavior is implementation specific.
+ * (Same as repeated puts but with efficiency gains.)
+ *
+ * @param mapping the keys-values to be added
+ * @return true if any change in the map results from this call,
+ * false otherwise
+ */
+ boolean putAll(Map<K, Collection<? extends V>> mapping);
+
+ /**
* Stores all the values in values associated with the key specified,
* removes all preexisting values and returns a collection of the removed
* values which may be empty if the entry did not exist.