net.sf.mmm.crypto.asymmetric.key

Class AbstractAsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

java.lang.Object

net.sf.mmm.crypto.algorithm.AbstractSecurityAlgorithm

net.sf.mmm.crypto.algorithm.AbstractCryptoAlgorithmWithProvider

net.sf.mmm.crypto.algorithm.CryptoAlgorithmImpl

net.sf.mmm.crypto.algorithm.CryptoAlgorithmImplWithRandom

net.sf.mmm.crypto.asymmetric.key.AbstractAsymmetricKeyCreator<PR,PU,PAIR>

Type Parameters:

PR - type of wrapped PrivateKey.

PU - type of wrapped PublicKey.

PAIR - type of AsymmetricKeyPair.

All Implemented Interfaces:

CryptoAlgorithm, AsymmetricKeyCreator<PR,PU,PAIR>, AsymmetricKeyPairFactory<PR,PU,PAIR>, AsymmetricKeyPairFactorySimple<PR,PU,PAIR>, PrivateKeyFactory<PR>, PublicKeyFactory<PU>, KeyCreator

Direct Known Subclasses:

AsymmetricKeyCreatorImpl, AsymmetricKeyCreatorRsa

public abstract class AbstractAsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>
extends CryptoAlgorithmImplWithRandom
implements AsymmetricKeyCreator<PR,PU,PAIR>

Abstract base implementation of KeyCreator.

Since:

1.0.0

Field Summary

Fields

Modifier and Type	Field and Description
private Map<String,AsymmetricKeyPairFactory<PR,PU,PAIR>>	format2factoryMap
private List<String>	formatOrderList
private int	keyLength

Fields inherited from class net.sf.mmm.crypto.algorithm.AbstractCryptoAlgorithmWithProvider

provider

Constructor Summary

Constructors

Constructor and Description
AbstractAsymmetricKeyCreator(KeyFactory keyFactory, int keyLength, SecurityProvider provider, RandomFactory randomFactory) The constructor.

Method Summary

Modifier and Type	Method and Description
byte[]	asData(PAIR keyPair, String format)
byte[]	asData(PR privateKey, String format)
byte[]	asData(PU publicKey, String format)
PAIR	createKeyPair(byte[] data, String format)
PR	createPrivateKey(byte[] data, String format)
PU	createPublicKey(byte[] data, String format)
PAIR	generateKeyPair()
private List<String>	getFormatOrderList()
int	getKeyLength()
private AsymmetricKeyPairFactory<PR,PU,PAIR>	getKeyPairFactory(String format)
protected void	init(KeyPairGenerator keyPairGenerator)
protected void	register(AsymmetricKeyPairFactory<PR,PU,PAIR> factory) Please register in proper order of trials for auto-detection.
protected void	register(AsymmetricKeyPairFactory<PR,PU,PAIR> factory, String format) Please register in proper order of trials for auto-detection.

Methods inherited from class net.sf.mmm.crypto.algorithm.CryptoAlgorithmImplWithRandom

createSecureRandom, getRandomFactory

Methods inherited from class net.sf.mmm.crypto.algorithm.CryptoAlgorithmImpl

getAlgorithm

Methods inherited from class net.sf.mmm.crypto.algorithm.AbstractCryptoAlgorithmWithProvider

getProvider

Methods inherited from class net.sf.mmm.crypto.algorithm.AbstractSecurityAlgorithm

creationFailedException, creationFailedException, creationFailedException, creationFailedException, getAlgorithm, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sf.mmm.crypto.asymmetric.key.AsymmetricKeyCreator

asBinary, asBinary, asBinary, asData, asData, asData, createKeyPair, createPrivateKey, createPublicKey, getKeyLength, getKeyLength, verifyKey, verifyKey

Methods inherited from interface net.sf.mmm.crypto.algorithm.CryptoAlgorithm

getAlgorithm

Methods inherited from interface net.sf.mmm.crypto.asymmetric.key.AsymmetricKeyPairFactory

asBinary

