Package org.exoplatform.web.security.security

Class AutoReseedRandom

java.lang.Object

java.util.Random

java.security.SecureRandom

org.exoplatform.web.security.security.AutoReseedRandom

All Implemented Interfaces:

Serializable, Runnable, RandomGenerator

public class AutoReseedRandom
extends SecureRandom
implements Runnable

Subclass of SecureRandom which is able to reseed itself every reseedingPeriod milliseconds. All methods inherited from SecureRandom are passed to delegate. When reseeding the delegate is recreated. The reseeding happens in a new Thread not to block the Thread in which any of the next* methods is called.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.random.RandomGenerator

RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_RANDOM_ALGORITHM	Default random algorithm "SHA1PRNG".
static final String	DEFAULT_RANDOM_ALGORITHM_PROVIDER	Default random algorithm provider.
static final long	DEFAULT_RESEEDING_PERIOD	Default expiration time in milliseconds, an equivalent of 24 hours.
static final int	DEFAULT_SEED_LENGTH	Default seed length 32.

Constructor Summary

Constructors

Constructor	Description
AutoReseedRandom()
AutoReseedRandom(String algorithm, String algorithmProvider, int seedLength, long reseedingPeriod)

Method Summary

Modifier and Type	Method	Description
byte[]	generateSeed(int numBytes)
String	getAlgorithm()
boolean	nextBoolean()
void	nextBytes(byte[] bytes)
double	nextDouble()
float	nextFloat()
double	nextGaussian()
int	nextInt()
int	nextInt(int n)
long	nextLong()
void	run()	Called from the reseeding Thread.
void	setSeed(byte[] seed)
void	setSeed(long seed)

Methods inherited from class java.security.SecureRandom

getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstanceStrong, getParameters, getProvider, getSeed, next, nextBytes, reseed, reseed, toString

Methods inherited from class java.util.Random

doubles, doubles, doubles, doubles, from, ints, ints, ints, ints, longs, longs, longs, longs

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.random.RandomGenerator

isDeprecated, nextDouble, nextDouble, nextExponential, nextFloat, nextFloat, nextGaussian, nextInt, nextLong, nextLong

Field Details

DEFAULT_RESEEDING_PERIOD

public static final long DEFAULT_RESEEDING_PERIOD

Default expiration time in milliseconds, an equivalent of 24 hours.

See Also:

• Constant Field Values

DEFAULT_RANDOM_ALGORITHM

public static final String DEFAULT_RANDOM_ALGORITHM

Default random algorithm "SHA1PRNG".

See Also:

• Constant Field Values

DEFAULT_RANDOM_ALGORITHM_PROVIDER

public static final String DEFAULT_RANDOM_ALGORITHM_PROVIDER

Default random algorithm provider.

DEFAULT_SEED_LENGTH

public static final int DEFAULT_SEED_LENGTH

Default seed length 32.

See Also:

• Constant Field Values

Constructor Details

AutoReseedRandom

public AutoReseedRandom()

AutoReseedRandom

public AutoReseedRandom(String algorithm,
 String algorithmProvider,
 int seedLength,
 long reseedingPeriod)

Parameters:

algorithm - See SecureRandom.getInstance(String, String).

algorithmProvider - See SecureRandom.getInstance(String, String). In most cases you will want to use DEFAULT_RANDOM_ALGORITHM_PROVIDER which will lead to using SecureRandom.getInstance(String) instead of SecureRandom.getInstance(String, String). You may want to consider using "NativePRNG", "SUN" or other providers if you have special requirements.

seedLength - number of Bytes, see SecureRandom.generateSeed(int).

reseedingPeriod - Time in milliseconds after which the delegate gets reseeded by resetRandom()

Method Details

run

public void run()

Called from the reseeding Thread.

Specified by:

run in interface Runnable

See Also:

• checkReseed()
• Runnable.run()

getAlgorithm

public String getAlgorithm()

Overrides:

getAlgorithm in class SecureRandom

setSeed

public void setSeed(byte[] seed)

Overrides:

setSeed in class SecureRandom

setSeed

public void setSeed(long seed)

Overrides:

setSeed in class SecureRandom

nextBytes

public void nextBytes(byte[] bytes)

Specified by:

nextBytes in interface RandomGenerator

Overrides:

nextBytes in class SecureRandom

generateSeed

public byte[] generateSeed(int numBytes)

Overrides:

generateSeed in class SecureRandom

nextInt

public int nextInt()

Specified by:

nextInt in interface RandomGenerator

Overrides:

nextInt in class Random

nextInt

public int nextInt(int n)

Specified by:

nextInt in interface RandomGenerator

Overrides:

nextInt in class Random

nextLong

public long nextLong()

Specified by:

nextLong in interface RandomGenerator

Overrides:

nextLong in class Random

nextBoolean

public boolean nextBoolean()

Specified by:

nextBoolean in interface RandomGenerator

Overrides:

nextBoolean in class Random

nextFloat

public float nextFloat()

Specified by:

nextFloat in interface RandomGenerator

Overrides:

nextFloat in class Random

nextDouble

public double nextDouble()

Specified by:

nextDouble in interface RandomGenerator

Overrides:

nextDouble in class Random

nextGaussian

public double nextGaussian()

Specified by:

nextGaussian in interface RandomGenerator

Overrides:

nextGaussian in class Random