/** * A chained store is a store that is a "view" of an existing store. The data comes from the * {@link #source}, however this view of the store may be sorted & filtered independently without * having any impact on the {@link #source} store. */Ext.define('Ext.data.ChainedStore', { extend: 'Ext.data.AbstractStore', alias: 'store.chained', /** * @property {Boolean} isChainedStore * `true` in this class to identify an object as an instantiated ChainedStore, or subclass thereof. */ isChainedStore: true, config: { /** * @cfg {Ext.data.Store/String} source * The backing data source for this chained store. Either a store instance * or the id of an existing store. */ source: null, remoteFilter: false, remoteSort: false }, mixins: [ 'Ext.data.LocalStore' ], //<debug> updateRemoteFilter: function(remoteFilter, oldRemoteFilter) { if (remoteFilter) { Ext.raise('Remote filtering cannot be used with chained stores.'); } this.callParent([remoteFilter, oldRemoteFilter]); }, updateRemoteSort: function(remoteSort, oldRemoteSort) { if (remoteSort) { Ext.raise('Remote sorting cannot be used with chained stores.'); } this.callParent([remoteSort, oldRemoteSort]); }, //</debug> remove: function() { var source = this.getSource(); //<debug> if (!source) { Ext.raise('Cannot remove records with no source.'); } //</debug> return source.remove.apply(source, arguments); }, removeAll: function() { var source = this.getSource(); //<debug> if (!source) { Ext.raise('Cannot remove records with no source.'); } //</debug> return source.removeAll(); }, getData: function() { var me = this, data = me.data; if (!data) { me.data = data = me.constructDataCollection(); } return data; }, getTotalCount: function() { return this.getCount(); }, getSession: function() { return this.getSourceValue('getSession', null); }, applySource: function(source) { if (source) { //<debug> var original = source, s; //</debug> source = Ext.data.StoreManager.lookup(source); //<debug> if (!source) { s = 'Invalid source {0}specified for Ext.data.ChainedStore'; s = Ext.String.format(s, typeof original === 'string' ? '"' + original + '" ' : ''); Ext.raise(s); } //</debug> } return source; }, updateSource: function(source, oldSource) { var me = this, data; if (oldSource && !oldSource.destroyed) { oldSource.removeObserver(me); } if (source) { data = me.getData(); data.setSource(source.getData()); if (!me.isInitializing) { me.fireEvent('refresh', me); me.fireEvent('datachanged', me); } source.addObserver(me); } }, /** * Get the model used for this store. * @return {Ext.data.Model} The model */ getModel: function() { return this.getSourceValue('getModel', null); }, getProxy: function() { return null; }, onCollectionAdd: function(collection, info) { var me = this, records = info.items, lastChunk = !info.next; if (me.ignoreCollectionAdd) { return; } // Collection add changes the items reference of the collection, and that array // object if directly referenced by Ranges. The ranges have to refresh themselves // upon add. if (me.activeRanges) { me.syncActiveRanges(); } me.fireEvent('add', me, records, info.at); // If there is a next property, that means there is another range that needs // to be removed after this. Wait until everything is gone before firign datachanged // since it should be a bulk operation if (lastChunk) { me.fireEvent('datachanged', me); } }, // Our collection tells us that an item has changed onCollectionItemChange: function(collection, info) { var me = this, record = info.item, modifiedFieldNames = info.modified || null, type = info.meta; // Inform any interested parties that a record has been mutated. // This will be invoked on TreeStores in which the invoking record // is an descendant of a collapsed node, and so *will not be contained by this store me.onUpdate(record, type, modifiedFieldNames, info); me.fireEvent('update', me, record, type, modifiedFieldNames, info); me.fireEvent('datachanged', me); }, onCollectionUpdateKey: function(source, details) { // Must react to upstream Collection key update by firing idchanged event this.fireEvent('idchanged', this, details.item, details.oldKey, details.newKey); }, onUpdate: Ext.emptyFn, onCollectionRemove: function(collection, info) { var me = this, records = info.items, lastChunk = !info.next; if (me.ignoreCollectionRemove) { return; } me.fireEvent('remove', me, records, info.at, false); // If there is a next property, that means there is another range that needs // to be removed after this. Wait until everything is gone before firign datachanged // since it should be a bulk operation if (lastChunk) { me.fireEvent('datachanged', me); } }, onSourceBeforeLoad: function(source, operation) { this.fireEvent('beforeload', this, operation); this.callObservers('BeforeLoad', [operation]); }, onSourceAfterLoad: function(source, records, successful, operation) { this.fireEvent('load', this, records, successful, operation); this.callObservers('AfterLoad', [records, successful, operation]); }, onFilterEndUpdate: function() { this.callParent(arguments); this.callObservers('Filter'); }, onSourceBeforePopulate: function() { this.ignoreCollectionAdd = true; this.callObservers('BeforePopulate'); }, onSourceAfterPopulate: function() { var me = this; me.ignoreCollectionAdd = false; me.fireEvent('datachanged', me); me.fireEvent('refresh', me); this.callObservers('AfterPopulate'); }, onSourceBeforeClear: function() { this.ignoreCollectionRemove = true; this.callObservers('BeforeClear'); }, onSourceAfterClear: function() { this.ignoreCollectionRemove = false; this.callObservers('AfterClear'); }, onSourceBeforeRemoveAll: function() { this.ignoreCollectionRemove = true; this.callObservers('BeforeRemoveAll'); }, onSourceAfterRemoveAll: function(source, silent) { var me = this; me.ignoreCollectionRemove = false; if (!silent) { me.fireEvent('clear', me); me.fireEvent('datachanged', me); } this.callObservers('AfterRemoveAll', [silent]); }, onSourceFilter: function() { var me = this; me.fireEvent('refresh', me); me.fireEvent('datachanged', me); }, hasPendingLoad: function() { return this.getSourceValue('hasPendingLoad', false); }, isLoaded: function() { return this.getSourceValue('isLoaded', false); }, isLoading: function() { return this.getSourceValue('isLoading', false); }, doDestroy: function() { var me = this; me.observers = null; me.setSource(null); me.getData().destroy(true); me.data = null; me.callParent(); }, privates: { getSourceValue: function(method, defaultValue) { var source = this.getSource(), val = defaultValue; if (source && !source.destroyed) { val = source[method](); } return val; }, isMoving: function () { var source = this.getSource(); return source.isMoving ? source.isMoving.apply(source, arguments) : false; }, loadsSynchronously: function() { return this.getSource().loadsSynchronously(); } } // Provides docs from the mixin /** * @method add * @inheritdoc Ext.data.LocalStore#add */ /** * @method each * @inheritdoc Ext.data.LocalStore#each */ /** * @method collect * @inheritdoc Ext.data.LocalStore#collect */ /** * @method getById * @inheritdoc Ext.data.LocalStore#getById */ /** * @method getByInternalId * @inheritdoc Ext.data.LocalStore#getByInternalId */ /** * @method indexOf * @inheritdoc Ext.data.LocalStore#indexOf */ /** * @method indexOfId * @inheritdoc Ext.data.LocalStore#indexOfId */ /** * @method insert * @inheritdoc Ext.data.LocalStore#insert */ /** * @method queryBy * @inheritdoc Ext.data.LocalStore#queryBy */ /** * @method query * @inheritdoc Ext.data.LocalStore#query */ /** * @method first * @inheritdoc Ext.data.LocalStore#first */ /** * @method last * @inheritdoc Ext.data.LocalStore#last */ /** * @method sum * @inheritdoc Ext.data.LocalStore#sum */ /** * @method count * @inheritdoc Ext.data.LocalStore#count */ /** * @method min * @inheritdoc Ext.data.LocalStore#min */ /** * @method max * @inheritdoc Ext.data.LocalStore#max */ /** * @method average * @inheritdoc Ext.data.LocalStore#average */ /** * @method aggregate * @inheritdoc Ext.data.LocalStore#aggregate */});