JavaTM 2 Platform
Standard Ed. 5.0

java.security
类 AlgorithmParameterGenerator

java.lang.Object
  继承者 java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object

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

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

为防止客户端不显式初始化 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 对象。

JavaTM 2 Platform
Standard Ed. 5.0

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

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策