devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
192 lines (191 loc) • 6.3 kB
JavaScript
/**
* DevExtreme (esm/__internal/data/m_abstract_store.js)
* Version: 24.2.6
* Build date: Mon Mar 17 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import _extends from "@babel/runtime/helpers/esm/extends";
import {
errors,
handleError
} from "../../common/data/errors";
import storeHelper from "../../common/data/store_helper";
import {
processRequestResultLock
} from "../../common/data/utils";
import Class from "../../core/class";
import {
EventsStrategy
} from "../../core/events_strategy";
import {
noop
} from "../../core/utils/common";
import {
compileGetter
} from "../../core/utils/data";
import {
Deferred,
when
} from "../../core/utils/deferred";
import {
each
} from "../../core/utils/iterator";
import {
isEmptyObject
} from "../../core/utils/type";
const {
abstract: abstract
} = Class;
const {
queryByOptions: queryByOptions
} = storeHelper;
const storeImpl = {};
const Store = Class.inherit({
_langParams: {},
ctor(options) {
const that = this;
options = options || {};
this._eventsStrategy = new EventsStrategy(this);
each(["onLoaded", "onLoading", "onInserted", "onInserting", "onUpdated", "onUpdating", "onPush", "onRemoved", "onRemoving", "onModified", "onModifying"], ((_, optionName) => {
if (optionName in options) {
that.on(optionName.slice(2).toLowerCase(), options[optionName])
}
}));
this._key = options.key;
this._errorHandler = options.errorHandler;
this._useDefaultSearch = true
},
_clearCache: noop,
_customLoadOptions: () => null,
key() {
return this._key
},
keyOf(obj) {
if (!this._keyGetter) {
this._keyGetter = compileGetter(this.key())
}
return this._keyGetter(obj)
},
_requireKey() {
if (!this.key()) {
throw errors.Error("E4005")
}
},
load(options) {
const that = this;
options = options || {};
this._eventsStrategy.fireEvent("loading", [options]);
return this._withLock(this._loadImpl(options)).done((result => {
that._eventsStrategy.fireEvent("loaded", [result, options])
}))
},
_loadImpl(options) {
if (!isEmptyObject(this._langParams)) {
options = options || {};
options._langParams = _extends({}, this._langParams, options._langParams)
}
return queryByOptions(this.createQuery(options), options).enumerate()
},
_withLock(task) {
const result = new Deferred;
task.done((function() {
const that = this;
const args = arguments;
processRequestResultLock.promise().done((() => {
result.resolveWith(that, args)
}))
})).fail((function() {
result.rejectWith(this, arguments)
}));
return result
},
createQuery: abstract,
totalCount(options) {
return this._totalCountImpl(options)
},
_totalCountImpl(options) {
return queryByOptions(this.createQuery(options), options, true).count()
},
byKey(key, extraOptions) {
return this._addFailHandlers(this._withLock(this._byKeyImpl(key, extraOptions)))
},
_byKeyImpl: abstract,
insert(values) {
const that = this;
that._eventsStrategy.fireEvent("modifying");
that._eventsStrategy.fireEvent("inserting", [values]);
return that._addFailHandlers(that._insertImpl(values).done(((callbackValues, callbackKey) => {
that._eventsStrategy.fireEvent("inserted", [callbackValues, callbackKey]);
that._eventsStrategy.fireEvent("modified")
})))
},
_insertImpl: abstract,
update(key, values) {
const that = this;
that._eventsStrategy.fireEvent("modifying");
that._eventsStrategy.fireEvent("updating", [key, values]);
return that._addFailHandlers(that._updateImpl(key, values).done((() => {
that._eventsStrategy.fireEvent("updated", [key, values]);
that._eventsStrategy.fireEvent("modified")
})))
},
_updateImpl: abstract,
push(changes) {
const beforePushArgs = {
changes: changes,
waitFor: []
};
this._eventsStrategy.fireEvent("beforePushAggregation", [beforePushArgs]);
when(...beforePushArgs.waitFor).done((() => {
this._pushImpl(changes);
this._eventsStrategy.fireEvent("beforePush", [{
changes: changes
}]);
this._eventsStrategy.fireEvent("push", [changes])
}))
},
_pushImpl: noop,
remove(key) {
const that = this;
that._eventsStrategy.fireEvent("modifying");
that._eventsStrategy.fireEvent("removing", [key]);
return that._addFailHandlers(that._removeImpl(key).done((callbackKey => {
that._eventsStrategy.fireEvent("removed", [callbackKey]);
that._eventsStrategy.fireEvent("modified")
})))
},
_removeImpl: abstract,
_addFailHandlers(deferred) {
return deferred.fail(this._errorHandler).fail(handleError)
},
on(eventName, eventHandler) {
this._eventsStrategy.on(eventName, eventHandler);
return this
},
off(eventName, eventHandler) {
this._eventsStrategy.off(eventName, eventHandler);
return this
}
});
Store.create = function(alias, options) {
if (!(alias in storeImpl)) {
throw errors.Error("E4020", alias)
}
return new storeImpl[alias](options)
};
Store.registerClass = function(type, alias) {
if (alias) {
storeImpl[alias] = type
}
return type
};
Store.inherit = function(inheritor) {
return function(members, alias) {
const type = inheritor.apply(this, [members]);
Store.registerClass(type, alias);
return type
}
}(Store.inherit);
export default Store;