Class AbstractMultimapTester<K extends @Nullable Object, V extends @Nullable Object, M extends com.google.common.collect.Multimap<K,V>>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

com.google.common.collect.testing.AbstractTester<OneSizeTestContainerGenerator<M, Map.Entry<K,V>>>

com.google.common.collect.testing.AbstractContainerTester<M, Map.Entry<K,V>>

com.google.common.collect.testing.google.AbstractMultimapTester<K,V,M>

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

AbstractListMultimapTester, MultimapAsMapGetTester, MultimapAsMapTester, MultimapClearTester, MultimapContainsEntryTester, MultimapContainsKeyTester, MultimapContainsValueTester, MultimapEntriesTester, MultimapEqualsTester, MultimapForEachTester, MultimapGetTester, MultimapKeySetTester, MultimapKeysTester, MultimapPutAllMultimapTester, MultimapPutIterableTester, MultimapPutTester, MultimapRemoveAllTester, MultimapRemoveEntryTester, MultimapReplaceValuesTester, MultimapSizeTester, MultimapToStringTester, MultimapValuesTester, SetMultimapAsMapTester, SetMultimapEqualsTester, SetMultimapPutAllTester, SetMultimapPutTester, SetMultimapReplaceValuesTester, SortedSetMultimapAsMapTester, SortedSetMultimapGetTester

@GwtCompatible
@NullMarked
public abstract class AbstractMultimapTester<K extends @Nullable Object, V extends @Nullable Object, M extends com.google.common.collect.Multimap<K,V>>
extends AbstractContainerTester<M, Map.Entry<K,V>>

Superclass for all Multimap testers.

Author:

Louis Wasserman

Nested Class Summary

Nested classes/interfaces inherited from class AbstractContainerTester

AbstractContainerTester.ArrayWithDuplicate<E>

Modifier and Type	Class	Description
static final class	AbstractContainerTester.ArrayWithDuplicate<E extends @Nullable Object>

Field Summary

Fields inherited from class AbstractContainerTester

container, samples

Modifier and Type	Field	Description
protected M	container
protected SampleElements<Map.Entry<K,V>>	samples

Constructor Summary

Constructors

Constructor	Description
AbstractMultimapTester()

Method Summary

Modifier and Type	Method	Description
protected Collection<Map.Entry<K,V>>	actualContents()
protected void	assertGet(K key, Collection<? extends V> values)
protected void	assertGet(K key, V... values)
protected Map.Entry<K,V>[]	createArrayWithNullKey()
protected Map.Entry<K,V>[]	createArrayWithNullKeyAndValue()
protected Map.Entry<K,V>[]	createArrayWithNullValue()
protected K	getKeyForNullValue()
protected V	getValueForNullKey()
protected void	initMultimapWithNullKey()
protected void	initMultimapWithNullKeyAndValue()
protected void	initMultimapWithNullValue()
protected final K	k0()
protected final K	k1()
protected final K	k2()
protected final K	k3()
protected final K	k4()
protected M	multimap()
protected void	resetCollection()
protected com.google.common.collect.Multimap<K,V>	resetContainer(Map.Entry<K,V>... newContents)
protected M	resetContainer(M newContents)	Replaces the existing container under test with a new container.
protected SampleElements<K>	sampleKeys()
protected SampleElements<V>	sampleValues()
protected final V	v0()
protected final V	v1()
protected final V	v2()
protected final V	v3()
protected final V	v4()

Methods inherited from class AbstractContainerTester

createArrayWithDuplicateElement, createDisjointCollection, createOrderedArray, createSamplesArray, e0, e1, e2, e3, e4, emptyCollection, expectAdded, expectAdded, expectAdded, expectContents, expectContents, expectMissing, expectUnchanged, getNullLocation, getNumElements, getOrderedElements, getSampleElements, getSampleElements, resetContainer, setUp

