This is a factory class for generating multiple random number generators of a specific algorithm. RandomGeneratorFactory also provides methods for selecting random number generator algorithms. A specific RandomGeneratorFactory can be located by using the RandomGeneratorFactory#of(String) method, where the argument string is the name of the algorithm required. The method RandomGeneratorFactory#all() produces a non-empty Stream of all available RandomGeneratorFactorys that can be searched to locate a RandomGeneratorFactory suitable to the task. There are three methods for constructing a RandomGenerator instance, depending on the type of initial seed required. RandomGeneratorFactory#create(long) is used for long seed construction, RandomGeneratorFactory#create(byte[]) is used for byte[] seed construction, and RandomGeneratorFactory#create() is used for random seed construction. Example;

RandomGeneratorFactory<RandomGenerator> factory = RandomGeneratorFactory.of("Random");

 for (int i = 0; i < 10; i++) {
     new Thread(() -> {
         RandomGenerator random = factory.create(100L);
         System.out.println(random.nextDouble());
     }).start();
 }

RandomGeneratorFactory also provides methods describing the attributes (or properties) of a generator and can be used to select random number generator algorithms. These methods are typically used in conjunction with RandomGeneratorFactory#all(). In this example, the code locates the RandomGeneratorFactory that produces RandomGenerators with the highest number of state bits.

RandomGeneratorFactory<RandomGenerator> best = RandomGeneratorFactory.all()
    .filter(rgf -> !rgf.name().equals("SecureRandom")) // SecureRandom has MAX_VALUE stateBits.
    .sorted(Comparator.comparingInt(RandomGeneratorFactory<RandomGenerator>::stateBits).reversed())
    .findFirst()
    .orElse(RandomGeneratorFactory.of("Random"));
System.out.println(best.name() + " in " + best.group() + " was selected");

RandomGenerator rng = best.create();
System.out.println(rng.nextLong());

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static record	RandomGeneratorFactory.RandomGeneratorProperties

Field Summary

Modifier and Type	Field and Description
private static final String	DEFAULT_ALGORITHM
private final RandomGeneratorFactory.RandomGeneratorProperties	properties Random generator properties.

Constructor Summary

Access	Constructor and Description
private	RandomGeneratorFactory(RandomGeneratorFactory.RandomGeneratorProperties Random generator properties. properties) Private constructor.

Method Summary

