モジュール java.base

パッケージ java.security

クラスKeyPairGeneratorSpi

java.lang.Object

java.security.KeyPairGeneratorSpi

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

KeyPairGenerator

public abstract class KeyPairGeneratorSpi extends Object

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

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

クライアントがKeyPairGenerator (initializeメソッドへのコールを介して)を明示的に初期化しない場合、各プロバイダは(とドキュメント)をデフォルトの初期化に指定する必要があります。 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 - keysizeがこのKeyPairGeneratorSpiオブジェクトでサポートされていない場合。

initialize

public void initialize(AlgorithmParameterSpec params, SecureRandom random) throws InvalidAlgorithmParameterException

指定されたパラメータ・セットとユーザーが提供する乱数発生の元を使って、キー・ペア・ジェネレータを初期化します。

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

パラメータ:

params - キーを生成するためのパラメータ・セット。

random - このジェネレータの乱数発生の元。

例外:

InvalidAlgorithmParameterException - 指定されたパラメータがこのキー・ペア・ジェネレータに不適切な場合。

導入されたバージョン:

1.2

generateKeyPair

public abstract KeyPair generateKeyPair()

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

戻り値:

新しく生成されたKeyPair