Class MapCreationTester<K,V>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

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

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

com.google.common.collect.testing.AbstractMapTester<K,V>

com.google.common.collect.testing.testers.MapCreationTester<K,V>

All Implemented Interfaces:

junit.framework.Test

@GwtCompatible
public class MapCreationTester<K,V>
extends AbstractMapTester<K,V>

A generic JUnit test which tests creation (typically through a constructor or static factory method) of a map. Can't be invoked directly; please see MapTestSuiteBuilder.

Author:

Chris Povirk, Kevin Bourrillion

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 Map<K,V>	container
protected SampleElements<Map.Entry<K,V>>	samples

Constructor Summary

Constructors

Constructor	Description
MapCreationTester()

Method Summary

Modifier and Type	Method	Description
static Method	getCreateWithNullKeyUnsupportedMethod()	Returns the Method instance for testCreateWithNullKeyUnsupported() so that tests can suppress it with FeatureSpecificTestSuiteBuilder.suppressing() until JDK-5045147 is fixed.
void	testCreateWithDuplicates_nonNullDuplicatesNotRejected()
void	testCreateWithDuplicates_nonNullDuplicatesRejected()
void	testCreateWithDuplicates_nullDuplicatesNotRejected()
void	testCreateWithDuplicates_nullDuplicatesRejected()
void	testCreateWithNullKeyAndValueSupported()
void	testCreateWithNullKeySupported()
void	testCreateWithNullKeyUnsupported()
void	testCreateWithNullValueSupported()
void	testCreateWithNullValueUnsupported()

Methods inherited from class AbstractMapTester

actualContents, createArrayWithNullKey, createArrayWithNullValue, createDisjointCollection, entry, expectContents, expectMissing, expectMissingKeys, expectMissingValues, expectNullKeyMissingWhenNullKeysUnsupported, expectNullValueMissingWhenNullValuesUnsupported, expectReplacement, get, getKeyForNullValue, getMap, getNumEntries, getSampleEntries, getSampleEntries, getValueForNullKey, initMapWithNullKey, initMapWithNullValue, k0, k1, k2, k3, k4, resetMap, resetMap, v0, v1, v2, v3, v4

Modifier and Type	Method	Description
protected Collection<Map.Entry<K,V>>	actualContents()
protected Map.Entry<K,V>[]	createArrayWithNullKey()
protected Map.Entry<K,V>[]	createArrayWithNullValue()
protected MinimalCollection<Map.Entry<K,V>>	createDisjointCollection()
protected Map.Entry<K,V>	entry(K key, V value)
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>... entries)
protected void	expectMissingKeys(K... elements)
protected void	expectMissingValues(V... elements)
protected void	expectNullKeyMissingWhenNullKeysUnsupported(String message)	Equivalent to expectMissingKeys (null) except that the call to contains(null) is permitted to throw a NullPointerException.
protected void	expectNullValueMissingWhenNullValuesUnsupported(String message)	Equivalent to expectMissingValues (null) except that the call to contains(null) is permitted to throw a NullPointerException.
protected final void	expectReplacement(Map.Entry<K,V> newEntry)
protected V	get(K key)	Wrapper for Map.get(Object) that forces the caller to pass in a key of the same type as the map.
protected K	getKeyForNullValue()
protected Map<K,V>	getMap()
protected int	getNumEntries()
protected Collection<Map.Entry<K,V>>	getSampleEntries()
protected Collection<Map.Entry<K,V>>	getSampleEntries(int howMany)
protected V	getValueForNullKey()
protected void	initMapWithNullKey()
protected void	initMapWithNullValue()
protected final K	k0()
protected final K	k1()
protected final K	k2()
protected final K	k3()
protected final K	k4()
protected final void	resetMap()
protected void	resetMap(Map.Entry<K,V>[] entries)
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, createOrderedArray, createSamplesArray, e0, e1, e2, e3, e4, emptyCollection, expectAdded, expectAdded, expectAdded, expectContents, expectUnchanged, getNullLocation, getNumElements, getOrderedElements, getSampleElements, getSampleElements, resetContainer, resetContainer, setUp

Modifier and Type	Method	Description
protected AbstractContainerTester.ArrayWithDuplicate<Map.Entry<K,V>>	createArrayWithDuplicateElement()
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	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 Map<K,V>	resetContainer()	Replaces the existing container under test with a new container created by the subject generator.
protected Map<K,V>	resetContainer(Map<K,V> newValue)	Replaces the existing container under test with a new container.
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<Map<K,V>, Map.Entry<K,V>>	getSubjectGenerator()
final String	getTestMethodName()	Returns the name of the test method invoked by this test instance.
final void	init(OneSizeTestContainerGenerator<Map<K,V>, Map.Entry<K,V>> subjectGenerator, String suiteName)
final void	init(OneSizeTestContainerGenerator<Map<K,V>, 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

MapCreationTester

public MapCreationTester()

Method Details

testCreateWithNullKeySupported

public void testCreateWithNullKeySupported()

testCreateWithNullKeyUnsupported

public void testCreateWithNullKeyUnsupported()

testCreateWithNullValueSupported

public void testCreateWithNullValueSupported()

testCreateWithNullValueUnsupported

public void testCreateWithNullValueUnsupported()

testCreateWithNullKeyAndValueSupported

public void testCreateWithNullKeyAndValueSupported()

testCreateWithDuplicates_nullDuplicatesNotRejected

public void testCreateWithDuplicates_nullDuplicatesNotRejected()

testCreateWithDuplicates_nonNullDuplicatesNotRejected

public void testCreateWithDuplicates_nonNullDuplicatesNotRejected()

testCreateWithDuplicates_nullDuplicatesRejected

public void testCreateWithDuplicates_nullDuplicatesRejected()

testCreateWithDuplicates_nonNullDuplicatesRejected

public void testCreateWithDuplicates_nonNullDuplicatesRejected()

getCreateWithNullKeyUnsupportedMethod

@GwtIncompatible
public static Method getCreateWithNullKeyUnsupportedMethod()

Returns the Method instance for testCreateWithNullKeyUnsupported() so that tests can suppress it with FeatureSpecificTestSuiteBuilder.suppressing() until JDK-5045147 is fixed.