com.pholser.junit.quickcheck.generator

Class Fields<T>

java.lang.Object

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

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

Type Parameters:

T - the type of objects generated

All Implemented Interfaces:

Shrink<T>

Deprecated.

This was introduced to alleviate the difficulties of old Theory methods with many parameters, and will likely go away.

@Deprecated
public class Fields<T>
extends Generator<T>

Produces instances of a class by reflecting the class's fields and generating random values for them.

All fields of the class and its class hierarchy are auto-generated.

In order for this generator to work, the type it is given must have an accessible zero-arg constructor.

If a field is marked with an annotation that influences the generation of a given kind of value, it will be applied to the generation of values for that field.

This generator is intended to be used with From, and not to be available via the ServiceLoader mechanism.

Constructor Summary

Constructors

Constructor and Description
Fields(Class<T> type) Deprecated.

Method Summary

Modifier and Type	Method and Description
boolean	canRegisterAsType(Class<?> type) Deprecated. Tells whether this generator is allowed to be used for property parameters of the given type.
void	configure(AnnotatedType annotatedType) Deprecated. Configures this generator using annotations from a given annotated type.
T	generate(SourceOfRandomness random, GenerationStatus status) Deprecated. Produces a value for a property parameter.
void	provideRepository(GeneratorRepository provided) Deprecated. Used to supply the available generators to this one.

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

addComponentGenerators, canGenerateForParametersOfTypes, canShrink, compatibleWithTypeParameter, configurationAnnotationsOn, configure, doShrink, hasComponents, narrow, numberOfNeededComponents, shrink, types

Methods inherited from class java.lang.Object

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

Constructor Detail

Fields

public Fields(Class<T> type)

Deprecated.

Parameters:

type - the type of objects to be generated

Method Detail

generate

public T generate(SourceOfRandomness random,
                  GenerationStatus status)

Deprecated.

Description copied from class: Generator

Produces a value for a property parameter.

A generator may raise an unchecked exception if some condition exists which would lead to a confusing generation -- for example, if a generator honored a "range" configuration, and the endpoints were transposed.

Specified by:

generate in class Generator<T>

Parameters:

random - source of randomness to be used when generating the value

status - an object that the generator can use to influence the value it produces. For example, a generator for lists can use the size method to generate lists with a given number of elements.

Returns:

the generated value

canRegisterAsType

public boolean canRegisterAsType(Class<?> type)

Deprecated.

Description copied from class: Generator

Tells whether this generator is allowed to be used for property parameters of the given type.

Overrides:

canRegisterAsType in class Generator<T>

Parameters:

type - type against which to test this generator

Returns:

true if the generator is allowed to participate in generating values for property parameters of type

provideRepository

public void provideRepository(GeneratorRepository provided)

Deprecated.

Description copied from class: Generator

Used to supply the available generators to this one.

Overrides:

provideRepository in class Generator<T>

Parameters:

provided - repository of available generators

configure

public void configure(AnnotatedType annotatedType)

Deprecated.

Description copied from class: Generator

Configures this generator using annotations from a given annotated type.

This method considers only annotations that are themselves marked with GeneratorConfiguration.

By default, the generator will configure itself using this procedure:

• For each of the given annotations:
  • Find a public method on the generator named configure, that accepts a single parameter of the annotation type
  • Invoke the configure method reflectively, passing the annotation as the argument

Overrides:

configure in class Generator<T>

Parameters:

annotatedType - a type usage