Package org.apache.commons.collections.map

Class AbstractTestMap.TestMapValues

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.commons.collections.BulkTest

org.apache.commons.collections.AbstractTestObject

org.apache.commons.collections.collection.AbstractTestCollection

org.apache.commons.collections.map.AbstractTestMap.TestMapValues

All Implemented Interfaces:

java.lang.Cloneable, junit.framework.Test

Enclosing class:

AbstractTestMap

public class AbstractTestMap.TestMapValues
extends AbstractTestCollection

Field Summary

Fields inherited from class org.apache.commons.collections.collection.AbstractTestCollection

collection, confirmed

Fields inherited from class org.apache.commons.collections.AbstractTestObject

COLLECTIONS_MAJOR_VERSION

Constructor Summary

Constructors

Constructor	Description
TestMapValues()

Method Summary

Modifier and Type	Method	Description
boolean	areEqualElementsDistinguishable()	Specifies whether equal elements in the collection are, in fact, distinguishable with information not readily available.
java.lang.Object[]	getFullElements()	Returns an array of objects that are contained in a collection produced by AbstractTestCollection.makeFullCollection().
java.lang.Object[]	getOtherElements()	Returns an array of elements that are not contained in a full collection.
boolean	isAddSupported()	Returns true if the collections produced by AbstractTestCollection.makeCollection() and AbstractTestCollection.makeFullCollection() support the add and addAll operations.
boolean	isNullSupported()	Returns true to indicate that the collection supports holding null.
boolean	isRemoveSupported()	Returns true if the collections produced by AbstractTestCollection.makeCollection() and AbstractTestCollection.makeFullCollection() support the remove, removeAll, retainAll, clear and iterator().remove() methods.
boolean	isTestSerialization()	Is serialization testing supported.
java.util.Collection	makeCollection()	Return a new, empty Collection to be used for testing.
java.util.Collection	makeConfirmedCollection()	Returns a confirmed empty collection.
java.util.Collection	makeConfirmedFullCollection()	Returns a confirmed full collection.
java.util.Collection	makeFullCollection()	Returns a full collection to be used for testing.
void	resetEmpty()	Resets the AbstractTestCollection.collection and AbstractTestCollection.confirmed fields to empty collections.
void	resetFull()	Resets the AbstractTestCollection.collection and AbstractTestCollection.confirmed fields to full collections.
void	verify()	Verifies that AbstractTestCollection.collection and AbstractTestCollection.confirmed have identical state.

Methods inherited from class org.apache.commons.collections.collection.AbstractTestCollection

cloneMapEntry, getFullNonNullElements, getFullNonNullStringElements, getOtherNonNullElements, getOtherNonNullStringElements, isEqualsCheckable, isFailFastSupported, makeObject, testCollectionAdd, testCollectionAddAll, testCollectionClear, testCollectionContains, testCollectionContainsAll, testCollectionIsEmpty, testCollectionIterator, testCollectionIteratorFailFast, testCollectionIteratorRemove, testCollectionRemove, testCollectionRemoveAll, testCollectionRetainAll, testCollectionSize, testCollectionToArray, testCollectionToArray2, testCollectionToString, testSerializeDeserializeThenCompare, testUnsupportedAdd, testUnsupportedRemove

Methods inherited from class org.apache.commons.collections.AbstractTestObject

getCanonicalEmptyCollectionName, getCanonicalFullCollectionName, getCompatibilityVersion, readExternalFormFromBytes, readExternalFormFromDisk, skipSerializedCanonicalTests, supportsEmptyCollections, supportsFullCollections, testCanonicalEmptyCollectionExists, testCanonicalFullCollectionExists, testEqualsNull, testObjectEqualsSelf, testObjectHashCodeEqualsContract, testObjectHashCodeEqualsSelfHashCode, testSimpleSerialization, writeExternalFormToBytes, writeExternalFormToDisk

Methods inherited from class org.apache.commons.collections.BulkTest

clone, ignoredTests, makeSuite, toString

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, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, runTest, setName, setUp, tearDown

Methods inherited from class java.lang.Object

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

Constructor Detail

TestMapValues

public TestMapValues()

Method Detail

getFullElements

public java.lang.Object[] getFullElements()

Description copied from class: AbstractTestCollection

Returns an array of objects that are contained in a collection produced by AbstractTestCollection.makeFullCollection(). Every element in the returned array must be an element in a full collection.

The default implementation returns a heterogenous array of objects with some duplicates. null is added if allowed. Override if you require specific testing elements. Note that if you override AbstractTestCollection.makeFullCollection(), you must override this method to reflect the contents of a full collection.

Overrides:

getFullElements in class AbstractTestCollection

getOtherElements

public java.lang.Object[] getOtherElements()

