AlgorithmParameterGenerator

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

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

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

java.security
类 AlgorithmParameterGenerator

java.lang.Object
  java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object

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

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

使用与算法无关的方式时，所有参数生成器都共享“大小”概念和一个随机源。大小的测量由所有算法参数所普遍共享，尽管不同的算法对它有不同的解释。例如，在使用 DSA 算法的参数的情况下，“大小”对应于质数模数的大小（以位为单位）。使用这一方法时，特定于算法的参数生成值（如果有）默认为某些标准值，除非它们可以从指定大小派生。
另外一种方式使用特定于算法的语义初始化参数生成器对象，这些语义由特定于算法的参数生成值集合表示。例如，倘若要生成 Diffie-Hellman 系统参数，则参数生成值通常由质数模数的大小和随机指数的大小组成，这两个大小都使用位数指定。

为防止客户端没有显式初始化 AlgorithmParameterGenerator（通过调用 init 方法），每个提供商都必须提供（并记录）一种默认的初始化。例如，Sun 提供商使用 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)` 返回生成与指定算法一起使用的参数集的 AlgorithmParameterGenerator 对象。
`static AlgorithmParameterGenerator`	`getInstance(String algorithm, String provider)` 返回生成与指定算法一起使用的参数集的 AlgorithmParameterGenerator 对象。
`Provider`	`getProvider()` 返回此算法参数生成器对象的提供者。
`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`

构造方法详细信息

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

创建一个 AlgorithmParameterGenerator 对象。

参数：: paramGenSpi - 委托; provider - 提供者; algorithm - 算法

方法详细信息

getAlgorithm

public final String getAlgorithm()

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

返回：: 算法的字符串名称。

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm)
                                               throws NoSuchAlgorithmException

返回生成与指定算法一起使用的参数集的 AlgorithmParameterGenerator 对象。

此方法从首选的 Provider 开始遍历已注册安全提供者列表。返回封装新 AlgorithmParameterGeneratorSpi 实现的 AlgorithmParameterGenerator 对象，该对象取自第一个支持指定算法的 Provider。

注意，可以通过 Security.getProviders() 方法获取已注册提供者列表。

参数：: algorithm - 与此参数生成器关联的算法的名称。有关标准算法名称的信息，请参阅 Java Cryptography Architecture API Specification & Reference 中的附录 A。
返回：: 新的 AlgorithmParameterGenerator 对象。
抛出：: NoSuchAlgorithmException - 如果没有 Provider 支持指定算法的 AlgorithmParameterGeneratorSpi 实现。
另请参见：: Provider

getInstance

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

返回生成与指定算法一起使用的参数集的 AlgorithmParameterGenerator 对象。

返回封装 AlgorithmParameterGeneratorSpi 实现的新 AlgorithmParameterGenerator 对象，该实现取自指定 Provider。指定提供者必须在安全提供者列表中注册。

注意，可以通过 Security.getProviders() 方法获取已注册提供者列表。

参数：: algorithm - 与此参数生成器关联的算法的名称。有关标准算法名称的信息，请参阅 Java Cryptography Architecture API Specification & Reference 中的附录 A。; provider - Provider 的字符串名称。

返回：

新的 AlgorithmParameterGenerator 对象。

抛出：

NoSuchAlgorithmException - 如果指定算法的 AlgorithmParameterGeneratorSpi 实现不能从指定 Provider 获得。

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

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

另请参见：

Provider

getInstance

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

返回生成与指定算法一起使用的参数集的 AlgorithmParameterGenerator 对象。

返回封装 AlgorithmParameterGeneratorSpi 实现的新 AlgorithmParameterGenerator 对象，该实现取自指定 Provider 对象。注意，指定 Provider 对象无需在提供者列表中注册。

参数：: algorithm - 与此参数生成器关联的算法的字符串名称。有关标准算法名称的信息，请参阅 Java Cryptography Architecture API Specification & Reference 中的附录 A。; provider - Provider 对象。

返回：

新的 AlgorithmParameterGenerator 对象。

抛出：

NoSuchAlgorithmException - 如果指定算法的 AlgorithmParameterGeneratorSpi 实现不能从指定 Provider 对象获得。

IllegalArgumentException - 如果指定 provider 为 null。

从以下版本开始：

1.4

另请参见：

Provider

getProvider

public final Provider getProvider()

返回此算法参数生成器对象的提供者。

返回：: 此算法参数生成器对象的提供者

init

public final void init(int size)

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

参数：: size - 大小（位数）。

init

public final void init(int size,
                       SecureRandom random)

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

参数：: size - 大小（位数）。; random - 随机源。

init

public final void init(AlgorithmParameterSpec genParamSpec)
                throws InvalidAlgorithmParameterException

利用特定于算法的参数生成值集合初始化此参数生成器。要生成参数，则需要将最高优先级安装的提供者的 SecureRandom 实现用作随机源。（如果任何安装的提供者都不提供 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. 6

上一个类 下一个类

框架 无框架

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

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

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

java.security 类 AlgorithmParameterGenerator