compact1, compact2, compact3

java.security

Class AlgorithmParameters

java.lang.Object

java.security.AlgorithmParameters

public class AlgorithmParameters
extends Object

这个类被用作密码参数的不透明表示。

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

一旦获得AlgorithmParameters对象，它必须被初始化，通过调用init，使用适当的参数规格或参数编码。

一个透明的参数规格是由AlgorithmParameters对象通过调用getParameterSpec，和一个字节的参数编码是通过一个叫getEncoded获得。

java平台的每种实现都要求支持以下标准AlgorithmParameters算法：

• AES
• DES
• DESede
• DiffieHellman
• DSA

这些算法的java加密体系标准算法的名字 AlgorithmParameters section描述文件。请咨询您的实现的发布文档，以查看是否支持任何其他算法。

从以下版本开始：

一点二

另请参见：

AlgorithmParameterSpec， DSAParameterSpec， KeyPairGenerator

构造方法摘要

构造方法

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

方法摘要

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。
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

Constructor Detail

AlgorithmParameters

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

创建一个算法参数对象。

参数

paramSpi -代表

provider -供应商

algorithm -算法

方法详细信息

getAlgorithm

public final String getAlgorithm()

返回与此参数对象关联的算法的名称。

结果

算法名称。

getInstance

public static AlgorithmParameters getInstance(String algorithm)
                                       throws NoSuchAlgorithmException

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

该方法通过注册安全提供商列表，从最开始的首选供应商。一种新的算法参数对象封装algorithmparametersspi实施支持指定算法的第一供应商返回。

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

返回的参数对象必须初始化通过电话init，使用适当的参数规格或参数编码。

参数

algorithm -算法的名字要求。看到算法参数部分在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息。

结果

新参数对象。

异常

NoSuchAlgorithmException -如果没有供应商的支持algorithmparametersspi指定的算法实现。

另请参见：

Provider

getInstance

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

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

一种新的算法参数对象封装algorithmparametersspi实现从指定的提供程序返回。指定的提供程序必须在安全提供程序列表中注册。

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

返回的参数对象必须初始化通过电话init，使用适当的参数规格或参数编码。

参数

algorithm -算法的名字要求。看到算法参数部分在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息。

provider -提供者的名称。

结果

新参数对象。

异常

NoSuchAlgorithmException -如果指定算法的一个algorithmparametersspi执行不可从指定的供应商。

NoSuchProviderException -如果指定的供应商不在安全提供商注册名单。

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

另请参见：

Provider

getInstance

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

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

一种新的算法参数对象封装algorithmparametersspi实现从指定的提供程序对象返回。请注意，指定的提供程序对象不必在提供者列表中注册。

返回的参数对象必须初始化通过电话init，使用适当的参数规格或参数编码。

参数

algorithm -算法的名字要求。看到算法参数部分在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息。

provider -提供者的名称。

结果

新参数对象。

异常

NoSuchAlgorithmException -如果指定算法的一个algorithmparametergeneratorspi实现不可从指定的提供程序对象。

IllegalArgumentException如果供应商是空的。

从以下版本开始：

一点四

另请参见：

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

参数

params -编码参数。

format -解码方案的名称。

异常

IOException -解码错误，或者如果该参数对象已经初始化。

getParameterSpec

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

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

参数类型

T要returrned的参数规格类型

参数

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

结果

如果此参数对象没有初始化的格式化的字符串，则描述该参数的参数或。