Modifier and Type	Method	Description
protected AbstractContainerTester.ArrayWithDuplicate<Map.Entry<K,V>>	createArrayWithDuplicateElement()
protected MinimalCollection<Map.Entry<K,V>>	createDisjointCollection()
protected Map.Entry<K,V>[]	createOrderedArray()
protected Map.Entry<K,V>[]	createSamplesArray()
protected final Map.Entry<K,V>	e0()
protected final Map.Entry<K,V>	e1()
protected final Map.Entry<K,V>	e2()
protected final Map.Entry<K,V>	e3()
protected final Map.Entry<K,V>	e4()
protected MinimalCollection<Map.Entry<K,V>>	emptyCollection()
protected final void	expectAdded(int index, Map.Entry<K,V>... elements)
protected final void	expectAdded(int index, Collection<Map.Entry<K,V>> elements)
protected final void	expectAdded(Map.Entry<K,V>... elements)	Asserts that the collection under test contains exactly the elements it was initialized with plus the given elements, according to AbstractContainerTester.expectContents(java.util.Collection).
protected final void	expectContents(Map.Entry<K,V>... elements)
protected void	expectContents(Collection<Map.Entry<K,V>> expected)	Asserts that the collection under test contains exactly the given elements, respecting cardinality but not order.
protected void	expectMissing(Map.Entry<K,V>... elements)
protected void	expectUnchanged()
protected int	getNullLocation()
protected int	getNumElements()
protected List<Map.Entry<K,V>>	getOrderedElements()	Returns the sample elements as ordered by TestContainerGenerator.order(List).
protected Collection<Map.Entry<K,V>>	getSampleElements()
protected Collection<Map.Entry<K,V>>	getSampleElements(int howMany)
protected M	resetContainer()	Replaces the existing container under test with a new container created by the subject generator.
void	setUp()

Methods inherited from class AbstractTester

assertNull, getName, getSubjectGenerator, getTestMethodName, init, init, tearDown

Modifier and Type	Method	Description
static void	assertNull(String message, @Nullable Object object)	Asserts that the given object is non-null, with a better failure message than TestCase.assertNull(String, Object).
String	getName()
OneSizeTestContainerGenerator<M, Map.Entry<K,V>>	getSubjectGenerator()
final String	getTestMethodName()	Returns the name of the test method invoked by this test instance.
final void	init(OneSizeTestContainerGenerator<M, Map.Entry<K,V>> subjectGenerator, String suiteName)
final void	init(OneSizeTestContainerGenerator<M, Map.Entry<K,V>> subjectGenerator, String suiteName, @Nullable Runnable setUp, @Nullable Runnable tearDown)
void	tearDown()

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, run, run, runBare, runTest, setName, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

AbstractMultimapTester

public AbstractMultimapTester()

Method Details

multimap

protected M multimap()

createArrayWithNullKey

protected Map.Entry<K,V>[] createArrayWithNullKey()

Returns:

an array of the proper size with null as the key of the middle element.

createArrayWithNullValue

protected Map.Entry<K,V>[] createArrayWithNullValue()

Returns:

an array of the proper size with null as the value of the middle element.

createArrayWithNullKeyAndValue

protected Map.Entry<K,V>[] createArrayWithNullKeyAndValue()

Returns:

an array of the proper size with null as the key and value of the middle element.

getValueForNullKey

protected V getValueForNullKey()

getKeyForNullValue

protected K getKeyForNullValue()

initMultimapWithNullKey

protected void initMultimapWithNullKey()

initMultimapWithNullValue

protected void initMultimapWithNullValue()

initMultimapWithNullKeyAndValue

protected void initMultimapWithNullKeyAndValue()

sampleKeys

protected SampleElements<K> sampleKeys()

sampleValues

protected SampleElements<V> sampleValues()

actualContents

protected Collection<Map.Entry<K,V>> actualContents()

Specified by:

actualContents in class AbstractContainerTester<M extends com.google.common.collect.Multimap<K,V>, Map.Entry<K extends @Nullable Object, V extends @Nullable Object>>

Returns:

the contents of the container under test, for use by expectContents(E...) and its friends.

resetContainer

@CanIgnoreReturnValue
protected M resetContainer(M newContents)

Description copied from class: AbstractContainerTester

Replaces the existing container under test with a new container. This is useful when a single test method needs to create multiple containers while retaining the ability to use expectContents(E...) and other convenience methods. The creation of multiple containers in a single method is discouraged in most cases, but it is vital to the iterator tests.

Overrides:

resetContainer in class AbstractContainerTester<M extends com.google.common.collect.Multimap<K,V>, Map.Entry<K extends @Nullable Object, V extends @Nullable Object>>

Parameters:

newContents - the new container instance

Returns:

the new container instance

resetContainer

@CanIgnoreReturnValue
protected com.google.common.collect.Multimap<K,V> resetContainer(Map.Entry<K,V>... newContents)

resetCollection

protected void resetCollection()

See Also:

• AbstractContainerTester.resetContainer()

assertGet

protected void assertGet(K key,
 V... values)

assertGet

protected void assertGet(K key,
 Collection<? extends V> values)

k0

protected final K k0()

v0

protected final V v0()

k1

protected final K k1()

v1

protected final V v1()

k2

protected final K k2()

v2

protected final V v2()

k3

protected final K k3()

v3

protected final V v3()

k4

protected final K k4()

v4

protected final V v4()