org.glassfish.hk2.testing.collections

Class AbstractSetTest

java.lang.Object

org.glassfish.hk2.testing.collections.AbstractCollectionTest

org.glassfish.hk2.testing.collections.AbstractSetTest

public abstract class AbstractSetTest
extends AbstractCollectionTest

This class can be used to test Sets for basic Set functionality.

Subclasses must implement the methods that return Sets from the two most common types of constructors, the zero argument constructor and the single argument Collection constructor.

In general, sets do not allow for duplicate entries, but this may not be true of all sets. All of the same questions about Collections can also be overriden for Sets

Field Summary

Fields inherited from class org.glassfish.hk2.testing.collections.AbstractCollectionTest

FIVE, FOUR, ONE, THREE, TWO

Constructor Summary

Constructors

Constructor and Description
AbstractSetTest()

Method Summary

Modifier and Type	Method and Description
protected Collection	createCollection() Subclasses must override this method in order to construct an empty Collection with the null argument constructor.
protected Collection	createCollection(Collection input) Subclasses must override this method in order to construct a Collection with the elements found in the input Collection.
protected abstract Set	createSet()
protected abstract Set	createSet(Collection input)
protected boolean	doesCollectionSupportDuplicateElements() Subclasses should override this method if their Set implementation allows duplicate elements.

Methods inherited from class org.glassfish.hk2.testing.collections.AbstractCollectionTest

doesCollectionAllowNullElements, doesCollectionDelegateFromOriginalCollection, doesCollectionsIteratorSupportRemove, doesCollectionSupportEmpty, doesCollectionSupportRemove, doesCollectionSupportRetainAll, getElement, isCollectionArgumentConstructorSupported, isNullArgumentConstructorSupported, testAddAllThrows, testAddAllWithEmptyCollectionAndEmptyInput, testAddAllWithNonEmptyCollectionAndEmptyInput, testAddAllWithNonEmptyCollectionAndNonEmptyInputDups, testAddAllWithNonEmptyCollectionAndNonEmptyInputNoDups, testAddOneThousandEntries, testAddReturnsProperValueForDuplicateAdd, testAddReturnsProperValueForNonDuplicateAdd, testCanAddToCollection, testCanCollectionHaveNullAndNonNullElements, testCanCollectionHaveNullElements, testClearWorksOnEmptyCollection, testClearWorksOnNonEmptyCollection, testCollectionFromCollectionConstructorHasZeroSize, testCollectionFromNullConstructorHasZeroSize, testCollectionToArrayWithArgumentWithCollectionOfMultipleItems, testCollectionToArrayWithArgumentWithCollectionOfOneItem, testCollectionToArrayWithArgumentWithEmptyCollection, testCollectionToArrayWithArgumentWithNullThrows, testCollectionToArrayWithCollectionOfMultipleItems, testCollectionToArrayWithCollectionOfOneItem, testCollectionToArrayWithEmptyCollection, testContainsAfterAdd, testContainsAllThrows, testContainsAllWithEmptyCollectionAndEmptyInput, testContainsAllWithNonEmptyCollectionAndCorrectInput, testContainsAllWithNonEmptyCollectionAndEmptyInput, testContainsAllWithNonEmptyCollectionAndIncorrectInput, testDoubleIteratorRemoveThrows, testFallingOffEndOfEmptyIteratorThrows, testFallingOffEndOfNonEmptyIteratorThrows, testIteratorRemoveOnEmptyIteratorThrows, testIteratorReturnedFromEmptyList, testListColnstructedWithNullCollectionThrows, testModifyingOriginalCollectionDoesNotAffectNewCollection, testMultipleItemIterator, testMultipleItemIteratorRemoval, testRemoveAllThrows, testRemoveAllWithEmptyCollectionAndEmptyInput, testRemoveAllWithNonEmptyCollectionAndEmptyInput, testRemoveAllWithNonEmptyCollectionAndNonEmptyInput, testRemoveAllWithNonEmptyCollectionAndNonEmptyInputWithExtras, testRemoveFirstThingFromMultiElementList, testRemoveFromEmptyList, testRemoveFromOneElementList, testRemoveLastThingFromMultiElementList, testRemoveMiddleThingFromMultiElementList, testRetainAllThrows, testRetainAllWithEmptyCollectionAndEmptyInput, testRetainAllWithNonEmptyCollectionAndEmptyInput, testRetainAllWithNonEmptyCollectionAndNonEmptyInput, testRetainAllWithNonEmptyCollectionAndNonEmptyInputWithExtras, testSingleItemIterator, testSingleItemIteratorRemoval, testUnsupporedRemoveIteratorThrows, testUnsupportedClearThrows, testUnsupportedRetainAllThrowsProperException

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSetTest

public AbstractSetTest()

Method Detail

doesCollectionSupportDuplicateElements

protected boolean doesCollectionSupportDuplicateElements()

Subclasses should override this method if their Set implementation allows duplicate elements. In other words, if you call "add(foo)" followed by "add(foo)" and the Set will have two elements then your Set supports duplicate elements. Otherwise (if duplicates are overwritten) then this method should return false.

Overrides:

doesCollectionSupportDuplicateElements in class AbstractCollectionTest

Returns:

true if the set allows an arbitrary number of elements whose "equals" returns true to be in the collection, and false if those objects will instead be overwritten

createCollection

protected Collection createCollection()

Description copied from class: AbstractCollectionTest

Subclasses must override this method in order to construct an empty Collection with the null argument constructor. If isNullArgumentConstructorSupported returns false then this method will never be called

Specified by:

createCollection in class AbstractCollectionTest

Returns:

An empty List

createCollection

protected Collection createCollection(Collection input)

Description copied from class: AbstractCollectionTest

Subclasses must override this method in order to construct a Collection with the elements found in the input Collection. If isCollectionArgumentConstructorSupported returns false then this method will never be called

Specified by:

createCollection in class AbstractCollectionTest

Parameters:

input - A possibly null and possibly empty collection of items to seed the list with

Returns:

An empty List that has all of the elements of the input collection in Iterator ordering in the list

createSet

protected abstract Set createSet()

createSet

protected abstract Set createSet(Collection input)