@openui5/sap.ui.core 1.96.2 → 1.97.0

package/src/sap/ui/model/odata/v4/ODataListBinding.js

@@ -76,7 +76,7 @@ sap.ui.define([
 	 * @mixes sap.ui.model.odata.v4.ODataParentBinding
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 * @borrows sap.ui.model.odata.v4.ODataBinding#getGroupId as #getGroupId
 	 * @borrows sap.ui.model.odata.v4.ODataBinding#getRootBinding as #getRootBinding
 	 * @borrows sap.ui.model.odata.v4.ODataBinding#getUpdateGroupId as #getUpdateGroupId
@@ -122,6 +122,14 @@ sap.ui.define([
 					? null
 					: Context.createNewContext(oModel, this, sPath);
 				this.sOperationMode = mParameters.$$operationMode || oModel.sOperationMode;
+				// map<string,sap.ui.model.odata.v4.Context>
+				// Maps a string path to a v4.Context with that path. A context may either be
+				// - an element of this.aContexts (then it knows its index) or
+				// - a value of this.mPreviousContextsByPath.
+				// Contexts which have previously been part of this.aContexts are parked here for
+				// reuse (and thus still remember their index) and get destroyed by
+				// #destroyPreviousContexts after the next call to #createContexts.
+				// A kept-alive context may be parked here for a longer time, with undefined index.
 				this.mPreviousContextsByPath = {};
 				this.aPreviousData = [];
 				this.bSharedRequest = mParameters.$$sharedRequest || oModel.bSharedRequests;
@@ -215,13 +223,18 @@ sap.ui.define([
 	 *   An entity with the ETag of the binding for which the deletion was requested. This is
 	 *   provided if the deletion is delegated from a context binding with empty path to a list
 	 *   binding.
+	 * @param {boolean} [bDoNotRequestCount]
+	 *   Whether not to request the new count from the server; useful in case of
+	 *   {@link sap.ui.model.odata.v4.Context#replaceWith} where it is known that the count remains
+	 *   unchanged
 	 * @returns {Promise}
 	 *   A promise which is resolved without a result in case of success, or rejected with an
 	 *   instance of <code>Error</code> in case of failure.
 	 *
 	 * @private
 	 */
-	ODataListBinding.prototype._delete = function (oGroupLock, sEditUrl, oContext, oETagEntity) {
+	ODataListBinding.prototype._delete = function (oGroupLock, sEditUrl, oContext, oETagEntity,
+			bDoNotRequestCount) {
 		var bDestroy,
 			bFireChange = false,
 			sPath = oContext.iIndex === undefined
@@ -231,7 +244,7 @@ sap.ui.define([
 			bReadCount = false,
 			that = this;
 
-		return this.deleteFromCache(oGroupLock, sEditUrl, sPath, oETagEntity,
+		return this.deleteFromCache(oGroupLock, sEditUrl, sPath, oETagEntity, bDoNotRequestCount,
 			function (iIndex, aEntities) {
 				var sContextPath, sPredicate, sResolvedPath, i$skipIndex, i;
 
@@ -627,6 +640,9 @@ sap.ui.define([
 		if (this.mParameters.$$aggregation) {
 			throw new Error("Unsupported $$aggregation at " + this);
 		}
+		if (this.bSharedRequest) {
+			throw new Error("Unsupported $$sharedRequest at " + this);
+		}
 	};
 
 	/**
@@ -719,22 +735,34 @@ sap.ui.define([
 	 * @param {boolean} [bAtEnd]
 	 *   Whether the entity is inserted at the end of the list. When creating multiple entities,
 	 *   this parameter must have the same value for each entity. Supported since 1.66.0
+	 * @param {boolean} [bInactive]
+	 *   Create an inactive context. Such a context will only be sent to the server after the first
+	 *   property update. From then on it behaves like any other created context. This parameter is
+	 *   experimental and its implementation may still change. Do not use it in productive code yet.
+	 *   Supported since 1.97.0
 	 * @returns {sap.ui.model.odata.v4.Context}
 	 *   The context object for the created entity; its method
 	 *   {@link sap.ui.model.odata.v4.Context#created} returns a promise that is resolved when the
 	 *   creation is finished
 	 * @throws {Error}
-	 *   If the binding's root binding is suspended, if a relative binding is unresolved, if
-	 *   entities are created both at the start and at the end, or if <code>bAtEnd</code> is
-	 *   <code>true</code> and the binding does not know the final length.
-	 *
+	 *   If
+	 *   <ul>
+	 *     <li> the binding's root binding is suspended,
+	 *     <li> a relative binding is unresolved,
+	 *     <li> entities are created both at the start and at the end,
+	 *     <li> <code>bAtEnd</code> is <code>true</code> and the binding does not know the final
+	 *       length,
+	 *     <li> <code>bInactive</code> is <code>true</code> and the update group ID does not have
+	 *       {@link sap.ui.model.odata.v4.SubmitMode.Auto}.
+	 *   </ul>
 	 * @public
 	 * @since 1.43.0
 	 */
-	ODataListBinding.prototype.create = function (oInitialData, bSkipRefresh, bAtEnd) {
+	ODataListBinding.prototype.create = function (oInitialData, bSkipRefresh, bAtEnd, bInactive) {
 		var oContext,
 			oCreatePathPromise = this.fetchResourcePath(),
 			oCreatePromise,
+			sGroupId = this.getUpdateGroupId(),
 			oGroupLock,
 			sResolvedPath = this.getResolvedPath(),
 			sTransientPredicate = "($uid=" + uid() + ")",
@@ -757,8 +785,16 @@ sap.ui.define([
 		}
 		this.bCreatedAtEnd = bAtEnd;
 
+		if (bInactive) {
+			if (!this.oModel.isAutoGroup(sGroupId)) {
+				throw new Error("bInactive only supported for update group with SubmitMode.Auto: "
+					+ this);
+			}
+			sGroupId = "$inactive." + sGroupId;
+		}
+
 		// only for createInCache
-		oGroupLock = this.lockGroup(undefined, true, true, function () {
+		oGroupLock = this.lockGroup(sGroupId, true, true, function () {
 			that.destroyCreated(oContext, true);
 			return Promise.resolve().then(function () {
 				// Fire the change asynchronously so that Cache#delete is finished and #getContexts
@@ -1022,10 +1058,45 @@ sap.ui.define([
 	 * @see sap.ui.model.odata.v4.ODataBinding#doCreateCache
 	 */
 	ODataListBinding.prototype.doCreateCache = function (sResourcePath, mQueryOptions, oContext,
-			sDeepResourcePath) {
-		return _AggregationCache.create(this.oModel.oRequestor, sResourcePath, sDeepResourcePath,
+			sDeepResourcePath, bOldCacheReadOnly, oOldCache) {
+		var sBindingPath,
+			aKeptElementPaths,
+			oCache,
+			that = this;
+
+		if (oOldCache && oOldCache.getResourcePath() === sResourcePath
+				&& oOldCache.$deepResourcePath === sDeepResourcePath) {
+			sBindingPath = this.oHeaderContext.getPath();
+			aKeptElementPaths = Object.keys(this.mPreviousContextsByPath).filter(function (sPath) {
+				return that.mPreviousContextsByPath[sPath].isKeepAlive();
+			});
+
+			if (aKeptElementPaths.length && !bOldCacheReadOnly) {
+				oOldCache.reset(aKeptElementPaths.map(function (sPath) {
+					return _Helper.getRelativePath(sPath, sBindingPath);
+				}));
+				// Note: #inheritQueryOptions as called below should not matter in case of own
+				// requests, which are a precondition for kept-alive elements
+				oOldCache.setQueryOptions(mQueryOptions, true);
+
+				return oOldCache;
+			}
+		}
+
+		oCache = _AggregationCache.create(this.oModel.oRequestor, sResourcePath, sDeepResourcePath,
 			this.mParameters.$$aggregation, this.inheritQueryOptions(mQueryOptions, oContext),
 			this.oModel.bAutoExpandSelect, this.bSharedRequest);
+
+		if (aKeptElementPaths && aKeptElementPaths.length) {
+			oCache.setLateQueryOptions(oOldCache.getLateQueryOptions());
+			aKeptElementPaths.forEach(function (sPath) {
+				oCache.addKeptElement(
+					oOldCache.getValue(_Helper.getRelativePath(sPath, sBindingPath)));
+				that.mPreviousContextsByPath[sPath].checkUpdate(); // add change listeners
+			});
+		}
+
+		return oCache;
 	};
 
 	/**
@@ -1043,6 +1114,59 @@ sap.ui.define([
 		});
 	};
 
+	/**
+	 * Replaces the given old context with a new one for the given element and key predicate,
+	 * placing the new one at the same index and returning it. If a context for the given key
+	 * predicate already exists, it is reused. A newly created context will be kept-alive if the old
+	 * context was, and then it will share the <code>fnOnBeforeDestroy</code> method - but it will
+	 * be called with the new context as first argument.
+	 *
+	 * @param {sap.ui.model.odata.v4.Context} oOldContext - The old context
+	 * @param {object} oElement - The element data
+	 * @param {string} sPredicate - The key predicate
+	 * @returns {sap.ui.model.odata.v4.Context} - The new context
+	 * @throws {Error} If a reused context is already part of the collection (has an index)
+	 *
+	 * @private
+	 */
+	ODataListBinding.prototype.doReplaceWith = function (oOldContext, oElement, sPredicate) {
+		var iIndex = oOldContext.iIndex,
+			bKeepAlive = oOldContext.isKeepAlive(),
+			bNew,
+			fnOnBeforeDestroy = oOldContext.fnOnBeforeDestroy,
+			fnOnBeforeDestroyClone,
+			sPath = this.oHeaderContext.getPath() + sPredicate,
+			oResult = this.mPreviousContextsByPath[sPath];
+
+		if (oResult) {
+			if (oResult.iIndex !== undefined) {
+				throw new Error("Unexpected index: " + oResult);
+			}
+			oResult.iIndex = iIndex;
+			delete this.mPreviousContextsByPath[sPath];
+		} else {
+			oResult = Context.create(this.oModel, this, sPath, iIndex);
+			bNew = true;
+		}
+		oOldContext.iIndex = undefined;
+		this.aContexts[iIndex] = oResult;
+		this.oCache.doReplaceWith(iIndex, oElement);
+		if (bKeepAlive) {
+			this.mPreviousContextsByPath[oOldContext.getPath()] = oOldContext;
+			if (bNew) {
+				if (fnOnBeforeDestroy) {
+					fnOnBeforeDestroyClone
+						= (fnOnBeforeDestroy.$original || fnOnBeforeDestroy).bind(null, oResult);
+					fnOnBeforeDestroyClone.$original = fnOnBeforeDestroy;
+				}
+				oResult.setKeepAlive(true, fnOnBeforeDestroyClone);
+			}
+		}
+		this._fireChange({reason : ChangeReason.Change});
+
+		return oResult;
+	};
+
 	/**
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataParentBinding#doSetProperty
@@ -1107,43 +1231,6 @@ sap.ui.define([
 		});
 	};
 
-	/**
-	 * Creates a cache for this binding if a cache is needed and updates <code>oCachePromise</code>.
-	 * Copies the data for kept-alive contexts and the late query options from the old cache to the
-	 * new one.
-	 *
-	 * @private
-	 */
-	// @override sap.ui.model.odata.v4.ODataBinding#fetchCache
-	ODataListBinding.prototype.fetchCache = function () {
-		var oOldCache = this.oCache,
-			sBindingPath = this.getResolvedPath(),
-			bKeptDataAdded,
-			that = this;
-
-		asODataParentBinding.prototype.fetchCache.apply(this, arguments);
-
-		if (oOldCache) {
-			this.oCachePromise.then(function (oCache) {
-				Object.keys(that.mPreviousContextsByPath).forEach(function (sPath) {
-					var oContext = that.mPreviousContextsByPath[sPath];
-
-					if (oContext.isKeepAlive()) {
-						// either absolute or $$ownRequest === true
-						// ->has own cache, see #checkKeepAlive
-						oCache.addKeptElement(
-							oOldCache.getValue(_Helper.getRelativePath(sPath, sBindingPath)));
-						oContext.checkUpdate(); // add change listeners
-						bKeptDataAdded = true;
-					}
-				});
-				if (bKeptDataAdded) {
-					oCache.setLateQueryOptions(oOldCache.getLateQueryOptions());
-				}
-			}); // no catch; if the new cache can't be created, data for kept-alive contexts is lost
-		}
-	};
-
 	/**
 	 * Fetches the data and creates contexts for the given range.
 	 *
@@ -1499,10 +1586,11 @@ sap.ui.define([
 	};
 
 	/**
-	 * Filters the list with the given filters.
+	 * Filters the list with the given filters. Since 1.97.0, if filters are unchanged, no request
+	 * is sent, regardless of pending changes.
 	 *
-	 * If there are pending changes an error is thrown. Use {@link #hasPendingChanges} to check if
-	 * there are pending changes. If there are changes, call
+	 * If there are pending changes that cannot be ignored, an error is thrown. Use
+	 * {@link #hasPendingChanges} to check if there are such pending changes. If there are, call
 	 * {@link sap.ui.model.odata.v4.ODataModel#submitBatch} to submit the changes or
 	 * {@link sap.ui.model.odata.v4.ODataModel#resetChanges} to reset the changes before calling
 	 * {@link #filter}.
@@ -1543,8 +1631,10 @@ sap.ui.define([
 	 * @returns {this}
 	 *   <code>this</code> to facilitate method chaining
 	 * @throws {Error}
-	 *   If there are pending changes or if an unsupported operation mode is used (see
-	 *   {@link sap.ui.model.odata.v4.ODataModel#bindList})
+	 *   If there are pending changes that cannot be ignored or if an unsupported operation mode is
+	 *   used (see {@link sap.ui.model.odata.v4.ODataModel#bindList}). Since 1.97.0, pending changes
+	 *   are ignored if they relate to a
+	 *   {@link sap.ui.model.odata.v4.Context#setKeepAlive kept-alive} context of this binding.
 	 *
 	 * @public
 	 * @see sap.ui.model.ListBinding#filter
@@ -1553,17 +1643,25 @@ sap.ui.define([
 	 */
 	// @override sap.ui.model.ListBinding#filter
 	ODataListBinding.prototype.filter = function (vFilters, sFilterType) {
+		var aFilters = _Helper.toArray(vFilters);
+
 		if (this.sOperationMode !== OperationMode.Server) {
 			throw new Error("Operation mode has to be sap.ui.model.odata.OperationMode.Server");
 		}
-		if (this.hasPendingChanges()) {
+
+		if (sFilterType === FilterType.Control && _Helper.deepEqual(aFilters, this.aFilters)
+				|| _Helper.deepEqual(aFilters, this.aApplicationFilters)) {
+			return this;
+		}
+
+		if (this.hasPendingChanges(true)) {
 			throw new Error("Cannot filter due to pending changes");
 		}
 
 		if (sFilterType === FilterType.Control) {
-			this.aFilters = _Helper.toArray(vFilters);
+			this.aFilters = aFilters;
 		} else {
-			this.aApplicationFilters = _Helper.toArray(vFilters);
+			this.aApplicationFilters = aFilters;
 		}
 
 		if (this.isRootBindingSuspended()) {
@@ -1690,7 +1788,7 @@ sap.ui.define([
 							detailedReason : "RemoveVirtualContext",
 							reason : ChangeReason.Change
 						});
-						that.reset(ChangeReason.Refresh);
+						that.reset(ChangeReason.Refresh, true);
 					}
 					oVirtualContext.destroy();
 				});
@@ -2298,7 +2396,8 @@ sap.ui.define([
 		}
 
 		// add the context binding's query options as late query options
-		if (!this.aggregateQueryOptions(mEntityQueryOptions, "", /*bImmutable*/true)) {
+		if (!this.aggregateQueryOptions(mEntityQueryOptions, _Helper.getMetaPath(sEntityPath),
+				/*bImmutable*/true)) {
 			throw new Error(oEntityContext + ": could not move the entity. Probably a list binding"
 				+ " w/o $$ownRequest depends on it");
 		}
@@ -2357,9 +2456,13 @@ sap.ui.define([
 
 			if (oCache && !oPromise) { // do not refresh twice
 				that.removeCachesAndMessages(sResourcePathPrefix);
-				that.fetchCache(that.oContext, false, /*bKeepQueryOptions*/true);
+				that.fetchCache(that.oContext, false, /*bKeepQueryOptions*/true, bKeepCacheOnError);
 				oKeptElementsPromise = that.oCachePromise.then(function (oNewCache) {
 					return oNewCache.refreshKeptElements(that.lockGroup(sGroupId), onRemove);
+				}).catch(function (oError) {
+					that.oModel.reportError("Failed to refresh kept-alive elements", sClassName,
+						oError);
+					throw oError;
 				});
 				if (that.iCurrentEnd > 0) {
 					oPromise = that.createRefreshPromise().catch(function (oError) {
@@ -2772,23 +2875,29 @@ sap.ui.define([
 	 *   A change reason; if given, a refresh event with this reason is fired and the next
 	 *   getContexts() fires a change event with this reason. Change reason "change" is ignored
 	 *   as long as the binding is still empty.
+	 * @param {boolean} [bKeepCreated]
+	 *   Whether created contexts shall remain in aContexts
 	 *
 	 * @private
 	 */
-	ODataListBinding.prototype.reset = function (sChangeReason) {
+	ODataListBinding.prototype.reset = function (sChangeReason, bKeepCreated) {
 		var bEmpty = this.iCurrentEnd === 0,
 			that = this;
 
+		if (!bKeepCreated) {
+			this.iCreatedContexts = 0; // number of (client-side) created contexts in aContexts
+			// true if contexts have been created at the end, false if contexts have been created at
+			// the start, undefined if there are no created contexts
+			this.bCreatedAtEnd = undefined;
+		}
 		if (this.aContexts) { // allow initial call from c'tor via #applyParameters
-			this.aContexts.forEach(function (oContext) {
+			this.aContexts.slice(this.iCreatedContexts).forEach(function (oContext) {
 				that.mPreviousContextsByPath[oContext.getPath()] = oContext;
 			});
+			this.aContexts.length = this.iCreatedContexts;
+		} else {
+			this.aContexts = [];
 		}
-		this.aContexts = [];
-		this.iCreatedContexts = 0; // number of (client-side) created contexts in aContexts
-		// true if contexts have been created at the end, false if contexts have been created at the
-		// start, undefined if there are no created contexts
-		this.bCreatedAtEnd = undefined;
 		// the range of array indices for getCurrentContexts
 		this.iCurrentBegin = this.iCurrentEnd = 0;
 		// upper boundary for server-side list length (based on observations so far)
@@ -2846,7 +2955,8 @@ sap.ui.define([
 		aBindings.forEach(function (oDependentBinding) {
 			// do not call checkUpdate in dependent property bindings if the cache of this
 			// binding is reset and the binding has not yet fired a change event
-			oDependentBinding.resumeInternal(!bRefresh, !!sResumeChangeReason);
+			oDependentBinding.resumeInternal(!bRefresh,
+				!!sResumeChangeReason && !oDependentBinding.oContext.isKeepAlive());
 		});
 		if (this.sChangeReason === "AddVirtualContext") {
 			// In a refresh event the table would ignore the result -> no virtual context -> no
@@ -2931,10 +3041,13 @@ sap.ui.define([
 	 *   separate row after all children, when a group level node is expanded (since 1.86.0);
 	 *   <code>true</code> for bottom only, <code>false</code> for top and bottom, the default is
 	 *   top only (that is, as part of the group level node)
-	 * @throws {Error}
-	 *   If the given data aggregation object is unsupported, if the system query option
-	 *   <code>$apply</code> has been specified explicitly before, or if there are pending changes
-	 *
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> the given data aggregation object is unsupported,
+	 *     <li> the <code>$apply</code> system query option has been specified explicitly before,
+	 *     <li> the binding has a kept-alive context,
+	 *     <li> there are pending changes
+	 *   </ul>
 	 * @example <caption>First group level is product category including subtotals for the net
 	 *     amount in display currency. On leaf level, transaction currency is used as an additional
 	 *     dimension and the net amount is averaged.</caption>
@@ -2960,9 +3073,19 @@ sap.ui.define([
 	ODataListBinding.prototype.setAggregation = function (oAggregation) {
 		var mParameters;
 
+		function hasKeptAliveContext(aContexts) {
+			return aContexts.some(function (oContext) {
+				return oContext && oContext.isKeepAlive();
+			});
+		}
+
 		if (this.hasPendingChanges()) {
 			throw new Error("Cannot set $$aggregation due to pending changes");
 		}
+		if (hasKeptAliveContext(this.aContexts)
+				|| hasKeptAliveContext(Object.values(this.mPreviousContextsByPath))) {
+			throw new Error("Cannot set $$aggregation due to a kept-alive context");
+		}
 
 		mParameters = Object.assign({}, this.mParameters);
 		if (oAggregation === undefined) {
@@ -3048,10 +3171,11 @@ sap.ui.define([
 	/**
 	 * Sort the entries represented by this list binding according to the given sorters.
 	 * The sorters are stored at this list binding and they are used for each following data
-	 * request.
+	 * request. Since 1.97.0, if sorters are unchanged, no request is sent, regardless of pending
+	 * changes.
 	 *
-	 * If there are pending changes an error is thrown. Use {@link #hasPendingChanges} to check if
-	 * there are pending changes. If there are changes, call
+	 * If there are pending changes that cannot be ignored, an error is thrown. Use
+	 * {@link #hasPendingChanges} to check if there are such pending changes. If there are, call
 	 * {@link sap.ui.model.odata.v4.ODataModel#submitBatch} to submit the changes or
 	 * {@link sap.ui.model.odata.v4.ODataModel#resetChanges} to reset the changes before calling
 	 * {@link #sort}.
@@ -3064,8 +3188,10 @@ sap.ui.define([
 	 * @returns {this}
 	 *   <code>this</code> to facilitate method chaining
 	 * @throws {Error}
-	 *   If there are pending changes or if an unsupported operation mode is used (see
-	 *   {@link sap.ui.model.odata.v4.ODataModel#bindList}).
+	 *   If there are pending changes that cannot be ignored or if an unsupported operation mode is
+	 *   used (see {@link sap.ui.model.odata.v4.ODataModel#bindList}). Since 1.97.0, pending changes
+	 *   are ignored if they relate to a
+	 *   {@link sap.ui.model.odata.v4.Context#setKeepAlive kept-alive} context of this binding.
 	 *
 	 * @public
 	 * @see sap.ui.model.ListBinding#sort
@@ -3073,14 +3199,21 @@ sap.ui.define([
 	 */
 	// @override sap.ui.model.ListBinding#sort
 	ODataListBinding.prototype.sort = function (vSorters) {
+		var aSorters = _Helper.toArray(vSorters);
+
 		if (this.sOperationMode !== OperationMode.Server) {
 			throw new Error("Operation mode has to be sap.ui.model.odata.OperationMode.Server");
 		}
-		if (this.hasPendingChanges()) {
+
+		if (_Helper.deepEqual(aSorters, this.aSorters)) {
+			return this;
+		}
+
+		if (this.hasPendingChanges(true)) {
 			throw new Error("Cannot sort due to pending changes");
 		}
 
-		this.aSorters = _Helper.toArray(vSorters);
+		this.aSorters = aSorters;
 
 		if (this.isRootBindingSuspended()) {
 			this.setResumeChangeReason(ChangeReason.Sort);

package/src/sap/ui/model/odata/v4/ODataMetaModel.js

@@ -658,7 +658,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var ODataMetaModel = MetaModel.extend("sap.ui.model.odata.v4.ODataMetaModel", {
 		/*

package/src/sap/ui/model/odata/v4/ODataModel.js

@@ -210,7 +210,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.Model
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var ODataModel = Model.extend("sap.ui.model.odata.v4.ODataModel",
 			/** @lends sap.ui.model.odata.v4.ODataModel.prototype */
@@ -1184,6 +1184,7 @@ sap.ui.define([
 	 *
 	 * @private
 	 */
+	// eslint-disable-next-line valid-jsdoc -- .@$ui5. is not understood properly
 	ODataModel.prototype.createUI5Message = function (oRawMessage, sResourcePath, sCachePath) {
 		var bIsBound = typeof oRawMessage.target === "string",
 			sMessageLongtextUrl = oRawMessage.longtextUrl,

package/src/sap/ui/model/odata/v4/ODataParentBinding.js

@@ -299,8 +299,8 @@ sap.ui.define([
 	/**
 	 * Changes this binding's parameters and refreshes the binding.
 	 *
-	 * If there are pending changes an error is thrown. Use {@link #hasPendingChanges} to check if
-	 * there are pending changes. If there are changes, call
+	 * If there are pending changes that cannot be ignored, an error is thrown. Use
+	 * {@link #hasPendingChanges} to check if there are such pending changes. If there are, call
 	 * {@link sap.ui.model.odata.v4.ODataModel#submitBatch} to submit the changes or
 	 * {@link sap.ui.model.odata.v4.ODataModel#resetChanges} to reset the changes before calling
 	 * {@link #changeParameters}.
@@ -313,12 +313,14 @@ sap.ui.define([
 	 *   Map of binding parameters, see {@link sap.ui.model.odata.v4.ODataModel#bindList} and
 	 *   {@link sap.ui.model.odata.v4.ODataModel#bindContext}
 	 * @throws {Error}
-	 *   If there are pending changes or if <code>mParameters</code> is missing, contains
-	 *   binding-specific or unsupported parameters, contains unsupported values, or contains the
-	 *   property "$expand" or "$select" when the model is in auto-$expand/$select mode.
-	 *   Since 1.90.0, binding-specific parameters are ignored if they are unchanged. Since 1.93.0,
-	 *   string values for "$expand" and "$select" are ignored if they are unchanged; pending
-	 *   changes are ignored if all parameters are unchanged.
+	 *   If there are pending changes that cannot be ignored or if <code>mParameters</code> is
+	 *   missing, contains binding-specific or unsupported parameters, contains unsupported values,
+	 *   or contains the property "$expand" or "$select" when the model is in auto-$expand/$select
+	 *   mode. Since 1.90.0, binding-specific parameters are ignored if they are unchanged. Since
+	 *   1.93.0, string values for "$expand" and "$select" are ignored if they are unchanged;
+	 *   pending changes are ignored if all parameters are unchanged. Since 1.97.0, pending changes
+	 *   are ignored if they relate to a
+	 *   {@link sap.ui.model.odata.v4.Context#setKeepAlive kept-alive} context of this binding.
 	 *
 	 * @public
 	 * @since 1.45.0
@@ -384,7 +386,7 @@ sap.ui.define([
 		}
 
 		if (sChangeReason) {
-			if (this.hasPendingChanges()) {
+			if (this.hasPendingChanges(true)) {
 				throw new Error("Cannot change parameters due to pending changes");
 			}
 			this.applyParameters(mBindingParameters, sChangeReason);
@@ -456,7 +458,7 @@ sap.ui.define([
 	 *   The absolute path to the collection in the cache where to create the entity
 	 * @param {string} sTransientPredicate
 	 *   A (temporary) key predicate for the transient entity: "($uid=...)"
-	 * @param {object} oInitialData
+	 * @param {object} [oInitialData={}]
 	 *   The initial data for the created entity
 	 * @param {function} fnErrorCallback
 	 *   A function which is called with an error object each time a POST request for the create
@@ -574,6 +576,10 @@ sap.ui.define([
 	 *   An entity with the ETag of the binding for which the deletion was requested. This is
 	 *   provided if the deletion is delegated from a context binding with empty path to a list
 	 *   binding.
+	 * @param {boolean} [bDoNotRequestCount]
+	 *   Whether not to request the new count from the server; useful in case of
+	 *   {@link sap.ui.model.odata.v4.Context#replaceWith} where it is known that the count remains
+	 *   unchanged
 	 * @param {function} fnCallback
 	 *   A function which is called after the entity has been deleted from the server and from the
 	 *   cache; the index of the entity is passed as parameter
@@ -587,7 +593,7 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataParentBinding.prototype.deleteFromCache = function (oGroupLock, sEditUrl, sPath,
-			oETagEntity, fnCallback) {
+			oETagEntity, bDoNotRequestCount, fnCallback) {
 		var sGroupId;
 
 		if (this.oCache === undefined) {
@@ -599,10 +605,12 @@ sap.ui.define([
 			if (!this.oModel.isAutoGroup(sGroupId) && !this.oModel.isDirectGroup(sGroupId)) {
 				throw new Error("Illegal update group ID: " + sGroupId);
 			}
-			return this.oCache._delete(oGroupLock, sEditUrl, sPath, oETagEntity, fnCallback);
+			return this.oCache._delete(oGroupLock, sEditUrl, sPath, oETagEntity, bDoNotRequestCount,
+				fnCallback);
 		}
 		return this.oContext.getBinding().deleteFromCache(oGroupLock, sEditUrl,
-			_Helper.buildPath(this.oContext.iIndex, this.sPath, sPath), oETagEntity, fnCallback);
+			_Helper.buildPath(this.oContext.iIndex, this.sPath, sPath), oETagEntity,
+			bDoNotRequestCount, fnCallback);
 	};
 
 	/**
@@ -992,13 +1000,14 @@ sap.ui.define([
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataBinding#hasPendingChangesInDependents
 	 */
-	ODataParentBinding.prototype.hasPendingChangesInDependents = function () {
-		var aDependents = this.getDependentBindings();
-
-		return aDependents.some(function (oDependent) {
+	ODataParentBinding.prototype.hasPendingChangesInDependents = function (bIgnoreKeptAlive) {
+		return this.getDependentBindings().some(function (oDependent) {
 			var oCache = oDependent.oCache,
 				bHasPendingChanges;
 
+			if (bIgnoreKeptAlive && oDependent.oContext.isKeepAlive()) {
+				return false;
+			}
 			if (oCache !== undefined) {
 				// Pending changes for this cache are only possible when there is a cache already
 				if (oCache && oCache.hasPendingChangesForPath("")) {
@@ -1010,7 +1019,10 @@ sap.ui.define([
 			if (oDependent.mCacheByResourcePath) {
 				bHasPendingChanges = Object.keys(oDependent.mCacheByResourcePath)
 					.some(function (sPath) {
-						return oDependent.mCacheByResourcePath[sPath].hasPendingChangesForPath("");
+						var oCacheForPath = oDependent.mCacheByResourcePath[sPath];
+
+						return oCacheForPath !== oCache // don't ask again
+							&& oCacheForPath.hasPendingChangesForPath("");
 					});
 				if (bHasPendingChanges) {
 					return true;
@@ -1322,8 +1334,10 @@ sap.ui.define([
 
 	/**
 	 * Suspends this binding. A suspended binding does not fire change events nor does it trigger
-	 * data service requests. Call {@link #resume} to resume the binding.
-	 * Before 1.53.0, this method was not supported and threw an error.
+	 * data service requests. Call {@link #resume} to resume the binding. Before 1.53.0, this method
+	 * was not supported and threw an error. Since 1.97.0, pending changes are ignored if they
+	 * relate to a {@link sap.ui.model.odata.v4.Context#setKeepAlive kept-alive} context of this
+	 * binding.
 	 *
 	 * @throws {Error}
 	 *   If this binding
@@ -1331,7 +1345,7 @@ sap.ui.define([
 	 *   <li>is relative to a {@link sap.ui.model.odata.v4.Context},</li>
 	 *   <li>is an operation binding,</li>
 	 *   <li>has {@link sap.ui.model.Binding#isSuspended} set to <code>true</code>,</li>
-	 *   <li>has pending changes,</li>
+	 *   <li>has pending changes that cannot be ignored,</li>
 	 *   <li>is not a root binding. Use {@link #getRootBinding} to determine the root binding.</li>
 	 *   </ul>
 	 *
@@ -1356,7 +1370,7 @@ sap.ui.define([
 		if (this.bSuspended) {
 			throw new Error("Cannot suspend a suspended binding: " + this);
 		}
-		if (this.hasPendingChanges()) {
+		if (this.hasPendingChanges(true)) {
 			throw new Error("Cannot suspend a binding with pending changes: " + this);
 		}
 
@@ -1445,7 +1459,6 @@ sap.ui.define([
 		"adjustPredicate",
 		"destroy",
 		"doDeregisterChangeListener",
-		"fetchCache",
 		"getGeneration",
 		"hasPendingChangesForPath"
 	].forEach(function (sMethod) { // method (still) not final, allow for "super" calls