Package org.apache.commons.rng.core.source32

Class JDKRandom

java.lang.Object

org.apache.commons.rng.core.BaseProvider

org.apache.commons.rng.core.source32.IntProvider

org.apache.commons.rng.core.source32.JDKRandom

All Implemented Interfaces:

RandomIntSource, RestorableUniformRandomProvider, UniformRandomProvider

public class JDKRandom
extends IntProvider

A provider that uses the Random.nextInt() method of the JDK's Random class as the source of randomness.

Caveat: All the other calls will be redirected to the methods implemented within this library.

The state of this source of randomness is saved and restored through the serialization of the Random instance.

Since:

1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	JDKRandom.ValidatingObjectInputStream	An ObjectInputStream that's restricted to deserialize only Random using look-ahead deserialization.

Field Summary

Fields

Modifier and Type	Field	Description
private Random	delegate	Delegate.

Constructor Summary

Constructors

Constructor	Description
JDKRandom(Long seed)	Creates an instance with the given seed.

Method Summary

Modifier and Type	Method	Description
protected byte[]	getStateInternal()	Creates a snapshot of the RNG state.
int	next()	Return the next random value.
protected void	setStateInternal(byte[] s)	Resets the RNG to the given state.

Methods inherited from class org.apache.commons.rng.core.source32.IntProvider

nextBoolean, nextBytes, nextBytes, nextBytesFill, nextDouble, nextInt, nextLong, resetCachedState

Methods inherited from class org.apache.commons.rng.core.BaseProvider

checkIndex, checkStateSize, composeStateInternal, extendSeed, extendSeed, fillState, fillState, restoreState, saveState, splitStateInternal, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.rng.UniformRandomProvider

doubles, doubles, doubles, doubles, ints, ints, ints, ints, longs, longs, longs, longs, nextDouble, nextDouble, nextFloat, nextFloat, nextFloat, nextInt, nextInt, nextLong, nextLong

Field Details

delegate

private Random delegate

Delegate. Cannot be "final" (to allow serialization).

Constructor Details

JDKRandom

public JDKRandom(Long seed)

Creates an instance with the given seed.

Parameters:

seed - Initial seed.

Method Details

next

public int next()

Return the next random value.

Returns:

the next random value.

See Also:

• Random.nextInt()

getStateInternal

protected byte[] getStateInternal()

Creates a snapshot of the RNG state.

Overrides:

getStateInternal in class IntProvider

Returns:

the internal state.

setStateInternal

protected void setStateInternal(byte[] s)

Resets the RNG to the given state.

Overrides:

setStateInternal in class IntProvider

Parameters:

s - State (previously obtained by a call to BaseProvider.getStateInternal()).

See Also:

• BaseProvider.checkStateSize(byte[],int)