Java java.security 类 AlgorithmParameterGenerator（JDK5）

所有类

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

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 - 随机源。