java.security

Class SecureRandom

java.lang.Object

java.util.Random

java.security.SecureRandom

All Implemented Interfaces:

Serializable

public class SecureRandom
extends Random

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SecureRandom() Constructs a secure random number generator (RNG) implementing the default random number algorithm.
SecureRandom(byte[] seed) Constructs a secure random number generator (RNG) implementing the default random number algorithm.

Method Summary

Modifier and Type	Method and Description
byte[]	generateSeed(int numBytes) Returns the given number of seed bytes, computed using the seed generation algorithm that this class uses to seed itself.
protected int	next(int numBits) Generates an integer containing the user-specified number of pseudo-random bits (right justified, with leading zeros).
void	nextBytes(byte[] bytes) Generates a user-specified number of random bytes.
void	setSeed(byte[] seed) Reseeds this random object.
void	setSeed(long seed) Reseeds this random object, using the eight bytes contained in the given long seed.

Methods inherited from class java.util.Random

nextBoolean, nextDouble, nextFloat, nextGaussian, nextInt, nextInt, nextLong

Methods inherited from class java.lang.Object

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

Constructor Detail

SecureRandom

public SecureRandom()

Constructs a secure random number generator (RNG) implementing the default random number algorithm.

The returned SecureRandom object has not been seeded. To seed the returned object, call the setSeed method. If setSeed is not called, the first call to nextBytes will force the SecureRandom object to seed itself. This self-seeding will not occur if setSeed was previously called.

SecureRandom

public SecureRandom(byte[] seed)

Constructs a secure random number generator (RNG) implementing the default random number algorithm. The SecureRandom instance is seeded with the specified seed bytes.

Parameters:

seed - the seed.

Method Detail

setSeed

public void setSeed(byte[] seed)

Reseeds this random object. The given seed supplements, rather than replaces, the existing seed. Thus, repeated calls are guaranteed never to reduce randomness.

Parameters:

seed - the seed.

setSeed

public void setSeed(long seed)

Reseeds this random object, using the eight bytes contained in the given long seed. The given seed supplements, rather than replaces, the existing seed. Thus, repeated calls are guaranteed never to reduce randomness.

This method is defined for compatibility with java.util.Random.

Overrides:

setSeed in class Random

Parameters:

seed - the seed.

nextBytes

public void nextBytes(byte[] bytes)

Generates a user-specified number of random bytes.

If a call to setSeed had not occurred previously, the first call to this method forces this SecureRandom object to seed itself. This self-seeding will not occur if setSeed was previously called.

Overrides:

nextBytes in class Random

Parameters:

bytes - the array to be filled in with random bytes.

next

protected final int next(int numBits)

Generates an integer containing the user-specified number of pseudo-random bits (right justified, with leading zeros). This method overrides a java.util.Random method, and serves to provide a source of random bits to all of the methods inherited from that class (for example, nextInt, nextLong, and nextFloat).

Overrides:

next in class Random

Parameters:

numBits - number of pseudo-random bits to be generated, where 0 <= numBits <= 32.

Returns:

an int containing the user-specified number of pseudo-random bits (right justified, with leading zeros).

generateSeed

public byte[] generateSeed(int numBytes)

Returns the given number of seed bytes, computed using the seed generation algorithm that this class uses to seed itself. This call may be used to seed other random number generators.

Parameters:

numBytes - the number of seed bytes to generate.

Returns:

the seed bytes.