io.github.benas.randombeans

Class EnhancedRandomBuilder

java.lang.Object

io.github.benas.randombeans.EnhancedRandomBuilder

public class EnhancedRandomBuilder
extends Object

Builder to create EnhancedRandom instances.

Author:

Mahmoud Ben Hassine ([email protected])

Constructor Summary

Constructors

Constructor and Description
EnhancedRandomBuilder() Create a new EnhancedRandomBuilder.

Method Summary

Modifier and Type	Method and Description
static EnhancedRandomBuilder	aNewEnhancedRandomBuilder() Create a new EnhancedRandomBuilder.
EnhancedRandom	build() Build a EnhancedRandom instance.
EnhancedRandomBuilder	charset(Charset charset) Set the charset to use for character based fields.
EnhancedRandomBuilder	dateRange(java.time.LocalDate min, java.time.LocalDate max) Set the date range.
EnhancedRandomBuilder	exclude(Class<?>... types) Exclude types from being populated.
<T,F> EnhancedRandomBuilder	exclude(FieldDefinition<T,F> fieldDefinition) Exclude a field from being populated.
EnhancedRandomBuilder	maxCollectionSize(int maxCollectionSize) Set the maximum collection size.
EnhancedRandomBuilder	maxStringLength(int maxStringLength) Set the maximum string length.
EnhancedRandomBuilder	overrideDefaultInitialization(boolean overrideDefaultInitialization) Should default initialization of field values be overridden? E.g.
<T,R> EnhancedRandomBuilder	randomize(Class<T> type, Randomizer<R> randomizer) Register a custom randomizer for a given type.
<T,R> EnhancedRandomBuilder	randomize(Class<T> type, java.util.function.Supplier<R> supplier) Register a supplier as randomizer for a given type.
<T,F,R> EnhancedRandomBuilder	randomize(FieldDefinition<T,F> fieldDefinition, Randomizer<R> randomizer) Register a custom randomizer for a given field.
<T,F,R> EnhancedRandomBuilder	randomize(FieldDefinition<T,F> fieldDefinition, java.util.function.Supplier<R> supplier) Register a supplier as randomizer for a given field.
EnhancedRandomBuilder	registerRandomizerRegistry(RandomizerRegistry registry) Register a RandomizerRegistry.
EnhancedRandomBuilder	scanClasspathForConcreteTypes(boolean scanClasspathForConcreteTypes) Should the classpath be scanned for concrete types when a field with an interface or abstract class type is encountered? Deactivated by default.
EnhancedRandomBuilder	seed(long seed) Set the initial random seed.
EnhancedRandomBuilder	timeRange(java.time.LocalTime min, java.time.LocalTime max) Set the time range.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnhancedRandomBuilder

public EnhancedRandomBuilder()

Create a new EnhancedRandomBuilder.

Method Detail

aNewEnhancedRandomBuilder

public static EnhancedRandomBuilder aNewEnhancedRandomBuilder()

Create a new EnhancedRandomBuilder.

Returns:

a new EnhancedRandomBuilder

randomize

public <T,F,R> EnhancedRandomBuilder randomize(FieldDefinition<T,F> fieldDefinition,
                                               Randomizer<R> randomizer)

Register a custom randomizer for a given field. The field type MUST be provided in the field definition

Type Parameters:

T - The target class type

F - The target field type

R - The type generated by the randomizer

Parameters:

fieldDefinition - definition of the field to randomize

randomizer - the custom Randomizer to use

Returns:

a pre configured EnhancedRandomBuilder instance

randomize

public <T,F,R> EnhancedRandomBuilder randomize(FieldDefinition<T,F> fieldDefinition,
                                               java.util.function.Supplier<R> supplier)

Register a supplier as randomizer for a given field. The field type MUST be provided in the field definition

Type Parameters:

T - The target class type

F - The target field type

R - The type generated by the supplier

Parameters:

fieldDefinition - definition of the field to randomize

supplier - the custom Supplier to use

Returns:

a pre configured EnhancedRandomBuilder instance

randomize

