Package org.operaton.bpm.engine.impl.variable.serializer

Class AbstractObjectValueSerializer

java.lang.Object

org.operaton.bpm.engine.impl.variable.serializer.AbstractTypedValueSerializer<ObjectValue>

org.operaton.bpm.engine.impl.variable.serializer.AbstractSerializableValueSerializer<ObjectValue>

org.operaton.bpm.engine.impl.variable.serializer.AbstractObjectValueSerializer

All Implemented Interfaces:

TypedValueSerializer<ObjectValue>

Direct Known Subclasses:

FallbackSpinObjectValueSerializer, JavaObjectSerializer, SpinObjectValueSerializer

public abstract class AbstractObjectValueSerializer
extends AbstractSerializableValueSerializer<ObjectValue>

Abstract implementation of a TypedValueSerializer for ObjectValues.

Author:

Daniel Meyer

Field Summary

Fields inherited from class org.operaton.bpm.engine.impl.variable.serializer.AbstractSerializableValueSerializer

serializationDataFormat

Fields inherited from class org.operaton.bpm.engine.impl.variable.serializer.AbstractTypedValueSerializer

BINARY_VALUE_TYPES, valueType

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractObjectValueSerializer(String serializationDataFormat)

Method Summary

Modifier and Type	Method	Description
ObjectValue	convertToTypedValue(UntypedValueImpl untypedValue)	Returns a typed value for the provided untyped value.
protected ObjectValue	createDeserializedValue(Object deserializedObject, String serializedStringValue, ValueFields valueFields, boolean asTransientValue)	Creates a deserialized value from the given parameters.
protected ObjectValue	createSerializedValue(String serializedStringValue, ValueFields valueFields, boolean asTransientValue)	Creates a serialized value from the given parameters.
protected abstract Object	deserializeFromByteArray(byte[] object, String objectTypeName)	Deserialize the object from a byte array.
protected Object	deserializeFromByteArray(byte[] object, ValueFields valueFields)	Deserialize the object from a byte array.
protected String	getObjectTypeName(ObjectValue value, ValueFields valueFields)
protected abstract String	getTypeNameForDeserialized(Object deserializedObject)	Returns the type name for the deserialized object.
boolean	isMutableValue(ObjectValue typedValue)
protected abstract boolean	isSerializationTextBased()	Return true if the serialization is text based.
protected String	readObjectNameFromFields(ValueFields valueFields)
protected abstract byte[]	serializeToByteArray(Object deserializedObject)	Implementations must return a byte[] representation of the provided object.
protected void	updateTypedValue(ObjectValue value, String serializedStringValue)	Updates the typed value with the serialized string representation.
protected void	writeToValueFields(ObjectValue value, ValueFields valueFields, byte[] serializedValue)	Writes the serialized value to the provided value fields.

Methods inherited from class org.operaton.bpm.engine.impl.variable.serializer.AbstractSerializableValueSerializer

canSerializeValue, canWriteValue, getSerializationDataformat, getSerializedBytesValue, getSerializedStringValue, readSerializedValueFromFields, readValue, writeValue

Methods inherited from class org.operaton.bpm.engine.impl.variable.serializer.AbstractTypedValueSerializer

canHandle, getType

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.operaton.bpm.engine.impl.variable.serializer.TypedValueSerializer

getName

Constructor Details

AbstractObjectValueSerializer

protected AbstractObjectValueSerializer(String serializationDataFormat)

Method Details

convertToTypedValue

public ObjectValue convertToTypedValue(UntypedValueImpl untypedValue)

Description copied from interface: TypedValueSerializer

Returns a typed value for the provided untyped value. This is used on cases where the user sets an untyped value which is then detected to be handled by this TypedValueSerializer (by invocation of TypedValueSerializer.canHandle(TypedValue)).

Parameters:

untypedValue - the untyped value

Returns:

the corresponding typed value

writeToValueFields

