org.assertj.guava.api

Class MultimapAssert<K,V>

java.lang.Object

org.assertj.core.api.AbstractAssert<MultimapAssert<K,V>,com.google.common.collect.Multimap<K,V>>

org.assertj.guava.api.MultimapAssert<K,V>

All Implemented Interfaces:

org.assertj.core.api.Assert<MultimapAssert<K,V>,com.google.common.collect.Multimap<K,V>>, org.assertj.core.api.Descriptable<MultimapAssert<K,V>>, org.assertj.core.api.ExtensionPoints<MultimapAssert<K,V>,com.google.common.collect.Multimap<K,V>>

public class MultimapAssert<K,V>
extends org.assertj.core.api.AbstractAssert<MultimapAssert<K,V>,com.google.common.collect.Multimap<K,V>>

Assertions for guava Multimap.

Author:

@marcelfalliere, @miralak, Joel Costigliola

Field Summary

Fields inherited from class org.assertj.core.api.AbstractAssert

actual, info, myself

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MultimapAssert(com.google.common.collect.Multimap<K,V> actual)

Method Summary

Methods

Modifier and Type	Method and Description
MultimapAssert<K,V>	contains(org.assertj.core.data.MapEntry... entries) Verifies that the actual Multimap contains the given entries.
MultimapAssert<K,V>	containsKeys(K... keys) Verifies that the actual Multimap contains the given keys.
MultimapAssert<K,V>	containsValues(V... values) Verifies that the actual Multimap contains the given values for any key.
protected com.google.common.collect.Multimap<K,V>	getActual()
MultimapAssert<K,V>	hasSize(int expectedSize) Verifies that the number of values in the actual Multimap is equal to the given one.
void	isEmpty() Verifies that the actual Multimap is empty.

Methods inherited from class org.assertj.core.api.AbstractAssert

as, as, describedAs, describedAs, descriptionText, doesNotHave, doesNotHaveSameClassAs, equals, failWithMessage, getWritableAssertionInfo, has, hashCode, hasSameClassAs, inBinary, inHexadecimal, is, isEqualTo, isExactlyInstanceOf, isIn, isIn, isInstanceOf, isInstanceOfAny, isNot, isNotEqualTo, isNotExactlyInstanceOf, isNotIn, isNotIn, isNotInstanceOf, isNotInstanceOfAny, isNotNull, isNotOfAnyClassIn, isNotSameAs, isNull, isOfAnyClassIn, isSameAs, overridingErrorMessage, usingComparator, usingDefaultComparator

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultimapAssert

protected MultimapAssert(com.google.common.collect.Multimap<K,V> actual)

Method Detail

getActual

protected com.google.common.collect.Multimap<K,V> getActual()

containsKeys

public MultimapAssert<K,V> containsKeys(K... keys)

Verifies that the actual Multimap contains the given keys.

Example :

 Multimap<String, String> actual = ArrayListMultimap.create();
 
 actual.putAll("Lakers", newArrayList("Kobe Bryant", "Magic Johnson", "Kareem Abdul Jabbar"));
 actual.putAll("Spurs", newArrayList("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 actual.putAll("Bulls", newArrayList("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 assertThat(actual).containsKeys("Lakers", "Bulls");
 

If the keys argument is null or empty, an IllegalArgumentException is thrown.

Parameters:

keys - the keys to look for in actual Multimap.

Returns:

this MultimapAssert for assertions chaining.

Throws:

IllegalArgumentException - if no param keys have been set.

AssertionError - if the actual Multimap is null.

AssertionError - if the actual Multimap does not contain the given keys.

contains

public MultimapAssert<K,V> contains(org.assertj.core.data.MapEntry... entries)

Verifies that the actual Multimap contains the given entries.

Example :

 Multimap<String, String> actual = ArrayListMultimap.create();

 actual.putAll("Lakers", newArrayList("Kobe Bryant", "Magic Johnson", "Kareem Abdul Jabbar"));
 actual.putAll("Spurs", newArrayList("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 actual.putAll("Bulls", newArrayList("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 // entry can be statically imported from org.assertj.guava.api.Assertions or org.assertj.guava.data.MapEntry
 assertThat(actual).contains(entry("Lakers", "Kobe Bryant"), entry("Spurs", "Tim Duncan"));
 

If the entries argument is null or empty, an IllegalArgumentException is thrown.

Parameters:

entries - the entries to look for in actual Multimap.

Returns:

this MultimapAssert for assertions chaining.

Throws:

IllegalArgumentException - if no param entries have been set.

AssertionError - if the actual Multimap is null.

AssertionError - if the actual Multimap does not contain the given entries.

containsValues

public MultimapAssert<K,V> containsValues(V... values)

Verifies that the actual Multimap contains the given values for any key.

Example :

 Multimap<String, String> actual = ArrayListMultimap.create();

 actual.putAll("Lakers", newArrayList("Kobe Bryant", "Magic Johnson", "Kareem Abdul Jabbar"));
 actual.putAll("Spurs", newArrayList("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 actual.putAll("Bulls", newArrayList("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 // note that given values are not linked to same key
 assertThat(actual).containsValues("Kobe Bryant", "Michael Jordan");
 

If the values argument is null or empty, an IllegalArgumentException is thrown.

Parameters:

values - the values to look for in actual Multimap.

Returns:

this MultimapAssert for assertions chaining.

Throws:

IllegalArgumentException - if no param values have been set.

AssertionError - if the actual Multimap is null.

AssertionError - if the actual Multimap does not contain the given values.

isEmpty

public void isEmpty()

Verifies that the actual Multimap is empty.

Example :

 Multimap<String, String> actual = ArrayListMultimap.create();

 assertThat(actual).isEmpty();
 

Throws:

AssertionError - if the actual Multimap is null.

AssertionError - if the actual Multimap is not empty.

hasSize

public MultimapAssert<K,V> hasSize(int expectedSize)

Verifies that the number of values in the actual Multimap is equal to the given one.

Example :

 Multimap<String, String> actual = ArrayListMultimap.create();

 actual.putAll("Lakers", newArrayList("Kobe Bryant", "Magic Johnson", "Kareem Abdul Jabbar"));
 actual.putAll("Spurs", newArrayList("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 actual.putAll("Bulls", newArrayList("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 assertThat(actual).hasSize(9);
 

Parameters:

expectedSize - the expected size of actual Multimap.

Returns:

this MultimapAssert for assertions chaining.

Throws:

AssertionError - if the actual Multimap is null.

AssertionError - if the number of values of the actual Multimap is not equal to the given one.