Package org.assertj.core.internal
Class Maps
java.lang.Object
org.assertj.core.internal.Maps
Reusable assertions for
Map
s.-
Field Summary
FieldsModifier and TypeFieldDescription(package private) Conditions
(package private) Failures
private static final Maps
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription<K,
V> void assertContains
(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) Asserts that the givenMap
contains the given entries, in any order.<K,
V> void assertContainsAnyOf
(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) <K,
V> void assertContainsExactly
(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>... entries) Verifies that the actual map contains only the given entries and nothing else, in order.
This assertion should only be used with map that have a consistent iteration order (i.e.<K,
V> void assertContainsKeys
(AssertionInfo info, Map<K, V> actual, K... keys) Verifies that the actual map contain the given key.<K,
V> void assertContainsOnly
(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>... entries) Verifies that the actual map contains only the given entries and nothing else, in any order.<K,
V> void assertContainsOnlyKeys
(AssertionInfo info, Map<K, V> actual, K... keys) Verifies that the actual map contains only the given keys and nothing else, in any order.<K,
V> void assertContainsValue
(AssertionInfo info, Map<K, V> actual, V value) Verifies that the actual map contain the given value.<K,
V> void assertContainsValues
(AssertionInfo info, Map<K, V> actual, V... values) Verifies that the actual map contain the given values.<K,
V> void assertDoesNotContain
(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) Asserts that the givenMap
does not contain the given entries.<K,
V> void assertDoesNotContainKey
(AssertionInfo info, Map<K, V> actual, K key) Verifies that the actual map not contains the given key.<K,
V> void assertDoesNotContainKeys
(AssertionInfo info, Map<K, V> actual, K... keys) Verifies that the actual map not contains all the given keys.<K,
V> void assertDoesNotContainValue
(AssertionInfo info, Map<K, V> actual, V value) Verifies that the actual map not contains the given value.void
assertEmpty
(AssertionInfo info, Map<?, ?> actual) Asserts that the givenMap
is empty.<K,
V> void assertHasEntrySatisfying
(AssertionInfo info, Map<K, V> actual, K key, Consumer<? super V> valueRequirements) Verifies that theMap
contains the value for givenkey
that satisfy givenvalueRequirements
.<K,
V> void assertHasEntrySatisfying
(AssertionInfo info, Map<K, V> actual, K key, Condition<? super V> valueCondition) Verifies that the givenMap
contains the value for givenkey
that satisfy givenvalueCondition
.<K,
V> void assertHasEntrySatisfying
(AssertionInfo info, Map<K, V> actual, Condition<? super Map.Entry<K, V>> entryCondition) Verifies that the givenMap
contains an entry satisfying givenentryCondition
.<K,
V> void assertHasEntrySatisfyingConditions
(AssertionInfo info, Map<K, V> actual, Condition<? super K> keyCondition, Condition<? super V> valueCondition) Verifies that the givenMap
contains an entry with key satisfyingkeyCondition
and value satisfyingvalueCondition
.<K> void
assertHasKeySatisfying
(AssertionInfo info, Map<K, ?> actual, Condition<? super K> keyCondition) Verifies that the givenMap
contains an entry with key satisfyingkeyCondition
.void
assertHasSameSizeAs
(AssertionInfo info, Map<?, ?> map, Iterable<?> other) Asserts that the number of entries in the givenMap
has the same size as the otherIterable
.void
assertHasSameSizeAs
(AssertionInfo info, Map<?, ?> map, Object other) Asserts that the number of entries in the givenMap
has the same size as the other array.void
assertHasSameSizeAs
(AssertionInfo info, Map<?, ?> map, Map<?, ?> other) Asserts that the size of the givenMap
is equal to the size of the otherMap
.void
assertHasSize
(AssertionInfo info, Map<?, ?> actual, int expectedSize) Asserts that the number of entries in the givenMap
is equal to the expected one.<V> void
assertHasValueSatisfying
(AssertionInfo info, Map<?, V> actual, Condition<? super V> valueCondition) Verifies that the givenMap
contains an entry with value satisfyingvalueCondition
.void
assertNotEmpty
(AssertionInfo info, Map<?, ?> actual) Asserts that the givenMap
is not empty.private void
assertNotNull
(AssertionInfo info, Map<?, ?> actual) void
assertNullOrEmpty
(AssertionInfo info, Map<?, ?> actual) Asserts that the givenMap
isnull
or empty.private <K,
V> void compareActualMapAndExpectedEntries
(Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries, Set<Map.Entry<? extends K, ? extends V>> notExpected, Set<Map.Entry<? extends K, ? extends V>> notFound) private <K,
V> void compareActualMapAndExpectedKeys
(Map<K, V> actual, K[] keys, Set<K> notExpected, Set<K> notFound) private <K,
V> boolean containsEntry
(Map<K, V> actual, Map.Entry<? extends K, ? extends V> entry) private <K,
V> void doCommonContainsCheck
(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) private static <K,
V> Map<K, V> entriesToMap
(Map.Entry<? extends K, ? extends V>[] entries) private static <K,
V> void failIfEmpty
(Map.Entry<? extends K, ? extends V>[] entries) private static <K> void
failIfEmpty
(K[] keys) private static <K,
V> void failIfEmptySinceActualIsNotEmpty
(Map.Entry<? extends K, ? extends V>[] values) private static <K,
V> void failIfNull
(Map.Entry<? extends K, ? extends V>[] entries) private static <K> void
failIfNull
(K[] keys) private static <K,
V> void failIfNullOrEmpty
(Map.Entry<? extends K, ? extends V>[] entries) static Maps
instance()
Returns the singleton instance of this class.
-
Field Details
-
INSTANCE
-
failures
Failures failures -
conditions
Conditions conditions
-
-
Constructor Details
-
Maps
Maps()
-
-
Method Details
-
instance
Returns the singleton instance of this class.- Returns:
- the singleton instance of this class.
-
assertNullOrEmpty
Asserts that the givenMap
isnull
or empty.- Parameters:
info
- contains information about the assertion.actual
- the given map.- Throws:
AssertionError
- if the givenMap
is notnull
*and* contains one or more entries.
-
assertEmpty
Asserts that the givenMap
is empty.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.- Throws:
AssertionError
- if the givenMap
isnull
.AssertionError
- if the givenMap
is not empty.
-
assertNotEmpty
Asserts that the givenMap
is not empty.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.- Throws:
AssertionError
- if the givenMap
isnull
.AssertionError
- if the givenMap
is empty.
-
assertHasSize
Asserts that the number of entries in the givenMap
is equal to the expected one.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.expectedSize
- the expected size ofactual
.- Throws:
AssertionError
- if the givenMap
isnull
.AssertionError
- if the number of entries in the givenMap
is different than the expected one.
-
assertHasSameSizeAs
Asserts that the number of entries in the givenMap
has the same size as the otherIterable
.- Parameters:
info
- contains information about the assertion.map
- the givenMap
.other
- the group to compare- Throws:
AssertionError
- if the givenMap
isnull
.AssertionError
- if the givenIterable
isnull
.AssertionError
- if the number of entries in the givenMap
does not have the same size.
-
assertHasSameSizeAs
Asserts that the number of entries in the givenMap
has the same size as the other array.- Parameters:
info
- contains information about the assertion.map
- the givenMap
.other
- the group to compare- Throws:
AssertionError
- if the givenMap
isnull
.AssertionError
- if the given array isnull
.AssertionError
- if the number of entries in the givenMap
does not have the same size.
-
assertHasSameSizeAs
Asserts that the size of the givenMap
is equal to the size of the otherMap
.- Parameters:
info
- contains information about the assertion.map
- the givenMap
.other
- the otherMap
to compare- Throws:
NullPointerException
- if the otherMap
isnull
.AssertionError
- if the givenMap
isnull
.AssertionError
- if the size of the givenMap
is not equal to the otherMap
size
-
assertContains
public <K,V> void assertContains(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) Asserts that the givenMap
contains the given entries, in any order.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.entries
- the entries that are expected to be in the givenMap
.- Throws:
NullPointerException
- if the array of entries isnull
.IllegalArgumentException
- if the array of entries is empty.NullPointerException
- if any of the entries in the given array isnull
.AssertionError
- if the givenMap
isnull
.AssertionError
- if the givenMap
does not contain the given entries.
-
assertContainsAnyOf
public <K,V> void assertContainsAnyOf(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) -
assertHasEntrySatisfying
public <K,V> void assertHasEntrySatisfying(AssertionInfo info, Map<K, V> actual, K key, Condition<? super V> valueCondition) Verifies that the givenMap
contains the value for givenkey
that satisfy givenvalueCondition
.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.key
- he given key to check.valueCondition
- the given condition for check value.- Throws:
NullPointerException
- if the given values isnull
.AssertionError
- if the actual map isnull
.AssertionError
- if the actual map not contains the givenkey
.AssertionError
- if the actual map contains the given key, but value not match the givenvalueCondition
.- Since:
- 2.6.0 / 3.6.0
-
assertHasEntrySatisfying
public <K,V> void assertHasEntrySatisfying(AssertionInfo info, Map<K, V> actual, K key, Consumer<? super V> valueRequirements) Verifies that theMap
contains the value for givenkey
that satisfy givenvalueRequirements
.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.key
- he given key to check.valueRequirements
- the given requirements for check value.- Throws:
NullPointerException
- if the given values isnull
.AssertionError
- if the actual map isnull
.AssertionError
- if the actual map not contains the givenkey
.AssertionError
- if the actual map contains the given key, but value not pass the givenvalueRequirements
.
-
assertHasEntrySatisfying
public <K,V> void assertHasEntrySatisfying(AssertionInfo info, Map<K, V> actual, Condition<? super Map.Entry<K, V>> entryCondition) Verifies that the givenMap
contains an entry satisfying givenentryCondition
.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.entryCondition
- the condition for searching entry.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the actual map isnull
.AssertionError
- if there is no entry matching givenentryCondition
.- Since:
- 2.7.0 / 3.7.0
-
assertHasEntrySatisfyingConditions
public <K,V> void assertHasEntrySatisfyingConditions(AssertionInfo info, Map<K, V> actual, Condition<? super K> keyCondition, Condition<? super V> valueCondition) Verifies that the givenMap
contains an entry with key satisfyingkeyCondition
and value satisfyingvalueCondition
.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.keyCondition
- the condition for entry key.valueCondition
- the condition for entry value.- Throws:
NullPointerException
- if any of the given conditions isnull
.AssertionError
- if the actual map isnull
.AssertionError
- if there is no entry matching givenkeyCondition
andvalueCondition
.- Since:
- 2.7.0 / 3.7.0
-
assertHasKeySatisfying
public <K> void assertHasKeySatisfying(AssertionInfo info, Map<K, ?> actual, Condition<? super K> keyCondition) Verifies that the givenMap
contains an entry with key satisfyingkeyCondition
.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.keyCondition
- the condition for key search.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the actual map isnull
.AssertionError
- if there is no key matching givenkeyCondition
.- Since:
- 2.7.0 / 3.7.0
-
assertHasValueSatisfying
public <V> void assertHasValueSatisfying(AssertionInfo info, Map<?, V> actual, Condition<? super V> valueCondition) Verifies that the givenMap
contains an entry with value satisfyingvalueCondition
.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.valueCondition
- the condition for value search.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the actual map isnull
.AssertionError
- if there is no value matching givenvalueCondition
.- Since:
- 2.7.0 / 3.7.0
-
assertDoesNotContain
public <K,V> void assertDoesNotContain(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) Asserts that the givenMap
does not contain the given entries.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.entries
- the entries that are expected to be in the givenMap
.- Throws:
NullPointerException
- if the array of entries isnull
.IllegalArgumentException
- if the array of entries is empty.NullPointerException
- if any of the entries in the given array isnull
.AssertionError
- if the givenMap
isnull
.AssertionError
- if the givenMap
contains any of the given entries.
-
assertContainsKeys
Verifies that the actual map contain the given key.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.keys
- the given keys- Throws:
AssertionError
- if the actual map isnull
.AssertionError
- if the actual map not contains the given key.
-
assertDoesNotContainKey
Verifies that the actual map not contains the given key.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.key
- the given key- Throws:
AssertionError
- if the actual map isnull
.AssertionError
- if the actual map contains the given key.
-
assertDoesNotContainKeys
Verifies that the actual map not contains all the given keys.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.keys
- the given keys- Throws:
AssertionError
- if the actual map isnull
.AssertionError
- if the actual map contains all the given keys.
-
assertContainsOnlyKeys
Verifies that the actual map contains only the given keys and nothing else, in any order.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.keys
- the keys that are expected to be in the givenMap
.- Throws:
NullPointerException
- if the array of keys isnull
.IllegalArgumentException
- if the array of keys is empty.AssertionError
- if the givenMap
isnull
.AssertionError
- if the givenMap
does not contain the given keys or if the givenMap
contains keys that are not in the given array.
-
assertContainsValue
Verifies that the actual map contain the given value.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.value
- the given value- Throws:
AssertionError
- if the actual map isnull
.AssertionError
- if the actual map not contains the given value.
-
assertContainsValues
Verifies that the actual map contain the given values.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.values
- the given values- Throws:
AssertionError
- if the actual map isnull
.AssertionError
- if the actual map not contains the given values.NullPointerException
- if values vararg isnull
.
-
assertDoesNotContainValue
Verifies that the actual map not contains the given value.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.value
- the given value- Throws:
AssertionError
- if the actual map isnull
.AssertionError
- if the actual map contains the given value.
-
assertContainsOnly
public <K,V> void assertContainsOnly(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>... entries) Verifies that the actual map contains only the given entries and nothing else, in any order.- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.entries
- the entries that should be in the actual map.- Throws:
AssertionError
- if the actual map isnull
.NullPointerException
- if the given entries array isnull
.IllegalArgumentException
- if the given entries array is empty.AssertionError
- if the actual map does not contain the given entries, i.e. the actual map contains some or none of the given entries, or the actual map contains more entries than the given ones.
-
assertContainsExactly
public <K,V> void assertContainsExactly(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>... entries) Verifies that the actual map contains only the given entries and nothing else, in order.
This assertion should only be used with map that have a consistent iteration order (i.e. don't use it withHashMap
).- Parameters:
info
- contains information about the assertion.actual
- the givenMap
.entries
- the given entries.- Throws:
NullPointerException
- if the given entries array isnull
.AssertionError
- if the actual map isnull
.IllegalArgumentException
- if the given entries array is empty.AssertionError
- if the actual map does not contain the given entries with same order, i.e. the actual map contains some or none of the given entries, or the actual map contains more entries than the given ones or entries are the same but the order is not.
-
compareActualMapAndExpectedKeys
-
compareActualMapAndExpectedEntries
-
doCommonContainsCheck
private <K,V> void doCommonContainsCheck(AssertionInfo info, Map<K, V> actual, Map.Entry<? extends K, ? extends V>[] entries) -
entriesToMap
-
failIfEmpty
private static <K> void failIfEmpty(K[] keys) -
failIfEmpty
-
failIfNullOrEmpty
-
failIfNull
private static <K> void failIfNull(K[] keys) -
failIfNull
-
containsEntry
-
assertNotNull
-
failIfEmptySinceActualIsNotEmpty
private static <K,V> void failIfEmptySinceActualIsNotEmpty(Map.Entry<? extends K, ? extends V>[] values)
-