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

java.lang.Object
  extended by junit.framework.Assert
      extended by junit.framework.TestCase
          extended by org.apache.commons.collections.BulkTest
              extended by org.apache.commons.collections.AbstractTestObject
                  extended by org.apache.commons.collections.collection.AbstractTestCollection
                      extended by 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
AbstractTestMap.TestMapValues()
           
 
Method Summary
 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
countTestCases, createResult, getName, run, run, runBare, runTest, setName, setUp, tearDown
 
Methods inherited from class junit.framework.Assert
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, fail, fail, failNotEquals, failNotSame, failSame
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AbstractTestMap.TestMapValues

public AbstractTestMap.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


Copyright © 2001-2010 Apache Software Foundation. All Rights Reserved.