Description copied from class: AbstractTestCollection

Returns an array of elements that are not contained in a full collection. Every element in the returned array must not exist in a collection returned by AbstractTestCollection.makeFullCollection(). The default implementation returns a heterogenous array of elements without null. Note that some of the tests add these elements to an empty or full collection, so if your collection restricts certain kinds of elements, you should override this method.

Overrides:

getOtherElements in class AbstractTestCollection

makeCollection

public java.util.Collection makeCollection()

Description copied from class: AbstractTestCollection

Return a new, empty Collection to be used for testing.

Specified by:

makeCollection in class AbstractTestCollection

makeFullCollection

public java.util.Collection makeFullCollection()

Description copied from class: AbstractTestCollection

Returns a full collection to be used for testing. The collection returned by this method should contain every element returned by AbstractTestCollection.getFullElements(). The default implementation, in fact, simply invokes addAll on an empty collection with the results of AbstractTestCollection.getFullElements(). Override this default if your collection doesn't support addAll.

Overrides:

makeFullCollection in class AbstractTestCollection

isNullSupported

public boolean isNullSupported()

Description copied from class: AbstractTestCollection

Returns true to indicate that the collection supports holding null. The default implementation returns true;

Overrides:

isNullSupported in class AbstractTestCollection

isAddSupported

public boolean isAddSupported()

Description copied from class: AbstractTestCollection

Returns true if the collections produced by AbstractTestCollection.makeCollection() and AbstractTestCollection.makeFullCollection() support the add and addAll operations.

Default implementation returns true. Override if your collection class does not support add or addAll.

Overrides:

isAddSupported in class AbstractTestCollection

isRemoveSupported

public boolean isRemoveSupported()

Description copied from class: AbstractTestCollection

Returns true if the collections produced by AbstractTestCollection.makeCollection() and AbstractTestCollection.makeFullCollection() support the remove, removeAll, retainAll, clear and iterator().remove() methods. Default implementation returns true. Override if your collection class does not support removal operations.

Overrides:

isRemoveSupported in class AbstractTestCollection

isTestSerialization

public boolean isTestSerialization()

Description copied from class: AbstractTestObject

Is serialization testing supported. Default is true.

Overrides:

isTestSerialization in class AbstractTestObject

areEqualElementsDistinguishable

public boolean areEqualElementsDistinguishable()

Description copied from class: AbstractTestCollection

Specifies whether equal elements in the collection are, in fact, distinguishable with information not readily available. That is, if a particular value is to be removed from the collection, then there is one and only one value that can be removed, even if there are other elements which are equal to it.

In most collection cases, elements are not distinguishable (equal is equal), thus this method defaults to return false. In some cases, however, they are. For example, the collection returned from the map's values() collection view are backed by the map, so while there may be two values that are equal, their associated keys are not. Since the keys are distinguishable, the values are.

This flag is used to skip some verifications for iterator.remove() where it is impossible to perform an equivalent modification on the confirmed collection because it is not possible to determine which value in the confirmed collection to actually remove. Tests that override the default (i.e. where equal elements are distinguishable), should provide additional tests on iterator.remove() to make sure the proper elements are removed when remove() is called on the iterator.

Overrides:

areEqualElementsDistinguishable in class AbstractTestCollection

makeConfirmedCollection

public java.util.Collection makeConfirmedCollection()

Description copied from class: AbstractTestCollection

Returns a confirmed empty collection. For instance, an ArrayList for lists or a HashSet for sets.

Specified by:

makeConfirmedCollection in class AbstractTestCollection

Returns:

a confirmed empty collection

makeConfirmedFullCollection

public java.util.Collection makeConfirmedFullCollection()

Description copied from class: AbstractTestCollection

Returns a confirmed full collection. For instance, an ArrayList for lists or a HashSet for sets. The returned collection should contain the elements returned by AbstractTestCollection.getFullElements().

Specified by:

makeConfirmedFullCollection in class AbstractTestCollection

Returns:

a confirmed full collection

resetFull

public void resetFull()

Description copied from class: AbstractTestCollection

Resets the AbstractTestCollection.collection and AbstractTestCollection.confirmed fields to full collections. Invoke this method before performing a modification test.

Overrides:

resetFull in class AbstractTestCollection

resetEmpty

public void resetEmpty()

Description copied from class: AbstractTestCollection

Resets the AbstractTestCollection.collection and AbstractTestCollection.confirmed fields to empty collections. Invoke this method before performing a modification test.

Overrides:

resetEmpty in class AbstractTestCollection

verify

public void verify()

Description copied from class: AbstractTestCollection

Verifies that AbstractTestCollection.collection and AbstractTestCollection.confirmed have identical state.

Overrides:

verify in class AbstractTestCollection