Maestro supports serialization apis to make it easy to write objects to registry, or to json for other purposes.
Objects that can be serialized are classes, or nodes, which implement the Serializable interface
Your node or class must adhere to the Serializable interface
- have isSerializable field set to true
- have public functions (i.e. for nodes, a func interface) for:
- public function serialize() as mc.types.assocarray - returns an aa of the values to serialize the node
- public function deserialize(data as mc.types.assocarray) - takes the values in data, and assigns them to itself
Objects are serialized with:
mc.utils.Serialization.serialize(serializable as object) as mc.types.assocarray
Which returns an associative array, if successful, invalid otherwise
If the passed in object is a node, then the field _serializationType with the type of the node will be appended to the serialized data
Objects can be deserialized with:
mc.utils.Serialization.deSerialize(data as mc.types.assocarray, serializable = invalid as object) as object
note, one can pass in a target serializable object to serialize into. If an object is not passed in the function will assume that the serialize object is node, and will use the data._serializationType to create an instance of that node, and serialize it.
mc.utils.Serialization.isSerializable(item as object) as boolean
You can easily work with serializable objects by using the registry functions:
readSerializable(section as string, key as string, serializable as object) as boolean- if the data was successfully read from the registry, returns the serialized object. A target serializable can be passed in to receive the data.
writeSerializable(section as string, key as string, serializable as object) as boolean- returns true if the object was successfully deserialized and written to the registry