Modifier and Type	Method and Description
public static Stream<RandomGeneratorFactory<RandomGenerator>>	Returns: a non-empty stream of all available `RandomGeneratorFactory(s)`. all() Returns a non-empty stream of available `RandomGeneratorFactory(s)`.
public T	Returns: new instance of `RandomGenerator`. create() Create an instance of `RandomGenerator` based on the algorithm chosen.
public T	Returns: new instance of `RandomGenerator`. create(long long random seed value. seed) Create an instance of `RandomGenerator` based on the algorithm chosen, and the provided `seed`.
public T	Returns: new instance of `RandomGenerator`. create(byte[] byte array random seed value. seed) Create an instance of `RandomGenerator` based on the algorithm chosen, and the provided `seed`.
public int	Returns: the equidistribution of the algorithm. equidistribution() Returns the equidistribution of the algorithm.
pack-priv static < Sub-interface of `RandomGenerator` to produce T extends RandomGenerator> RandomGeneratorFactory<T>	Returns: Factory of `RandomGenerator` factoryOf(String Name of random number algorithm to use name, Class<T> Sub-interface of `RandomGenerator` to type check category) Returns a `RandomGeneratorFactory` that will produce instances of `RandomGenerator` that utilizes the named algorithm.
private static RandomGeneratorFactory.RandomGeneratorProperties	Returns: A RandomGeneratorProperties instance matching name and category. findClass(String Name of RandomGenerator name, Class<? extends RandomGenerator> Interface category, sub-interface of `RandomGenerator`. category) Returns a RandomGeneratorProperties instance matching name and category.
public static RandomGeneratorFactory<RandomGenerator>	Returns: a `RandomGeneratorFactory` getDefault() Returns a `RandomGeneratorFactory` meeting the minimal requirement of having an algorithm whose state bits are greater than or equal 64.
private static Map<String, RandomGeneratorFactory.RandomGeneratorProperties>	Returns: Map of random generator classes. getFactoryMap() Returns the factory map, lazily constructing the map on first call.
public String	Returns: Group name of the algorithm. group() Return the group name of the algorithm used by the random number generator.
public boolean	Returns: true if random generator is arbitrarily jumpable. isArbitrarilyJumpable() Return true if random generator can jump an arbitrarily specified distant point in the state cycle.
public boolean	Returns: true if the implementation of RandomGenerator (algorithm) has been marked for deprecation isDeprecated() Return true if the implementation of RandomGenerator (algorithm) has been marked for deprecation.
public boolean	Returns: true if random generator is generated by hardware. isHardware() Return true if random generator uses a hardware device (HRNG) to produce entropic input.
public boolean	Returns: true if random generator is jumpable. isJumpable() Return true if random generator can jump a specified distant point in the state cycle.
public boolean	Returns: true if random generator is leapable. isLeapable() Return true if random generator is jumpable and can leap to a very distant point in the state cycle.
public boolean	Returns: true if random generator is splittable. isSplittable() Return true if random generator can be cloned into a separate object with the same properties but positioned further in the state cycle.
public boolean	Returns: true if random generator is statistical. isStatistical() Return true if random generator is computed using an arithmetic algorithm and is statistically deterministic.
public boolean	Returns: true if random generator is stochastic. isStochastic() Return true if random generator is computed using external or entropic sources as inputs.
public boolean	Returns: true if random generator is streamable. isStreamable() Return true if random generator can be used to create `Streams` of random numbers.
private boolean	Returns: true if the random generator class is a subclass of the category. isSubclass(Class<? extends RandomGenerator> Interface category, sub-interface of `RandomGenerator`. category) Return true if the random generator class is a subclass of the category.
private static boolean	Returns: true if rgClass is a subclass of the category. isSubclass(Class<? extends RandomGenerator> Interface category, sub-interface of `RandomGenerator`. category, Class<? extends RandomGenerator> Class that is being filtered. rgClass) Return true if rgClass is a subclass of the category.
public String	Returns: Name of the algorithm. name() Return the name of the algorithm used by the random number generator.
pack-priv static < Sub-interface of `RandomGenerator` to produce T extends RandomGenerator> T	Returns: An instance of `RandomGenerator` of(String Name of random number algorithm to use name, Class<T> Sub-interface of `RandomGenerator` to type check category) Returns a `RandomGenerator` that utilizes the `name` algorithm.
public static < Sub-interface of `RandomGenerator` to produce T extends RandomGenerator> RandomGeneratorFactory<T>	Returns: `RandomGeneratorFactory` of `RandomGenerator` of(String Name of random number generator algorithm name) Returns a `RandomGeneratorFactory` that can produce instances of `RandomGenerator` that utilize the `name` algorithm.
public BigInteger	Returns: BigInteger period. period() Return the period of the algorithm used by the random number generator.
public int	Returns: number of bits used by the algorithm to maintain state of seed. stateBits() Returns number of bits used by the algorithm to maintain state of seed.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

DEFAULT_ALGORITHM	back to summary
private static final String DEFAULT_ALGORITHM

properties	back to summary
private final RandomGeneratorFactory.RandomGeneratorProperties properties Random generator properties.

Constructor Detail

RandomGeneratorFactory	back to summary
private RandomGeneratorFactory(RandomGeneratorFactory.RandomGeneratorProperties properties) Private constructor. Parameters properties:RandomGeneratorFactory.RandomGeneratorProperties Random generator properties.

RandomGeneratorFactory

back to summary

private RandomGeneratorFactory(RandomGeneratorFactory.RandomGeneratorProperties properties)

Private constructor.

Parameters

properties:RandomGeneratorFactory.RandomGeneratorProperties: Random generator properties.

Method Detail

all back to summary

all	back to summary
public static Stream<RandomGeneratorFactory<RandomGenerator>> all() Returns a non-empty stream of available `RandomGeneratorFactory(s)`. RandomGenerators that are marked as deprecated are not included in the result. Returns:Stream<RandomGeneratorFactory<RandomGenerator>> a non-empty stream of all available `RandomGeneratorFactory(s)`.

public static Stream<RandomGeneratorFactory<RandomGenerator>> all()

Returns a non-empty stream of available RandomGeneratorFactory(s). RandomGenerators that are marked as deprecated are not included in the result.

Returns:Stream<RandomGeneratorFactory<RandomGenerator>>: a non-empty stream of all available RandomGeneratorFactory(s).

create back to summary

