org.apache.commons.crypto.random

Class CryptoRandomFactory

java.lang.Object

org.apache.commons.crypto.random.CryptoRandomFactory

public class CryptoRandomFactory
extends Object

Creates CryptoRandom instances

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CryptoRandomFactory.RandomProvider Defines the internal CryptoRandom implementations.

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLASSES_KEY The configuration key of the CryptoRandom implementation class.
static String	DEVICE_FILE_PATH_DEFAULT The default value ("/dev/urandom") of the file path for secure random device.
static String	DEVICE_FILE_PATH_KEY The configuration key of the file path for secure random device.
static String	JAVA_ALGORITHM_DEFAULT The default value ("SHA1PRNG") of the algorithm of secure random.
static String	JAVA_ALGORITHM_KEY The configuration key of the algorithm of secure random.

Method Summary

Modifier and Type	Method and Description
static CryptoRandom	getCryptoRandom() Gets a CryptoRandom instance using the default implementation as defined by CLASSES_DEFAULT
static CryptoRandom	getCryptoRandom(Properties props) Gets a CryptoRandom instance for specified props.

Methods inherited from class java.lang.Object

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

Field Detail

DEVICE_FILE_PATH_KEY

public static final String DEVICE_FILE_PATH_KEY

The configuration key of the file path for secure random device.

See Also:

Constant Field Values

DEVICE_FILE_PATH_DEFAULT

public static final String DEVICE_FILE_PATH_DEFAULT

The default value ("/dev/urandom") of the file path for secure random device.

See Also:

Constant Field Values

JAVA_ALGORITHM_KEY

public static final String JAVA_ALGORITHM_KEY

The configuration key of the algorithm of secure random.

See Also:

Constant Field Values

JAVA_ALGORITHM_DEFAULT

public static final String JAVA_ALGORITHM_DEFAULT

The default value ("SHA1PRNG") of the algorithm of secure random.

See Also:

Constant Field Values

CLASSES_KEY

public static final String CLASSES_KEY

The configuration key of the CryptoRandom implementation class.

The value of the CLASSES_KEY needs to be the full name of a class that implements the CryptoRandom interface The internal classes are listed in the enum RandomProvider which can be used to obtain the full class name.

The value can also be a comma-separated list of class names in order of descending priority.

See Also:

Constant Field Values

Method Detail

getCryptoRandom

public static CryptoRandom getCryptoRandom()
                                    throws GeneralSecurityException

Gets a CryptoRandom instance using the default implementation as defined by CLASSES_DEFAULT

Returns:

CryptoRandom the cryptoRandom object.

Throws:

GeneralSecurityException - if cannot create the CryptoRandom class

getCryptoRandom

public static CryptoRandom getCryptoRandom(Properties props)
                                    throws GeneralSecurityException

Gets a CryptoRandom instance for specified props. Uses the SECURE_RANDOM_CLASSES_KEY from the provided properties. If it is not set, then it checks the System properties. Failing that, it defaults to OpenSslCryptoRandom,JavaCryptoRandom The properties are passed to the generated class.

Parameters:

props - the configuration properties.

Returns:

CryptoRandom the cryptoRandom object.

Throws:

GeneralSecurityException - if cannot create the CryptoRandom class

IllegalArgumentException - if no classname(s) are provided