Package org.instancio.internal.generator.array

Class ArrayGenerator<T>

java.lang.Object

org.instancio.internal.generator.AbstractGenerator<T>

org.instancio.internal.generator.array.ArrayGenerator<T>

All Implemented Interfaces:

Generator<T>, GeneratorSpec<T>, ArrayGeneratorSpec<T>, NullableGeneratorSpec<T>

public class ArrayGenerator<T>
extends AbstractGenerator<T>
implements ArrayGeneratorSpec<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected int	maxLength
protected int	minLength

Constructor Summary

Constructors

Constructor	Description
ArrayGenerator(GeneratorContext context)
ArrayGenerator(GeneratorContext context, Class<?> arrayType)

Method Summary

Modifier and Type	Method	Description
String	apiMethod()	Returns the public API method name of the generator spec.
Hints	hints()	Hints provided by the generator to the engine.
ArrayGeneratorSpec<T>	length(int length)	length of array to generate.
ArrayGeneratorSpec<T>	maxLength(int length)	Maximum length of array to generate.
ArrayGeneratorSpec<T>	minLength(int length)	Minimum length of array to generate.
ArrayGeneratorSpec<T>	nullable()	Indicates that null value can be generated.
ArrayGeneratorSpec<T>	nullable(boolean isNullable)
ArrayGeneratorSpec<T>	nullableElements()	Indicates that null values can be generated for array elements.
ArrayGenerator<T>	subtype(Class<?> type)	Specifies the type of array that should be generated.
protected T	tryGenerateNonNull(Random random)	Makes the best effort to return a non-null value.
final ArrayGeneratorSpec<T>	with(T... elements)	Adds given elements to the generated array at random positions.

Methods inherited from class org.instancio.internal.generator.AbstractGenerator

generate, getContext, isNullable

Methods inherited from class java.lang.Object

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

Field Details

minLength

protected int minLength

maxLength

protected int maxLength

Constructor Details

ArrayGenerator

public ArrayGenerator(GeneratorContext context)

ArrayGenerator

public ArrayGenerator(GeneratorContext context,
 Class<?> arrayType)

Method Details

apiMethod

public String apiMethod()

Description copied from class: AbstractGenerator

Returns the public API method name of the generator spec. The returned name is used for reporting validation errors.

Specified by:

apiMethod in class AbstractGenerator<T>

Returns:

spec name if defined, or null otherwise

minLength

public ArrayGeneratorSpec<T> minLength(int length)

Description copied from interface: ArrayGeneratorSpec

Minimum length of array to generate.

Specified by:

minLength in interface ArrayGeneratorSpec<T>

Parameters:

length - minimum length (inclusive)

Returns:

spec builder

maxLength

public ArrayGeneratorSpec<T> maxLength(int length)

Description copied from interface: ArrayGeneratorSpec

Maximum length of array to generate.

Specified by:

maxLength in interface ArrayGeneratorSpec<T>

Parameters:

length - maximum length (inclusive)

Returns:

spec builder

length

public ArrayGeneratorSpec<T> length(int length)

Description copied from interface: ArrayGeneratorSpec

length of array to generate.

Specified by:

length in interface ArrayGeneratorSpec<T>

Parameters:

length - of array

Returns:

spec builder

nullable

public ArrayGeneratorSpec<T> nullable()

Description copied from interface: NullableGeneratorSpec

Indicates that null value can be generated.

Specified by:

nullable in interface ArrayGeneratorSpec<T>

Specified by:

nullable in interface NullableGeneratorSpec<T>

Overrides:

nullable in class AbstractGenerator<T>

Returns:

spec builder

nullable

public ArrayGeneratorSpec<T> nullable(boolean isNullable)

Overrides:

nullable in class AbstractGenerator<T>

nullableElements

public ArrayGeneratorSpec<T> nullableElements()

Description copied from interface: ArrayGeneratorSpec

Indicates that null values can be generated for array elements.

Specified by:

nullableElements in interface ArrayGeneratorSpec<T>

Returns:

spec builder

subtype

public ArrayGenerator<T> subtype(Class<?> type)

Description copied from interface: ArrayGeneratorSpec

Specifies the type of array that should be generated.

Specified by:

subtype in interface ArrayGeneratorSpec<T>

Parameters:

type - of array to generate

Returns:

spec builder

with

@SafeVarargs
public final ArrayGeneratorSpec<T> with(T... elements)

Description copied from interface: ArrayGeneratorSpec

Adds given elements to the generated array at random positions.

Specified by:

with in interface ArrayGeneratorSpec<T>

Parameters:

elements - to add

Returns:

spec builder

tryGenerateNonNull

protected T tryGenerateNonNull(Random random)

Description copied from class: AbstractGenerator

Makes the best effort to return a non-null value. However, in certain cases this method will produce a null.

Specified by:

tryGenerateNonNull in class AbstractGenerator<T>

Parameters:

random - for generating the value

Returns:

generated value, either a null or non-null

hints

public Hints hints()

Description copied from interface: Generator

Hints provided by the generator to the engine.

The most important hint for custom generators is AfterGenerate. This hint indicates whether the object created by this generator:

• should be populated (for example, if it has null fields)
• can be modified using selectors

For example, setting the hint to AfterGenerate.POPULATE_NULLS will cause Instancio to populate null fields on the object returned by this generator:

   @Override
   public Hints hints() {
       return Hints.afterGenerate(AfterGenerate.POPULATE_NULLS);
   }
 

If the action is not specified, default behaviour will be based on the AfterGenerate value configured in the Settings using the key Keys.AFTER_GENERATE_HINT.

In addition, the following hints can be provided for populating data structures:

• ArrayHint
• CollectionHint
• MapHint

Specified by:

hints in interface Generator<T>

Overrides:

hints in class AbstractGenerator<T>

Returns:

hints from this generator to the engine

See Also:

• Hint
• Hints
• AfterGenerate