程序包 org.hibernate.internal.util

类 SerializationHelper

java.lang.Object

org.hibernate.internal.util.SerializationHelper

public final class SerializationHelper
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

作者:

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

方法概要

修饰符和类型	方法	说明
static Object	clone(Serializable object)	Deep clone an Object using serialization.
static ClassLoader	defaultClassLoader()	Returns the Thread Context ClassLoader (TCCL).
static Object	deserialize(byte[] objectData)	Deserializes an object from an array of bytes using the Thread Context ClassLoader (TCCL).
static Object	deserialize(byte[] objectData, ClassLoader loader)	Deserializes an object from an array of bytes.
static <T> T	deserialize(InputStream inputStream)	Deserializes an object from the specified stream using the Thread Context ClassLoader (TCCL).
static Object	deserialize(InputStream inputStream, ClassLoader loader)	Deserializes an object from the specified stream using the Thread Context ClassLoader (TCCL).
static <T> T	doDeserialize(InputStream inputStream, ClassLoader loader, ClassLoader fallbackLoader1, ClassLoader fallbackLoader2)
static ClassLoader	hibernateClassLoader()
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

方法详细资料

clone

public static Object clone(Serializable object)
                    throws SerializationException

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)
                      throws SerializationException

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)
                        throws SerializationException

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 <T> T deserialize(InputStream inputStream)
                         throws SerializationException

Deserializes an object from the specified stream using the Thread Context ClassLoader (TCCL).

Delegates to doDeserialize(java.io.InputStream, java.lang.ClassLoader, java.lang.ClassLoader, java.lang.ClassLoader)

参数:

inputStream - the serialized object input stream, must not be null

返回:

the deserialized object

抛出:

IllegalArgumentException - if inputStream is null

SerializationException - (runtime) if the serialization fails

defaultClassLoader

public static ClassLoader defaultClassLoader()

Returns the Thread Context ClassLoader (TCCL).

返回:

The current TCCL

hibernateClassLoader

public static ClassLoader hibernateClassLoader()

deserialize

public static Object deserialize(InputStream inputStream,
                                 ClassLoader loader)
                          throws SerializationException

Deserializes an object from the specified stream using the Thread Context ClassLoader (TCCL). If there is no TCCL set, the classloader of the calling class is used.

The stream will be closed once the object is read. 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 the caller, if desired.

参数:

inputStream - the serialized object input stream, must not be null

loader - The classloader to use

返回:

the deserialized object

抛出:

IllegalArgumentException - if inputStream is null

SerializationException - (runtime) if the serialization fails

doDeserialize

public static <T> T doDeserialize(InputStream inputStream,
                                  ClassLoader loader,
                                  ClassLoader fallbackLoader1,
                                  ClassLoader fallbackLoader2)
                           throws SerializationException

抛出:

SerializationException

deserialize

public static Object deserialize(byte[] objectData)
                          throws SerializationException

Deserializes an object from an array of bytes using the Thread Context ClassLoader (TCCL). If there is no TCCL set, the classloader of the calling class is used.

Delegates to deserialize(byte[], ClassLoader)

参数:

objectData - the serialized object, must not be null

返回:

the deserialized object

抛出:

IllegalArgumentException - if objectData is null

SerializationException - (runtime) if the serialization fails

deserialize

public static Object deserialize(byte[] objectData,
                                 ClassLoader loader)
                          throws SerializationException

Deserializes an object from an array of bytes.

Delegates to deserialize(java.io.InputStream, ClassLoader) using a ByteArrayInputStream to wrap the array.

参数:

objectData - the serialized object, must not be null

loader - The classloader to use

返回:

the deserialized object

抛出:

IllegalArgumentException - if objectData is null

SerializationException - (runtime) if the serialization fails