compact1, compact2, compact3

java.security

Class AlgorithmParameters

java.lang.Object

java.security.AlgorithmParameters

public class AlgorithmParameters
extends Object

此类用作加密参数的不透明表示。

可以通过调用getInstance工厂方法（返回给定类的实例的静态方法）来获得用于管理特定算法的AlgorithmParameters对象。

一旦获得了一个AlgorithmParameters对象，它必须通过调用init进行init ，使用适当的参数规范或参数编码。

通过调用getParameterSpec从AlgorithmParameters对象获得getParameterSpec ，并通过调用getEncoded获得参数的字节编码。

Java平台的每个实现都需要支持以下标准的AlgorithmParameters算法：

• AES
• DES
• DESede
• DiffieHellman
• DSA

这些算法的描述AlgorithmParameters section Java加密体系结构标准算法名称的文档。 请参阅发行说明文件以了解是否支持其他算法。

从以下版本开始：

1.2

另请参见：

AlgorithmParameterSpec ， DSAParameterSpec ， KeyPairGenerator

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AlgorithmParameters(AlgorithmParametersSpi paramSpi, Provider provider, String algorithm) 创建一个AlgorithmParameters对象。

方法摘要

Modifier and Type	Method and Description
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(类<T> paramSpec) 返回此参数对象的（透明）规范。
Provider	getProvider() 返回此参数对象的提供者。
void	init(AlgorithmParameterSpec paramSpec) 使用paramSpec中 paramSpec的参数初始化此参数对象。
void	init(byte[] params) 导入指定的参数，并根据参数的主要解码格式进行解码。
void	init(byte[] params, String format) 从 params ，并根据指定的解码方案进行解码。
String	toString() 返回描述参数的格式化字符串。

Methods inherited from class 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中封装AlgorithmParametersSpi实现的新AlgorithmParameters对象。

请注意，可以通过Security.getProviders()方法检索已注册提供商的列表。

返回的参数对象必须通过调用init进行init ，使用适当的参数规范或参数编码。

参数

algorithm - algorithm的名称。 看到的的AlgorithmParameters部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称的信息。

结果

新的参数对象。

异常

NoSuchAlgorithmException - 如果没有提供者支持指定算法的AlgorithmParametersSpi实现。

另请参见：

Provider

getInstance

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

返回指定算法的参数对象。

返回从指定提供程序封装AlgorithmParametersSpi实现的新AlgorithmParameters对象。 指定的提供者必须在安全提供程序列表中注册。

请注意，注册提供商的列表可以通过Security.getProviders()方法检索 。

返回的参数对象必须通过调用init进行init ，使用适当的参数规范或参数编码。

参数

algorithm - algorithm的名称。 看到的的AlgorithmParameters部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称的信息。

provider - 提供者的名称。

结果

新的参数对象。

异常

NoSuchAlgorithmException - 如果指定算法的AlgorithmParametersSpi实现不能从指定的提供程序获得。

NoSuchProviderException - 如果指定的提供程序未在安全提供程序列表中注册。

IllegalArgumentException - 如果提供者名称为空或为空。

另请参见：

Provider

getInstance

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

返回指定算法的参数对象。

返回从指定的Provider对象封装AlgorithmParametersSpi实现的新AlgorithmParameters对象。 请注意，指定的Provider对象不必在提供者列表中注册。

返回的参数对象必须通过调用init进行init ，使用适当的参数规范或参数编码。

参数

algorithm - algorithm的名称。 看到的的AlgorithmParameters部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称的信息。

provider - 提供者的名称。

结果

新的参数对象。

异常

NoSuchAlgorithmException - 如果指定的算法的AlgorithmParameterGeneratorSpi实现从指定的Provider对象中不可用。

IllegalArgumentException - 如果提供者为空。

从以下版本开始：

1.4

另请参见：

Provider

getProvider

public final Provider getProvider()

返回此参数对象的提供者。

结果

该参数对象的提供者

init

public final void init(AlgorithmParameterSpec paramSpec)
                throws InvalidParameterSpecException

使用paramSpec中 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为空，则使用参数的主要解码格式。 主要解码格式为ASN.1，如果存在这些参数的ASN.1规范。

参数

params - 编码参数。

format - 解码方案的名称。

异常

IOException - 解码错误，或者该参数对象是否已被初始化。

getParameterSpec

public final <T extends AlgorithmParameterSpec> T getParameterSpec(类<T> paramSpec)
                                                            throws InvalidParameterSpecException

返回此参数对象的（透明）规范。 paramSpec标识了应该返回参数的规范类。 例如，它可以是DSAParameterSpec.class ，以表明在DSAParameterSpec类的实例中应该返回DSAParameterSpec 。

参数类型

T - 要重新执行的参数规范的类型

参数

paramSpec - 应该返回 paramSpec的规范类。

结果

参数规格。

异常

InvalidParameterSpecException - 如果请求的参数规范不适合此参数对象，或者该参数对象尚未初始化。

getEncoded

public final byte[] getEncoded()
                        throws IOException

返回其主要编码格式的参数。 参数的主要编码格式是ASN.1，如果存在此类参数的ASN.1规范。

结果

使用其主编码格式编码的参数。

异常

IOException - 编码错误，或者该参数对象尚未初始化。

getEncoded

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

返回在指定方案中编码的参数。 如果format为空，则使用参数的主编码格式。 如果存在这些参数的ASN.1规范，则主编码格式为ASN.1。

参数

format - 编码格式的名称

结果

使用指定编码方案编码的参数。

异常

IOException - 对编码错误，或者该参数对象尚未初始化。

toString

public final String toString()

返回描述参数的格式化字符串。

重写：

toString在 Object类

结果

描述参数的格式化字符串，如果此参数对象尚未初始化，则为null。