Interface MapDifference<K extends @Nullable Object,V extends @Nullable Object>

All Known Subinterfaces:

SortedMapDifference<K,V>

@DoNotMock("Use Maps.difference")
@GwtCompatible
public interface MapDifference<K extends @Nullable Object,V extends @Nullable Object>

An object representing the differences between two maps.

Since:

2.0

Author:

Kevin Bourrillion

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	MapDifference.ValueDifference<V extends @Nullable Object>	A difference between the mappings from two maps with the same key.

Method Summary

Modifier and Type	Method	Description
boolean	areEqual()	Returns true if there are no differences between the two maps; that is, if the maps are equal.
Map<K,MapDifference.ValueDifference<V>>	entriesDiffering()	Returns an unmodifiable map describing keys that appear in both maps, but with different values.
Map<K,V>	entriesInCommon()	Returns an unmodifiable map containing the entries that appear in both maps; that is, the intersection of the two maps.
Map<K,V>	entriesOnlyOnLeft()	Returns an unmodifiable map containing the entries from the left map whose keys are not present in the right map.
Map<K,V>	entriesOnlyOnRight()	Returns an unmodifiable map containing the entries from the right map whose keys are not present in the left map.
boolean	equals(@Nullable Object object)	Compares the specified object with this instance for equality.
int	hashCode()	Returns the hash code for this instance.

Method Details

areEqual

boolean areEqual()

Returns true if there are no differences between the two maps; that is, if the maps are equal.

entriesOnlyOnLeft

Map<K,V> entriesOnlyOnLeft()

Returns an unmodifiable map containing the entries from the left map whose keys are not present in the right map.

entriesOnlyOnRight

Map<K,V> entriesOnlyOnRight()

Returns an unmodifiable map containing the entries from the right map whose keys are not present in the left map.

entriesInCommon

Map<K,V> entriesInCommon()

Returns an unmodifiable map containing the entries that appear in both maps; that is, the intersection of the two maps.

entriesDiffering

Map<K,MapDifference.ValueDifference<V>> entriesDiffering()

Returns an unmodifiable map describing keys that appear in both maps, but with different values.

equals

boolean equals(@Nullable Object object)

Compares the specified object with this instance for equality. Returns true if the given object is also a MapDifference and the values returned by the entriesOnlyOnLeft(), entriesOnlyOnRight(), entriesInCommon() and entriesDiffering() of the two instances are equal.

Overrides:

equals in class Object

hashCode

int hashCode()

Returns the hash code for this instance. This is defined as the hash code of

Arrays.asList(entriesOnlyOnLeft(), entriesOnlyOnRight(),
    entriesInCommon(), entriesDiffering())

Overrides:

hashCode in class Object