Package java.security

Class KeyFactorySpi

  • public abstract class KeyFactorySpi
extends java.lang.Object
    This class defines the Service Provider Interface (SPI) for the KeyFactory class. All the abstract methods in this class must be implemented by each cryptographic service provider who wishes to supply the implementation of a key factory for a particular algorithm.

    Key factories are used to convert keys (opaque cryptographic keys of type Key) into key specifications (transparent representations of the underlying key material), and vice versa.

    Key factories are bi-directional. That is, they allow you to build an opaque key object from a given key specification (key material), or to retrieve the underlying key material of a key object in a suitable format.

    Multiple compatible key specifications may exist for the same key. For example, a DSA public key may be specified using DSAPublicKeySpec or X509EncodedKeySpec. A key factory can be used to translate between compatible key specifications.

    A provider should document all the key specifications supported by its key factory.

    Since:
    1.2
    See Also:
    KeyFactory, Key, PublicKey, PrivateKey, KeySpec, DSAPublicKeySpec, X509EncodedKeySpec

    • Constructor Summary

      Constructors 
      Constructor Description
      KeyFactorySpi()  

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      protected abstract PrivateKey engineGeneratePrivate​(KeySpec keySpec)
      Generates a private key object from the provided key specification (key material).
      protected abstract PublicKey engineGeneratePublic​(KeySpec keySpec)
      Generates a public key object from the provided key specification (key material).

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • KeyFactorySpi

        public KeyFactorySpi()

    • Method Detail

      • engineGeneratePrivate

        protected abstract PrivateKey engineGeneratePrivate​(KeySpec keySpec)
                                             throws InvalidKeySpecException
        Generates a private key object from the provided key specification (key material).
        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.

      • engineGeneratePublic

        protected abstract PublicKey engineGeneratePublic​(KeySpec keySpec)
                                           throws InvalidKeySpecException
        Generates a public key object from the provided key specification (key material).
        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.