Package org.assertj.guava.api

Class MultimapAssert<K,V>

java.lang.Object
org.assertj.core.api.AbstractAssert<MultimapAssert<K,V>,Multimap<K,V>>
org.assertj.guava.api.MultimapAssert<K,V>
All Implemented Interfaces:
Assert<MultimapAssert<K,V>,Multimap<K,V>>, Descriptable<MultimapAssert<K,V>>, ExtensionPoints<MultimapAssert<K,V>,Multimap<K,V>>
public class MultimapAssert<K,V> extends AbstractAssert<MultimapAssert<K,V>,Multimap<K,V>>
Assertions for guava Multimap.
Author:
marcelfalliere, miralak, Joel Costigliola

  • Constructor Details

    • MultimapAssert

      protected MultimapAssert(Multimap<K,V> actual)

  • Method Details

    • getActual

      protected 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

      @SafeVarargs public final MultimapAssert<K,V> contains(MapEntry<K,V>... 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.

    • isNotEmpty

      public void isNotEmpty()
      Verifies that the actual Multimap is not empty.

      Example : 

       Multimap<String, String> actual = ArrayListMultimap.create();
 nba.put("Bulls", "Derrick Rose");
 nba.put("Bulls", "Joachim Noah");

 assertThat(nba).isNotEmpty();
      Throws:
      AssertionError - if the actual Multimap is null.
      AssertionError - if the actual Multimap is 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.

    • hasSameEntriesAs

      public final MultimapAssert<K,V> hasSameEntriesAs(Multimap<? extends K,? extends V> other)
      Verifies that the actual Multimap has the same entries as the given one.
      It allows to compare two multimaps having the same content but who are not equal because being of different types like SetMultimap and ListMultimap.

      Example : 

       Multimap<String, String> actual = ArrayListMultimap.create();
 listMultimap.putAll("Spurs", newArrayList("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 listMultimap.putAll("Bulls", newArrayList("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 Multimap<String, String> setMultimap = TreeMultimap.create();
 setMultimap.putAll("Spurs", newHashSet("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 setMultimap.putAll("Bulls", newHashSet("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 // assertion will pass as listMultimap and setMultimap have the same content
 assertThat(listMultimap).hasSameEntriesAs(setMultimap);

 // this assertion FAILS even though both multimaps have the same content
 assertThat(listMultimap).isEqualTo(setMultimap);
      Parameters:
      other - Multimap to compare actual's entries with.
      Returns:
      this MultimapAssert for assertions chaining.
      Throws:
      AssertionError - if the actual Multimap is null.
      IllegalArgumentException - if the other Multimap is null.
      AssertionError - if actual Multimap does not have the same entries as the other Multimap.

    • containsAllEntriesOf

      public final MultimapAssert<K,V> containsAllEntriesOf(Multimap<? extends K,? extends V> other)
      Verifies that the actual Multimap contains all entries of the given one (it might contain more entries).

      Example : 

       Multimap<String, String> actual = ArrayListMultimap.create();
 actual.putAll("Spurs", newArrayList("Tony Parker", "Tim Duncan", "Manu Ginobili"));
 actual.putAll("Bulls", newArrayList("Michael Jordan", "Scottie Pippen", "Derrick Rose"));

 Multimap<String, String> other = TreeMultimap.create();
 other.putAll("Spurs", newHashSet("Tony Parker", "Tim Duncan"));
 other.putAll("Bulls", newHashSet("Michael Jordan", "Scottie Pippen"));

 // assertion will pass as other is a subset of actual.
 assertThat(actual).containsAllEntriesOf(other);

 // this assertion FAILS as other does not contain "Spurs -> "Manu Ginobili" and "Bulls" -> "Derrick Rose"
 assertThat(other).containsAllEntriesOf(actual);
      Parameters:
      other - Multimap to compare actual's entries with.
      Returns:
      this MultimapAssert for assertions chaining.
      Throws:
      AssertionError - if the actual Multimap is null.
      IllegalArgumentException - if the other Multimap is null.
      AssertionError - if actual Multimap does not have contain all the given Multimap entries.

    • doesNotContainKey

      public MultimapAssert<K,V> doesNotContainKey(K key)
      Verifies that the actual multimap does not contain the given key.

      Examples: 

       Multimap<Ring, TolkienCharacter> elvesRingBearers = HashMultimap.create();
 elvesRingBearers.put(nenya, galadriel);
 elvesRingBearers.put(narya, gandalf);
 elvesRingBearers.put(vilya, elrond);

 // assertion will pass
 assertThat(elvesRingBearers).doesNotContainKey(oneRing);

 // assertion will fail
 assertThat(elvesRingBearers).doesNotContainKey(vilya);
      Parameters:
      key - the given key
      Returns:
      this assertions object
      Throws:
      AssertionError - if the actual map is null.
      AssertionError - if the actual map contains the given key.
      Since:
      3.26.0

    • doesNotContainKeys

      public MultimapAssert<K,V> doesNotContainKeys(K... keys)
      Verifies that the actual multimap does not contain any of the given keys.

      Examples: 

       Multimap<Ring, TolkienCharacter> elvesRingBearers = HashMultimap.create();
 elvesRingBearers.put(nenya, galadriel);
 elvesRingBearers.put(narya, gandalf);
 elvesRingBearers.put(vilya, elrond);

 // assertion will pass
 assertThat(elvesRingBearers).doesNotContainKeys(oneRing, someManRing);

 // assertions will fail
 assertThat(elvesRingBearers).doesNotContainKeys(vilya, nenya);
 assertThat(elvesRingBearers).doesNotContainKeys(vilya, oneRing);
      Parameters:
      keys - the given keys
      Returns:
      this assertions object
      Throws:
      AssertionError - if the actual map is null.
      AssertionError - if the actual map contains the given key.
      NullPointerException - if the varargs of keys is null
      Since:
      3.26.0