create	back to summary
public T create() Create an instance of `RandomGenerator` based on the algorithm chosen. Returns:T new instance of `RandomGenerator`.

public T create()

Create an instance of RandomGenerator based on the algorithm chosen.

Returns:T: new instance of RandomGenerator.

create back to summary

create	back to summary
public T create(long seed) Create an instance of `RandomGenerator` based on the algorithm chosen, and the provided `seed`. If the `RandomGenerator` doesn't support instantiation through a `seed` of type `long` then this method throws an `UnsupportedOperationException`. Parameters seed:long long random seed value. Returns:T new instance of `RandomGenerator`. Exceptions UnsupportedOperationException: if a `seed` of type `long` in not supported.

public T create(long seed)

Create an instance of RandomGenerator based on the algorithm chosen, and the provided seed. If the RandomGenerator doesn't support instantiation through a seed of type long then this method throws an UnsupportedOperationException.

Parameters

seed:long: long random seed value.

Returns:T

new instance of RandomGenerator.

Exceptions

UnsupportedOperationException:: if a seed of type long in not supported.

create back to summary

create	back to summary
public T create(byte[] seed) Create an instance of `RandomGenerator` based on the algorithm chosen, and the provided `seed`. If the `RandomGenerator` doesn't support instantiation through a `seed` of type `byte[]` then this method throws an `UnsupportedOperationException`. Parameters seed:byte[] byte array random seed value. Returns:T new instance of `RandomGenerator`. Exceptions UnsupportedOperationException: if a `seed` of type `byte[]` in not supported. NullPointerException: if seed is null.

public T create(byte[] seed)

Create an instance of RandomGenerator based on the algorithm chosen, and the provided seed. If the RandomGenerator doesn't support instantiation through a seed of type byte[] then this method throws an UnsupportedOperationException.

Parameters

seed:byte[]: byte array random seed value.

Returns:T

new instance of RandomGenerator.

Exceptions

UnsupportedOperationException:: if a seed of type byte[] in not supported.
NullPointerException:: if seed is null.

equidistribution	back to summary
public int equidistribution() Returns the equidistribution of the algorithm. Returns:int the equidistribution of the algorithm.

equidistribution

back to summary

public int equidistribution()

Returns the equidistribution of the algorithm.

Returns:int: the equidistribution of the algorithm.

factoryOf back to summary

factoryOf	back to summary
pack-priv static <T extends RandomGenerator> RandomGeneratorFactory<T> factoryOf(String name, Class<T> category) throws IllegalArgumentException Returns a `RandomGeneratorFactory` that will produce instances of `RandomGenerator` that utilizes the named algorithm. Parameters <T> Sub-interface of `RandomGenerator` to produce name:String Name of random number algorithm to use category:Class<T> Sub-interface of `RandomGenerator` to type check Returns:RandomGeneratorFactory<T> Factory of `RandomGenerator` Exceptions IllegalArgumentException: when either the name or category is null

pack-priv static <T extends RandomGenerator> RandomGeneratorFactory<T> factoryOf(String name, Class<T> category) throws IllegalArgumentException

Returns a RandomGeneratorFactory that will produce instances of RandomGenerator that utilizes the named algorithm.

Parameters

<T>: Sub-interface of RandomGenerator to produce
name:String: Name of random number algorithm to use
category:Class<T>: Sub-interface of RandomGenerator to type check

Returns:RandomGeneratorFactory<T>

Factory of RandomGenerator

Exceptions

IllegalArgumentException:: when either the name or category is null

findClass back to summary

findClass	back to summary
private static RandomGeneratorFactory.RandomGeneratorProperties findClass(String name, Class<? extends RandomGenerator> category) throws IllegalArgumentException Returns a RandomGeneratorProperties instance matching name and category. Parameters name:String Name of RandomGenerator category:Class<? extends RandomGenerator> Interface category, sub-interface of `RandomGenerator`. Returns:RandomGeneratorFactory.RandomGeneratorProperties A RandomGeneratorProperties instance matching name and category. Exceptions IllegalArgumentException: if the resulting type is not a subclass of category.

private static RandomGeneratorFactory.RandomGeneratorProperties findClass(String name, Class<? extends RandomGenerator> category) throws IllegalArgumentException

Returns a RandomGeneratorProperties instance matching name and category.

Parameters

name:String: Name of RandomGenerator
category:Class<? extends RandomGenerator>: Interface category, sub-interface of RandomGenerator.

