add extjs 6.0.1 sources

[extjs.git] / extjs / packages / core / src / app / bind / AbstractStub.js

/**\r
 * This class manages bindings for a `Session` or `ViewModel`.\r
 * @private\r
 */\r
Ext.define('Ext.app.bind.AbstractStub', {\r
    extend: 'Ext.util.Schedulable',\r
\r
    requires: [\r
        'Ext.app.bind.Binding'\r
    ],\r
\r
    children: null,\r
\r
    depth: 0,\r
\r
    generation: 1,\r
\r
    kind: 10,\r
\r
    parent: null,\r
\r
    constructor: function (owner, name) {\r
        var me = this;\r
\r
        /**\r
         * @property {Ext.data.Session/Ext.app.ViewModel} owner\r
         * This property is set at creation of ths stub and should not be changed.\r
         * @readonly\r
         */\r
        me.owner = owner;\r
        me.name = name;\r
\r
        me.callParent();\r
    },\r
\r
    destroy: function () {\r
        var me = this,\r
            children = me.children,\r
            bindings = me.bindings,\r
            len, i, key;\r
\r
        if (bindings) {\r
            for (i = 0, len = bindings.length; i < len; ++i) {\r
                bindings[i].destroy(true);\r
            }\r
        }\r
\r
        for (key in children) {\r
            children[key].destroy();\r
        }\r
        me.callParent();\r
        me.bindings = me.children = me.owner = null;\r
    },\r
\r
    add: function (child) {\r
        var me = this;\r
\r
        (me.children || (me.children = {}))[child.name] = child;\r
\r
        child.depth = me.depth + 1;\r
        child.parent = me;\r
    },\r
\r
    getChild: function (path) {\r
        var pathArray = Ext.isString(path) ? path.split('.') : path;\r
\r
        if (pathArray && pathArray.length) {\r
            return this.descend(pathArray, 0);\r
        }\r
\r
        return this;\r
    },\r
\r
    getFullName: function () {\r
        var me = this,\r
            name = me.fullName,\r
            parent = me.parent,\r
            s;\r
\r
        if (!name) {\r
            name = me.name || me.id;\r
            if (parent && (s = parent.getFullName())) {\r
                name = ((s.charAt(s.length-1) !== ':') ? s + '.' : s) + name;\r
            }\r
            me.fullName = name;\r
        }\r
\r
        return name;\r
    },\r
\r
    getSession: function () {\r
        var owner = this.owner;\r
\r
        return owner.isSession ? owner : owner.getSession();\r
    },\r
\r
    bind: function (callback, scope, options) {\r
        var me = this,\r
            binding = new Ext.app.bind.Binding(me, callback, scope, options),\r
            bindings = (me.bindings || (me.bindings = []));\r
\r
        binding.depth = me.depth;\r
        bindings.push(binding);\r
\r
        return binding;\r
    },\r
\r
    getValue: function () {\r
        return this.isLoading() ? null : this.getRawValue();\r
    },\r
\r
    graft: function (replacement) {\r
        var me = this,\r
            bindings = me.bindings,\r
            name = me.name,\r
            i;\r
\r
        // Clear these so that when we call destroy we won't damage anything:\r
        me.parent = me.bindings = null;\r
        me.destroy(); // we may be scheduled\r
\r
        replacement.depth = me.depth;\r
        replacement.bindings = bindings;\r
        replacement.generation = me.generation + 1;\r
        replacement.name = name;\r
        replacement.id = me.id;\r
        replacement.path = me.path;\r
\r
        // Now for the fun part...\r
        if (bindings) {\r
            for (i = bindings.length; i-- > 0; ) {\r
                bindings[i].stub = replacement;\r
            }\r
        } \r
\r
        return replacement;\r
    },\r
\r
    isDescendantOf: function (item) {\r
        for (var parent = this; parent = parent.parent; ) {\r
            if (parent === item) {\r
                return true;\r
            }\r
        }\r
        return false;\r
    },\r
\r
    onSchedule: function() {\r
        // When a stub changes, say "foo.bar.baz" we may need to notify bindings on our\r
        // parents "foo.bar" and "foo", This is true especially when these are targets of\r
        // links. To economize on this we require that bindings that want to be notified\r
        // of changes to sub-properties of their target set the "deep" property to true.\r
        for (var i, len, binding, bindings, p = this.parent; p; p = p.parent) {\r
            bindings = p.bindings;\r
            if (bindings) {\r
                for (i = 0, len = bindings.length; i < len; ++i) {\r
                    binding = bindings[i];\r
                    if (binding.deep && !binding.scheduled) {\r
                        binding.schedule();\r
                    }\r
                }\r
            }\r
        }\r
    },\r
\r
    react: function () {\r
        var bindings = this.bindings,\r
            binding, i, len;\r
            \r
        if (bindings) {\r
            for (i = 0, len = bindings.length; i < len; ++i) {\r
                binding = bindings[i];\r
                if (!binding.scheduled) {\r
                    binding.schedule();\r
                }\r
            }\r
        }\r
    },\r
\r
    unbind: function (binding) {\r
        var bindings = this.bindings;\r
\r
        if (bindings && bindings.length) {\r
            Ext.Array.remove(bindings, binding);\r
        }\r
    },\r
\r
    privates: {\r
        collect: function() {\r
            var children = this.children,\r
                bindings = this.bindings,\r
                totalCount = 0,\r
                count = 0,\r
                child,\r
                key;\r
            \r
            if (children) {\r
                for (key in children) {\r
                    child = children[key];\r
                    count = child.collect();\r
                    if (count === 0) {\r
                        // The child (and any deep children) have no bindings,\r
                        // so we can consider it a dead node.\r
                        child.destroy();\r
                        delete children[key];\r
                    }\r
                    totalCount += count;\r
                }\r
            }\r
            \r
            if (bindings) {\r
                totalCount += bindings.length;\r
            }\r
            \r
            return totalCount;\r
        },\r
        \r
        getScheduler: function () {\r
            var owner = this.owner;\r
            return owner && owner.getScheduler();\r
        },\r
        \r
        sort: function () {\r
            var parent = this.parent;\r
\r
            if (parent) {\r
                // We sort our parent first because if it is something like a link we need\r
                // it to determine the value of the root-level property before we can dot\r
                // our way into it. This is especially important for formulas that might\r
                // throw errors if the links have not published results before they run.\r
                this.scheduler.sortItem(parent);\r
            }\r
\r
            // Schedulable#sort === emptyFn\r
            //me.callParent();\r
        }\r
    }\r
});\r