javax.crypto

Class EncryptedPrivateKeyInfo

java.lang.Object

javax.crypto.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

构造方法摘要

构造方法

Constructor and Description
EncryptedPrivateKeyInfo(AlgorithmParameters algParams, byte[] encryptedData) 构造一个 EncryptedPrivateKeyInfo从加密算法参数和加密数据。
EncryptedPrivateKeyInfo(byte[] encoded) 从其ASN.1编码构造（即解析） EncryptedPrivateKeyInfo 。
EncryptedPrivateKeyInfo(String algName, byte[] encryptedData) 构造一个 EncryptedPrivateKeyInfo从加密算法的名称和加密的数据。

方法摘要

Modifier and Type	Method and Description
String	getAlgName() 返回加密算法。
AlgorithmParameters	getAlgParameters() 返回加密算法使用的算法参数。
byte[]	getEncoded() 返回此对象的ASN.1编码。
byte[]	getEncryptedData() 返回加密数据。
PKCS8EncodedKeySpec	getKeySpec(Cipher cipher) 从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。
PKCS8EncodedKeySpec	getKeySpec(Key decryptKey) 从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。
PKCS8EncodedKeySpec	getKeySpec(Key decryptKey, Provider provider) 从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。
PKCS8EncodedKeySpec	getKeySpec(Key decryptKey, String providerName) 从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

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 Cryptography Architecture Reference Guide中的附录A.

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 - 如果不支持指定的指定的algName algParams algParams参数。

方法详细信息

getAlgName

public String getAlgName()

返回加密算法。

注意：如果此类映射可用，则在构造函数中返回标准名称而不是指定的名称。 有关标准密码算法名称的信息，请参阅Java Cryptography Architecture Reference Guide中的附录A.

结果

加密算法名称。

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)
                               throws NoSuchAlgorithmException,
                                      InvalidKeyException

从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。

参数

decryptKey - 用于解密加密数据的密钥。

结果

PKCS8EncodedKeySpec对象。

异常

NullPointerException - 如果 decryptKey为空。

NoSuchAlgorithmException - 如果找不到适当的密码来解密加密数据。

InvalidKeyException - 如果 decryptKey不能用于解密加密数据或解密结果不是有效的PKCS8KeySpec。

从以下版本开始：

1.5

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey,
                                      String providerName)
                               throws NoSuchProviderException,
                                      NoSuchAlgorithmException,
                                      InvalidKeyException

从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。

参数

decryptKey - 用于解密加密数据的密钥。

providerName - 将使用Cipher实现的提供程序的名称。

结果

PKCS8EncodedKeySpec对象。

异常

NullPointerException - 如果 decryptKey或 providerName为空。

NoSuchProviderException - 如果没有提供者 providerName被注册。

NoSuchAlgorithmException - 如果找不到适当的密码来解密加密数据。

InvalidKeyException - 如果 decryptKey不能用于解密加密数据或解密结果不是有效的PKCS8KeySpec。

从以下版本开始：

1.5

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey,
                                      Provider provider)
                               throws NoSuchAlgorithmException,
                                      InvalidKeyException

从加密数据中提取封闭的PKCS8EncodedKeySpec对象并返回。

参数

decryptKey - 用于解密加密数据的密钥。

provider - 将使用Cipher实现的提供者的名称。

结果

PKCS8EncodedKeySpec对象。

异常

NullPointerException - 如果 decryptKey或 provider为空。

NoSuchAlgorithmException -如果无法找到合适的密码在对加密数据 provider 。

InvalidKeyException - 如果 decryptKey不能用于解密加密数据或解密结果不是有效的PKCS8KeySpec。

从以下版本开始：

1.5

getEncoded

public byte[] getEncoded()
                  throws IOException

返回此对象的ASN.1编码。

结果

ASN.1编码。 每次调用此方法时都会返回一个新数组。

异常

IOException - 如果构建其ASN.1编码时发生错误。