com.pholser.junit.quickcheck.generator.java.util

Class CollectionGenerator<T extends Collection>

java.lang.Object

com.pholser.junit.quickcheck.generator.Generator<T>

com.pholser.junit.quickcheck.generator.ComponentizedGenerator<T>

com.pholser.junit.quickcheck.generator.java.util.CollectionGenerator<T>

Type Parameters:

T - the type of collection generated

Direct Known Subclasses:

ArrayListGenerator, HashSetGenerator, LinkedHashSetGenerator, LinkedListGenerator, StackGenerator, VectorGenerator

public abstract class CollectionGenerator<T extends Collection>
extends ComponentizedGenerator<T>

Base class for generators of Collections, such as Lists and Set.

The generated collection has a number of elements limited by GenerationStatus.size(), or else by the attributes of a Size marking. The individual elements will have a type corresponding to the theory parameter's type argument.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CollectionGenerator(Class<T> type)

Method Summary

Modifier and Type	Method and Description
boolean	canRegisterAsType(Class<?> type)
void	configure(Size sizeRange) Tells this generator to add elements to the generated collection a number of times within a specified minimum and/or maximum, inclusive, chosen with uniform distribution.
protected abstract T	empty()
T	generate(SourceOfRandomness random, GenerationStatus status)
int	numberOfNeededComponents()

Methods inherited from class com.pholser.junit.quickcheck.generator.ComponentizedGenerator

addComponentGenerators, canGenerateForParametersOfTypes, componentGenerators, configure, hasComponents, provideRepository

Methods inherited from class com.pholser.junit.quickcheck.generator.Generator

compatibleWithTypeParameter, types

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionGenerator

protected CollectionGenerator(Class<T> type)

Method Detail

configure

public void configure(Size sizeRange)

Tells this generator to add elements to the generated collection a number of times within a specified minimum and/or maximum, inclusive, chosen with uniform distribution.

Note that some kinds of collections disallow duplicates, so the number of elements added may not be equal to the collection's Collection.size().

Parameters:

sizeRange - annotation that gives the size constraints

generate

public T generate(SourceOfRandomness random,
                  GenerationStatus status)

Specified by:

generate in class Generator<T extends Collection>

numberOfNeededComponents

public int numberOfNeededComponents()

Overrides:

numberOfNeededComponents in class Generator<T extends Collection>

canRegisterAsType

public boolean canRegisterAsType(Class<?> type)

Overrides:

canRegisterAsType in class Generator<T extends Collection>

empty

protected abstract T empty()