Returns:RandomGeneratorFactory.RandomGeneratorProperties

A RandomGeneratorProperties instance matching name and category.

Exceptions

IllegalArgumentException:: if the resulting type is not a subclass of category.

getDefault back to summary

getDefault	back to summary
public static RandomGeneratorFactory<RandomGenerator> getDefault() Returns a `RandomGeneratorFactory` meeting the minimal requirement of having an algorithm whose state bits are greater than or equal 64. Implementation Specification Since algorithms will improve over time, there is no guarantee that this method will return the same algorithm over time. Returns:RandomGeneratorFactory<RandomGenerator> a `RandomGeneratorFactory`

public static RandomGeneratorFactory<RandomGenerator> getDefault()

Returns a RandomGeneratorFactory meeting the minimal requirement of having an algorithm whose state bits are greater than or equal 64.

Implementation Specification

Since algorithms will improve over time, there is no guarantee that this method will return the same algorithm over time.

Returns:RandomGeneratorFactory<RandomGenerator>: a RandomGeneratorFactory

getFactoryMap	back to summary
private static Map<String, RandomGeneratorFactory.RandomGeneratorProperties> getFactoryMap() Returns the factory map, lazily constructing the map on first call. Returns:Map<String, RandomGeneratorFactory.RandomGeneratorProperties> Map of random generator classes.

getFactoryMap

back to summary

private static Map<String, RandomGeneratorFactory.RandomGeneratorProperties> getFactoryMap()

Returns the factory map, lazily constructing the map on first call.

Returns:Map<String, RandomGeneratorFactory.RandomGeneratorProperties>: Map of random generator classes.

group	back to summary
public String group() Return the group name of the algorithm used by the random number generator. Returns:String Group name of the algorithm.

group

back to summary

public String group()

Return the group name of the algorithm used by the random number generator.

Returns:String: Group name of the algorithm.

isArbitrarilyJumpable	back to summary
public boolean isArbitrarilyJumpable() Return true if random generator can jump an arbitrarily specified distant point in the state cycle. Returns:boolean true if random generator is arbitrarily jumpable.

isArbitrarilyJumpable

back to summary

public boolean isArbitrarilyJumpable()

Return true if random generator can jump an arbitrarily specified distant point in the state cycle.

Returns:boolean: true if random generator is arbitrarily jumpable.

isDeprecated	back to summary
public boolean isDeprecated() Return true if the implementation of RandomGenerator (algorithm) has been marked for deprecation. Implementation Note Random number generator algorithms evolve over time; new algorithms will be introduced and old algorithms will lose standing. If an older algorithm is deemed unsuitable for continued use, it will be marked as deprecated to indicate that it may be removed at some point in the future. Returns:boolean true if the implementation of RandomGenerator (algorithm) has been marked for deprecation

isDeprecated

back to summary

public boolean isDeprecated()

Return true if the implementation of RandomGenerator (algorithm) has been marked for deprecation.

Implementation Note

Random number generator algorithms evolve over time; new algorithms will be introduced and old algorithms will lose standing. If an older algorithm is deemed unsuitable for continued use, it will be marked as deprecated to indicate that it may be removed at some point in the future.

Returns:boolean: true if the implementation of RandomGenerator (algorithm) has been marked for deprecation

isHardware	back to summary
public boolean isHardware() Return true if random generator uses a hardware device (HRNG) to produce entropic input. Returns:boolean true if random generator is generated by hardware.

isHardware

back to summary

public boolean isHardware()

Return true if random generator uses a hardware device (HRNG) to produce entropic input.

Returns:boolean: true if random generator is generated by hardware.

isJumpable	back to summary
public boolean isJumpable() Return true if random generator can jump a specified distant point in the state cycle. Returns:boolean true if random generator is jumpable.

isJumpable

back to summary

public boolean isJumpable()

Return true if random generator can jump a specified distant point in the state cycle.

Returns:boolean: true if random generator is jumpable.

isLeapable	back to summary
public boolean isLeapable() Return true if random generator is jumpable and can leap to a very distant point in the state cycle. Returns:boolean true if random generator is leapable.

isLeapable

back to summary

public boolean isLeapable()

Return true if random generator is jumpable and can leap to a very distant point in the state cycle.

Returns:boolean: true if random generator is leapable.

isSplittable	back to summary
public boolean isSplittable() Return true if random generator can be cloned into a separate object with the same properties but positioned further in the state cycle. Returns:boolean true if random generator is splittable.

