モジュール 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