モジュール java.base

パッケージ java.security

クラスSecureRandomSpi

java.lang.Object

java.security.SecureRandomSpi

すべての実装されたインタフェース:

Serializable

public abstract class SecureRandomSpi extends Object implements Serializable

このクラスは、SecureRandomクラスの「サービス・プロバイダ・インタフェース」 (SPI)を定義します。

このクラス内のすべての抽象メソッドは、暗号用に強化した擬似乱数ジェネレータの実装を供給しようとする各サービス・プロバイダによって実装される必要があります。

実装要件:

実装でSecureRandomSpi(SecureRandomParameters)コンストラクタがオーバーライドされると、SecureRandomがインスタンス化されるたびに常にコールされます。 正確には、オブジェクトがSecureRandomのgetInstanceメソッドwithoutのいずれかでSecureRandomParametersパラメータを使用してインスタンス化される場合、コンストラクタはnull引数を使用してコールされ、実装はengineGetParameters()がコールされるときに使用する独自のSecureRandomParametersパラメータを作成します。 オブジェクトがSecureRandomのgetInstanceメソッドwithのいずれかでSecureRandomParameters引数を使用してインスタンス化されると、その引数を使用してコンストラクタがコールされます。 engineGetParameters()メソッドはnullを返してはなりません。

それ以外の場合は、実装でSecureRandomSpi(SecureRandomParameters)コンストラクタがオーバーライドされない場合、SecureRandomSpi()コンストラクタはオーバーライドする必要があり、オブジェクトがSecureRandomのgetInstanceメソッドwithoutのいずれかでSecureRandomParameters引数でインスタンス化されるとコールされます。 SecureRandomのgetInstanceメソッドの1つをコールすると、SecureRandomParameters引数でこの実装のインスタンスを返しません。 engineGetParameters()メソッドはnullを返す必要があります。

スレッドの安全性の詳細は、SecureRandomを参照してください。 デフォルトでは、SecureRandomSpi実装は複数の同時スレッドで使用しても安全ではないとみなされ、SecureRandomは適用可能な各エンジン・メソッド(メソッドのリストについては、SecureRandomを参照してください。)へのアクセスを同期します。 ただし、SecureRandomSpi実装がスレッド・セーフである場合、登録時に「サービス・プロバイダ属性」 "ThreadSafe"を次のように"true"に設定する必要があります:

 put("SecureRandom.AlgName ThreadSafe", "true");

or

 putService(new Service(this, "SecureRandom", "AlgName", className,
          null, Map.of("ThreadSafe", "true")));

SecureRandomは、同期なしで適用可能なエンジン・メソッドを呼び出します。

導入されたバージョン:

1.2

関連項目:

• 直列化された形式

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

コンストラクタ

修飾子	コンストラクタ	説明
	SecureRandomSpi()	パラメータのないコンストラクタです。
protected	SecureRandomSpi(SecureRandomParameters params)	パラメータを持つコンストラクタです。

メソッドのサマリー

修飾子と型	メソッド	説明
protected abstract byte[]	engineGenerateSeed(int numBytes)	指定されたバイト数のシード・バイト数を返します。
protected SecureRandomParameters	engineGetParameters()	このSecureRandomインスタンスの有効なSecureRandomParametersを返します。
protected abstract void	engineNextBytes(byte[] bytes)	ユーザーが指定したバイト数の乱数バイト数を生成します。
protected void	engineNextBytes(byte[] bytes, SecureRandomParameters params)	追加パラメータを使用して、ユーザー指定のランダム・バイト数を生成します。
protected void	engineReseed(SecureRandomParameters params)	エントロピ・ソースから読み取られたエントロピ入力で、このランダム・オブジェクトを追加パラメータで再シードします。
protected abstract void	engineSetSeed(byte[] seed)	このランダムなオブジェクトを、指定されたシードに再シードします。
String	toString()	このSecureRandomの人間が読める文字列表現を返します。

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

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

コンストラクタの詳細

SecureRandomSpi

public SecureRandomSpi()

パラメータのないコンストラクタです。

SecureRandomSpi

protected SecureRandomSpi(SecureRandomParameters params)

パラメータを持つコンストラクタです。

パラメータ:

params - SecureRandomParametersオブジェクト。 この引数にはnullを指定できます。

例外:

IllegalArgumentException - このSecureRandomによってparamsが認識できないか、またはサポートされていない場合

導入されたバージョン:

9

メソッドの詳細

engineSetSeed

protected abstract void engineSetSeed(byte[] seed)

このランダムなオブジェクトを、指定されたシードに再シードします。 シードは、既存のシードを置き換えるのではなく、補足します。 これにより、呼出しを繰り返しても、ランダム性が減少しないことが保証されます。

パラメータ:

seed - シード。

engineNextBytes

protected abstract void engineNextBytes(byte[] bytes)

ユーザーが指定したバイト数の乱数バイト数を生成します。

一部の乱数ジェネレータでは、呼出しごとに限られた量のランダム・バイトしか生成できません。 bytesのサイズがこの制限より大きい場合、実装では、このメソッドから戻す前に、その生成プロセスを複数回起動してバッファを完全に埋める必要があります。

パラメータ:

bytes - 乱数バイトを充填する配列。

engineNextBytes

protected void engineNextBytes(byte[] bytes, SecureRandomParameters params)

追加パラメータを使用して、ユーザー指定のランダム・バイト数を生成します。

一部の乱数ジェネレータでは、呼出しごとに限られた量のランダム・バイトしか生成できません。 bytesのサイズがこの制限より大きい場合、実装では、このメソッドから戻す前に、その生成プロセスを複数回起動してバッファを完全に埋める必要があります。

実装要件:

デフォルトの実装では、UnsupportedOperationExceptionがスローされます。

パラメータ:

bytes - 乱数バイトを充填する配列

params - 追加パラメータ

例外:

UnsupportedOperationException - 実装がこのメソッドをオーバーライドしていない場合

IllegalArgumentException - paramsがnullの場合、このSecureRandomによって不正またはサポートされていない

導入されたバージョン:

9

engineGenerateSeed

protected abstract byte[] engineGenerateSeed(int numBytes)

指定されたバイト数のシード・バイト数を返します。 この呼出しを使うと、ほかの乱数ジェネレータをシードできます。

パラメータ:

numBytes - 生成するシード・バイト数。

戻り値:

シード・バイト。

engineReseed

protected void engineReseed(SecureRandomParameters params)

エントロピ・ソースから読み取られたエントロピ入力で、このランダム・オブジェクトを追加パラメータで再シードします。

このメソッドがSecureRandom.reseed()によって呼び出された場合、paramsはnullになります。

実装がリ・シードをサポートしていない場合は、このメソッドをオーバーライドしないでください。

実装要件:

デフォルトの実装では、UnsupportedOperationExceptionがスローされます。

パラメータ:

params - 追加パラメータには、nullを指定できます。

例外:

UnsupportedOperationException - 実装がこのメソッドをオーバーライドしていない場合

IllegalArgumentException - このSecureRandomによってparamsが不正またはサポートされていない場合

導入されたバージョン:

9

engineGetParameters

protected SecureRandomParameters engineGetParameters()

このSecureRandomインスタンスの有効なSecureRandomParametersを返します。

実装要件:

デフォルトの実装ではnullを返します。

戻り値:

有効なSecureRandomParametersパラメータ、またはパラメータが使用されていない場合はnull。

導入されたバージョン:

9

toString

public String toString()

このSecureRandomの人間が読める文字列表現を返します。

オーバーライド:

toString、クラスObject

戻り値:

文字列表現