Class MapPutTester<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.MapPutTester<K,V>

All Implemented Interfaces:

junit.framework.Test

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

A generic JUnit test which tests put operations on 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
MapPutTester()

Method Summary

Modifier and Type	Method	Description
static Method	getPutNullKeyUnsupportedMethod()	Returns the Method instance for testPut_nullKeyUnsupported() so that tests of TreeMap can suppress it with FeatureSpecificTestSuiteBuilder.suppressing() until JDK-5045147 is fixed.
void	setUp()
void	testPut_nullKeyAndValueSupported()
void	testPut_nullKeySupportedNotPresent()
void	testPut_nullKeySupportedPresent()
void	testPut_nullKeyUnsupported()
void	testPut_nullValueSupported()
void	testPut_nullValueUnsupported()
void	testPut_replaceNullValueWithNonNullSupported()
void	testPut_replaceNullValueWithNullSupported()
void	testPut_replaceWithNullValueSupported()
void	testPut_replaceWithNullValueUnsupported()
void	testPut_supportedNotPresent()
void	testPut_supportedPresent()
void	testPut_unsupportedNotPresent()
void	testPut_unsupportedPresentDifferentValue()
void	testPut_unsupportedPresentExistingValue()
void	testPutAbsentConcurrentWithEntrySetIteration()
void	testPutAbsentConcurrentWithKeySetIteration()
void	testPutAbsentConcurrentWithValueIteration()

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

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.

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

MapPutTester

public MapPutTester()

Method Details

setUp

public void setUp()
           throws Exception

Overrides:

setUp in class AbstractContainerTester<Map<K,V>, Map.Entry<K,V>>

Throws:

Exception

testPut_supportedPresent

public void testPut_supportedPresent()

testPut_supportedNotPresent

public void testPut_supportedNotPresent()

testPutAbsentConcurrentWithEntrySetIteration

public void testPutAbsentConcurrentWithEntrySetIteration()

testPutAbsentConcurrentWithKeySetIteration

public void testPutAbsentConcurrentWithKeySetIteration()

testPutAbsentConcurrentWithValueIteration

public void testPutAbsentConcurrentWithValueIteration()

testPut_unsupportedNotPresent

public void testPut_unsupportedNotPresent()

testPut_unsupportedPresentExistingValue

public void testPut_unsupportedPresentExistingValue()

testPut_unsupportedPresentDifferentValue

public void testPut_unsupportedPresentDifferentValue()

testPut_nullKeySupportedNotPresent

public void testPut_nullKeySupportedNotPresent()

testPut_nullKeySupportedPresent

public void testPut_nullKeySupportedPresent()

testPut_nullKeyUnsupported

public void testPut_nullKeyUnsupported()

testPut_nullValueSupported

public void testPut_nullValueSupported()

testPut_nullValueUnsupported

public void testPut_nullValueUnsupported()

testPut_replaceWithNullValueSupported

public void testPut_replaceWithNullValueSupported()

testPut_replaceWithNullValueUnsupported

public void testPut_replaceWithNullValueUnsupported()

testPut_replaceNullValueWithNullSupported

public void testPut_replaceNullValueWithNullSupported()

testPut_replaceNullValueWithNonNullSupported

public void testPut_replaceNullValueWithNonNullSupported()

testPut_nullKeyAndValueSupported

public void testPut_nullKeyAndValueSupported()

getPutNullKeyUnsupportedMethod

@GwtIncompatible
public static Method getPutNullKeyUnsupportedMethod()

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