com.goldencode.p2j.util

Class LegacyObject

java.lang.Object

com.goldencode.p2j.util.LegacyObject

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable

public class LegacyObject
extends java.lang.Object
implements java.io.Externalizable

Provides a transport mechanism of object instances over the network, for i.e. appserver calls.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LegacyObject.LegacyArray Serializable storage of a BDT array associated with a field.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	legacyClass The legacy type being transported.
private boolean	local Flag indicating whether the appserver, which sent the object, is running in the same JVM as the requester.
private static CentralLogger	LOG Logger
private java.util.LinkedHashMap<java.lang.reflect.Field,java.lang.Object>	serialized Serialization of each instance field.
private java.lang.Class<? extends _BaseObject_>	type The converted type of the object being transported.
private boolean	unknown Flag indicating if this is an unknown instance.

Constructor Summary

Constructors

Constructor and Description
LegacyObject() Default c'tor, used for deserialization.
LegacyObject(object<? extends _BaseObject_> o) Calls serialize(com.goldencode.p2j.util.object<? extends com.goldencode.p2j.oo.lang._BaseObject_>) in order to prepare the object to be transported over network.
LegacyObject(object<? extends _BaseObject_> o, boolean local) Calls serialize(com.goldencode.p2j.util.object<? extends com.goldencode.p2j.oo.lang._BaseObject_>) in order to prepare the object to be transported over network.

Method Summary

Modifier and Type	Method and Description
void	assign(LegacyObject ref)
private java.util.ArrayList<java.lang.reflect.Field>	collectInstanceFields(_BaseObject_ ref) Collect all instance fields defined in the reference's type.
private void	deserialize(java.lang.Object dest, BaseDataType ser) Restore the given field from its serialized state.
private void	deserializeDataSet(java.lang.Object dest, longchar ser) Restore the given DataSet field from its serialized state.
private void	deserializeHandle(java.lang.Object dest, handle ser) Restore the given handle field from its serialized state.
private void	deserializeMemptr(java.lang.Object dest, MemoryBuffer ser) Restore the given memptr field from its serialized state.
private boolean	deserializeObject(java.lang.Class<?> ftype, java.lang.Object dest, java.lang.Object ser) Restore the state of a field using the received (serialized) value.
private void	deserializeObject(java.lang.Object dest, LegacyObject ser) Restore the given object field from its serialized state.
private void	deserializeTable(java.lang.Object dest, TableWrapper ser) Restore the given table field from its serialized state.
java.lang.Class<? extends _BaseObject_>	getType() Get the object's type.
private static TableWrapper	preProcessTable(TableWrapper tableWrapper) This method emulates as if TableWrapper was sent over the network.
void	readExternal(java.io.ObjectInput in) Initialize this instance by reading its state from the specified stream.
_BaseObject_	restore() Create a new instance and set its state from the serialized information.
(package private) _BaseObject_	restore(boolean local) Create a new instance and set its state from the serialized information.
private void	restoreField(java.lang.reflect.Field f, _BaseObject_ ref, java.lang.Object ser) Restore the given field from its serialized state.
private void	save(_BaseObject_ ref) Serialize the given reference.
private static java.io.Externalizable	serialize(BaseDataType ref) Get the field's serialized state.
private void	serialize(object<? extends _BaseObject_> o) Serialize the given object reference, and save it, to be transported over network.
private static java.io.Externalizable	serializeDataSet(DataSet dataSet) Get the field's serialized state.
private java.lang.Object	serializeField(_BaseObject_ ref, java.lang.reflect.Field f) Get the field's serialized state.
private static java.lang.Object	serializeField(java.lang.Class<?> ftype, java.lang.Object val) Get the field's value using a serializable instance, assuming that the sent object is not being transported in the same JVM.
private static java.lang.Object	serializeField(java.lang.Class<?> ftype, java.lang.Object val, boolean local) Get the field's value using a serializable instance.
private static java.io.Externalizable	serializeHandle(handle ref) Get the field's serialized state.
private static java.io.Externalizable	serializeMemptr(memptr ref) Get the field's serialized state.
private static java.io.Externalizable	serializeObject(object ref) Get the field's serialized state.
private static java.io.Externalizable	serializeTable(Buffer buffer, boolean local) Get the field's serialized state.
void	writeExternal(java.io.ObjectOutput out) Write the state of this instance to the specified stream.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final CentralLogger LOG

Logger

legacyClass

private java.lang.String legacyClass

The legacy type being transported.

unknown

private boolean unknown

Flag indicating if this is an unknown instance.

type

private java.lang.Class<? extends _BaseObject_> type

The converted type of the object being transported.

serialized

private java.util.LinkedHashMap<java.lang.reflect.Field,java.lang.Object> serialized

Serialization of each instance field.

local

private boolean local

Flag indicating whether the appserver, which sent the object, is running in the same JVM as the requester.

Constructor Detail

LegacyObject

public LegacyObject()

Default c'tor, used for deserialization.

LegacyObject

public LegacyObject(object<? extends _BaseObject_> o,
                    boolean local)

Calls serialize(com.goldencode.p2j.util.object<? extends com.goldencode.p2j.oo.lang._BaseObject_>) in order to prepare the object to be transported over network.

Parameters:

o - The instance.

local - Flag indicating if the object is being transported in the same JVM.

LegacyObject

public LegacyObject(object<? extends _BaseObject_> o)

Calls serialize(com.goldencode.p2j.util.object<? extends com.goldencode.p2j.oo.lang._BaseObject_>) in order to prepare the object to be transported over network.

Parameters:

o - The instance.

Method Detail

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Write the state of this instance to the specified stream.

Specified by:

writeExternal in interface java.io.Externalizable

