- 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 SQLJAVA_OBJECTvalue. Assuming the Java object implements theSerializableinterface, 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
SerialExceptionobject 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 forSerialJavaObjecthelper class.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Objectclone()Returns a clone of thisSerialJavaObject.booleanequals(Object o)Compares this SerialJavaObject to the specified object.Field[]getFields()Returns an array ofFieldobjects that contains each field of the object that this helper class is serializing.ObjectgetObject()Returns anObjectthat is a copy of thisSerialJavaObjectobject.inthashCode()Returns a hash code for this SerialJavaObject.
-
-
-
Constructor Detail
-
SerialJavaObject
public SerialJavaObject(Object obj) throws SerialException
Constructor forSerialJavaObjecthelper class.- Parameters:
obj- the JavaObjectto be serialized- Throws:
SerialException- if the object is found not to be serializable
-
-
Method Detail
-
getObject
public Object getObject() throws SerialException
Returns anObjectthat is a copy of thisSerialJavaObjectobject.- Returns:
- a copy of this
SerialJavaObjectobject as anObjectin the Java programming language - Throws:
SerialException- if the instance is corrupt
-
getFields
public Field[] getFields() throws SerialException
Returns an array ofFieldobjects that contains each field of the object that this helper class is serializing.- Returns:
- an array of
Fieldobjects - Throws:
SerialException- if an error is encountered accessing the serialized objectSecurityException- If a security manager, s, is present and the caller's class loader is not the same as or an ancestor of the class loader for the class of the object being serialized and invocation ofs.checkPackageAccess()denies access to the package of that class.- See Also:
Class.getFields()
-
equals
public boolean equals(Object o)
Compares this SerialJavaObject to the specified object. The result istrueif and only if the argument is notnulland is aSerialJavaObjectobject that is identical to this object- Overrides:
equalsin classObject- Parameters:
o- The object to compare thisSerialJavaObjectagainst- Returns:
trueif the given object represents aSerialJavaObjectequivalent to this SerialJavaObject,falseotherwise- See Also:
Object.hashCode()
-
hashCode
public int hashCode()
Returns a hash code for this SerialJavaObject. The hash code for aSerialJavaObjectobject is taken as the hash code of theObjectit stores- Overrides:
hashCodein classObject- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object)
-
-