de.cscc.crypto.provider
Class RSAKeyFactoryEngine

java.lang.Object
  java.security.KeyFactorySpi
      de.cscc.crypto.provider.RSAKeyFactoryEngine

public final class RSAKeyFactoryEngine

extends KeyFactorySpi

RSAKeyFactoryEngine Class.

Version:

$Revision: 1.8 $

Author:

Uwe Günther

Constructor Summary

RSAKeyFactoryEngine()
Creates new RSAKeyFactoryEngine

Method Summary

PrivateKey	engineGeneratePrivate(KeySpec keySpec) Generates a private key object from the provided key specification (key material).
PublicKey	engineGeneratePublic(KeySpec keySpec) Generates a public key object from the provided key specification (key material).
KeySpec	engineGetKeySpec(Key key, Class keySpec) Returns a specification (key material) of the given key object.
Key	engineTranslateKey(Key key) Translates a key object, whose provider may be unknown or potentially untrusted, into a corresponding key object of this key factory.
String	toString() Returns a string representation of the object.

Methods inherited from class java.lang.Object

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

Constructor Detail

RSAKeyFactoryEngine

public RSAKeyFactoryEngine()

Creates new RSAKeyFactoryEngine

Method Detail

toString

public String toString()

Returns a string representation of the object.

Returns:

a string representation of the object.

engineGeneratePrivate

public PrivateKey engineGeneratePrivate(KeySpec keySpec)
                                 throws InvalidKeySpecException

Generates a private key object from the provided key specification (key material).

The following KeySpecs will produce the following instances of its matching keys:

• RSAPrivateCrtKeySpec produces:
  • a instance of RSAPrivateCrtKey
• RSAPrivateKeySpec produces:
  • a instance of RSAPrivateKey

Parameters:

keySpec - the specification (key material) of the private key.

Returns:

the private key.

Throws:

InvalidKeySpecException - if the given key specification is inappropriate for this key factory to produce a private key.

NullPointerException - If keySpec or one of the key data in keySpec is null. So you have to construct a valid keySpec without null fields.

See Also:

BigInteger

engineGeneratePublic

public PublicKey engineGeneratePublic(KeySpec keySpec)
                               throws InvalidKeySpecException

Generates a public key object from the provided key specification (key material).

The following KeySpecs will produce the following instances of its matching keys:

• RSAPublicKeySpec produces:
  • a instance of RSAPublicKey

Parameters:

keySpec - the specification (key material) of the public key.

Returns:

the public key.

Throws:

InvalidKeySpecException - if the given key specification is inappropriate for this key factory to produce a public key.

NullPointerException - If keySpec or one of the key data in keySpec is null. So you have to construct a valid keySpec without null fields.

IllegalArgumentException - if any key material from keySpec is negative.

engineGetKeySpec

public KeySpec engineGetKeySpec(Key key,
                                Class keySpec)
                         throws InvalidKeySpecException

Returns a specification (key material) of the given key object. keySpec identifies the specification class in which the key material should be returned. It could, for example, be RSAPublicKeySpec.class, to indicate that the key material should be returned in an instance of the RSAPublicKeySpec class.

The following conversions are valid for this provider:

• RSAPrivateCrtKey:
  • to RSAPrivateCrtKeySpec
  • to RSAPrivateKeySpec
  • to RSAPublicKeySpec
• RSAPrivateKey:
  • to RSAPrivateKeySpec
• RSAPublicKey:
  • to RSAPublicKeySpec

Parameters:

key - the key.

keySpec - the specification class in which the key material should be returned.

Returns:

the underlying key specification (key material) in an instance of the requested specification class.

Throws:

InvalidKeySpecException - if the requested key specification is inappropriate for the given key, or the given key cannot be dealt with (e.g., the given key has an unrecognized format).

NullPointerException - If one of the params or one of the needed key data in the key is null. So you have to produce a valid key without null fields with your KeyPairGenerator. This should not be a problem with keys from this provider, but maybe with keys from other providers.

IllegalArgumentException - if any key material in the key key is negative. This should not be a problem with keys from this provider, but maybe with keys from other providers.

engineTranslateKey

public Key engineTranslateKey(Key key)
                       throws InvalidKeyException

Translates a key object, whose provider may be unknown or potentially untrusted, into a corresponding key object of this key factory.

The following translations are valid for this provider:

• RSAPrivateCrtKey:
  • to RSAPrivateCrtKey
• RSAPrivateKey:
  • to RSAPrivateKey
• RSAPublicKey:
  • to RSAPublicKey

Parameters:

key - the key whose provider is unknown or untrusted.

Returns:

the translated key.

Throws:

InvalidKeyException - if the given key cannot be processed by this key factory.

NullPointerException - If the key it self or one of the key data in the key is null. So you have to produce a valid key without null fields with your KeyPairGenerator. This should not be a problem with this provider, but maybe with other providers.

IllegalArgumentException - if any key material in the key key is negative. This should not be a problem with keys from this provider, but maybe with keys from other providers.