y.view
Class SimpleUserDataHandler

java.lang.Object
  y.view.SimpleUserDataHandler

All Implemented Interfaces:

GenericEdgeRealizer.UserDataHandler, GenericNodeRealizer.UserDataHandler, NodePort.UserDataHandler, YLabel.UserDataHandler

public class SimpleUserDataHandler
extends Object
implements GenericNodeRealizer.UserDataHandler, GenericEdgeRealizer.UserDataHandler, YLabel.UserDataHandler, NodePort.UserDataHandler

Simple implementation of the GenericNodeRealizer.UserDataHandler, GenericEdgeRealizer.UserDataHandler, and YLabel.UserDataHandler interfaces. that can be used by GenericNodeRealizer, GenericEdgeRealizer, and YLabel instances respectively. This implementation tries to either clone the user data and if that fails either copies the value by reference, returns null or throws a RuntimeException

Field Summary

static byte	EXCEPTION_ON_FAILURE Policy constant.
static byte	NULL_ON_FAILURE Policy constant.
static byte	REFERENCE_ON_FAILURE Policy constant.

Constructor Summary

SimpleUserDataHandler(byte mode)
Creates a new instance of SimpleUserDataHandler using the given mode

Method Summary

Object	copyUserData(EdgeRealizer srcContext, Object srcData, EdgeRealizer targetContext) Copies the user-defined data appropriately.
Object	copyUserData(NodePort srcPort, Object srcData, NodePort tgtPort) Creates a copy of the specified user data that is suitable for the specified target port instance.
Object	copyUserData(NodeRealizer srcContext, Object srcData, NodeRealizer targetContext) Copies the user data using its clone method and if that fails either returns the reference, null, or throws a RuntimeException, depending on the mode of this instance.
protected Object	copyUserData(Object srcData) Callback method that performs the actual copy.
Object	copyUserData(YLabel srcContext, Object srcData, YLabel targetContext) Copies the user-defined data appropriately.
Object	readUserData(EdgeRealizer context, ObjectInputStream ois) Retrieves the user-defined data object from the ObjectInputStream.
Object	readUserData(NodeRealizer context, ObjectInputStream ois) Read the user data using the default serialization method.
protected Object	readUserData(ObjectInputStream ois)
Object	readUserData(YLabel context, ObjectInputStream ois) Retrieves the user-defined data object from the ObjectInputStream.
void	storeUserData(EdgeRealizer context, Object userData, ObjectOutputStream oos) Stores the user-defined data object to the ObjectOutputStream.
void	storeUserData(NodeRealizer context, Object userData, ObjectOutputStream oos) Writes the user data using the default serialization method.
protected void	storeUserData(Object userData, ObjectOutputStream oos)
void	storeUserData(YLabel context, Object userData, ObjectOutputStream oos) Stores the user-defined data object to the ObjectOutputStream.

Methods inherited from class java.lang.Object

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

Field Detail

REFERENCE_ON_FAILURE

public static final byte REFERENCE_ON_FAILURE

Policy constant. This mode will copy the user data by reference if cloning fails.

See Also:

Constant Field Values

NULL_ON_FAILURE

public static final byte NULL_ON_FAILURE

Policy constant. This mode will return a null if cloning fails and serialize a null if serialization fails.

See Also:

Constant Field Values

EXCEPTION_ON_FAILURE

public static final byte EXCEPTION_ON_FAILURE

Policy constant. This mode will throw a RuntimeException if cloning fails or serialization fails.

See Also:

Constant Field Values

Constructor Detail

SimpleUserDataHandler

public SimpleUserDataHandler(byte mode)

Creates a new instance of SimpleUserDataHandler using the given mode

Method Detail

copyUserData

public Object copyUserData(NodeRealizer srcContext,
                           Object srcData,
                           NodeRealizer targetContext)

Copies the user data using its clone method and if that fails either returns the reference, null, or throws a RuntimeException, depending on the mode of this instance.

Specified by:

copyUserData in interface GenericNodeRealizer.UserDataHandler

copyUserData

protected Object copyUserData(Object srcData)

Callback method that performs the actual copy. This implementation tries to invoke the clone method.

Parameters:

srcData - the object to copy/clone

Returns:

the clone, if successful

readUserData

public Object readUserData(NodeRealizer context,
                           ObjectInputStream ois)
                    throws IOException

