モジュール java.base
パッケージ java.security

クラスKeyFactorySpi

java.lang.Object
java.security.KeyFactorySpi
public abstract class KeyFactorySpi extends Object
このクラスは、KeyFactoryクラスのサービス・プロバイダ・インタフェース (SPI)を定義します。 特定アルゴリズムのキー・ファクトリの実装を提供する各暗号サービス・プロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。

キー・ファクトリは、Key型の不透明な暗号キーであるキーと、基本のキー・マテリアルの透明な表現であるキー仕様との間の変換を行うために使用します。

キー・ファクトリには双方向性があります。 つまり、指定したキー仕様(キー・データ)から不透明なキー・オブジェクトを構築することも、適切な形式でキー・オブジェクトの基本のキー・データを取り出すこともできます。

同一のキーに対して、複数の互換性のあるキー仕様が存在することがあります。 たとえばDSA公開キーは、DSAPublicKeySpecまたはX509EncodedKeySpecを使って指定できます。 キー・ファクトリは、互換性のあるキー仕様間の変換に使用できます。

プロバイダは、そのキー・ファクトリがサポートするすべてのキー仕様をドキュメント化する必要があります。

導入されたバージョン:
1.2
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    KeyFactorySpi()
    サブクラスが呼び出すためのコンストラクタ。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    protected abstract PrivateKey
    engineGeneratePrivate(KeySpec keySpec)
    指定されたキー仕様(キー・データ)から非公開キー・オブジェクトを生成します。
    protected abstract PublicKey
    engineGeneratePublic(KeySpec keySpec)
    指定されたキー仕様(キー・データ)から公開キー・オブジェクトを生成します。
    protected abstract <T extends KeySpec>
    T
    engineGetKeySpec(Key key, Class<T> keySpec)
    指定されたキー・オブジェクトの仕様(キー・データ)を返します。
    protected abstract Key
    engineTranslateKey(Key key)
    プロバイダが未知であるか、信頼できない可能性があるキー・オブジェクトを、このキー・ファクトリの対応するキー・オブジェクトに変換します。

    クラスjava.lang.Objectで宣言されたメソッド

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

  • コンストラクタの詳細

    • KeyFactorySpi

      public KeyFactorySpi()
      サブクラスが呼び出すためのコンストラクタ。

  • メソッドの詳細

    • engineGeneratePublic

      protected abstract PublicKey engineGeneratePublic(KeySpec keySpec) throws InvalidKeySpecException
      指定されたキー仕様(キー・データ)から公開キー・オブジェクトを生成します。
      パラメータ:
      keySpec - 公開キーの仕様(キー・データ)。
      戻り値:
      公開キー。
      例外:
      InvalidKeySpecException - 指定されたキー仕様がこのキー・ファクトリによる公開キーの生成に不適切な場合。

    • engineGeneratePrivate

      protected abstract PrivateKey engineGeneratePrivate(KeySpec keySpec) throws InvalidKeySpecException
      指定されたキー仕様(キー・データ)から非公開キー・オブジェクトを生成します。
      パラメータ:
      keySpec - 非公開キーの仕様(キー・データ)。
      戻り値:
      非公開キー。
      例外:
      InvalidKeySpecException - 指定されたキー仕様がこのキー・ファクトリによる非公開キーの生成に不適切な場合。

    • engineGetKeySpec

      protected abstract <T extends KeySpec> T engineGetKeySpec(Key key, Class<T> keySpec) throws InvalidKeySpecException
      指定されたキー・オブジェクトの仕様(キー・データ)を返します。keySpecは、キーのデータが返されるべき仕様クラスを識別します。 たとえば、DSAPublicKeySpec.classは、キーのデータがDSAPublicKeySpecクラスのインスタンスに返されるべきであることを指示します。
      型パラメータ:
      T - 返されるキー仕様の型
      パラメータ:
      key - キー
      keySpec - キー・データが返される仕様クラス。
      戻り値:
      要求される仕様クラスのインスタンスにおける基本のキー仕様(キー・データ)。
      例外:
      InvalidKeySpecException - 要求されるキー仕様が指定されたキーに不適切な場合、または認識されない形式のキーを指定した場合など、指定されたキーを処理できない場合。

    • engineTranslateKey

      protected abstract Key engineTranslateKey(Key key) throws InvalidKeyException
      プロバイダが未知であるか、信頼できない可能性があるキー・オブジェクトを、このキー・ファクトリの対応するキー・オブジェクトに変換します。
      パラメータ:
      key - プロバイダが未知であるか、信頼できないキー。
      戻り値:
      変換したキー。
      例外:
      InvalidKeyException - 指定されたキーをこのキー・ファクトリで処理できない場合。