isSplittable

back to summary

public boolean isSplittable()

Return true if random generator can be cloned into a separate object with the same properties but positioned further in the state cycle.

Returns:boolean: true if random generator is splittable.

isStatistical	back to summary
public boolean isStatistical() Return true if random generator is computed using an arithmetic algorithm and is statistically deterministic. Returns:boolean true if random generator is statistical.

isStatistical

back to summary

public boolean isStatistical()

Return true if random generator is computed using an arithmetic algorithm and is statistically deterministic.

Returns:boolean: true if random generator is statistical.

isStochastic	back to summary
public boolean isStochastic() Return true if random generator is computed using external or entropic sources as inputs. Returns:boolean true if random generator is stochastic.

isStochastic

back to summary

public boolean isStochastic()

Return true if random generator is computed using external or entropic sources as inputs.

Returns:boolean: true if random generator is stochastic.

isStreamable back to summary

isStreamable	back to summary
public boolean isStreamable() Return true if random generator can be used to create `Streams` of random numbers. Returns:boolean true if random generator is streamable.

public boolean isStreamable()

Return true if random generator can be used to create Streams of random numbers.

Returns:boolean: true if random generator is streamable.

isSubclass back to summary

isSubclass	back to summary
private boolean isSubclass(Class<? extends RandomGenerator> category) Return true if the random generator class is a subclass of the category. Parameters category:Class<? extends RandomGenerator> Interface category, sub-interface of `RandomGenerator`. Returns:boolean true if the random generator class is a subclass of the category.

private boolean isSubclass(Class<? extends RandomGenerator> category)

Return true if the random generator class is a subclass of the category.

Parameters

category:Class<? extends RandomGenerator>: Interface category, sub-interface of RandomGenerator.

Returns:boolean

true if the random generator class is a subclass of the category.

isSubclass back to summary

isSubclass	back to summary
private static boolean isSubclass(Class<? extends RandomGenerator> category, Class<? extends RandomGenerator> rgClass) Return true if rgClass is a subclass of the category. Parameters category:Class<? extends RandomGenerator> Interface category, sub-interface of `RandomGenerator`. rgClass:Class<? extends RandomGenerator> Class that is being filtered. Returns:boolean true if rgClass is a subclass of the category.

private static boolean isSubclass(Class<? extends RandomGenerator> category, Class<? extends RandomGenerator> rgClass)

Return true if rgClass is a subclass of the category.

Parameters

category:Class<? extends RandomGenerator>: Interface category, sub-interface of RandomGenerator.
rgClass:Class<? extends RandomGenerator>: Class that is being filtered.

Returns:boolean

true if rgClass is a subclass of the category.

name	back to summary
public String name() Return the name of the algorithm used by the random number generator. Returns:String Name of the algorithm.

name

back to summary

public String name()

Return the name of the algorithm used by the random number generator.

Returns:String: Name of the algorithm.

of back to summary

of	back to summary
pack-priv static <T extends RandomGenerator> T of(String name, Class<T> category) throws IllegalArgumentException Returns a `RandomGenerator` that utilizes the `name` algorithm. Parameters <T> Sub-interface of `RandomGenerator` to produce name:String Name of random number algorithm to use category:Class<T> Sub-interface of `RandomGenerator` to type check Returns:T An instance of `RandomGenerator` Exceptions IllegalArgumentException: when either the name or category is null

pack-priv static <T extends RandomGenerator> T of(String name, Class<T> category) throws IllegalArgumentException

Returns a RandomGenerator that utilizes the name algorithm.

Parameters

<T>: Sub-interface of RandomGenerator to produce
name:String: Name of random number algorithm to use
category:Class<T>: Sub-interface of RandomGenerator to type check

Returns:T

An instance of RandomGenerator

Exceptions

IllegalArgumentException:: when either the name or category is null

of back to summary

of	back to summary
public static <T extends RandomGenerator> RandomGeneratorFactory<T> of(String name) Returns a `RandomGeneratorFactory` that can produce instances of `RandomGenerator` that utilize the `name` algorithm. Parameters <T> Sub-interface of `RandomGenerator` to produce name:String Name of random number generator algorithm Returns:RandomGeneratorFactory<T> `RandomGeneratorFactory` of `RandomGenerator` Exceptions NullPointerException: if name is null IllegalArgumentException: if the named algorithm is not found

