| java.lang.Object
 org.apache.commons.lang.SerializationUtils
| SerializationUtils | | public class SerializationUtils (Code) | | Assists with the serialization process and performs additional functionality based
on serialization.
- Deep clone using serialization
- Serialize managing finally and IOException
- Deserialize managing finally and IOException
This class throws exceptions for invalid null inputs.
Each method documents its behaviour in more detail.
author:
Nissim Karpenstein
author:
Janek Bogucki
author:
Daniel Rall
author:
Stephen Colebourne
author:
Jeff Varszegi
author:
Gary Gregory
since:
1.0
version:
$Id: SerializationUtils.java 437554 2006-08-28 06:21:41Z bayard $ |
| Constructor Summary | |
| public | SerializationUtils()
SerializationUtils instances should NOT be constructed in standard programming. |
| Method Summary | |
| public static Object | clone(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. | | public static Object | deserialize(InputStream inputStream)
Deserializes an Object from the specified stream.
The stream will be closed once the object is written. | | public static Object | deserialize(byte[] objectData)
| | public static void | serialize(Serializable obj, OutputStream outputStream)
Serializes an Object to the specified stream.
The stream will be closed once the object is written. | | public static byte[] | serialize(Serializable obj)
|
| SerializationUtils | | public SerializationUtils()(Code) | | 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.
since:
2.0 |
| clone | | public static Object clone(Serializable object)(Code) | | 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:
object - the Serializable object to clone the cloned object
throws:
SerializationException - (runtime) if the serialization fails |
| deserialize | | public static Object deserialize(InputStream inputStream)(Code) | | 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:
inputStream - the serialized object input stream, must not be null the deserialized object
throws:
IllegalArgumentException - if inputStream is null
throws:
SerializationException - (runtime) if the serialization fails |
| deserialize | | public static Object deserialize(byte[] objectData)(Code) | | Deserializes a single Object from an array of bytes.
Parameters:
objectData - the serialized object, must not be null the deserialized object
throws:
IllegalArgumentException - if objectData is null
throws:
SerializationException - (runtime) if the serialization fails |
| serialize | | public static void serialize(Serializable obj, OutputStream outputStream)(Code) | | 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:
obj - the object to serialize to bytes, may be null
Parameters:
outputStream - the stream to write to, must not be null
throws:
IllegalArgumentException - if outputStream is null
throws:
SerializationException - (runtime) if the serialization fails |
| serialize | | public static byte[] serialize(Serializable obj)(Code) | | Serializes an Object to a byte array for
storage/serialization.
Parameters:
obj - the object to serialize to bytes a byte[] with the converted Serializable
throws:
SerializationException - (runtime) if the serialization fails |
|
|