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

クラスKeyPairGeneratorSpi

java.lang.Object
java.security.KeyPairGeneratorSpi
直系の既知のサブクラス:
KeyPairGenerator
public abstract class KeyPairGeneratorSpi extends Object

このクラスは、KeyPairGeneratorクラスのサービス・プロバイダ・インタフェース (SPI)を定義します。これは、公開キーと非公開キーのペアを生成するために使用されます。

特定アルゴリズムのキー・ペア・ジェネレータの実装を提供する各暗号サービス・プロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。

クライアントがinitializeメソッドの呼出しで、明示的にKeyPairGeneratorを初期化しない場合には、各プロバイダはデフォルトで初期化を提供しドキュメント化する必要があります。 JDKプロバイダが使用するKeyPairGeneratorのデフォルトについては、「JDKプロバイダ」ドキュメントの「キー・サイズの制限」セクションを参照してください。 ただし、デフォルトはプロバイダごとに異なる場合があります。 また、プロバイダのデフォルト値は、将来のバージョンで変更される可能性があります。 したがって、プロバイダ固有のデフォルトに頼るのではなく、KeyPairGeneratorを明示的に初期化することをお勧めします。

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

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract KeyPair
    generateKeyPair()
    キー・ペアを生成します。
    abstract void
    initialize​(int keysize, SecureRandom random)
    デフォルトのパラメータ・セットを使って、特定のキー・サイズに対してキー・ペア・ジェネレータを初期化します。
    void
    initialize​(AlgorithmParameterSpec params, SecureRandom random)
    指定されたパラメータ・セットとユーザーが提供する乱数発生の元を使って、キー・ペア・ジェネレータを初期化します。

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

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

  • コンストラクタの詳細

    • KeyPairGeneratorSpi

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

  • メソッドの詳細

    • initialize

      public abstract void initialize​(int keysize, SecureRandom random)
      デフォルトのパラメータ・セットを使って、特定のキー・サイズに対してキー・ペア・ジェネレータを初期化します。
      パラメータ:
      keysize - キー・サイズ。 モジュラスの長さのような、ビット長で指定されたアルゴリズムに固有のメトリック。
      random - このジェネレータの乱数発生の元。
      例外:
      InvalidParameterException - このKeyPairGeneratorSpiオブジェクトがkeysizeメソッドをサポートしていない場合。

    • initialize

      public void initialize​(AlgorithmParameterSpec params, SecureRandom random) throws InvalidAlgorithmParameterException
      指定されたパラメータ・セットとユーザーが提供する乱数発生の元を使って、キー・ペア・ジェネレータを初期化します。

      この具象メソッドは、事前に定義されたこの抽象クラスに追加されたものです。 下位互換性のために、抽象メソッドにはできません。 キー・ペア・ジェネレータを初期化するために、プロバイダによってオーバーライドされる場合があります。 そのようなオーバーライドを行うと、パラメータがこのキー・ペア・ジェネレータに不適切な場合に、InvalidAlgorithmParameterExceptionがスローされます。 このメソッドがオーバーライドされない場合は、常にUnsupportedOperationExceptionがスローされます。

      パラメータ:
      params - キーを生成するためのパラメータ・セット。
      random - このジェネレータの乱数発生の元。
      例外:
      InvalidAlgorithmParameterException - 指定されたパラメータがこのキー・ペア・ジェネレータに不適切な場合。
      導入されたバージョン:
      1.2

    • generateKeyPair

      public abstract KeyPair generateKeyPair()
      キー・ペアを生成します。 KeyPairGeneratorインタフェースを使って初期化メソッドを呼び出さない場合は、アルゴリズムに固有のデフォルト設定が使用されます。 これは呼び出されるたびに、新しいキー・ペアを生成します。
      戻り値:
      新しく生成されたKeyPair