Package org.instancio.internal.generator.lang

Class LongGenerator

java.lang.Object

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

org.instancio.internal.generator.lang.AbstractRandomNumberGeneratorSpec<T>

org.instancio.internal.generator.lang.AbstractRandomComparableNumberGeneratorSpec<Long>

org.instancio.internal.generator.lang.LongGenerator

All Implemented Interfaces:

AsStringGeneratorSpec<Long>, Generator<Long>, GeneratorSpec<Long>, AsGeneratorSpec<Long>, LongSpec, NullableGeneratorSpec<Long>, NumberAsGeneratorSpec<Long>, NumberGeneratorSpec<Long>, NumberSpec<Long>, ValueSpec<Long>

public class LongGenerator
extends AbstractRandomComparableNumberGeneratorSpec<Long>
implements LongSpec

Constructor Summary

Constructors

Constructor	Description
LongGenerator()
LongGenerator(GeneratorContext context)

Method Summary

Modifier and Type	Method	Description
String	apiMethod()	Returns the public API method name of the generator spec.
LongGenerator	max(Long max)	Specifies the upper bound.
LongGenerator	min(Long min)	Specifies the lower bound.
LongGenerator	nullable()	Indicates that null value can be generated.
LongGenerator	nullable(boolean isNullable)
LongGenerator	range(Long min, Long max)	Specifies the range for the generated number.
protected Long	tryGenerateNonNull(Random random)	Makes the best effort to return a non-null value.

Methods inherited from class org.instancio.internal.generator.lang.AbstractRandomNumberGeneratorSpec

generate, getMax, getMin

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

getContext, hints, isNullable

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.instancio.generator.specs.AsGeneratorSpec

as, asString

Methods inherited from interface org.instancio.generator.AsStringGeneratorSpec

asString

Methods inherited from interface org.instancio.generator.Generator

init

Methods inherited from interface org.instancio.generator.ValueSpec

get, list, map, stream, toModel

Constructor Details

LongGenerator

public LongGenerator()

LongGenerator

public LongGenerator(GeneratorContext context)

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

Returns:

spec name if defined, or null otherwise

min

public LongGenerator min(Long min)

Description copied from class: AbstractRandomComparableNumberGeneratorSpec

Specifies the lower bound.

If the specified min value is greater than or equal to the current max value, the max value will be updated to a value higher than the given min.

Specified by:

min in interface LongSpec

Specified by:

min in interface NumberAsGeneratorSpec<Long>

Specified by:

min in interface NumberGeneratorSpec<Long>

Specified by:

min in interface NumberSpec<Long>

Overrides:

min in class AbstractRandomComparableNumberGeneratorSpec<Long>

Parameters:

min - lower bound (inclusive)

Returns:

spec builder

max

public LongGenerator max(Long max)

Description copied from class: AbstractRandomComparableNumberGeneratorSpec

Specifies the upper bound.

If the specified max value is less than or equal to the current min value, the min value will be updated to a value lower than the given max.

Specified by:

max in interface LongSpec

Specified by:

max in interface NumberAsGeneratorSpec<Long>

Specified by:

max in interface NumberGeneratorSpec<Long>

Specified by:

max in interface NumberSpec<Long>

Overrides:

max in class AbstractRandomComparableNumberGeneratorSpec<Long>

Parameters:

max - upper bound (inclusive)

Returns:

spec builder

range

public LongGenerator range(Long min,
 Long max)

Description copied from interface: NumberGeneratorSpec

Specifies the range for the generated number.

This method can be invoked multiple times to specify several ranges, for example, the following will generate a random value within [10-15] or [20-25]:

   ints().range(10, 15).range(20, 25)
 

Note: this method has higher precedence than NumberGeneratorSpec.min(Number) and NumberGeneratorSpec.max(Number). For example, the following will generate a number within [1, 5]:

   ints().range(1, 5).min(95).max(99)
 

Specified by:

range in interface LongSpec

Specified by:

range in interface NumberAsGeneratorSpec<Long>

Specified by:

range in interface NumberGeneratorSpec<Long>

Specified by:

range in interface NumberSpec<Long>

Overrides:

range in class AbstractRandomComparableNumberGeneratorSpec<Long>

Parameters:

min - lower bound (inclusive)

max - upper bound (inclusive)

Returns:

spec builder

nullable

public LongGenerator nullable()

Description copied from interface: NullableGeneratorSpec

Indicates that null value can be generated.

Specified by:

nullable in interface LongSpec

Specified by:

nullable in interface NullableGeneratorSpec<Long>

Specified by:

nullable in interface NumberAsGeneratorSpec<Long>

Specified by:

nullable in interface NumberGeneratorSpec<Long>

Specified by:

nullable in interface NumberSpec<Long>

Specified by:

nullable in interface ValueSpec<Long>

Overrides:

nullable in class AbstractRandomNumberGeneratorSpec<Long>

Returns:

spec builder

nullable

public LongGenerator nullable(boolean isNullable)

Overrides:

nullable in class AbstractRandomNumberGeneratorSpec<Long>

tryGenerateNonNull

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

Parameters:

random - for generating the value

Returns:

generated value, either a null or non-null