模块  java.base
软件包  javax.crypto

Class EncryptedPrivateKeyInfo

  • public class EncryptedPrivateKeyInfo
extends Object
    此类实现PKCS＃8中定义的EncryptedPrivateKeyInfo类型。

    其ASN.1定义如下： 

      EncryptedPrivateKeyInfo ::=  SEQUENCE {
     encryptionAlgorithm   AlgorithmIdentifier,
     encryptedData   OCTET STRING }

 AlgorithmIdentifier  ::=  SEQUENCE  {
     algorithm              OBJECT IDENTIFIER,
     parameters             ANY DEFINED BY algorithm OPTIONAL  }
    从以下版本开始：
    1.4
    另请参见：
    PKCS8EncodedKeySpec

    • 构造方法详细信息

      • EncryptedPrivateKeyInfo

        public EncryptedPrivateKeyInfo​(byte[] encoded)
                        throws IOException
        从其ASN.1编码构造（即，解析） EncryptedPrivateKeyInfo 。
        参数
        encoded - 此对象的ASN.1编码。 复制数组的内容以防止后续修改。
        异常
        NullPointerException - 如果 encoded为空。
        IOException - 解析ASN.1编码时是否发生错误。

      • EncryptedPrivateKeyInfo

        public EncryptedPrivateKeyInfo​(String algName,
                               byte[] encryptedData)
                        throws NoSuchAlgorithmException
        根据加密算法名称和加密数据构造EncryptedPrivateKeyInfo 。

        注意：此构造函数将使用null作为算法参数的值。 如果加密算法具有值不为空的参数，则应使用不同的构造函数，例如EncryptedPrivateKeyInfo（AlgorithmParameters，byte []）。

        参数
        algName - 加密算法名称。 有关标准密码算法名称的信息，请参阅Java Security Standard Algorithm Names文档。
        encryptedData - 加密数据。 复制encrypedData的内容以防止在构造此对象时进行后续修改。
        异常
        NullPointerException - 如果 algName或 encryptedData为空。
        IllegalArgumentException - 如果 encryptedData为空，即0长度。
        NoSuchAlgorithmException - 如果不支持指定的algName。

      • EncryptedPrivateKeyInfo

        public EncryptedPrivateKeyInfo​(AlgorithmParameters algParams,
                               byte[] encryptedData)
                        throws NoSuchAlgorithmException
        根据加密算法参数和加密数据构造 EncryptedPrivateKeyInfo 。
        参数
        algParams - 加密算法的算法参数。 algParams.getEncoded()应返回EncryptedPrivateKeyInfo类型的AlgorithmIdentifer组件的parameters字段的ASN.1编码字节。
        encryptedData - 加密数据。 复制encrypedData的内容以防止在构造此对象时进行后续修改。
        异常
        NullPointerException - 如果 algParams或 encryptedData为空。
        IllegalArgumentException - 如果 encryptedData为空，即0长度。
        NoSuchAlgorithmException - 如果不支持指定的 algParams参数的指定 algParams 。

    • 方法详细信息

      • getAlgName

        public String getAlgName()
        返回加密算法。

        注意：当此类映射可用时，将返回标准名称而不是构造函数中指定的名称。 有关标准密码算法名称的信息，请参阅Java Security Standard Algorithm Names文档。

        结果
        加密算法名称。

      • getAlgParameters

        public AlgorithmParameters getAlgParameters()
        返回加密算法使用的算法参数。
        结果
        算法参数。

      • getEncryptedData

        public byte[] getEncryptedData()
        返回加密数据。
        结果
        加密数据。 每次调用此方法时返回一个新数组。

      • getKeySpec

        public PKCS8EncodedKeySpec getKeySpec​(Cipher cipher)
                               throws InvalidKeySpecException
        从加密数据中提取附带的PKCS8EncodedKeySpec对象并将其返回。
        注意：为了成功检索随附的PKCS8EncodedKeySpec对象，需要将cipher初始化为Cipher.DECRYPT_MODE或Cipher.UNWRAP_MODE，并使用与生成加密数据相同的密钥和参数。
        参数
        cipher - 初始化的密码对象，用于解密加密数据。
        结果
        PKCS8EncodedKeySpec对象。
        异常
        NullPointerException - 如果 cipher为空。
        InvalidKeySpecException - 如果给定的密码不适合加密数据，或者加密数据已损坏且无法解密。

      • getKeySpec

        public PKCS8EncodedKeySpec getKeySpec​(Key decryptKey,
                                      Provider provider)
                               throws NoSuchAlgorithmException,
                                      InvalidKeyException
        从加密数据中提取附带的PKCS8EncodedKeySpec对象并将其返回。
        参数
        decryptKey - 用于解密加密数据的密钥。
        provider - 将使用其密码实现的提供程序的名称。
        结果
        PKCS8EncodedKeySpec对象。
        异常
        NullPointerException - 如果 decryptKey或 provider为空。
        NoSuchAlgorithmException - 如果找不到合适的密码来解密 provider的加密数据。
        InvalidKeyException - 如果 decryptKey不能用于解密加密数据或解密结果不是有效的PKCS8KeySpec。
        从以下版本开始：
        1.5

      • getEncoded

        public byte[] getEncoded()
                  throws IOException
        返回此对象的ASN.1编码。
        结果
        ASN.1编码。 每次调用此方法时返回一个新数组。
        异常
        IOException - 如果在构造其ASN.1编码时发生错误。