add extjs 6.0.1 sources

[extjs.git] / extjs / packages / core / src / data / matrix / Matrix.js

/**\r
 * This class manages a many-to-many matrix for a `Session`.\r
 * @private\r
 */\r
Ext.define('Ext.data.matrix.Matrix', {\r
    requires: [\r
        'Ext.data.matrix.Side'\r
    ],\r
\r
    /**\r
     * @property {Ext.data.schema.ManyToMany} association\r
     * The `ManyToMany` association for this matrix.\r
     * @readonly\r
     */\r
\r
    /**\r
     * @property {Ext.data.Session} session\r
     * The `Session` owning this matrix.\r
     * @readonly\r
     */\r
\r
    /*\r
     *      data: [\r
     *          [ leftId, rightId, -1/0/1 ],   // === DELETED/UNMODIFIED/ADDED\r
     *          ...\r
     *      ],\r
     *      \r
     *      left: new Ext.data.matrix.Side({\r
     *          matrix: me,\r
     *          index: 0,\r
     *          inverse: right,\r
     *          slices: {\r
     *              leftId: new Ext.data.matrix.Slice({\r
     *                  id: leftId,\r
     *                  side: left,\r
     *                  members: {\r
     *                      rightId: data[0]\r
     *                  }\r
     *              })\r
     *          }\r
     *      },\r
     *      \r
     *      right: new Ext.data.matrix.Side({\r
     *          matrix: me,\r
     *          index: 1,\r
     *          inverse: left,\r
     *          slices: {\r
     *              rightId: new Ext.data.matrix.Slice({\r
     *                  id: rightId,\r
     *                  side: right,\r
     *                  members: {\r
     *                      leftId: data[0]\r
     *                  }\r
     *              })\r
     *          })\r
     *      }\r
     */\r
\r
    constructor: function (session, matrix) {\r
        var me = this,\r
            association = matrix.isManyToMany ? matrix\r
                                : session.getSchema().getAssociation(matrix),\r
            Side = Ext.data.matrix.Side,\r
            left = new Side(me, 0, association.left),\r
            right = new Side(me, 1, association.right);\r
\r
        //<debug>\r
        Ext.Assert.truthy(association.isManyToMany, 'Association is not many-to-many');\r
        //</debug>\r
\r
        me.association = association;\r
        me.session = session;\r
\r
        me.left = left;\r
        me.right = right;\r
\r
        left.inverse = right;\r
        right.inverse = left;\r
    },\r
\r
    commit: function() {\r
        this.left.commit();\r
        this.right.commit();\r
    },\r
\r
    update: function (id1, id2, state) {\r
        return this.left.update(id1, id2, state);\r
    },\r
\r
    updateId: function(record, oldId, newId) {\r
        var Type = record.self,\r
            left = this.left,\r
            right = this.right,\r
            matchSide;\r
\r
        // Are we interested in this record? Check types\r
        if (Type === left.role.cls) {\r
            matchSide = left;\r
        }\r
\r
        if (Type === right.role.cls) {\r
            matchSide = right;\r
        }\r
\r
        if (matchSide) {\r
            matchSide.updateId(oldId, newId);\r
        }\r
    },\r
\r
    destroy: function() {\r
        var me = this;\r
\r
        me.left.destroy();\r
        me.right.destroy();\r
\r
        me.association = me.session = me.left = me.right = null;\r
        me.callParent();\r
    }\r
});\r