JavaTM 2 Platform
Standard Ed. 6

javax.crypto
类 EncryptedPrivateKeyInfo

java.lang.Object
  继承者 javax.crypto.EncryptedPrivateKeyInfo

public class EncryptedPrivateKeyInfo
extends Object

此类实现 EncryptedPrivateKeyInfo 类型,如在 PKCS #8 中定义的那样。

它的 ASN.1 定义如下:

 EncryptedPrivateKeyInfo ::=  SEQUENCE {
     encryptionAlgorithm   AlgorithmIdentifier,
     encryptedData   OCTET STRING }
 
 AlgorithmIdentifier  ::=  SEQUENCE  {
     algorithm              OBJECT IDENTIFIER,
     parameters             ANY DEFINED BY algorithm OPTIONAL  }
 

从以下版本开始:
1.4
另请参见:
PKCS8EncodedKeySpec

构造方法摘要
EncryptedPrivateKeyInfo(AlgorithmParameters algParams, byte[] encryptedData)
          根据加密算法参数和加密数据构造 EncryptedPrivateKeyInfo
EncryptedPrivateKeyInfo(byte[] encoded)
          根据其 ASN.1 编码构造(即解析)EncryptedPrivateKeyInfo
EncryptedPrivateKeyInfo(String algName, byte[] encryptedData)
          根据加密算法名称和加密数据构造 EncryptedPrivateKeyInfo
 
方法摘要
 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 对象从加密的数据中抽取出来并将其返回。
 
从类 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 为 null。
IOException - 如果在解析 ASN.1 编码过程中出现错误。

EncryptedPrivateKeyInfo

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

注:此构造方法将用 null 充当算法参数的值。如果加密算法所带的参数不为 null,则应换一种构造方法使用,例如,EncryptedPrivateKeyInfo(AlgorithmParameters, byte[])。

参数:
algName - 加密算法名称。有关标准 Cipher 算法名称的信息,请参见 Java Cryptography Architecture Reference Guide 中的附录 A。
encryptedData - 加密数据。encrypedData 的内容被复制,以免构造此对象时出现后续修改。
抛出:
NullPointerException - 如果 algNameencryptedData 为 null。
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 - 如果 algParamsencryptedData 为 null。
IllegalArgumentException - 如果 encryptedData 为空,即长度为 0。
NoSuchAlgorithmException - 如果的指定的 algParams 参数的指定 algName 不受支持。
方法详细信息

getAlgName

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

注:如果有这样的映射可用,则返回标准名称而不是指定的名称。有关标准 Cipher 算法名称的信息,请参见 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 为 null。
InvalidKeySpecException - 如果给定的密码不适合加密的数据,或者加密的数据已损坏,无法解密。

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey)
                               throws NoSuchAlgorithmException,
                                      InvalidKeyException
将密封的 PKCS8EncodedKeySpec 对象从加密的数据中抽取出来并将其返回。

参数:
decryptKey - 在对加密的数据进行解密时所使用的密钥。
返回:
PKCS8EncodedKeySpec 对象。
抛出:
NullPointerException - 如果 decryptKey 为 null。
NoSuchAlgorithmException - 如果无法找到合适的密码对加密的数据进行解密。
InvalidKeyException - 如果无法用 decryptKey 对加密的数据进行解密,或者解密结果不是有效的 PKCS8KeySpec。
从以下版本开始:
1.5

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey,
                                      String providerName)
                               throws NoSuchProviderException,
                                      NoSuchAlgorithmException,
                                      InvalidKeyException
将密封的 PKCS8EncodedKeySpec 对象从加密的数据中抽取出来并将其返回。

参数:
decryptKey - 在对加密的数据进行解密时所使用的密钥。
providerName - 其 Cipher 实现将被使用的提供者的名称。
返回:
PKCS8EncodedKeySpec 对象。
抛出:
NullPointerException - 如果 decryptKeyproviderName 为 null。
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 - 如果 decryptKeyprovider 为 null。
NoSuchAlgorithmException - 如果在 provider 中无法找到合适的密码对加密的数据进行解密。
InvalidKeyException - 如果无法用 decryptKey 对加密的数据进行解密,或者解密结果不是有效的 PKCS8KeySpec。
从以下版本开始:
1.5

getEncoded

public byte[] getEncoded()
                  throws IOException
返回此对象的 ASN.1 编码。

返回:
ASN.1 编码。每次调用此方法都返回一个新的数组。
抛出:
IOException - 如果在构造 ASN.1 编码过程中发生错误。

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策