public static <T extends RandomGenerator> RandomGeneratorFactory<T> of(String name)

Returns a RandomGeneratorFactory that can produce instances of RandomGenerator that utilize the name algorithm.

Parameters

<T>: Sub-interface of RandomGenerator to produce
name:String: Name of random number generator algorithm

Returns:RandomGeneratorFactory<T>

RandomGeneratorFactory of RandomGenerator

Exceptions

NullPointerException:: if name is null
IllegalArgumentException:: if the named algorithm is not found

period	back to summary
public BigInteger period() Return the period of the algorithm used by the random number generator. Returns BigInteger.ZERO if period is not determinable. Returns:BigInteger BigInteger period.

period

back to summary

public BigInteger period()

Return the period of the algorithm used by the random number generator. Returns BigInteger.ZERO if period is not determinable.

Returns:BigInteger: BigInteger period.

stateBits	back to summary
public int stateBits() Returns number of bits used by the algorithm to maintain state of seed. Returns:int number of bits used by the algorithm to maintain state of seed.

stateBits

back to summary

public int stateBits()

Returns number of bits used by the algorithm to maintain state of seed.

Returns:int: number of bits used by the algorithm to maintain state of seed.

java.util.random back to summary

private final Record RandomGeneratorFactory.RandomGeneratorProperties

Class Inheritance

extends Record

java.lang.Object
java.lang.Record
java.util.random.RandomGeneratorFactory.RandomGeneratorProperties

Record Components

rgClass:Class<? extends RandomGenerator>
name:String
group:String
i:int
j:int
k:int
equidistribution:int
flags:int

Field Summary

Modifier and Type	Field and Description
private static final int	ALL_CONSTRUCTORS
private static final int	BYTE_ARRAY_SEED
private static final int	DEPRECATED
private final int	equidistribution Record Component accessed by equidistribution().
private static final Map<String, RandomGeneratorFactory.RandomGeneratorProperties>	FACTORY_MAP
private final int	flags Record Component accessed by flags().
private final String	group Record Component accessed by group().
private static final int	HARDWARE
private final int	i Record Component accessed by i().
private static final int	INSTANTIABLE
private final int	j Record Component accessed by j().
private final int	k Record Component accessed by k().
private static final int	LONG_SEED
private final String	name Record Component accessed by name().
private final Class<? extends RandomGenerator>	rgClass Record Component accessed by rgClass().
private static final int	STOCHASTIC

Constructor Summary

Access	Constructor and Description
private	RandomGeneratorProperties(Class<? extends RandomGenerator> rgClass, String name, String group, int i, int j, int k, int equidistribution, int flags)

Method Summary

Modifier and Type	Method and Description
private RandomGenerator	create()
private RandomGenerator	create(long seed)
private RandomGenerator	create(byte[] seed)
private static Map<String, RandomGeneratorFactory.RandomGeneratorProperties>	Returns: Map of RandomGeneratorProperties. createFactoryMap() Returns the factory map, lazily constructing it on first use.
private static int	deprecationBit(Class<? extends RandomGenerator> rgClass)
private static Map.Entry<String, RandomGeneratorFactory.RandomGeneratorProperties>	entry(Class<? extends RandomGenerator> rgClass, String name, String group, int i, int j, int k, int equidistribution, int flags)
public final boolean	equals(Object o) Implements abstract java.lang.Record.equals. Indicates whether some other object is "equal to" this one.
public int	equidistribution() Record Component getter of equidistribution.
public int	flags() Record Component getter of flags.
public String	group() Record Component getter of group.
public final int	hashCode() Implements abstract java.lang.Record.hashCode. Returns a hash code value for the record.
public int	i() Record Component getter of i.
private boolean	isDeprecated()
private boolean	isHardware()
private boolean	isInstantiable()
private boolean	isStochastic()
public int	j() Record Component getter of j.
public int	k() Record Component getter of k.
public String	name() Record Component getter of name.
private BigInteger	period()
public Class<? extends RandomGenerator>	rgClass() Record Component getter of rgClass.
private int	stateBits()
public final String	toString() Implements abstract java.lang.Record.toString. Returns a string representation of the record.

Field Detail

ALL_CONSTRUCTORS	back to summary
private static final int ALL_CONSTRUCTORS

BYTE_ARRAY_SEED	back to summary
private static final int BYTE_ARRAY_SEED

DEPRECATED	back to summary
private static final int DEPRECATED

