javax.crypto

Class SealedObject

java.lang.Object

javax.crypto.SealedObject

All Implemented Interfaces:

Serializable

public class SealedObject
extends Object
implements Serializable

这个类允许程序员创建一个对象，并用密码算法来保护它的保密性。

任何可序列化的对象，可以创建一个原始对象SealedObject中可以封装，在序列化格式（即“深拷贝”），和海豹（加密）的序列化的内容，使用加密算法如DES，以保护其机密性。加密的内容以后可以解密（使用正确的解密密钥对应的算法）和反序列化，得到原始对象。

注意：密码必须完全初始化对象的正确算法，密钥，填充方案，等，在应用于SealedObject中可以。

被密封的原始对象可以以两种不同的方式恢复：

• 利用getObject方法，以Cipher对象。

  这种方法需要一个完全初始化Cipher对象，用同样的算法，初始化键，填充方案，等，被用来密封的对象。

  这种方法的优点是，人开启密封的对象不需要解密的关键知识。例如，在一方已经初始化密码对象所需的解密密钥，它可以交出密码对象到另一个人然后开启密封的对象。

• 用以上的方法，getObject采取Key对象。

  在这种方法中，该getObject方法创建相应的解密算法的加密对象并将它初始化与给定的解密密钥和算法参数（如果有的话），存放在密封的对象。

  这种方法的优点是，人开封对象不需要追踪的参数（例如，IV），被用来封装对象。

从以下版本开始：

一点四

另请参见：

Cipher， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	encodedParams 密封密码所使用的密码参数，以默认格式编码。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	SealedObject(SealedObject so) 构建了一个SealedObject中可以在SealedObject中可以从对象。
	SealedObject(Serializable object, Cipher c) 任何可序列化的对象构建SealedObject中可以。

方法摘要

Modifier and Type	Method and Description
String	getAlgorithm() 返回用于密封该对象的算法。
Object	getObject(Cipher c) 检索原始（封装的）对象。
Object	getObject(Key key) 检索原始（封装的）对象。
Object	getObject(Key key, String provider) 检索原始（封装的）对象。

Methods inherited from class java.lang.Object

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

Field Detail

encodedParams

protected byte[] encodedParams

密封密码所使用的密码参数，以默认格式编码。

这是cipher.getParameters().getEncoded()。

Constructor Detail

SealedObject

public SealedObject(Serializable object,
                    Cipher c)
             throws IOException,
                    IllegalBlockSizeException

任何可序列化的对象构建SealedObject中可以。

给定的对象序列化，序列化的内容进行加密，使用给定的密码，必须完全初始化。

可用于加密操作任何算法参数存储在新的SealedObject。

参数

object -被密封的对象；可以为空。

c -用于密封对象的密码。

异常

NullPointerException -如果给定的密码为空。

IOException -如果在序列化期间发生错误

IllegalBlockSizeException -如果给定的密码是一种分组密码，无填料一直要求和总输入长度（即序列化对象的内容的长度）是没有密码的块大小的倍数

SealedObject

protected SealedObject(SealedObject so)

构建了一个SealedObject中可以在SealedObject中可以从对象。

参数

一个对象 so SealedObject中可以

异常

NullPointerException -如果给定的密封对象为空。

方法详细信息

getAlgorithm

public final String getAlgorithm()

返回用于密封该对象的算法。

结果

用于密封该对象的算法。

getObject

public final Object getObject(Key key)
                       throws IOException,
                              ClassNotFoundException,
                              NoSuchAlgorithmException,
                              InvalidKeyException

检索原始（封装的）对象。

该方法创建了一个用于在密封操作中使用的算法的密码。如果默认的提供程序包提供了该算法的实现，使用该算法的一个包含该实现的密码的实例。如果该算法在默认包中不可用，则搜索其他包。对象初始化的密码解密，使用给定的key和参数（如果有的话），已被用于密封操作。

被封装的对象是启封和反序列化，返回前。

参数

key使用打开对象的关键。

结果

原始对象。

异常

IOException -如果在德serialiazation发生错误。

ClassNotFoundException -如果在德serialiazation发生错误。

NoSuchAlgorithmException如果打开对象的算法不可用。

InvalidKeyException -如果给定的键不能用来开启的对象（例如，它有错误的算法）。

NullPointerException -如果 key是空的。

getObject

public final Object getObject(Cipher c)
                       throws IOException,
                              ClassNotFoundException,
                              IllegalBlockSizeException,
                              BadPaddingException

检索原始（封装的）对象。

被封装的对象是密封（使用给定的密码，如果密码已经被正确地初始化）和反序列化，返回前。

参数

c使用打开对象的密码

结果

原始对象。

异常

NullPointerException -如果给定的密码为空。

IOException -如果在德serialiazation发生错误

ClassNotFoundException -如果在德serialiazation发生错误

IllegalBlockSizeException -如果给定的密码是一种分组密码，无填料一直要求和总输入长度不是密码的块大小的倍数

BadPaddingException -如果给定的密码已经初始化为解密，并填充已被指定，但输入数据没有正确预期的填充字节

getObject

public final Object getObject(Key key,
                              String provider)
                       throws IOException,
                              ClassNotFoundException,
                              NoSuchAlgorithmException,
                              NoSuchProviderException,
                              InvalidKeyException

检索原始（封装的）对象。

此方法创建一个已被用于密封操作的算法，利用给定的provider，算法的实现。对象初始化的密码解密，使用给定的key和参数（如果有的话），已被用于密封操作。

被封装的对象是启封和反序列化，返回前。

参数

key使用打开对象的关键。

provider -算法的提供程序的名称打开对象。

结果

原始对象。

异常

IllegalArgumentException -如果给定的提供者是null或空。

IOException -如果在德serialiazation发生错误。

ClassNotFoundException -如果在德serialiazation发生错误。

NoSuchAlgorithmException如果打开对象的算法不可用。

NoSuchProviderException -如果给定的供应商没有配置。

InvalidKeyException -如果给定的键不能用来开启的对象（例如，它有错误的算法）。

NullPointerException -如果 key是空的。