|
Assists with the serialization process and performs additional functionality based on serialization.
This class throws exceptions for invalid null inputs. Each method documents its behavior in more detail. Constructor Detailpublic SerializationUtils() SerializationUtils instances should NOT be constructed in standard programming. Instead, the class should be used as SerializationUtils.clone(object). This constructor is public to permit tools that require a JavaBean instance to operate. Method Detailpublic static java.lang.Object clone(java.io.Serializable object) Deep clone an Object using serialization. This is many times slower than writing clone methods by hand on all objects in your object graph. However, for complex object graphs, or for those that don't support deep cloning, this can be a simple alternative implementation. Of course all the objects must be Serializable. Parameters: objectthe Serializable object to clone Returns: the cloned object Throws: SerializationException(runtime) if the serialization fails public static void serialize(java.io.Serializable obj, java.io.OutputStream outputStream) Serializes an Object to the specified stream. The stream will be closed once the object is written. This avoids the need for a finally clause, and maybe also exception handling, in the application code. The stream passed in is not buffered internally within this method. This is the responsibility of your application if desired. Parameters: objthe object to serialize to bytes, may be null outputStreamthe stream to write to, must not be null Throws: java.lang.IllegalArgumentExceptionif outputStream is null SerializationException(runtime) if the serialization fails public static byte[] serialize(java.io.Serializable obj) Serializes an Object to a byte array for storage/serialization. Parameters: objthe object to serialize to bytes Returns: a byte[] with the converted Serializable Throws: SerializationException(runtime) if the serialization fails public static java.lang.Object deserialize(java.io.InputStream inputStream) Deserializes an Object from the specified stream. The stream will be closed once the object is written. This avoids the need for a finally clause, and maybe also exception handling, in the application code. The stream passed in is not buffered internally within this method. This is the responsibility of your application if desired. Parameters: inputStreamthe serialized object input stream, must not be null Returns: the deserialized object Throws: java.lang.IllegalArgumentExceptionif inputStream is null SerializationException(runtime) if the serialization fails public static java.lang.Object deserialize(byte[] objectData) Deserializes a single Object from an array of bytes. Parameters: objectDatathe serialized object, must not be null Returns: the deserialized object Throws: java.lang.IllegalArgumentExceptionif objectData is null SerializationException(runtime) if the serialization fails |
|