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) 指定されたプロバイダによって提供される、指定されたアルゴリズムのパラメータオブジェクトを作成します。
<T extends AlgorithmParameterSpec> T	getParameterSpec(Class<T> 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 <T extends AlgorithmParameterSpec> T getParameterSpec(Class<T> 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