protected void writeToValueFields(ObjectValue value,
 ValueFields valueFields,
 byte[] serializedValue)

Description copied from class: AbstractSerializableValueSerializer

Writes the serialized value to the provided value fields.

Specified by:

writeToValueFields in class AbstractSerializableValueSerializer<ObjectValue>

Parameters:

value - the value to write

valueFields - the fields to write to

serializedValue - the serialized value as a byte array

getObjectTypeName

protected String getObjectTypeName(ObjectValue value,
 ValueFields valueFields)

updateTypedValue

protected void updateTypedValue(ObjectValue value,
 String serializedStringValue)

Description copied from class: AbstractSerializableValueSerializer

Updates the typed value with the serialized string representation.

Specified by:

updateTypedValue in class AbstractSerializableValueSerializer<ObjectValue>

Parameters:

value - the typed value to update

serializedStringValue - the serialized string representation

createDeserializedValue

protected ObjectValue createDeserializedValue(Object deserializedObject,
 String serializedStringValue,
 ValueFields valueFields,
 boolean asTransientValue)

Description copied from class: AbstractSerializableValueSerializer

Creates a deserialized value from the given parameters.

Specified by:

createDeserializedValue in class AbstractSerializableValueSerializer<ObjectValue>

Parameters:

deserializedObject - the deserialized object

serializedStringValue - the serialized string representation

valueFields - the value fields

asTransientValue - whether the value is transient

Returns:

the deserialized value

createSerializedValue

protected ObjectValue createSerializedValue(String serializedStringValue,
 ValueFields valueFields,
 boolean asTransientValue)

Description copied from class: AbstractSerializableValueSerializer

Creates a serialized value from the given parameters.

Specified by:

createSerializedValue in class AbstractSerializableValueSerializer<ObjectValue>

Parameters:

serializedStringValue - the serialized string representation

valueFields - the value fields

asTransientValue - whether the value is transient

Returns:

the serialized value

readObjectNameFromFields

protected String readObjectNameFromFields(ValueFields valueFields)

isMutableValue

public boolean isMutableValue(ObjectValue typedValue)

Specified by:

isMutableValue in interface TypedValueSerializer<ObjectValue>

Overrides:

isMutableValue in class AbstractTypedValueSerializer<ObjectValue>

Returns:

whether values serialized by this serializer can be mutable and should be re-serialized if changed

getTypeNameForDeserialized

protected abstract String getTypeNameForDeserialized(Object deserializedObject)

Returns the type name for the deserialized object.

Parameters:

deserializedObject - . Guaranteed not to be null

Returns:

the type name fot the object.

serializeToByteArray

protected abstract byte[] serializeToByteArray(Object deserializedObject)
                                        throws Exception

Implementations must return a byte[] representation of the provided object. The object is guaranteed not to be null.

Specified by:

serializeToByteArray in class AbstractSerializableValueSerializer<ObjectValue>

Parameters:

deserializedObject - the object to serialize

Returns:

the byte array value of the object

deserializeFromByteArray

protected Object deserializeFromByteArray(byte[] object,
 ValueFields valueFields)
                                   throws Exception

Description copied from class: AbstractSerializableValueSerializer

Deserialize the object from a byte array.

Specified by:

deserializeFromByteArray in class AbstractSerializableValueSerializer<ObjectValue>

Parameters:

object - the object to deserialize

valueFields - the value fields

Returns:

the deserialized object

Throws:

Exception - in case the object cannot be deserialized

deserializeFromByteArray

protected abstract Object deserializeFromByteArray(byte[] object,
 String objectTypeName)
                                            throws Exception

Deserialize the object from a byte array.

Parameters:

object - the object to deserialize

objectTypeName - the type name of the object to deserialize

Returns:

the deserialized object

isSerializationTextBased

protected abstract boolean isSerializationTextBased()

Return true if the serialization is text based. Return false otherwise

Specified by:

isSerializationTextBased in class AbstractSerializableValueSerializer<ObjectValue>