public <T,R> EnhancedRandomBuilder randomize(Class<T> type,
                                             Randomizer<R> randomizer)

Register a custom randomizer for a given type.

Type Parameters:

T - The field type

R - The type generated by the randomizer

Parameters:

type - class of the type to randomize

randomizer - the custom Randomizer to use

Returns:

a pre configured EnhancedRandomBuilder instance

randomize

public <T,R> EnhancedRandomBuilder randomize(Class<T> type,
                                             java.util.function.Supplier<R> supplier)

Register a supplier as randomizer for a given type.

Type Parameters:

T - The field type

R - The type generated by the supplier

Parameters:

type - class of the type to randomize

supplier - the custom Supplier to use

Returns:

a pre configured EnhancedRandomBuilder instance

exclude

public <T,F> EnhancedRandomBuilder exclude(FieldDefinition<T,F> fieldDefinition)

Exclude a field from being populated.

Type Parameters:

T - The target class type

F - The target field type

Parameters:

fieldDefinition - definition of the field to exclude

Returns:

a pre configured EnhancedRandomBuilder instance

exclude

public EnhancedRandomBuilder exclude(Class<?>... types)

Exclude types from being populated.

Parameters:

types - the types to exclude

Returns:

a pre configured EnhancedRandomBuilder instance

seed

public EnhancedRandomBuilder seed(long seed)

Set the initial random seed.

Parameters:

seed - the initial seed

Returns:

a pre configured EnhancedRandomBuilder instance

maxCollectionSize

public EnhancedRandomBuilder maxCollectionSize(int maxCollectionSize)

Set the maximum collection size.

Parameters:

maxCollectionSize - the maximum collection size

Returns:

a pre configured EnhancedRandomBuilder instance

maxStringLength

public EnhancedRandomBuilder maxStringLength(int maxStringLength)

Set the maximum string length.

Parameters:

maxStringLength - the maximum string length

Returns:

a pre configured EnhancedRandomBuilder instance

charset

public EnhancedRandomBuilder charset(Charset charset)

Set the charset to use for character based fields.

Parameters:

charset - the charset to use

Returns:

a pre configured EnhancedRandomBuilder instance

dateRange

public EnhancedRandomBuilder dateRange(java.time.LocalDate min,
                                       java.time.LocalDate max)

Set the date range.

Parameters:

min - date

max - date

Returns:

a pre configured EnhancedRandomBuilder instance

timeRange

public EnhancedRandomBuilder timeRange(java.time.LocalTime min,
                                       java.time.LocalTime max)

Set the time range.

Parameters:

min - time

max - time

Returns:

a pre configured EnhancedRandomBuilder instance

registerRandomizerRegistry

public EnhancedRandomBuilder registerRandomizerRegistry(RandomizerRegistry registry)

Register a RandomizerRegistry.

Parameters:

registry - the RandomizerRegistry to register

Returns:

a pre configured EnhancedRandomBuilder instance

scanClasspathForConcreteTypes

public EnhancedRandomBuilder scanClasspathForConcreteTypes(boolean scanClasspathForConcreteTypes)

Should the classpath be scanned for concrete types when a field with an interface or abstract class type is encountered? Deactivated by default.

Parameters:

scanClasspathForConcreteTypes - whether to scan the classpath or not

Returns:

a pre configured EnhancedRandomBuilder instance

overrideDefaultInitialization

public EnhancedRandomBuilder overrideDefaultInitialization(boolean overrideDefaultInitialization)

Should default initialization of field values be overridden? E.g. should the values of the strings and integers fields below be kept untouched or should they be randomized.

 
 public class Bean {
     Set<String> strings = new HashSet<>();
     List<Integer> integers;
 
     public Bean() {
         integers = Arrays.asList(1, 2, 3);
     }
 }
 

Deactivated by default.

Parameters:

overrideDefaultInitialization - whether to override default initialization of field values or not

Returns:

a pre configured EnhancedRandomBuilder instance

build

public EnhancedRandom build()

Build a EnhancedRandom instance.

Returns:

a configured EnhancedRandom instance