AlgorithmParameterGenerator

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.security
类 AlgorithmParameterGenerator

java.lang.Object
  java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object
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 对象。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。