模块  java.base
软件包  java.security

Class AlgorithmParameterGenerator


  • public class AlgorithmParameterGenerator
    extends Object
    AlgorithmParameterGenerator类用于生成一组要与特定算法一起使用的参数。 使用getInstance工厂方法(返回给定类的实例的静态方法)构造参数生成器。

    生成参数的对象可以通过两种不同的方式初始化:以与算法无关的方式或以特定于算法的方式:

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

    如果客户端未显式初始化AlgorithmParameterGenerator(通过调用init方法),则每个提供程序必须提供(并记录)默认初始化。 有关JDK提供程序使用的AlgorithmParameterGenerator缺省值的信息,请参阅JDK Providers文档的Keysize Restriction部分。 但请注意,默认值可能因不同的提供商而异。 此外,提供程序的默认值可能会在将来的版本中更改。 因此,建议显式初始化AlgorithmParameterGenerator,而不是依赖于特定于提供程序的默认值。

    需要Java平台的每个实现来支持以下标准AlgorithmParameterGenerator算法并在括号中键入:

    • DiffieHellmanDiffieHellman
    • DSADSA
    这些算法在Java安全标准算法名称规范的AlgorithmParameterGenerator section中描述。 请参阅实现的发行文档,以了解是否支持任何其他算法。
    从以下版本开始:
    1.2
    另请参见:
    AlgorithmParametersAlgorithmParameterSpec
    • 构造方法详细信息

      • 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对象,用于生成要与指定算法一起使用的一组参数。

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

        请注意,可以通过Security.getProviders()方法检索已注册的提供者列表。

        Implementation Note:
        JDK Reference Implementation还使用jdk.security.provider.preferred Security属性来确定指定算法的首选提供程序顺序。 这可能与Security.getProviders()返回的提供商的顺序不同。
        参数
        algorithm - 此参数生成器所关联的算法的名称。 有关标准算法名称的信息,请参阅Java Security Standard Algorithm Names Specification中的AlgorithmParameterGenerator部分。
        结果
        新的 AlgorithmParameterGenerator对象
        异常
        NoSuchAlgorithmException - 如果没有 Provider支持指定算法的 AlgorithmParameterGeneratorSpi实现
        NullPointerException - 如果 algorithmnull
        另请参见:
        Provider
      • getInstance

        public static AlgorithmParameterGenerator getInstance​(String algorithm,
                                                              Provider provider)
                                                       throws NoSuchAlgorithmException
        返回AlgorithmParameterGenerator对象,用于生成要与指定算法一起使用的一组参数。

        将返回一个新的AlgorithmParameterGenerator对象,该对象从指定的Provider对象封装AlgorithmParameterGeneratorSpi实现。 请注意,指定的Provider对象不必在提供程序列表中注册。

        参数
        algorithm - 此参数生成器与之关联的算法的字符串名称。 有关标准算法名称的信息,请参阅Java Security Standard Algorithm Names Specification中的AlgorithmParameterGenerator部分。
        provider - Provider对象。
        结果
        新的 AlgorithmParameterGenerator对象
        异常
        IllegalArgumentException - 如果指定的提供者是 null
        NoSuchAlgorithmException - 如果指定的算法的 AlgorithmParameterGeneratorSpi实现不可用于指定的 Provider对象
        NullPointerException - 如果 algorithmnull
        从以下版本开始:
        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 - 如果给定的参数生成值不适合此参数生成器。
      • generateParameters

        public final AlgorithmParameters generateParameters()
        生成参数。
        结果
        the new AlgorithmParameters object.