1 files changed, 465 insertions, 0 deletions

diff --git a/node_modules/montage-user/core/serializer.js b/node_modules/montage-user/core/serializer.js
new file mode 100755
index 00000000..449ebf7d
--- /dev/null
+++ b/node_modules/montage-user/core/serializer.js
@@ -0,0 +1,465 @@
+/* <copyright>
+ This file contains proprietary software owned by Motorola Mobility, Inc.<br/>
+ No rights, expressed or implied, whatsoever to this software are provided by Motorola Mobility, Inc. hereunder.<br/>
+ (c) Copyright 2011 Motorola Mobility, Inc.  All Rights Reserved.
+ </copyright> */
+/**
+ @module montage/core/serializer
+ @requires montage
+ @requires montage/core/uuid
+ @requires montage/core/deserializer
+ */
+var Montage = require("montage").Montage;
+var Uuid = require("core/uuid").Uuid;
+var Deserializer = require("core/deserializer").Deserializer;
+var logger = require("core/logger").logger("serializer");
+var Element;
+
+// Shadowing the global with a local allows us to feature-test without typeof
+// Element does not exist on the server-side
+if (typeof window !== "undefined") {
+    Element = window.Element;
+}
+
+/**
+ @class module:montage/core/serializer.Serializer
+ @classdesc Serialized objects are indexed by uuid.
+ @extends module:montage/core/core.Montage
+ */
+var Serializer = Montage.create(Montage, /** @lends module:montage/serializer.Serializer# */ {
+    _MONTAGE_ID_ATTRIBUTE: {value: "data-montage-id"},
+    _serializedObjects: {value: {}}, // uuid -> string
+    _serializedReferences: {value: {}}, // uuid -> string
+    _externalObjects: {value: null}, // label -> object
+    _externalElements: {value: null},
+    _objectStack: {value: null},
+    _objectReferences: {value: null}, // uuid -> object with properies
+    // last used index of an objectName to create a label
+    _objectNamesIndex: {value: null},
+    _objectLabels: {value: null}, // uuid -> label
+    _serializationUnits: {value: []},
+
+    serializeNullValues: {value: false},
+
+    /**
+     Defines a serialization unit for an object.
+     @function
+     @param {string} name The unit name.
+     @param {function} funktion The delegate function that creates the serialization unit. This function accepts the object being serialized as an argument and should return an object to be be JSON'd.
+     */
+    defineSerializationUnit: {value: function(name, funktion) {
+        this._serializationUnits.push({
+            name: name,
+            funktion: funktion
+        });
+    }},
+
+    /**
+     Defines the require function to be used.
+     @function
+     @param {function} require The require function to be used to identify module ids of the objects being serialized.
+     */
+    initWithRequire: {
+        value: function(require) {
+            this._require = require;
+            return this;
+        }
+    },
+
+    /**
+     Serializes a single object.
+     @function
+     @param {object} object The object to be serialized.
+     @returns {string} The serialized object.
+     */
+    serializeObject: {
+        value: function(object) {
+            return this.serialize({root: object});
+        }
+    },
+
+    /**
+     Serialize several objects under specific labels.
+     @function
+     @param {object} objects A label->object mapping of the objects to be serialized.
+     @returns {string} The serialized objects.
+     */
+    serialize: {
+        value: function(objects) {
+            var serialization,
+                valueSerialization,
+                label;
+
+            this._serializedObjects = {};
+            this._serializedReferences = {};
+            this._externalObjects = {};
+            this._externalElements = [];
+            this._objectNamesIndex = {};
+            this._objectLabels = {};
+            this._objectReferences = {};
+
+            for (label in objects) {
+                this._objectLabels[objects[label].uuid] = label;
+            }
+
+            for (label in objects) {
+                valueSerialization = this._serializeValue(objects[label], null, 2);
+                // objects are automatically inserted as top level objects after calling _serializeValue, but native objects have to be manually inserted them.
+                if (!(label in this._serializedObjects)) {
+                    this._serializedObjects[label] = {value: valueSerialization};
+                }
+            }
+
+            serialization = this._getSerialization(this._serializedObjects);
+            //console.log(serialization);
+            // save the require used for this serialization
+            this._require = require;
+            this._serialization = serialization;
+            return serialization;
+        }
+    },
+
+    /**
+     This function is to be used in the context of serializeSelf delegate used for custom object serializations.
+     It adds an entry to the "properties" serialization unit of the object being serialized.
+     @function
+     @param {string} name The name of the entry to be added.
+     @param {string} value The value to be serialized.
+     */
+    set: {value: function(name, value) {
+        var stack = this._objectStack;
+
+        return (stack[stack.length - 1][name] = value);
+    }},
+
+    /**
+     This function is to be used in the context of serializeSelf delegate used for custom object serializations.
+     It adds an entry to the "properties" serialization unit of the object being serialized. The value for this entry will be stored as a reference only and not the value itself.
+     @function
+     @param {string} name The name of the entry to be added.
+     @param {string} value The value to be referenced.
+     */
+    setReference: {value: function(name, value) {
+        var stack = this._objectStack,
+            stackElement = stack[stack.length - 1],
+            objectReferences = this._objectReferences,
+            uuid = stackElement.uuid;
+
+        if (!(uuid in objectReferences)) {
+            objectReferences[uuid] = {};
+            objectReferences[uuid][name] = true;
+        }
+
+        return (stackElement[name] = value);
+    }},
+
+    /**
+     This function is to be used in the context of serializeSelf delegate used for custom object serializations.
+     It serializes all properties specified as part of the "properties" serialization unit.
+     @function
+     @param {array} propertyNames The array with the property names to be serialized.
+     */
+    setProperties: {value: function(propertyNames) {
+        var ix = this._objectStack.length - 2,
+            object = this._objectStack[ix];
+
+        for (var i = 0, l = propertyNames.length; i < l; i++) {
+            var propertyName = propertyNames[i];
+            if (Montage.getPropertyAttribute(object, propertyName, "serializable") === "reference") {
+                this.setReference(propertyName, object[propertyName]);
+            } else {
+                this.set(propertyName, object[propertyName]);
+            }
+        }
+    }},
+
+    /**
+     This function is to be used in the context of serializeSelf delegate used for custom object serializations.
+     It adds an object to be serialized into the current serialization.
+     @function
+     @param {object} object The object to be serialized.
+     */
+    addObject: {value: function(object) {
+        var valueSerialization = this._serializeValue(object, null, 2);
+        var label = this._getObjectLabel(object);
+        // objects are automatically inserted as top level objects after calling _serializeValue, but native objects have to be manually inserted them.
+        if (!(label in this._serializedObjects)) {
+            this._serializedObjects[label] = {value: valueSerialization};
+        }
+    }},
+
+    /**
+     @private
+     */
+    _pushContextObject: {value: function(object) {
+        if (this._objectStack === null) {
+            this._objectStack = [object];
+        } else {
+            this._objectStack.push(object);
+        }
+    }},
+
+    /**
+     @private
+     */
+    _popContextObject: {value: function() {
+        return this._objectStack.pop();
+    }},
+
+    /**
+     Returns a dictionary of the external objects that were referenced in the last serialization.
+     @function
+     @returns {object} The dictionary of external objects {label: object}
+     */
+    getExternalObjects: {value: function() {
+        var externalObjects = this._externalObjects;
+
+        for (var label in externalObjects) {
+            var object = externalObjects[label];
+            if (this._serializedObjects[object.uuid]) {
+                delete externalObjects[label];
+            }
+        }
+
+        return externalObjects;
+    }},