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

クラスKeyPairGeneratorSpi

  • 直系の既知のサブクラス:
    KeyPairGenerator

    public abstract class KeyPairGeneratorSpi
    extends Object

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

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

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

    導入されたバージョン:
    1.2
    関連項目:
    KeyPairGenerator, AlgorithmParameterSpec
    • コンストラクタの詳細

      • 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