javax.crypto
Class SealedObject

java.lang.Object
  |
  +--javax.crypto.SealedObject

public class SealedObject

extends java.lang.Object

implements java.io.Serializable

Class for cryptographic "sealing" a serialized object.

Attention: This is not a SUN implementation!

This class has been developed by IAIK according to the documentation publically available.
For SUNīs documentation of this class see http://java.sun.com/security/JCE1.2/spec/apidoc/index.html

This class can be used for protecting the confidentiality of a Serializable object. For protecting the Serializable object, create a SealedObject by calling the constructor with the given Serializable object and the Cipher to be used for encrypting. For decrypting - and deserializing - the encrypted object again, use the getobject(Cipher cipher) method, where now the Cipher is initialized for decryptiion.

See Also:

getObject(javax.crypto.Cipher), Serialized Form

Constructor Summary

SealedObject(java.io.Serializable object, Cipher c)
Creates a SealedObject from the given Serializable object using the given Cipher for encryption.

Method Summary

java.lang.String	getAlgorithm() Returns the algorithm that was used to seal this object.
java.lang.Object	getObject(Cipher c) Returns he original Serializable object from which this SealedObject has been created.
java.lang.Object	getObject(Key key) Retrieves the original (encapsulated) object.
java.lang.Object	getObject(Key key, java.lang.String provider) Retrieves the original (encapsulated) object.

Methods inherited from class java.lang.Object

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

Constructor Detail

SealedObject

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

Creates a SealedObject from the given Serializable object using the given Cipher for encryption.

Parameters:

object - the Serializeable object to be sealed

c - the cipher used for sealing, initialized for encryption

Throws:

java.io.IOException - if an error occurs during serialization

IllegalBlockSizeException - if the total length of the processed data is not a multiple of the block size for a (no padding performing) block cipher

Method Detail

getAlgorithm

public final java.lang.String getAlgorithm()

Returns the algorithm that was used to seal this object.

Returns:

the algorithm that was used to seal this object

getObject

public final java.lang.Object getObject(Cipher c)
                                 throws java.io.IOException,
                                        java.lang.ClassNotFoundException,
                                        IllegalBlockSizeException,
                                        BadPaddingException

Returns he original Serializable object from which this SealedObject has been created.

Parameters:

c - the cipher used for unsealing, initialized for decryption

Returns:

the original object.

Throws:

java.io.IOException - if an error occurs during de-serialiazation

java.lang.ClassNotFoundException - if an error occurs during de-serialiazation

IllegalBlockSizeException - if the total length of the processed data is not a multiple of the block size for a (no padding performing) block cipher

BadPaddingException - if the input data does not have proper padding bytes for data decryption including (un)padding

getObject

public final java.lang.Object getObject(Key key)
                                 throws java.io.IOException,
                                        java.lang.ClassNotFoundException,
                                        NoSuchAlgorithmException,
                                        InvalidKeyException

Retrieves the original (encapsulated) object. This method creates a cipher for the algorithm that had been used in the sealing operation. If the default provider package provides an implementation of that algorithm, an instance of Cipher containing that implementation is used. If the algorithm is not available in the default package, other packages are searched. The Cipher object is initialized for decryption, using the given key and the parameters (if any) that had been used in the sealing operation. The encapsulated object is unsealed and de-serialized, before it is returned.

Parameters:

key - the key used to unseal the object

Returns:

the original object

Throws:

java.io.IOException - if an error occurs during de-serialiazation

java.lang.ClassNotFoundException - if an error occurs during de-serialiazation

NoSuchAlgorithmException - if the algorithm to unseal the object is not available

InvalidKeyException - if the given key cannot be used to unseal the object (e.g., it has the wrong algorithm)

getObject

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

Retrieves the original (encapsulated) object. This method creates a cipher for the algorithm that had been used in the sealing operation, using an implementation of that algorithm from the given provider. The Cipher object is initialized for decryption, using the given key and the parameters (if any) that had been used in the sealing operation. The encapsulated object is unsealed and de-serialized, before it is returned.

Parameters:

key - the key used to unseal the object

provider - the name of the provider of the algorithm to unseal the object

Returns:

the original object

Throws:

java.io.IOException - if an error occurs during de-serialiazation

java.lang.ClassNotFoundException - if an error occurs during de-serialiazation

NoSuchAlgorithmException - if the algorithm to unseal the object is not available

NoSuchProviderException - if the given provider is not configured

InvalidKeyException - if the given key cannot be used to unseal the object (e.g., it has the wrong algorithm)