JavaTM 2 Platform
Std. Ed. v1.3

java.security
クラス AlgorithmParameterGenerator

java.lang.Object
  |
  +--java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object

AlgorithmParameterGenerator クラスは、特定のアルゴリズムで使われるパラメータのセットを生成するために使用されます。パラメータジェネレータは、getInstance ファクトリメソッド (指定したクラスのインスタンスを返す static メソッド) を使って構築されます。

パラメータを生成するオブジェクトは、アルゴリズム独立型、またはアルゴリズム特定型の方法の 2 通りの方法で初期化できます。

クライアントが init メソッドの呼び出しで、明示的に AlgorithmParameterGenerator を初期化しない場合には、各プロバイダはデフォルトによる初期化を提供し、ドキュメント化する必要があります。たとえば Sun のプロバイダは、1,024 ビットのモジュラスプライムサイズをデフォルトとして、DSA パラメータを生成します。

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

コンストラクタの概要
protected AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi paramGenSpi, Provider provider, String algorithm)
          AlgorithmParameterGenerator オブジェクトを作成します。
 
メソッドの概要
 AlgorithmParameters generateParameters()
          パラメータを生成します。
 String getAlgorithm()
          パラメータジェネレータに関連したアルゴリズムの標準名を返します。
static AlgorithmParameterGenerator getInstance(String algorithm)
          指定されたダイジェストアルゴリズムを実装する AlgorithmParameterGenerator オブジェクトを作成します。
static AlgorithmParameterGenerator getInstance(String algorithm, String provider)
          指定されたプロバイダから提供される、要求したアルゴリズムの AlgorithmParameterGenerator オブジェクトを作成します。
 Provider getProvider()
          アルゴリズムパラメータジェネレータオブジェクトのプロバイダを返します。
 void init(AlgorithmParameterSpec genParamSpec)
          アルゴリズム特定型のパラメータ生成値のセットで、パラメータジェネレータを初期化します。
 void init(AlgorithmParameterSpec genParamSpec, SecureRandom random)
          アルゴリズム特定型のパラメータ生成値のセットで、パラメータジェネレータを初期化します。
 void init(int size)
          特定のサイズに対して、パラメータジェネレータを初期化します。
 void init(int size, SecureRandom random)
          特定のサイズと乱数の発生源に対して、パラメータジェネレータを初期化します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

AlgorithmParameterGenerator

protected AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi paramGenSpi,
                                      Provider provider,
                                      String algorithm)
AlgorithmParameterGenerator オブジェクトを作成します。
パラメータ:
paramGenSpi - 委譲先
provider - プロバイダ
algorithm - アルゴリズム
メソッドの詳細

getAlgorithm

public final String getAlgorithm()
パラメータジェネレータに関連したアルゴリズムの標準名を返します。
戻り値:
アルゴリズムの文字列名

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm)
                                               throws NoSuchAlgorithmException
指定されたダイジェストアルゴリズムを実装する AlgorithmParameterGenerator オブジェクトを作成します。要求されるダイジェストアルゴリズムの実装をデフォルトのプロバイダパッケージが提供する場合は、その実装を含む AlgorithmParameterGenerator のインスタンスが返されます。デフォルトパッケージで目的のアルゴリズムが提供されていない場合には、他のパッケージが検索されます。
パラメータ:
algorithm - このパラメータジェネレータに関連したアルゴリズムの文字列名
戻り値:
新しい AlgorithmParameterGenerator オブジェクト
例外:
NoSuchAlgorithmException - アルゴリズムがその環境で使用できない場合

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm,
                                                      String provider)
                                               throws NoSuchAlgorithmException,
                                                      NoSuchProviderException
指定されたプロバイダから提供される、要求したアルゴリズムの AlgorithmParameterGenerator オブジェクトを作成します。ただし、そのようなパラメータジェネレータがプロバイダから使用可能な場合に限ります。
パラメータ:
algorithm - アルゴリズムの文字列名
provider - プロバイダ名の文字列
戻り値:
新しい AlgorithmParameterGenerator オブジェクト
例外:
NoSuchAlgorithmException - 指定されたプロバイダにアルゴリズムがない場合
NoSuchProviderException - プロバイダがその環境で使用できない場合
関連項目:
Provider

getProvider

public final Provider getProvider()
アルゴリズムパラメータジェネレータオブジェクトのプロバイダを返します。
戻り値:
このアルゴリズムパラメータジェネレータオブジェクトのプロバイダ

init

public final void init(int size)
特定のサイズに対して、パラメータジェネレータを初期化します。パラメータを生成する際には、インストールされているプロバイダの内、もっとも優先順位の高いプロバイダの SecureRandom の実装が、乱数の発生源として使用されます。SecureRandom の実装を提供するプロバイダがインストールされていない場合は、システムが提供する乱数の発生源が使用されます。
パラメータ:
size - サイズ (ビット数)

init

public final void init(int size,
                       SecureRandom random)
特定のサイズと乱数の発生源に対して、パラメータジェネレータを初期化します。
パラメータ:
size - サイズ (ビット数)
random - 乱数の発生源

init

public final void init(AlgorithmParameterSpec genParamSpec)
                throws InvalidAlgorithmParameterException
アルゴリズム特定型のパラメータ生成値のセットで、パラメータジェネレータを初期化します。パラメータを生成する際には、インストールされているプロバイダの内、もっとも優先順位の高いプロバイダの SecureRandom の実装が、乱数の発生源として使用されます。SecureRandom の実装を提供するプロバイダがインストールされていない場合は、システムが提供する乱数の発生源が使用されます。
パラメータ:
genParamSpec - アルゴリズム特定型のパラメータ生成値のセット
例外:
InvalidAlgorithmParameterException - 指定されたパラメータ生成値がパラメータジェネレータに不適切な場合

init

public final void init(AlgorithmParameterSpec genParamSpec,
                       SecureRandom random)
                throws InvalidAlgorithmParameterException
アルゴリズム特定型のパラメータ生成値のセットで、パラメータジェネレータを初期化します。
パラメータ:
genParamSpec - アルゴリズム特定型のパラメータ生成値のセット
random - 乱数の発生源
例外:
InvalidAlgorithmParameterException - 指定されたパラメータ生成値がパラメータジェネレータに不適切な場合

generateParameters

public final AlgorithmParameters generateParameters()
パラメータを生成します。
戻り値:
新しい AlgorithmParameters オブジェクト

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.