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

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 IntProvider

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

Methods inherited from class BaseProvider

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

Methods inherited from class Object

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

Methods inherited from interface UniformRandomProvider

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

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)