Class SerialJavaObject

java.lang.Object

javax.sql.rowset.serial.SerialJavaObject

All Implemented Interfaces:

Serializable, Cloneable

public class SerialJavaObject
extends Object
implements Serializable, Cloneable

A serializable mapping in the Java programming language of an SQL JAVA_OBJECT value. Assuming the Java object implements the Serializable interface, this class simply wraps the serialization process.

If however, the serialization is not possible because the Java object is not immediately serializable, this class will attempt to serialize all non-static members to permit the object state to be serialized. Static or transient fields cannot be serialized; an attempt to serialize them will result in a SerialException object being thrown.

Thread safety

A SerialJavaObject is not safe for use by multiple concurrent threads. If a SerialJavaObject is to be used by more than one thread then access to the SerialJavaObject should be controlled by appropriate synchronization.

Since:

1.5

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
SerialJavaObject(Object obj)	Constructor for SerialJavaObject helper class.

Method Summary

Modifier and Type	Method	Description
Object	clone()	Returns a clone of this SerialJavaObject.
boolean	equals(Object o)	Compares this SerialJavaObject to the specified object.
Field[]	getFields()	Returns an array of Field objects that contains each field of the object that this helper class is serializing.
Object	getObject()	Returns an Object that is a copy of this SerialJavaObject object.
int	hashCode()	Returns a hash code for this SerialJavaObject.

Methods declared in class Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Modifier and Type	Method	Description
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

SerialJavaObject

public SerialJavaObject(Object obj)
                 throws SerialException

Constructor for SerialJavaObject helper class.

Parameters:

obj - the Java Object to be serialized

Throws:

SerialException - if the object is found not to be serializable

Method Details

getObject

public Object getObject()
                 throws SerialException

Returns an Object that is a copy of this SerialJavaObject object.

Returns:

a copy of this SerialJavaObject object as an Object in the Java programming language

Throws:

SerialException - if the instance is corrupt

getFields

public Field[] getFields()
                  throws SerialException

Returns an array of Field objects that contains each field of the object that this helper class is serializing.

Returns:

an array of Field objects

Throws:

SerialException - if an error is encountered accessing the serialized object

See Also:

• Class.getFields()

equals

public boolean equals(Object o)

Compares this SerialJavaObject to the specified object. The result is true if and only if the argument is not null and is a SerialJavaObject object that is identical to this object

Overrides:

equals in class Object

Parameters:

o - The object to compare this SerialJavaObject against

Returns:

true if the given object represents a SerialJavaObject equivalent to this SerialJavaObject, false otherwise

See Also:

• Object.hashCode()

hashCode

public int hashCode()

Returns a hash code for this SerialJavaObject. The hash code for a SerialJavaObject object is taken as the hash code of the Object it stores

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

• Object.equals(Object)

clone

public Object clone()

Returns a clone of this SerialJavaObject.

Overrides:

clone in class Object

Returns:

a clone of this SerialJavaObject