java.security
クラス AlgorithmParameters

java.lang.Object
  java.security.AlgorithmParameters

public class AlgorithmParameters
extends Object

暗号化パラメータの不透明な表示として使用します。

特定のアルゴリズムのパラメータを管理するための AlgorithmParameters オブジェクトを取得するには、getInstance ファクトリメソッド (指定されたクラスのインスタンスを返す static メソッド) のどれかを呼び出します。

そのような実装を要求するには、2 つの方法があります。1 つはアルゴリズム名のみを指定する方法で、もう 1 つはアルゴリズム名とパッケージプロバイダの両方を指定する方法です。

• アルゴリズム名のみを指定すると、システムは、要求されたアルゴリズムの AlgorithmParameters 実装がその環境にあるかどうか、また複数の実装がある場合は、優先順位の高い実装があるかどうかを調べます。
• アルゴリズム名とパッケージプロバイダの両方を指定すると、システムは、要求されたパッケージに実装があるかどうかを調べ、ない場合は例外をスローします。

AlgorithmParameters オブジェクトが返されたら、適切なパラメータ仕様またはパラメータの符号化により、init を呼び出すことで初期化する必要があります。

透明なパラメータ仕様を AlgorithmParameters オブジェクトから取得するには、getParameterSpec を呼び出します。パラメータのバイト符号化を行うには、getEncoded を呼び出します。

導入されたバージョン:

1.2

関連項目:

AlgorithmParameterSpec, DSAParameterSpec, KeyPairGenerator

コンストラクタの概要

protected

AlgorithmParameters(AlgorithmParametersSpi paramSpi, Provider provider, String algorithm) AlgorithmParameters オブジェクトを作成します。

メソッドの概要

String	getAlgorithm() このパラメータオブジェクトに関連したアルゴリズムの名前を返します。
byte[]	getEncoded() 一次符号化形式でパラメータを返します。
byte[]	getEncoded(String format) 指定された方式で符号化されたパラメータを返します。
static AlgorithmParameters	getInstance(String algorithm) 指定されたアルゴリズムのパラメータオブジェクトを生成します。
static AlgorithmParameters	getInstance(String algorithm, Provider provider) 指定されたプロバイダから指定されたアルゴリズムを取得できる場合に、そのプロバイダが提供するアルゴリズムのパラメータオブジェクトを生成します。
static AlgorithmParameters	getInstance(String algorithm, String provider) 指定されたプロバイダから指定されたアルゴリズムを取得できる場合に、そのプロバイダが提供するアルゴリズムのパラメータオブジェクトを生成します。
AlgorithmParameterSpec	getParameterSpec(Class paramSpec) パラメータオブジェクトの透明な仕様を返します。
Provider	getProvider() パラメータオブジェクトのプロバイダを返します。
void	init(AlgorithmParameterSpec paramSpec) paramSpec に指定されたパラメータで、パラメータオブジェクトを初期化します。
void	init(byte[] params) 指定されたパラメータをインポートし、パラメータの一次復号化形式に従って復号化します。
void	init(byte[] params, String format) params からパラメータをインポートし、指定された復号化方式に従って復号化します。
String	toString() パラメータを説明する書式付き文字列を返します。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

AlgorithmParameters

protected AlgorithmParameters(AlgorithmParametersSpi paramSpi,
                              Provider provider,
                              String algorithm)

AlgorithmParameters オブジェクトを作成します。

パラメータ:

paramSpi - 委譲先

provider - プロバイダ

algorithm - アルゴリズム

メソッドの詳細

getAlgorithm

public final String getAlgorithm()

このパラメータオブジェクトに関連したアルゴリズムの名前を返します。

戻り値:

アルゴリズム名

getInstance

public static AlgorithmParameters getInstance(String algorithm)
                                       throws NoSuchAlgorithmException

指定されたアルゴリズムのパラメータオブジェクトを生成します。

要求されたアルゴリズムの実装をデフォルトのプロバイダパッケージが提供している場合は、その実装を含む AlgorithmParameters のインスタンスが返されます。指定されたアルゴリズムがデフォルトのパッケージにない場合は、ほかのパッケージが検索されます。

返されたパラメータオブジェクトは、適切なパラメータ仕様またはパラメータの符号化により、init を呼び出すことで初期化する必要があります。

パラメータ:

algorithm - 要求するアルゴリズムの名前

戻り値:

新しいパラメータオブジェクト

例外:

NoSuchAlgorithmException - アルゴリズムがその環境で使用できない場合

getInstance

public static AlgorithmParameters getInstance(String algorithm,
                                              String provider)
                                       throws NoSuchAlgorithmException,
                                              NoSuchProviderException

指定されたプロバイダから指定されたアルゴリズムを取得できる場合に、そのプロバイダが提供するアルゴリズムのパラメータオブジェクトを生成します。