Parameters:

out - The stream where the state of this instance will be sent.

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Initialize this instance by reading its state from the specified stream.

Specified by:

readExternal in interface java.io.Externalizable

Parameters:

in - The stream from where the state of this instance will be read.

Throws:

java.io.IOException

java.lang.ClassNotFoundException

getType

public java.lang.Class<? extends _BaseObject_> getType()

Get the object's type.

Returns:

See above.

assign

public void assign(LegacyObject ref)

restore

public _BaseObject_ restore()

Create a new instance and set its state from the serialized information.

Returns:

See above.

restore

_BaseObject_ restore(boolean local)

Create a new instance and set its state from the serialized information.

Parameters:

local - Flag indicating if the object is being transported in the same JVM.

Returns:

See above.

serialize

private void serialize(object<? extends _BaseObject_> o)

Serialize the given object reference, and save it, to be transported over network.

Parameters:

o -

save

private void save(_BaseObject_ ref)

Serialize the given reference.

Parameters:

ref - The reference to serialize.

restoreField

private void restoreField(java.lang.reflect.Field f,
                          _BaseObject_ ref,
                          java.lang.Object ser)
                   throws java.lang.IllegalArgumentException,
                          java.lang.IllegalAccessException

Restore the given field from its serialized state.

Parameters:

f - The field to restore.

ref - The reference where the field needs to be set.

ser - The field's new value, which will either be assigned or set directly.

Throws:

java.lang.IllegalArgumentException

java.lang.IllegalAccessException

deserializeObject

private boolean deserializeObject(java.lang.Class<?> ftype,
                                  java.lang.Object dest,
                                  java.lang.Object ser)

Restore the state of a field using the received (serialized) value.

Parameters:

ftype - The field's type.

dest - The field's current value.

ser - The field's value to be assigned.

Returns:

true if the field was updated.

deserialize

private void deserialize(java.lang.Object dest,
                         BaseDataType ser)

Restore the given field from its serialized state.

Parameters:

dest - The reference where the field needs to be set.

ser - The serialized state.

deserializeTable

private void deserializeTable(java.lang.Object dest,
                              TableWrapper ser)

Restore the given table field from its serialized state.

Parameters:

dest - The reference where the field needs to be set.

ser - The serialized state.

deserializeDataSet

private void deserializeDataSet(java.lang.Object dest,
                                longchar ser)

Restore the given DataSet field from its serialized state.

Parameters:

dest - The reference where the field needs to be set.

ser - The serialized state.

deserializeMemptr

private void deserializeMemptr(java.lang.Object dest,
                               MemoryBuffer ser)

Restore the given memptr field from its serialized state.

Parameters:

dest - The reference where the field needs to be set.

ser - The serialized state.

deserializeHandle

private void deserializeHandle(java.lang.Object dest,
                               handle ser)

Restore the given handle field from its serialized state.

Parameters:

dest - The reference where the field needs to be set.

ser - The serialized state.

deserializeObject

private void deserializeObject(java.lang.Object dest,
                               LegacyObject ser)

Restore the given object field from its serialized state.

Parameters:

dest - The reference where the field needs to be set.

ser - The serialized state.

serializeField

private java.lang.Object serializeField(_BaseObject_ ref,
                                        java.lang.reflect.Field f)
                                 throws java.lang.IllegalArgumentException,
                                        java.lang.IllegalAccessException

Get the field's serialized state.

Parameters:

ref - The reference from where the field is read.

f - The field to read.

Returns:

See above.

Throws:

java.lang.IllegalArgumentException

java.lang.IllegalAccessException

serializeField

private static java.lang.Object serializeField(java.lang.Class<?> ftype,
                                               java.lang.Object val)

Get the field's value using a serializable instance, assuming that the sent object is not being transported in the same JVM.

Parameters:

ftype - The field's type.

val - The field's value.

Returns:

The serializable instance of this value or the actual value.

serializeField

private static java.lang.Object serializeField(java.lang.Class<?> ftype,
                                               java.lang.Object val,
                                               boolean local)

Get the field's value using a serializable instance.

Parameters:

ftype - The field's type.

val - The field's value.

local - Flag indicating if the object is being transported in the same JVM.

Returns:

The serializable instance of this value or the actual value.

serialize

private static java.io.Externalizable serialize(BaseDataType ref)

Get the field's serialized state.

Parameters:

ref - The field's value.

Returns:

See above.

serializeTable

private static java.io.Externalizable serializeTable(Buffer buffer,
                                                     boolean local)

Get the field's serialized state.

Parameters:

buffer - The field's value.

Returns:

See above.

preProcessTable

private static TableWrapper preProcessTable(TableWrapper tableWrapper)

This method emulates as if TableWrapper was sent over the network.

Parameters:

tableWrapper - The TableWrapper object which has to be serialized.

serializeDataSet

private static java.io.Externalizable serializeDataSet(DataSet dataSet)

Get the field's serialized state.

Parameters:

dataSet - The field's value.

Returns:

See above.

serializeMemptr

private static java.io.Externalizable serializeMemptr(memptr ref)

Get the field's serialized state.

Parameters:

ref - The field's value.

Returns:

See above.

serializeHandle

private static java.io.Externalizable serializeHandle(handle ref)

Get the field's serialized state.

Parameters:

ref - The field's value.

Returns:

See above.

serializeObject

private static java.io.Externalizable serializeObject(object ref)

Get the field's serialized state.

Parameters:

ref - The field's value.

Returns:

See above.

collectInstanceFields

private java.util.ArrayList<java.lang.reflect.Field> collectInstanceFields(_BaseObject_ ref)

Collect all instance fields defined in the reference's type.

Parameters:

ref - The reference.

Returns:

See above.