- All Superinterfaces:
RandomGenerator
- All Known Subinterfaces:
RandomGenerator.ArbitrarilyJumpableGenerator
,RandomGenerator.JumpableGenerator
,RandomGenerator.LeapableGenerator
,RandomGenerator.SplittableGenerator
- All Known Implementing Classes:
SplittableRandom
- Enclosing interface:
RandomGenerator
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
Nested classes/interfaces declared in interface java.util.random.RandomGenerator
RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator
-
Method Summary
Modifier and TypeMethodDescriptionrngs()
Returns an effectively unlimited stream of objects, each of which implements theRandomGenerator
interface.default Stream
<RandomGenerator> rngs
(long streamSize) Returns an effectively unlimited stream of objects, each of which implements theRandomGenerator
interface.Methods declared in interface java.util.random.RandomGenerator
doubles, doubles, doubles, doubles, equiDoubles, ints, ints, ints, ints, isDeprecated, longs, longs, longs, longs, nextBoolean, nextBytes, nextDouble, nextDouble, nextDouble, nextExponential, nextFloat, nextFloat, nextFloat, nextGaussian, nextGaussian, nextInt, nextInt, nextInt, nextLong, nextLong, nextLong
-
Method Details
-
of
- Parameters:
name
- Name of random number generator algorithm- Returns:
- An instance of
RandomGenerator.StreamableGenerator
- Throws:
NullPointerException
- if name is nullIllegalArgumentException
- if the named algorithm is not found
-
rngs
Stream<RandomGenerator> rngs()Returns an effectively unlimited stream of objects, each of which implements theRandomGenerator
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
Returns an effectively unlimited stream of objects, each of which implements theRandomGenerator
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 tostreamSize
. - Parameters:
streamSize
- the number of generators to generate- Returns:
- a stream of objects that implement the
RandomGenerator
interface - Throws:
IllegalArgumentException
- ifstreamSize
is less than zero
-