返されたパラメータオブジェクトは、適切なパラメータ仕様またはパラメータの符号化により、init を呼び出すことで初期化する必要があります。

パラメータ:

algorithm - 要求するアルゴリズムの名前

provider - プロバイダ名

戻り値:

新しいパラメータオブジェクト

例外:

NoSuchAlgorithmException - 要求されたプロバイダが提供するパッケージではアルゴリズムを使用できない場合

NoSuchProviderException - プロバイダがその環境で使用できない場合

IllegalArgumentException - プロバイダ名が null または空の場合

関連項目:

Provider

getInstance

public static AlgorithmParameters getInstance(String algorithm,
                                              Provider provider)
                                       throws NoSuchAlgorithmException

指定されたプロバイダから指定されたアルゴリズムを取得できる場合に、そのプロバイダが提供するアルゴリズムのパラメータオブジェクトを生成します。注:provider を登録する必要はありません。

返されたパラメータオブジェクトは、適切なパラメータ仕様またはパラメータの符号化により、init を呼び出すことで初期化する必要があります。

パラメータ:

algorithm - 要求するアルゴリズムの名前

provider - プロバイダ名

戻り値:

新しいパラメータオブジェクト

例外:

NoSuchAlgorithmException - 要求されたプロバイダが提供するパッケージではアルゴリズムを使用できない場合

IllegalArgumentException - provider が null の場合

導入されたバージョン:

1.4

関連項目:

Provider

getProvider

public final Provider getProvider()

パラメータオブジェクトのプロバイダを返します。

戻り値:

このパラメータオブジェクトのプロバイダ

init

public final void init(AlgorithmParameterSpec paramSpec)
                throws InvalidParameterSpecException

paramSpec に指定されたパラメータで、パラメータオブジェクトを初期化します。

パラメータ:

paramSpec - パラメータ仕様

例外:

InvalidParameterSpecException - 指定されたパラメータ仕様がこのパラメータオブジェクトの初期化に不適切な場合、またはこのパラメータオブジェクトがすでに初期化されている場合

init

public final void init(byte[] params)
                throws IOException

指定されたパラメータをインポートし、パラメータの一次復号化形式に従って復号化します。これらのパラメータの ASN.1 仕様がある場合には、パラメータの一次復号化形式は ASN.1 です。

パラメータ:

params - 符号化されたパラメータ

例外:

IOException - 復号化エラーが発生した場合、またはこのパラメータオブジェクトがすでに初期化されている場合

init

public final void init(byte[] params,
                       String format)
                throws IOException

params からパラメータをインポートし、指定された復号化方式に従って復号化します。format が null の場合には、パラメータの一次復号化形式が使用されます。これらのパラメータの ASN.1 仕様がある場合には、一次復号化形式は ASN.1 です。

パラメータ:

params - 符号化されたパラメータ

format - 復号化方式の名前

例外:

IOException - 復号化エラーが発生した場合、またはこのパラメータオブジェクトがすでに初期化されている場合

getParameterSpec

public final AlgorithmParameterSpec getParameterSpec(Class paramSpec)
                                              throws InvalidParameterSpecException

パラメータオブジェクトの透明な仕様を返します。 paramSpec は、パラメータが返される仕様クラスを識別します。たとえば、DSAParameterSpec.class の場合には、パラメータが DSAParameterSpec クラスのインスタンスに返されることを示します。

パラメータ:

paramSpec - パラメータが返される仕様クラス

戻り値:

パラメータ仕様

例外:

InvalidParameterSpecException - 要求されたパラメータ仕様がこのパラメータオブジェクトに不適切な場合、またはこのパラメータオブジェクトが初期化されていない場合

getEncoded

public final byte[] getEncoded()
                        throws IOException

一次符号化形式でパラメータを返します。この種のパラメータの ASN.1 仕様が存在する場合は、プライマリ復号化形式は、ASN.1 です。

戻り値:

パラメータの一次符号化方式で符号化されたパラメータ

例外:

IOException - 符号化エラーが発生した場合、またはこのパラメータオブジェクトが初期化されていない場合

getEncoded

public final byte[] getEncoded(String format)
                        throws IOException

指定された方式で符号化されたパラメータを返します。format が null の場合には、パラメータの一次符号化形式が使用されます。これらのパラメータの ASN.1 仕様がある場合には、一次符号化形式は ASN.1 です。

パラメータ:

format - 符号化形式の名前

戻り値:

指定された符号化方式で符号化されたパラメータ

例外:

IOException - 符号化エラーが発生した場合、またはこのパラメータオブジェクトが初期化されていない場合

toString

public final String toString()

パラメータを説明する書式付き文字列を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

パラメータを説明する書式付き文字列。このパラメータオブジェクトが初期化されていない場合は null