equidistribution	back to summary
private final int equidistribution Record Component accessed by equidistribution().

FACTORY_MAP	back to summary
private static final Map<String, RandomGeneratorFactory.RandomGeneratorProperties> FACTORY_MAP

flags	back to summary
private final int flags Record Component accessed by flags().

group	back to summary
private final String group Record Component accessed by group().

HARDWARE	back to summary
private static final int HARDWARE

i	back to summary
private final int i Record Component accessed by i().

INSTANTIABLE	back to summary
private static final int INSTANTIABLE

j	back to summary
private final int j Record Component accessed by j().

k	back to summary
private final int k Record Component accessed by k().

LONG_SEED	back to summary
private static final int LONG_SEED

name	back to summary
private final String name Record Component accessed by name().

rgClass	back to summary
private final Class<? extends RandomGenerator> rgClass Record Component accessed by rgClass().

STOCHASTIC	back to summary
private static final int STOCHASTIC

Constructor Detail

RandomGeneratorProperties	back to summary
private RandomGeneratorProperties(Class<? extends RandomGenerator> rgClass, String name, String group, int i, int j, int k, int equidistribution, int flags)

Method Detail

create	back to summary
private RandomGenerator create()

create	back to summary
private RandomGenerator create(long seed)

create	back to summary
private RandomGenerator create(byte[] seed)

createFactoryMap back to summary

private static Map<String, RandomGeneratorFactory.RandomGeneratorProperties> createFactoryMap()

Returns the factory map, lazily constructing it on first use.

Although ThreadLocalRandom can only be accessed via ThreadLocalRandom#current(), a map entry is added nevertheless to record its properties that are otherwise not documented anywhere else.

Currently, no algorithm is deprecated.

Returns:Map<String, RandomGeneratorFactory.RandomGeneratorProperties>: Map of RandomGeneratorProperties.

deprecationBit	back to summary
private static int deprecationBit(Class<? extends RandomGenerator> rgClass)

entry	back to summary
private static Map.Entry<String, RandomGeneratorFactory.RandomGeneratorProperties> entry(Class<? extends RandomGenerator> rgClass, String name, String group, int i, int j, int k, int equidistribution, int flags)

equals back to summary

public final boolean equals(Object o)

Implements abstract java.lang.Record.equals.

Doc from java.lang.Record.equals.

Indicates whether some other object is "equal to" this one. In addition to the general contract of Object.equals, record classes must further obey the invariant that when a record instance is "copied" by passing the result of the record component accessor methods to the canonical constructor, as follows:

    R copy = new R(r.c1(), r.c2(), ..., r.cn());

then it must be the case that r.equals(copy).

equidistribution	back to summary
public int equidistribution() Record Component getter of equidistribution.

flags	back to summary
public int flags() Record Component getter of flags.

group	back to summary
public String group() Record Component getter of group.

hashCode back to summary

public final int hashCode()

Implements abstract java.lang.Record.hashCode.

Doc from java.lang.Record.hashCode.

Returns a hash code value for the record. Obeys the general contract of Object.hashCode. For records, hashing behavior is constrained by the refined contract of Record.equals, so that any two records created from the same components must have the same hash code.

i	back to summary
public int i() Record Component getter of i.

isDeprecated	back to summary
private boolean isDeprecated()

isHardware	back to summary
private boolean isHardware()

isInstantiable	back to summary
private boolean isInstantiable()

isStochastic	back to summary
private boolean isStochastic()

j	back to summary
public int j() Record Component getter of j.

k	back to summary
public int k() Record Component getter of k.

name	back to summary
public String name() Record Component getter of name.

period	back to summary
private BigInteger period()

rgClass	back to summary
public Class<? extends RandomGenerator> rgClass() Record Component getter of rgClass.

stateBits	back to summary
private int stateBits()

toString back to summary

public final String toString()

Implements abstract java.lang.Record.toString.

Doc from java.lang.Record.toString.

Returns a string representation of the record. In accordance with the general contract of Object#toString(), the toString method returns a string that "textually represents" this record. The result should be a concise but informative representation that is easy for a person to read.

In addition to this general contract, record classes must further participate in the invariant that any two records which are equal must produce equal strings. This invariant is necessarily relaxed in the rare case where corresponding equal component values might fail to produce equal strings for themselves.

public final Class RandomGeneratorFactory<T extends RandomGenerator>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Record RandomGeneratorFactory.RandomGeneratorProperties

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail