java.security

接口
异常
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
 

构造方法详细信息

AlgorithmParameterGenerator

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 对象。