496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * The base module provides the Base class, which objects requiring attribute and custom event support can extend.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * The module also provides two ways to reuse code - It augments Base with the Plugin.Host interface which provides
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * plugin support and also provides the BaseCore.build method which provides a way to build custom classes using extensions.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @module base
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * <p>The base-core module provides the BaseCore class, the lightest version of Base,
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * which provides Base's basic lifecycle management and ATTRS construction support,
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * but doesn't fire init/destroy or attribute change events.</p>
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai *
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * <p>It mixes in AttributeCore, which is the lightest version of Attribute</p>
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @module base
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @submodule base-core
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var O = Y.Object,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai L = Y.Lang,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai DOT = ".",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai INITIALIZED = "initialized",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai DESTROYED = "destroyed",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai INITIALIZER = "initializer",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai OBJECT_CONSTRUCTOR = Object.prototype.constructor,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai DEEP = "deep",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai SHALLOW = "shallow",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai DESTRUCTOR = "destructor",
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai AttributeCore = Y.AttributeCore,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _wlmix = function(r, s, wlhash) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var p;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (p in s) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if(wlhash[p]) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai r[p] = s[p];
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return r;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai };
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * The BaseCore class, is the lightest version of Base, and provides Base's
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * basic lifecycle management and ATTRS construction support, but doesn't
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * fire init/destroy or attribute change events.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * BaseCore also handles the chaining of initializer and destructor methods across
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * the hierarchy as part of object construction and destruction. Additionally, attributes
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * configured through the static <a href="#property_BaseCore.ATTRS">ATTRS</a>
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * property for each class in the hierarchy will be initialized by BaseCore.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * Classes which require attribute support, but don't intend to use/expose attribute
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * change events can extend BaseCore instead of Base for optimal kweight and
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * runtime performance.
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai *
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @class BaseCore
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @constructor
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @uses AttributeCore
dd0c2dfda35d33dd7a894c8316b3efc154643ce1Satyen Desai * @param {Object} cfg Object with configuration property name/value pairs.
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * The object can be used to provide initial values for the objects published
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * attributes.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai function BaseCore(cfg) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (!this._BaseInvoked) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._BaseInvoked = true;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.log('constructor called', 'life', 'base');
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._initBase(cfg);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai else { Y.log('Based constructor called more than once. Ignoring duplicate calls', 'life', 'base'); }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * The list of properties which can be configured for each attribute
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * (e.g. setter, getter, writeOnce, readOnly etc.)
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @property _ATTR_CFG
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @type Array
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @static
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai BaseCore._ATTR_CFG = AttributeCore._ATTR_CFG.concat("cloneDefaultValue");
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai BaseCore._ATTR_CFG_HASH = Y.Array.hash(BaseCore._ATTR_CFG);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai /**
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * The array of non-attribute configuration properties supported by this class.
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai *
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * For example `BaseCore` defines a "plugins" configuration property which
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * should not be set up as an attribute. This property is primarily required so
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * that when <a href="#property__allowAdHocAttrs">`_allowAdHocAttrs`</a> is enabled by a class,
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * non-attribute configuration properties don't get added as ad-hoc attributes.
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai *
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @property _NON_ATTRS_CFG
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @type Array
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @static
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @private
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai */
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai BaseCore._NON_ATTRS_CFG = ["plugins"];
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * This property controls whether or not instances of this class should
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * allow users to add ad-hoc attributes through the constructor configuration
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * hash.
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai *
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * AdHoc attributes are attributes which are not defined by the class, and are
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * not handled by the MyClass._NON_ATTRS_CFG
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai *
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @property _allowAdHocAttrs
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @type boolean
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @default undefined (false)
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai * @protected
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai */
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * The string to be used to identify instances of this class.
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai *
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Classes extending BaseCore, should define their own
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * static NAME property, which should be camelCase by
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * convention (e.g. MyClass.NAME = "myClass";).
4cd36cd90f40231cd88acf6c0ab9d2fa89041bf0Satyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @property NAME
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @type String
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @static
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai BaseCore.NAME = "baseCore";
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * The default set of attributes which will be available for instances of this class, and
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * their configuration. In addition to the configuration properties listed by
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * AttributeCore's <a href="AttributeCore.html#method_addAttr">addAttr</a> method,
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * the attribute can also be configured with a "cloneDefaultValue" property, which
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * defines how the statically defined value field should be protected
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * ("shallow", "deep" and false are supported values).
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * By default if the value is an object literal or an array it will be "shallow"
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * cloned, to protect the default value.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @property ATTRS
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @type Object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @static
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai BaseCore.ATTRS = {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * Flag indicating whether or not this object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * has been through the init lifecycle phase.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @attribute initialized
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @readonly
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @default false
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @type boolean
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai initialized: {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai readOnly:true,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai value:false
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * Flag indicating whether or not this object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * has been through the destroy lifecycle phase.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @attribute destroyed
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @readonly
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @default false
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @type boolean
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai destroyed: {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai readOnly:true,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai value:false
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai };
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai BaseCore.prototype = {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Internal construction logic for BaseCore.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _initBase
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @param {Object} config The constructor configuration object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _initBase : function(config) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.stamp(this);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._initAttribute(config);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // If Plugin.Host has been augmented [ through base-pluginhost ], setup it's
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // initial state, but don't initialize Plugins yet. That's done after initialization.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var PluginHost = Y.Plugin && Y.Plugin.Host;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (this._initPlugins && PluginHost) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai PluginHost.call(this);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (this._lazyAddAttrs !== false) { this._lazyAddAttrs = true; }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * The string used to identify the class of this object.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @deprecated Use this.constructor.NAME
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @property name
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @type String
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this.name = this.constructor.NAME;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this.init.apply(this, arguments);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Initializes AttributeCore
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai *
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @method _initAttribute
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @private
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _initAttribute: function() {
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai AttributeCore.apply(this);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Init lifecycle method, invoked during construction. Sets up attributes
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * and invokes initializers for the class hierarchy.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method init
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @chainable
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @param {Object} cfg Object with configuration property name/value pairs
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @return {BaseCore} A reference to this object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai init: function(cfg) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.log('init called', 'life', 'base');
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._baseInit(cfg);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return this;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Internal initialization implementation for BaseCore
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _baseInit
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _baseInit: function(cfg) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._initHierarchy(cfg);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (this._initPlugins) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Need to initPlugins manually, to handle constructor parsing, static Plug parsing
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._initPlugins(cfg);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._set(INITIALIZED, true);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Destroy lifecycle method. Invokes destructors for the class hierarchy.
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method destroy
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * @return {BaseCore} A reference to this object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @chainable
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai destroy: function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._baseDestroy();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return this;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Internal destroy implementation for BaseCore
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _baseDestroy
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _baseDestroy : function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (this._destroyPlugins) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._destroyPlugins();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._destroyHierarchy();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._set(DESTROYED, true);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Returns the class hierarchy for this object, with BaseCore being the last class in the array.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _getClasses
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @protected
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @return {Function[]} An array of classes (constructor functions), making up the class hierarchy for this object.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * This value is cached the first time the method, or _getAttrCfgs, is invoked. Subsequent invocations return the
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * cached value.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _getClasses : function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (!this._classes) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._initHierarchyData();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return this._classes;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * Returns an aggregated set of attribute configurations, by traversing
b1e8839cb9f604a589a5703c40a83b64d2037fbdSatyen Desai * the class hierarchy.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _getAttrCfgs
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @protected
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @return {Object} The hash of attribute configurations, aggregated across classes in the hierarchy
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * This value is cached the first time the method, or _getClasses, is invoked. Subsequent invocations return
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * the cached value.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _getAttrCfgs : function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (!this._attrs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._initHierarchyData();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return this._attrs;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * A helper method used when processing ATTRS across the class hierarchy during
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * initialization. Returns a disposable object with the attributes defined for
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * the provided class, extracted from the set of all attributes passed in.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _filterAttrCfs
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @param {Function} clazz The class for which the desired attributes are required.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @param {Object} allCfgs The set of all attribute configurations for this instance.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * Attributes will be removed from this set, if they belong to the filtered class, so
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * that by the time all classes are processed, allCfgs will be empty.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @return {Object} The set of attributes belonging to the class passed in, in the form
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * of an object with attribute name/configuration pairs.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _filterAttrCfgs : function(clazz, allCfgs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var cfgs = null, attr, attrs = clazz.ATTRS;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (attrs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (attr in attrs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (allCfgs[attr]) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai cfgs = cfgs || {};
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai cfgs[attr] = allCfgs[attr];
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai allCfgs[attr] = null;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return cfgs;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai /**
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * @method _filterAdHocAttrs
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * @private
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai *
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * @param {Object} allAttrs The set of all attribute configurations for this instance.
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * Attributes will be removed from this set, if they belong to the filtered class, so
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * that by the time all classes are processed, allCfgs will be empty.
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * @param {Object} userVals The config object passed in by the user, from which adhoc attrs are to be filtered.
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * @return {Object} The set of adhoc attributes passed in, in the form
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai * of an object with attribute name/configuration pairs.
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai */
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai _filterAdHocAttrs : function(allAttrs, userVals) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai var adHocs,
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai nonAttrs = this._nonAttrs,
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai attr;
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai if (userVals) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai adHocs = {};
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai for (attr in userVals) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai if (!allAttrs[attr] && !nonAttrs[attr] && userVals.hasOwnProperty(attr)) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai adHocs[attr] = {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai value:userVals[attr]
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai };
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai return adHocs;
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai },
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * A helper method used by _getClasses and _getAttrCfgs, which determines both
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * the array of classes and aggregate set of attribute configurations
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * across the class hierarchy for the instance.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _initHierarchyData
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _initHierarchyData : function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var c = this.constructor,
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai i,
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai l,
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai nonAttrsCfg,
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai nonAttrs = (this._allowAdHocAttrs) ? {} : null,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai classes = [],
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai attrs = [];
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai while (c) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Add to classes
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai classes[classes.length] = c;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Add to attributes
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (c.ATTRS) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai attrs[attrs.length] = c.ATTRS;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai if (this._allowAdHocAttrs) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai nonAttrsCfg = c._NON_ATTRS_CFG;
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai if (nonAttrsCfg) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai for (i = 0, l = nonAttrsCfg.length; i < l; i++) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai nonAttrs[nonAttrsCfg[i]] = true;
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai c = c.superclass ? c.superclass.constructor : null;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._classes = classes;
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai this._nonAttrs = nonAttrs;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this._attrs = this._aggregateAttrs(attrs);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai /**
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai * Utility method to define the attribute hash used to filter/whitelist property mixes for
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai * this class.
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai *
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai * @method _attrCfgHash
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai * @private
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai */
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai _attrCfgHash: function() {
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai return BaseCore._ATTR_CFG_HASH;
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai },
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * A helper method, used by _initHierarchyData to aggregate
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * attribute configuration across the instances class hierarchy.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * The method will protect the attribute configuration value to protect the statically defined
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * default value in ATTRS if required (if the value is an object literal, array or the
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * attribute configuration has cloneDefaultValue set to shallow or deep).
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _aggregateAttrs
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @param {Array} allAttrs An array of ATTRS definitions across classes in the hierarchy
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * (subclass first, Base last)
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @return {Object} The aggregate set of ATTRS definitions for the instance
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _aggregateAttrs : function(allAttrs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var attr,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai attrs,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai cfg,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai val,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai path,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai i,
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai clone,
56b5f433405f287a41830929f5e8ea09b86dcabaSatyen Desai cfgPropsHash = this._attrCfgHash(),
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai aggAttrs = {};
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (allAttrs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (i = allAttrs.length-1; i >= 0; --i) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai attrs = allAttrs[i];
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (attr in attrs) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (attrs.hasOwnProperty(attr)) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Protect config passed in
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai //cfg = Y.mix({}, attrs[attr], true, cfgProps);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai //cfg = Y.Object(attrs[attr]);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai cfg = _wlmix({}, attrs[attr], cfgPropsHash);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai val = cfg.value;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai clone = cfg.cloneDefaultValue;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (val) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if ( (clone === undefined && (OBJECT_CONSTRUCTOR === val.constructor || L.isArray(val))) || clone === DEEP || clone === true) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.log('Cloning default value for attribute:' + attr, 'info', 'base');
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai cfg.value = Y.clone(val);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai } else if (clone === SHALLOW) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.log('Merging default value for attribute:' + attr, 'info', 'base');
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai cfg.value = Y.merge(val);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // else if (clone === false), don't clone the static default value.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // It's intended to be used by reference.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai path = null;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (attr.indexOf(DOT) !== -1) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai path = attr.split(DOT);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai attr = path.shift();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (path && aggAttrs[attr] && aggAttrs[attr].value) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai O.setValue(aggAttrs[attr].value, path, val);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai } else if (!path) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (!aggAttrs[attr]) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai aggAttrs[attr] = cfg;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai } else {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _wlmix(aggAttrs[attr], cfg, cfgPropsHash);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return aggAttrs;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * Initializes the class hierarchy for the instance, which includes
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * initializing attributes for each class defined in the class's
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * static <a href="#property_BaseCore.ATTRS">ATTRS</a> property and
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * invoking the initializer method on the prototype of each class in the hierarchy.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _initHierarchy
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @param {Object} userVals Object with configuration property name/value pairs
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _initHierarchy : function(userVals) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var lazy = this._lazyAddAttrs,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constr,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constrProto,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai ci,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai ei,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai el,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai extProto,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai exts,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai classes = this._getClasses(),
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai attrCfgs = this._getAttrCfgs(),
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai cl = classes.length - 1;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai for (ci = cl; ci >= 0; ci--) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constr = classes[ci];
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constrProto = constr.prototype;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai exts = constr._yuibuild && constr._yuibuild.exts;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (exts) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (ei = 0, el = exts.length; ei < el; ei++) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai exts[ei].apply(this, arguments);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai this.addAttrs(this._filterAttrCfgs(constr, attrCfgs), userVals, lazy);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai if (this._allowAdHocAttrs && ci === cl) {
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai this.addAttrs(this._filterAdHocAttrs(attrCfgs, userVals), userVals, lazy);
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai }
ed73fd1af1279111c591bd65981adbdc23a3a94aSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Using INITIALIZER in hasOwnProperty check, for performance reasons (helps IE6 avoid GC thresholds when
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // referencing string literals). Not using it in apply, again, for performance "." is faster.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (constrProto.hasOwnProperty(INITIALIZER)) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constrProto.initializer.apply(this, arguments);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (exts) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (ei = 0; ei < el; ei++) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai extProto = exts[ei].prototype;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (extProto.hasOwnProperty(INITIALIZER)) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai extProto.initializer.apply(this, arguments);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * Destroys the class hierarchy for this instance by invoking
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * the destructor method on the prototype of each class in the hierarchy.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method _destroyHierarchy
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @private
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai _destroyHierarchy : function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai var constr,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constrProto,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai ci, cl, ei, el, exts, extProto,
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai classes = this._getClasses();
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (ci = 0, cl = classes.length; ci < cl; ci++) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constr = classes[ci];
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constrProto = constr.prototype;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai exts = constr._yuibuild && constr._yuibuild.exts;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (exts) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai for (ei = 0, el = exts.length; ei < el; ei++) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai extProto = exts[ei].prototype;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (extProto.hasOwnProperty(DESTRUCTOR)) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai extProto.destructor.apply(this, arguments);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai if (constrProto.hasOwnProperty(DESTRUCTOR)) {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai constrProto.destructor.apply(this, arguments);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai },
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai /**
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * Default toString implementation. Provides the constructor NAME
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * and the instance guid, if set.
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai *
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @method toString
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai * @return {String} String representation for this object
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai */
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai toString: function() {
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai return this.name + "[" + Y.stamp(this, true) + "]";
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai }
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai };
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Straightup augment, no wrapper functions
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.mix(BaseCore, AttributeCore, false, null, 1);
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai // Fix constructor
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai BaseCore.prototype.constructor = BaseCore;
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai
496e4afa29c8a6fae3c6ddd03f0f7f42f968c3adSatyen Desai Y.BaseCore = BaseCore;