Class CollectionToArrayTester<E>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

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

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

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

com.google.common.collect.testing.testers.CollectionToArrayTester<E>

All Implemented Interfaces:

junit.framework.Test

@GwtCompatible
public class CollectionToArrayTester<E>
extends AbstractCollectionTester<E>

A generic JUnit test which tests toArray() operations on a collection. Can't be invoked directly; please see CollectionTestSuiteBuilder.

Author:

Kevin Bourrillion, Chris Povirk

Nested Class Summary

Nested classes/interfaces inherited from class AbstractContainerTester

AbstractContainerTester.ArrayWithDuplicate<E>

Modifier and Type	Class	Description
static final class	AbstractContainerTester.ArrayWithDuplicate<E extends @Nullable Object>

Field Summary

Fields inherited from class AbstractCollectionTester

collection

Modifier and Type	Field	Description
protected Collection<E>	collection

Fields inherited from class AbstractContainerTester

container, samples

Modifier and Type	Field	Description
protected Collection<E>	container
protected SampleElements<E>	samples

Constructor Summary

Constructors

Constructor	Description
CollectionToArrayTester()

Method Summary

Modifier and Type	Method	Description
static Method	getToArrayIsPlainObjectArrayMethod()	Returns the Method instance for testToArray_isPlainObjectArray() so that tests of Arrays.asList(Object[]) can suppress it with FeatureSpecificTestSuiteBuilder.suppressing() until JDK-6260652 is fixed.
void	testToArray_emptyArray()
void	testToArray_emptyArray_ordered()
void	testToArray_emptyArrayOfObject()
void	testToArray_emptyArrayOfWrongTypeForEmptyCollection()
void	testToArray_emptyArrayOfWrongTypeForNonEmptyCollection()
void	testToArray_isPlainObjectArray()	Collection.toArray(Object[]) says: "Note that toArray(new Object[0]) is identical in function to toArray()."
void	testToArray_noArgs()
void	testToArray_oversizedArray()
void	testToArray_oversizedArray_ordered()
void	testToArray_rightSizedArray()
void	testToArray_rightSizedArray_ordered()
void	testToArray_rightSizedArrayOfObject()
void	testToArray_rightSizedArrayOfObject_ordered()

Methods inherited from class AbstractCollectionTester

actualContents, createArrayWithNullElement, expectNullMissingWhenNullUnsupported, initCollectionWithNullElement, resetCollection, resetContainer

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 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

Modifier and Type	Method	Description
protected AbstractContainerTester.ArrayWithDuplicate<E>	createArrayWithDuplicateElement()
protected MinimalCollection<E>	createDisjointCollection()
protected E[]	createOrderedArray()
protected E[]	createSamplesArray()
protected final E	e0()
protected final E	e1()
protected final E	e2()
protected final E	e3()
protected final E	e4()
protected MinimalCollection<E>	emptyCollection()
protected final void	expectAdded(int index, E... elements)
protected final void	expectAdded(int index, Collection<E> elements)
protected final void	expectAdded(E... elements)	Asserts that the collection under test contains exactly the elements it was initialized with plus the given elements, according to AbstractContainerTester.expectContents(java.util.Collection).
protected final void	expectContents(E... elements)
protected void	expectContents(Collection<E> expected)	Asserts that the collection under test contains exactly the given elements, respecting cardinality but not order.
protected void	expectMissing(E... elements)
protected void	expectUnchanged()
protected int	getNullLocation()
protected int	getNumElements()
protected List<E>	getOrderedElements()	Returns the sample elements as ordered by TestContainerGenerator.order(List).
protected Collection<E>	getSampleElements()
protected Collection<E>	getSampleElements(int howMany)
protected Collection<E>	resetContainer()	Replaces the existing container under test with a new container created by the subject generator.
void	setUp()

Methods inherited from class AbstractTester

assertNull, getName, getSubjectGenerator, getTestMethodName, init, init, tearDown

Modifier and Type	Method	Description
static void	assertNull(String message, @Nullable Object object)	Asserts that the given object is non-null, with a better failure message than TestCase.assertNull(String, Object).
String	getName()
OneSizeTestContainerGenerator<Collection<E>, E>	getSubjectGenerator()
final String	getTestMethodName()	Returns the name of the test method invoked by this test instance.
final void	init(OneSizeTestContainerGenerator<Collection<E>, E> subjectGenerator, String suiteName)
final void	init(OneSizeTestContainerGenerator<Collection<E>, E> subjectGenerator, String suiteName, @Nullable Runnable setUp, @Nullable Runnable tearDown)
void	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, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, run, run, runBare, runTest, setName, toString

Methods inherited from class Object

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

Constructor Details

CollectionToArrayTester

public CollectionToArrayTester()

Method Details

testToArray_noArgs

public void testToArray_noArgs()

testToArray_isPlainObjectArray

public void testToArray_isPlainObjectArray()

Collection.toArray(Object[]) says: "Note that toArray(new Object[0]) is identical in function to toArray()."

For maximum effect, the collection under test should be created from an element array of a type other than Object[].

testToArray_emptyArray

public void testToArray_emptyArray()

testToArray_emptyArray_ordered

public void testToArray_emptyArray_ordered()

testToArray_emptyArrayOfObject

public void testToArray_emptyArrayOfObject()

testToArray_rightSizedArray

public void testToArray_rightSizedArray()

testToArray_rightSizedArray_ordered

public void testToArray_rightSizedArray_ordered()

testToArray_rightSizedArrayOfObject

public void testToArray_rightSizedArrayOfObject()

testToArray_rightSizedArrayOfObject_ordered

public void testToArray_rightSizedArrayOfObject_ordered()

testToArray_oversizedArray

public void testToArray_oversizedArray()

testToArray_oversizedArray_ordered

public void testToArray_oversizedArray_ordered()

testToArray_emptyArrayOfWrongTypeForNonEmptyCollection

public void testToArray_emptyArrayOfWrongTypeForNonEmptyCollection()

testToArray_emptyArrayOfWrongTypeForEmptyCollection

public void testToArray_emptyArrayOfWrongTypeForEmptyCollection()

getToArrayIsPlainObjectArrayMethod

@GwtIncompatible
public static Method getToArrayIsPlainObjectArrayMethod()

Returns the Method instance for testToArray_isPlainObjectArray() so that tests of Arrays.asList(Object[]) can suppress it with FeatureSpecificTestSuiteBuilder.suppressing() until JDK-6260652 is fixed.