java.security
类 AlgorithmParameterGenerator

java.lang.Object
  java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object

AlgorithmParameterGenerator 类用于生成要在某个特定算法中使用的参数集合。参数生成器是使用 getInstance 工厂方法（返回给定类的实例的静态方法）构造的。

可以使用以下两种方式初始化将生成参数的对象：与算法无关的方式或特定于算法的方式：

• 使用与算法无关的方法时，所有参数生成器都共享“大小”概念和一个随机源。大小的测量为所有算法参数所普遍共享，尽管不同的算法对它有不同的解释。例如，在使用 DSA 算法的参数的情况下，“大小”对应于质数模数的大小（以位为单位）。使用这一方法时，特定于算法的参数生成值（如果有）默认为某些标准值，除非它们可以从指定大小派生。

• 另外一种方法使用特定于算法的语义初始化参数生成器对象，这些语义由特定于算法的参数生成值集合表示。例如，要生成 Diffie-Hellman 系统参数，参数生成值通常由质数模数的大小和随机指数的大小组成，这两个大小都使用位数指定。

为防止客户端不显式初始化 AlgorithmParameterGenerator（通过调用 init 方法），每个 provider 都必须提供（并记录）一种默认的初始化。例如，Sun provider 使用 1024 位的默认模数主大小生成 DSA 参数。

从以下版本开始：

1.2

另请参见：

AlgorithmParameters, AlgorithmParameterSpec

构造方法摘要

protected

AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi paramGenSpi, Provider provider, String algorithm) 创建一个 AlgorithmParameterGenerator 对象。

方法摘要

AlgorithmParameters	generateParameters() 生成参数。
String	getAlgorithm() 返回与此参数生成器关联的算法的标准名称。
static AlgorithmParameterGenerator	getInstance(String algorithm) 生成实现指定的简要算法的 AlgorithmParameterGenerator 对象。
static AlgorithmParameterGenerator	getInstance(String algorithm, Provider provider) 如果可以从指定的 provider 中得到相关的参数生成器，则为所请求的算法（该 provider 提供）生成一个 AlgorithmParameterGenerator 对象。
static AlgorithmParameterGenerator	getInstance(String algorithm, String provider) 如果可以从指定的 provider 中得到相关的参数生成器，则为所请求的算法（该 provider 提供）生成一个 AlgorithmParameterGenerator 对象。
Provider	getProvider() 返回此算法参数生成器对象的 provider。
void	init(AlgorithmParameterSpec genParamSpec) 利用特定于算法的参数生成值集合初始化此参数生成器。
void	init(AlgorithmParameterSpec genParamSpec, SecureRandom random) 利用特定于算法的参数生成值集合初始化此参数生成器。
void	init(int size) 针对某个特定大小初始化此参数生成器。
void	init(int size, SecureRandom random) 针对某个特定大小和随机源初始化此参数生成器。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

AlgorithmParameterGenerator

protected AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi paramGenSpi,
                                      Provider provider,
                                      String algorithm)

创建一个 AlgorithmParameterGenerator 对象。

参数：

paramGenSpi - 委托

provider - provider

algorithm - 算法

方法详细信息

getAlgorithm

public final String getAlgorithm()

返回与此参数生成器关联的算法的标准名称。

返回：

算法的字符串名称。

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm)
                                               throws NoSuchAlgorithmException

生成实现指定的简要算法的 AlgorithmParameterGenerator 对象。如果默认的 provider 包提供所请求的简要算法的实现，则返回包含该实现的 AlgorithmParameterGenerator 的实例。如果在默认包中不存在该算法，则搜索其他包。

参数：

algorithm - 与此参数生成器关联的算法的字符串名称。

返回：

新的 AlgorithmParameterGenerator 对象。

抛出：

NoSuchAlgorithmException - 如果算法在环境中不可用。

getInstance

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

如果可以从指定的 provider 中得到相关的参数生成器，则为所请求的算法（该 provider 提供）生成一个 AlgorithmParameterGenerator 对象。

参数：

algorithm - 算法的字符串名称。

provider - provider 的字符串名称。

返回：

新的 AlgorithmParameterGenerator 对象。

抛出：

NoSuchAlgorithmException - 如果不能从 provider 得到算法。

NoSuchProviderException - 如果 provider 在环境中不可用。

IllegalArgumentException - 如果 provider 的名称为 null 或空。

另请参见：

Provider

getInstance

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

如果可以从指定的 provider 中得到相关的参数生成器，则为所请求的算法（该 provider 提供）生成一个 AlgorithmParameterGenerator 对象。注：不必注册 provider。

参数：

algorithm - 算法的字符串名称。

provider - provider。

返回：

新的 AlgorithmParameterGenerator 对象。

抛出：

NoSuchAlgorithmException - 如果不能从 provider 得到算法。

IllegalArgumentException - 如果 provider 为 null。

从以下版本开始：

1.4

另请参见：

Provider

getProvider

public final Provider getProvider()

返回此算法参数生成器对象的 provider。

返回：

此算法参数生成器对象的 provider

init

public final void init(int size)

针对某个特定大小初始化此参数生成器。要创建参数，需要将最高优先级安装的 provider 的 SecureRandom 实现用作随机源。（如果任何安装的 provider 都不提供 SecureRandom 的实现，则使用系统提供的随机源。）

参数：

size - 大小（位数）。

init

public final void init(int size,
                       SecureRandom random)

针对某个特定大小和随机源初始化此参数生成器。

参数：

size - 大小（位数）。

random - 随机源。

init

public final void init(AlgorithmParameterSpec genParamSpec)
                throws InvalidAlgorithmParameterException

利用特定于算法的参数生成值集合初始化此参数生成器。要生成参数，需要将最高优先级安装的 provider 的 SecureRandom 实现用作随机源。（如果任何安装的 provider 都不提供 SecureRandom 的实现，则使用系统提供的随机源。）

参数：

genParamSpec - 特定于算法的参数生成值的集合。

抛出：

InvalidAlgorithmParameterException - 如果给定的参数生成值不适合此参数生成器。

init

public final void init(AlgorithmParameterSpec genParamSpec,
                       SecureRandom random)
                throws InvalidAlgorithmParameterException

利用特定于算法的参数生成值集合初始化此参数生成器。

参数：

genParamSpec - 特定于算法的参数生成值的集合。

random - 随机源。

抛出：

InvalidAlgorithmParameterException - 如果给定的参数生成值不适合此参数生成器。

generateParameters

public final AlgorithmParameters generateParameters()

生成参数。

返回：

新的 AlgorithmParameters 对象。