de.flexiprovider.core.mars
Class MARSKeyFactory

java.lang.Object
  |
  +--javax.crypto.SecretKeyFactorySpi
        |
        +--de.flexiprovider.api.keys.SecretKeyFactory
              |
              +--de.flexiprovider.core.mars.MARSKeyFactory

public class MARSKeyFactory

extends SecretKeyFactory

This class represents a factory for secret keys. This class is used to convert MARS keys into a format usable by the CDC provider. The supported KeySpec class is MARSKeySpec.

This class should not be instantiated directly, instead use the java.security.KeyFactory interface.

Author:

Katja Rauch

See Also:

SecretKeyFactory

Constructor Summary

MARSKeyFactory()

Method Summary

SecretKey	generateSecret(KeySpec keySpec) Generate an MARS key object from the provided key specification.
KeySpec	getKeySpec(SecretKey key, java.lang.Class keySpec) Return a key specification of the given key object in the requested format.
SecretKey	translateKey(SecretKey key) Translate a MARS key object, whose provider may be unknown or potentially untrusted, into a corresponding key object of this key factory.

Methods inherited from class de.flexiprovider.api.keys.SecretKeyFactory

engineGenerateSecret, engineGetKeySpec, engineTranslateKey

Methods inherited from class java.lang.Object

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

Constructor Detail

MARSKeyFactory

public MARSKeyFactory()

Method Detail

generateSecret

public final SecretKey generateSecret(KeySpec keySpec)
                               throws InvalidKeySpecException

Generate an MARS key object from the provided key specification. The key specification has to be an instance of SecretKeySpec of type "MARS".

Overrides:

generateSecret in class SecretKeyFactory

Parameters:

keySpec - the key specification

Returns:

the secret key

Throws:

InvalidKeySpecException - if the key specification is of the wrong type.

getKeySpec

public KeySpec getKeySpec(SecretKey key,
                          java.lang.Class keySpec)
                   throws InvalidKeySpecException

Return a key specification of the given key object in the requested format. The format has to be equal to or a superclass of SecretKeySpec. The key has to be an instance of MARSKey.

Overrides:

getKeySpec in class SecretKeyFactory

Parameters:

key - the key

keySpec - the requested format in which the key material shall be returned

Returns:

the underlying key specification (key material) in the requested format

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).

translateKey

public final SecretKey translateKey(SecretKey key)
                             throws InvalidKeyException

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

Not currently implemented.

Overrides:

translateKey in class SecretKeyFactory

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.