Read the user data using the default serialization method. If that fails either returns null or throws an IOException, depending on the mode of this instance.

Specified by:

readUserData in interface GenericNodeRealizer.UserDataHandler

Throws:

IOException

readUserData

protected Object readUserData(ObjectInputStream ois)
                       throws IOException

Throws:

IOException

storeUserData

public void storeUserData(NodeRealizer context,
                          Object userData,
                          ObjectOutputStream oos)
                   throws IOException

Writes the user data using the default serialization method. If that fails either writes null or throws an IOException, depending on the mode of this instance.

Specified by:

storeUserData in interface GenericNodeRealizer.UserDataHandler

Throws:

IOException

storeUserData

protected void storeUserData(Object userData,
                             ObjectOutputStream oos)
                      throws IOException

Throws:

IOException

storeUserData

public void storeUserData(EdgeRealizer context,
                          Object userData,
                          ObjectOutputStream oos)
                   throws IOException

Description copied from interface: GenericEdgeRealizer.UserDataHandler

Stores the user-defined data object to the ObjectOutputStream. Used for YGF serialization.

Specified by:

storeUserData in interface GenericEdgeRealizer.UserDataHandler

Throws:

IOException - if an exception occurs

Parameters:

context - the edge to store the user-defined data

userData - the user-defined data object

oos - the stream to store the user-defined data object to

readUserData

public Object readUserData(EdgeRealizer context,
                           ObjectInputStream ois)
                    throws IOException

Description copied from interface: GenericEdgeRealizer.UserDataHandler

Retrieves the user-defined data object from the ObjectInputStream. Used for YGF deserialization.

Specified by:

readUserData in interface GenericEdgeRealizer.UserDataHandler

Throws:

IOException - if an exception occurs

Parameters:

context - the edge to read the user-defined data for

ois - the stream to read the user-defined data object from

Returns:

the user-defined data object as read in from the stream

copyUserData

public Object copyUserData(EdgeRealizer srcContext,
                           Object srcData,
                           EdgeRealizer targetContext)

Description copied from interface: GenericEdgeRealizer.UserDataHandler

Copies the user-defined data appropriately.

Specified by:

copyUserData in interface GenericEdgeRealizer.UserDataHandler

Parameters:

srcContext - the edge that will be copied

srcData - the data associated with the srcContext

targetContext - the edge the copy will be associated with

Returns:

the copy that will be stored with the targetContext

storeUserData

public void storeUserData(YLabel context,
                          Object userData,
                          ObjectOutputStream oos)
                   throws IOException

Description copied from interface: YLabel.UserDataHandler

Stores the user-defined data object to the ObjectOutputStream. Used for YGF serialization.

Specified by:

storeUserData in interface YLabel.UserDataHandler

Throws:

IOException - if an exception occurs

Parameters:

context - the label to store the user-defined data for

userData - the user-defined data object

oos - the stream to store the user-defined data object to

readUserData

public Object readUserData(YLabel context,
                           ObjectInputStream ois)
                    throws IOException

Description copied from interface: YLabel.UserDataHandler

Retrieves the user-defined data object from the ObjectInputStream. Used for YGF deserialization.

Specified by:

readUserData in interface YLabel.UserDataHandler

Throws:

IOException - if an exception occurs

Parameters:

context - the label to read the user-defined data for

ois - the stream to read the user-defined data object from

Returns:

the user-defined data object as read in from the stream

copyUserData

public Object copyUserData(YLabel srcContext,
                           Object srcData,
                           YLabel targetContext)

Description copied from interface: YLabel.UserDataHandler

Copies the user-defined data appropriately.

Specified by:

copyUserData in interface YLabel.UserDataHandler

Parameters:

srcContext - the label that will be copied

srcData - the data associated with the srcContext

targetContext - the label the copy will be associated with

Returns:

the copy that will be stored with the targetContext

copyUserData

public Object copyUserData(NodePort srcPort,
                           Object srcData,
                           NodePort tgtPort)

Description copied from interface: NodePort.UserDataHandler

Creates a copy of the specified user data that is suitable for the specified target port instance.

Specified by:

copyUserData in interface NodePort.UserDataHandler

Parameters:

srcPort - the port instance whose user data is copied.

srcData - the user data that has to be copied.

tgtPort - the port instance for which the copy is created.

Returns:

a copy of the specified user data.