Package com.google.common.collect.testing

Class AbstractCollectionTester<E extends @Nullable Object>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

com.google.common.collect.testing.AbstractTester<OneSizeTestContainerGenerator<C,E>>

com.google.common.collect.testing.AbstractContainerTester<Collection<E>,E>

com.google.common.collect.testing.AbstractCollectionTester<E>

Type Parameters:

E - the element type of the collection to be tested.

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

AbstractListTester, AbstractMultisetTester, AbstractQueueTester, AbstractSetTester, CollectionAddAllTester, CollectionAddTester, CollectionClearTester, CollectionContainsAllTester, CollectionContainsTester, CollectionCreationTester, CollectionEqualsTester, CollectionIsEmptyTester, CollectionIteratorTester, CollectionRemoveAllTester, CollectionRemoveTester, CollectionRetainAllTester, CollectionSerializationEqualTester, CollectionSerializationTester, CollectionSizeTester, CollectionToArrayTester, CollectionToStringTester

@GwtCompatible
public abstract class AbstractCollectionTester<E extends @Nullable Object>
extends AbstractContainerTester<Collection<E>,E>

Base class for collection testers.

Author:

Kevin Bourrillion

Nested Class Summary

Nested classes/interfaces inherited from class com.google.common.collect.testing.AbstractContainerTester

AbstractContainerTester.ArrayWithDuplicate<E extends @Nullable Object>

Field Summary

Fields

Modifier and Type	Field	Description
protected Collection<E>	collection

Fields inherited from class com.google.common.collect.testing.AbstractContainerTester

container, samples

Constructor Summary

Constructors

Constructor	Description
AbstractCollectionTester()

Method Summary

Modifier and Type	Method	Description
protected Collection<E>	actualContents()
protected E[]	createArrayWithNullElement()
protected void	expectNullMissingWhenNullUnsupported(String message)	Equivalent to expectMissing(null) except that the call to contains(null) is permitted to throw a NullPointerException.
protected void	initCollectionWithNullElement()
protected void	resetCollection()
protected Collection<E>	resetContainer(Collection<E> newContents)	Replaces the existing container under test with a new container.

Methods inherited from class com.google.common.collect.testing.AbstractContainerTester

createArrayWithDuplicateElement, createDisjointCollection, createOrderedArray, createSamplesArray, e0, e1, e2, e3, e4, emptyCollection, expectAdded, expectAdded, expectAdded, expectContents, expectContents, expectMissing, expectUnchanged, getNullLocation, getNumElements, getOrderedElements, getSampleElements, getSampleElements, resetContainer, setUp

Methods inherited from class com.google.common.collect.testing.AbstractTester

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

Methods inherited from class java.lang.Object

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

Field Detail

collection

protected Collection<E extends @Nullable Object> collection

Constructor Detail

AbstractCollectionTester

public AbstractCollectionTester()

Method Detail

actualContents

protected Collection<E> actualContents()

Specified by:

actualContents in class AbstractContainerTester<Collection<E extends @Nullable Object>,E extends @Nullable Object>

Returns:

the contents of the container under test, for use by expectContents(E...) and its friends.

resetContainer

@CanIgnoreReturnValue
protected Collection<E> resetContainer(Collection<E> newContents)

Description copied from class: AbstractContainerTester

Replaces the existing container under test with a new container. This is useful when a single test method needs to create multiple containers while retaining the ability to use expectContents(E...) and other convenience methods. The creation of multiple containers in a single method is discouraged in most cases, but it is vital to the iterator tests.

Overrides:

resetContainer in class AbstractContainerTester<Collection<E extends @Nullable Object>,E extends @Nullable Object>

Parameters:

newContents - the new container instance

Returns:

the new container instance

resetCollection

protected void resetCollection()

See Also:

AbstractContainerTester.resetContainer()

createArrayWithNullElement

protected E[] createArrayWithNullElement()

Returns:

an array of the proper size with null inserted into the middle element.

initCollectionWithNullElement

protected void initCollectionWithNullElement()

expectNullMissingWhenNullUnsupported

protected void expectNullMissingWhenNullUnsupported(String message)

Equivalent to expectMissing(null) except that the call to contains(null) is permitted to throw a NullPointerException.

Parameters:

message - message to use upon assertion failure