Package org.apache.commons.crypto.random

Class OsCryptoRandom

java.lang.Object

org.apache.commons.crypto.random.OsCryptoRandom

All Implemented Interfaces:

Closeable, AutoCloseable, CryptoRandom

final class OsCryptoRandom
extends Object
implements CryptoRandom

A Random implementation that uses random bytes sourced from the operating system.

This class is not public/protected so does not appear in the main Javadoc Please ensure that property use is documented in the enum CryptoRandomFactory.RandomProvider

Field Summary

Fields

Modifier and Type	Field	Description
private int	pos
private final byte[]	reservoir
private static final int	RESERVOIR_LENGTH
private FileInputStream	stream

Constructor Summary

Constructors

Constructor	Description
OsCryptoRandom(Properties props)	Constructs a OsCryptoRandom.

Method Summary

Modifier and Type	Method	Description
void	close()	Overrides AutoCloseable.close().
private void	fillReservoir(int min)	Fills the reservoir.
void	nextBytes(byte[] bytes)	Overrides CryptoRandom.nextBytes(byte[]).

Methods inherited from class java.lang.Object

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

Field Details

RESERVOIR_LENGTH

private static final int RESERVOIR_LENGTH

See Also:

• Constant Field Values

stream

private transient FileInputStream stream

reservoir

private final byte[] reservoir

pos

private int pos

Constructor Details

OsCryptoRandom

public OsCryptoRandom(Properties props)

Constructs a OsCryptoRandom.

Parameters:

props - the configuration properties. Uses CryptoRandomFactory.DEVICE_FILE_PATH_KEY to determine the path to the random device, default is CryptoRandomFactory.DEVICE_FILE_PATH_DEFAULT

Method Details

close

public void close()

Overrides AutoCloseable.close(). Closes the OS stream.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

fillReservoir

private void fillReservoir(int min)

Fills the reservoir.

Parameters:

min - the length.

nextBytes

public void nextBytes(byte[] bytes)

Overrides CryptoRandom.nextBytes(byte[]). Generates random bytes and places them into a user-supplied byte array. The number of random bytes produced is equal to the length of the byte array.

Specified by:

nextBytes in interface CryptoRandom

Parameters:

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