|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.commons.lang.SerializationUtils
Assists with the serialization process and performs additional functionality based on serialization.
This class throws exceptions for invalid null
inputs.
Each method documents its behaviour in more detail.
Constructor Summary | |
SerializationUtils()
SerializationUtils instances should NOT be constructed in standard programming. |
Method Summary | |
static Object |
clone(Serializable object)
Deep clone an Object using serialization. |
static Object |
deserialize(byte[] objectData)
Deserializes a single Object from an array of bytes. |
static Object |
deserialize(InputStream inputStream)
Deserializes an Object from the specified stream. |
static byte[] |
serialize(Serializable obj)
Serializes an Object to a byte array for
storage/serialization. |
static void |
serialize(Serializable obj,
OutputStream outputStream)
Serializes an Object to the specified stream. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public 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 Detail |
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. 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
.
object
- the Serializable
object to clonepublic static void serialize(Serializable obj, 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.
obj
- the object to serialize to bytes, may be nulloutputStream
- the stream to write to, must not be nulloutputStream
is null
public static byte[] serialize(Serializable obj)
Serializes an Object
to a byte array for
storage/serialization.
obj
- the object to serialize to bytespublic static Object deserialize(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.
inputStream
- the serialized object input stream, must not be nullinputStream
is null
public static Object deserialize(byte[] objectData)
Deserializes a single Object
from an array of bytes.
objectData
- the serialized object, must not be nullobjectData
is null
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |