compact1, compact2, compact3

java.security

クラスAlgorithmParameters

java.lang.Object

java.security.AlgorithmParameters

public class AlgorithmParameters
extends Object

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

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

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

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

Javaプラットフォームの実装は、すべて次の標準のAlgorithmParametersアルゴリズムをサポートする必要があります。

• AES
• DES
• DESede
• DiffieHellman
• DSA

これらのアルゴリズムについては、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのAlgorithmParametersのセクションで説明されています。サポートされているその他のアルゴリズムについては、実装のリリース・ドキュメントを参照してください。

導入されたバージョン:

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

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

このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。指定されたアルゴリズムをサポートする最初のProviderのAlgorithmParametersSpi実装をカプセル化する新しいAlgorithmParametersオブジェクトが返されます。

登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。

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

パラメータ:

algorithm - 要求するアルゴリズムの名前。アルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのAlgorithmParametersのセクションを参照。

戻り値:

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

例外:

NoSuchAlgorithmException - 指定したアルゴリズムのAlgorithmParametersSpi実装をサポートするプロバイダが存在しない場合。

関連項目:

Provider

getInstance

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

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

指定されたプロバイダのAlgorithmParametersSpi実装をカプセル化する新しいAlgorithmParametersオブジェクトが返されます。指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。

登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。

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

パラメータ:

algorithm - 要求するアルゴリズムの名前。アルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのAlgorithmParametersのセクションを参照。

provider - プロバイダ名。

戻り値:

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

例外:

NoSuchAlgorithmException - 指定されたプロバイダに指定されたアルゴリズムのAlgorithmParametersSpi実装がない場合。

NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合。

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

関連項目:

Provider

getInstance

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

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

指定されたProviderオブジェクトのAlgorithmParametersSpi実装をカプセル化する新しいAlgorithmParametersオブジェクトが返されます。指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。

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

パラメータ:

algorithm - 要求するアルゴリズムの名前。アルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのAlgorithmParametersのセクションを参照。

provider - プロバイダ名。

戻り値:

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

例外:

NoSuchAlgorithmException - 指定されたProviderオブジェクトに指定されたアルゴリズムのAlgorithmParameterGeneratorSpi実装がない場合。

IllegalArgumentException - プロバイダが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クラスのインスタンスに返されることを示します。

型パラメータ:

T - 返されるパラメータ仕様の型

パラメータ:

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()

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

オーバーライド:

toString、クラス: Object

戻り値:

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