org.apache.commons.lang
クラス SerializationUtils

java.lang.Object
  org.apache.commons.lang.SerializationUtils

public class SerializationUtils

extends Object

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.

導入されたバージョン:

1.0

バージョン:

$Id: SerializationUtils.java,v 1.1.1.1 2004/02/13 10:02:05 hioki Exp $

作成者:

Nissim Karpenstein, Janek Bogucki, Daniel Rall, Stephen Colebourne, Jeff Varszegi, Gary Gregory

コンストラクタの概要

SerializationUtils()
SerializationUtils instances should NOT be constructed in standard programming.

メソッドの概要

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.

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

SerializationUtils

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.

導入されたバージョン:

2.0

メソッドの詳細

clone

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 clone

戻り値:

the cloned object

例外:

SerializationException - (runtime) if the serialization fails

serialize

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. 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 null

outputStream - the stream to write to, must not be null

例外:

IllegalArgumentException - if outputStream is null

SerializationException - (runtime) if the serialization fails

serialize

public static byte[] serialize(Serializable obj)

Serializes an Object to a byte array for storage/serialization.

パラメータ:

obj - the object to serialize to bytes

戻り値:

a byte[] with the converted Serializable

例外:

SerializationException - (runtime) if the serialization fails

deserialize

public 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 null

戻り値:

the deserialized object

例外:

IllegalArgumentException - if inputStream is null

SerializationException - (runtime) if the serialization fails

deserialize

public static Object deserialize(byte[] objectData)

Deserializes a single Object from an array of bytes.

パラメータ:

objectData - the serialized object, must not be null

戻り値:

the deserialized object

例外:

IllegalArgumentException - if objectData is null

SerializationException - (runtime) if the serialization fails