groovyx.gpars.serial

Class WithSerialId

java.lang.Object

groovyx.gpars.serial.WithSerialId

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

AgentCore, DataflowExpression, DataflowQueue, DataflowStreamWriteAdapter, MessageStream, RemoteDataflowQueue

public abstract class WithSerialId
extends java.lang.Object
implements java.io.Serializable

Base class for objects which can be exposed to remote nodes via serialization.

Main concept is following:

• each object belongs to some LocalHost
• every object can be exposed to any RemoteHost
• on remote host object is represented by proxy usually called remote object
• for serialization we use writeReplace method, which creates special handle to be serialized instead of the object
• for deserialization handle's readResolve method creates remote object (proxy)

See Serializable for detailed description how methods writeReplace & readResolve works.

It is very important to know that (de)serialization never happens by itself but always happens in context of RemoteHost and (@link LocalHost}. Such context is used for right resolution/transformation of objects

Author:

Alex Tkachman

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
SerialHandle	serialHandle See SerialHandle class for details
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
WithSerialId()

Method Summary

Modifier and Type	Method and Description
protected RemoteHandle	createRemoteHandle(SerialHandle handle, SerialContext host)
SerialHandle	getOrCreateSerialHandle() Gets serial handle for the object If needed new handle created and serialization host subscribed for the object handle
<T extends RemoteSerialized> java.lang.Class<T>	getRemoteClass() Class of remote object to be created
protected java.lang.Object	writeReplace() Replace object by handle for serialization

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

serialHandle

public volatile SerialHandle serialHandle

See SerialHandle class for details

Constructor Detail

WithSerialId

public WithSerialId()

Method Detail

getOrCreateSerialHandle

public final SerialHandle getOrCreateSerialHandle()

Gets serial handle for the object If needed new handle created and serialization host subscribed for the object handle

Returns:

serial handle for the object

getRemoteClass

public <T extends RemoteSerialized> java.lang.Class<T> getRemoteClass()

Class of remote object to be created

Returns:

Throws UnsupportedOperationException

writeReplace

protected final java.lang.Object writeReplace()
                                       throws java.io.ObjectStreamException

Replace object by handle for serialization

Returns:

handle to serialize

Throws:

java.io.ObjectStreamException - If the object cannot be serialized

createRemoteHandle

protected RemoteHandle createRemoteHandle(SerialHandle handle,
                                          SerialContext host)