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
All Methods Instance Methods Concrete Methods 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 byAbstractTestCollection.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 byAbstractTestCollection.makeCollection()
andAbstractTestCollection.makeFullCollection()
support theadd
andaddAll
operations.boolean
isNullSupported()
Returns true to indicate that the collection supports holding null.boolean
isRemoveSupported()
Returns true if the collections produced byAbstractTestCollection.makeCollection()
andAbstractTestCollection.makeFullCollection()
support theremove
,removeAll
,retainAll
,clear
anditerator().remove()
methods.boolean
isTestSerialization()
Is serialization testing supported.java.util.Collection
makeCollection()
Return a new, emptyCollection
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 theAbstractTestCollection.collection
andAbstractTestCollection.confirmed
fields to empty collections.void
resetFull()
Resets theAbstractTestCollection.collection
andAbstractTestCollection.confirmed
fields to full collections.void
verify()
Verifies thatAbstractTestCollection.collection
andAbstractTestCollection.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
-
-
-
-
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 byAbstractTestCollection.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 classAbstractTestCollection
-
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 byAbstractTestCollection.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 classAbstractTestCollection
-
makeCollection
public java.util.Collection makeCollection()
Description copied from class:AbstractTestCollection
Return a new, emptyCollection
to be used for testing.- Specified by:
makeCollection
in classAbstractTestCollection
-
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 byAbstractTestCollection.getFullElements()
. The default implementation, in fact, simply invokesaddAll
on an empty collection with the results ofAbstractTestCollection.getFullElements()
. Override this default if your collection doesn't support addAll.- Overrides:
makeFullCollection
in classAbstractTestCollection
-
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 classAbstractTestCollection
-
isAddSupported
public boolean isAddSupported()
Description copied from class:AbstractTestCollection
Returns true if the collections produced byAbstractTestCollection.makeCollection()
andAbstractTestCollection.makeFullCollection()
support theadd
andaddAll
operations.Default implementation returns true. Override if your collection class does not support add or addAll.
- Overrides:
isAddSupported
in classAbstractTestCollection
-
isRemoveSupported
public boolean isRemoveSupported()
Description copied from class:AbstractTestCollection
Returns true if the collections produced byAbstractTestCollection.makeCollection()
andAbstractTestCollection.makeFullCollection()
support theremove
,removeAll
,retainAll
,clear
anditerator().remove()
methods. Default implementation returns true. Override if your collection class does not support removal operations.- Overrides:
isRemoveSupported
in classAbstractTestCollection
-
isTestSerialization
public boolean isTestSerialization()
Description copied from class:AbstractTestObject
Is serialization testing supported. Default is true.- Overrides:
isTestSerialization
in classAbstractTestObject
-
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 classAbstractTestCollection
-
makeConfirmedCollection
public java.util.Collection makeConfirmedCollection()
Description copied from class:AbstractTestCollection
Returns a confirmed empty collection. For instance, anArrayList
for lists or aHashSet
for sets.- Specified by:
makeConfirmedCollection
in classAbstractTestCollection
- Returns:
- a confirmed empty collection
-
makeConfirmedFullCollection
public java.util.Collection makeConfirmedFullCollection()
Description copied from class:AbstractTestCollection
Returns a confirmed full collection. For instance, anArrayList
for lists or aHashSet
for sets. The returned collection should contain the elements returned byAbstractTestCollection.getFullElements()
.- Specified by:
makeConfirmedFullCollection
in classAbstractTestCollection
- Returns:
- a confirmed full collection
-
resetFull
public void resetFull()
Description copied from class:AbstractTestCollection
Resets theAbstractTestCollection.collection
andAbstractTestCollection.confirmed
fields to full collections. Invoke this method before performing a modification test.- Overrides:
resetFull
in classAbstractTestCollection
-
resetEmpty
public void resetEmpty()
Description copied from class:AbstractTestCollection
Resets theAbstractTestCollection.collection
andAbstractTestCollection.confirmed
fields to empty collections. Invoke this method before performing a modification test.- Overrides:
resetEmpty
in classAbstractTestCollection
-
verify
public void verify()
Description copied from class:AbstractTestCollection
Verifies thatAbstractTestCollection.collection
andAbstractTestCollection.confirmed
have identical state.- Overrides:
verify
in classAbstractTestCollection
-
-