W3cubDocs

/OpenJDK 21

Interface RandomGenerator.StreamableGenerator

All Superinterfaces:
RandomGenerator
All Known Subinterfaces:
RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator
All Known Implementing Classes:
SplittableRandom
Enclosing interface:
RandomGenerator
public static interface RandomGenerator.StreamableGenerator extends RandomGenerator
The RandomGenerator.StreamableGenerator interface augments the RandomGenerator interface to provide methods that return streams of RandomGenerator objects. Ideally, such a stream of objects would have the property that the behavior of each object is statistically independent of all the others. In practice, one may have to settle for some approximation to this property.

A generator that implements interface RandomGenerator.SplittableGenerator may choose to use its splits() method to implement the rngs() method required by this interface.

A generator that implements interface RandomGenerator.JumpableGenerator may choose to use its jumps() method to implement the rngs() method required by this interface.

A generator that implements interface RandomGenerator.LeapableGenerator may choose to use its leaps() method to implement the rngs() method required by this interface.

Objects that implement RandomGenerator.StreamableGenerator are typically not cryptographically secure. Consider instead using SecureRandom to get a cryptographically secure pseudo-random number generator for use by security-sensitive applications.

Nested Class Summary

Method Summary

Modifier and Type Method Description
static RandomGenerator.StreamableGenerator of(String name)
Returns an instance of RandomGenerator.StreamableGenerator that utilizes the name algorithm.
Stream<RandomGenerator> rngs()
Returns an effectively unlimited stream of objects, each of which implements the RandomGenerator interface.
default Stream<RandomGenerator> rngs(long streamSize)
Returns an effectively unlimited stream of objects, each of which implements the RandomGenerator interface.

Method Details

of

static RandomGenerator.StreamableGenerator of(String name)
Returns an instance of RandomGenerator.StreamableGenerator that utilizes the name algorithm.
Parameters:
name - Name of random number generator algorithm
Returns:
An instance of RandomGenerator.StreamableGenerator
Throws:
NullPointerException - if name is null
IllegalArgumentException - if the named algorithm is not found

rngs

Stream<RandomGenerator> rngs()
Returns an effectively unlimited stream of objects, each of which implements the RandomGenerator interface. Ideally the generators in the stream will appear to be statistically independent. The new generators are of the same algorithm as this generator.
Implementation Note:
It is permitted to implement this method in a manner equivalent to rngs (Long.MAX_VALUE).
Returns:
a stream of objects that implement the RandomGenerator interface

rngs

default Stream<RandomGenerator> rngs(long streamSize)
Returns an effectively unlimited stream of objects, each of which implements the RandomGenerator interface. Ideally the generators in the stream will appear to be statistically independent. The new generators are of the same algorithm as this generator.
Implementation Requirements:
The default implementation calls rngs() and then limits its length to streamSize.
Parameters:
streamSize - the number of generators to generate
Returns:
a stream of objects that implement the RandomGenerator interface
Throws:
IllegalArgumentException - if streamSize is less than zero

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/random/RandomGenerator.StreamableGenerator.html