模块  java.base
软件包  java.security

Class AlgorithmParameters

  • public class AlgorithmParameters
extends Object
    此类用作加密参数的不透明表示。

    可以通过调用getInstance工厂方法之一（返回给定类的实例的静态方法）来获取用于管理特定算法的参数的AlgorithmParameters对象。

    获得AlgorithmParameters对象后，必须使用适当的参数规范或参数编码通过调用init对其进行初始化。

    通过调用getParameterSpec从AlgorithmParameters对象获得透明参数规范，并且通过调用getEncoded获得参数的字节编码。

    需要Java平台的每个实现来支持以下标准AlgorithmParameters算法：

    • AES
    • DES
    • DESede
    • DiffieHellman
    • DSA
    这些算法在Java安全标准算法名称规范的AlgorithmParameters section中描述。 请参阅实现的发行文档，以了解是否支持任何其他算法。
    从以下版本开始：
    1.2
    另请参见：
    AlgorithmParameterSpec ， DSAParameterSpec ， KeyPairGenerator

    • 构造方法详细信息

      • AlgorithmParameters

        protected AlgorithmParameters​(AlgorithmParametersSpi paramSpi,
                              Provider provider,
                              String algorithm)
        创建AlgorithmParameters对象。
        参数
        paramSpi - 代表
        provider - 提供者
        algorithm - 算法

    • 方法详细信息

      • getAlgorithm

        public final String getAlgorithm()
        返回与此参数对象关联的算法的名称。
        结果
        算法名称。

      • getInstance

        public static AlgorithmParameters getInstance​(String algorithm)
                                       throws NoSuchAlgorithmException
        返回指定算法的参数对象。

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

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

        必须使用适当的参数规范或参数编码通过调用init初始化返回的参数对象。

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

      • getInstance

        public static AlgorithmParameters getInstance​(String algorithm,
                                              Provider provider)
                                       throws NoSuchAlgorithmException
        返回指定算法的参数对象。

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

        必须使用适当的参数规范或参数编码通过调用init初始化返回的参数对象。

        参数
        algorithm - 请求的算法的名称。 有关标准算法名称的信息，请参阅Java Security Standard Algorithm Names Specification中的AlgorithmParameters部分。
        provider - 提供者的名称。
        结果
        新参数对象
        异常
        IllegalArgumentException - 如果提供者是 null
        NoSuchAlgorithmException - 如果指定的算法的 AlgorithmParameterGeneratorSpi实现不可用于指定的 Provider对象
        NullPointerException - 如果 algorithm是 null
        从以下版本开始：
        1.4
        另请参见：
        Provider

      • getProvider

        public final Provider getProvider()
        返回此参数对象的提供者。
        结果
        此参数对象的提供者

      • init

        public final void init​(byte[] params)
                throws IOException
        导入指定的参数并根据参数的主要解码格式对其进行解码。 如果存在此类参数的ASN.1规范，则参数的主要解码格式为ASN.1。
        参数
        params - 编码参数。
        异常
        IOException - 解码错误，或者此参数对象是否已初始化。

      • init

        public final void init​(byte[] params,
                       String format)
                throws IOException
        从params导入参数，并根据指定的解码方案对其进行解码。 如果format为null，则使用参数的主要解码格式。 如果存在这些参数的ASN.1规范，则主要解码格式为ASN.1。
        参数
        params - 编码参数。
        format - 解码方案的名称。
        异常
        IOException - 解码错误，或者此参数对象是否已初始化。

      • getParameterSpec

        public final <T extends AlgorithmParameterSpec> T getParameterSpec​(类<T> paramSpec)
                                                            throws InvalidParameterSpecException
        返回此参数对象的（透明）规范。 paramSpec标识应返回参数的规范类。 例如，它可以是DSAParameterSpec.class ，以指示应该在DSAParameterSpec类的实例中返回参数。
        参数类型
        T - 要返回的参数规范的类型
        参数
        paramSpec - 应返回参数的规范类。
        结果
        参数规范。
        异常
        InvalidParameterSpecException - 如果请求的参数规范不适合此参数对象，或者此参数对象尚未初始化。

      • getEncoded

        public final byte[] getEncoded()
                        throws IOException
        以主编码格式返回参数。 如果存在此类参数的ASN.1规范，则参数的主要编码格式为ASN.1。
        结果
        使用主编码格式编码的参数。
        异常
        IOException - 有关编码错误，或者此参数对象尚未初始化。

      • getEncoded

        public final byte[] getEncoded​(String format)
                        throws IOException
        返回在指定方案中编码的参数。 如果format为null，则使用参数的主要编码格式。 如果存在这些参数的ASN.1规范，则主要编码格式为ASN.1。
        参数
        format - 编码格式的名称。
        结果
        使用指定编码方案编码的参数。
        异常
        IOException - 有关编码错误，或者此参数对象尚未初始化。

      • toString

        public final String toString()
        返回描述参数的格式化字符串。
        重写：
        toString类 Object
        结果
        描述参数的格式化字符串，如果尚未初始化此参数对象，则返回null。