Methods inherited from interface net.sf.mmm.crypto.asymmetric.key.PrivateKeyFactory

asBinary

Methods inherited from interface net.sf.mmm.crypto.asymmetric.key.PublicKeyFactory

asBinary

Methods inherited from interface net.sf.mmm.crypto.asymmetric.key.AsymmetricKeyPairFactorySimple

createKeyPair

Field Detail

format2factoryMap

private final Map<String,AsymmetricKeyPairFactory<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>> format2factoryMap

formatOrderList

private final List<String> formatOrderList

keyLength

private final int keyLength

Constructor Detail

AbstractAsymmetricKeyCreator

public AbstractAsymmetricKeyCreator(KeyFactory keyFactory,
                                    int keyLength,
                                    SecurityProvider provider,
                                    RandomFactory randomFactory)

The constructor.

Parameters:

keyFactory - the KeyFactory.

keyLength - the key length.

provider - the security Provider.

randomFactory - the RandomFactory.

Method Detail

getKeyLength

public int getKeyLength()

Specified by:

getKeyLength in interface KeyCreator

Returns:

the length of the key in bits. The bigger the key length the stronger and more secure the encryption but also the more computation power is required. Reasonable values depend on the algorithm: A recent value for RSA is 4096 bits while for PBKDF2 256 may be sufficient.

register

protected void register(AsymmetricKeyPairFactory<PR,PU,PAIR> factory)

Please register in proper order of trials for auto-detection.

Parameters:

factory - the AsymmetricKeyPairFactory to register.

register

protected void register(AsymmetricKeyPairFactory<PR,PU,PAIR> factory,
                        String format)

Please register in proper order of trials for auto-detection.

Parameters:

factory - the AsymmetricKeyPairFactory to register.

format - the format to register as.

getFormatOrderList

private List<String> getFormatOrderList()

getKeyPairFactory

private AsymmetricKeyPairFactory<PR,PU,PAIR> getKeyPairFactory(String format)

createPrivateKey

public PR createPrivateKey(byte[] data,
                           String format)

Specified by:

createPrivateKey in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Parameters:

data - the PrivateKey as raw byte array.

format - the CryptoBinaryFormat to use.

Returns:

the deserialized PrivateKey.

asData

public byte[] asData(PR privateKey,
                     String format)

Specified by:

asData in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Parameters:

privateKey - the PrivateKey to serialize.

format - the the CryptoBinaryFormat to use.

Returns:

the binary data.

createPublicKey

public PU createPublicKey(byte[] data,
                          String format)

Specified by:

createPublicKey in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Parameters:

data - the PublicKey as raw byte array.

format - the the CryptoBinaryFormat to use.

Returns:

the deserialized PublicKey.

asData

public byte[] asData(PU publicKey,
                     String format)

Specified by:

asData in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Parameters:

publicKey - the PublicKey to serialize.

format - the the CryptoBinaryFormat to use.

Returns:

the binary data.

createKeyPair

public PAIR createKeyPair(byte[] data,
                          String format)

Specified by:

createKeyPair in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Parameters:

data - the AsymmetricKeyPair as raw byte array.

format - the the CryptoBinaryFormat to use.

Returns:

the deserialized AsymmetricKeyPair.

asData

public byte[] asData(PAIR keyPair,
                     String format)

Specified by:

asData in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Parameters:

keyPair - the AsymmetricKeyPair to serialize.

format - the the CryptoBinaryFormat to use.

Returns:

the serialized binary data.

generateKeyPair

public PAIR generateKeyPair()

Specified by:

generateKeyPair in interface AsymmetricKeyCreator<PR extends PrivateKey,PU extends PublicKey,PAIR extends AbstractAsymmetricKeyPair<PR,PU>>

Returns:

a new AsymmetricKeyPair with a generated private and public key for the underlying cryptography.

init

protected void init(KeyPairGenerator keyPairGenerator)
             throws Exception

Parameters:

keyPairGenerator - the KeyPairGenerator to initialize.

Throws:

Exception - on error.