@openui5/sap.ui.core 1.112.0 → 1.113.0

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

@@ -57,7 +57,7 @@ sap.ui.define([
 		 * @mixes sap.ui.model.odata.v4.ODataParentBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.112.0
+		 * @version 1.113.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
@@ -126,7 +126,9 @@ sap.ui.define([
 		// BEWARE: #doReplaceWith can insert a context w/ negative index, but w/o #created promise
 		// into aContexts' area of "created contexts"!
 		this.iCreatedContexts = 0; // number of (client-side) created contexts in aContexts
-		this.bDeepCreate = false; // Whether the binding is within a deep create
+		// Whether the binding is a nested binding within a deep create; it is true while using the
+		// parent cache so that it can contribute to the POST request (see #prepareDeepCreate)
+		this.bDeepCreate = false;
 		this.iDeletedContexts = 0; // number of (client-side) deleted contexts
 		this.oDiff = undefined;
 		this.aFilters = [];
@@ -135,7 +137,6 @@ sap.ui.define([
 		this.oHeaderContext = this.bRelative
 			? null
 			: Context.createNewContext(oModel, this, sPath);
-		this.bKeepCreated = false; // Whether the next createContexts shall keep created contexts
 		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
@@ -624,7 +625,7 @@ sap.ui.define([
 		if (oContext === this.oHeaderContext) {
 			throw new Error("Unsupported header context " + oContext);
 		}
-		if (this.mParameters.$$aggregation) {
+		if (_Helper.isDataAggregation(this.mParameters)) {
 			throw new Error("Unsupported $$aggregation at " + this);
 		}
 		if (this.bSharedRequest) {
@@ -714,7 +715,17 @@ sap.ui.define([
 	 * method then adds a transient entity to the parent's navigation property, which is sent with
 	 * the payload of the parent entity. Such a nested context also has a
 	 * {@link sap.ui.model.odata.v4.Context#created created} promise, which resolves when the deep
-	 * create resolves. Deep create is an <b>experimental</b> API.
+	 * create resolves. <b>Beware:</b> After a succesful creation of the main entity the context
+	 * returned for a nested entity is no longer valid. New contexts are created for the nested
+	 * collection because it is not possible to reliably assign the response entities to those of
+	 * the request, especially if the count differs.
+	 *
+	 * Deep create requires the <code>autoExpandSelect<code> parameter at the
+	 * {@link sap.ui.model.odata.v4.ODataModel#constructor model}. The refresh after a deep create
+	 * is optimized. Only the (navigation) properties missing from the POST response are actually
+	 * requested. If the POST response contains all required properties, no request is sent at all.
+	 *
+	 * Deep create is an <b>experimental</b> API.
 	 *
 	 * Note: Creating at the end is only allowed if the final length of the binding is known (see
 	 * {@link #isLengthFinal}), so that there is a clear position to place this entity at. This is
@@ -828,8 +839,11 @@ sap.ui.define([
 				that.fireEvent("createSent", {context : oContext});
 			}
 		).then(function (oCreatedEntity) { // the entity was created on the server
-			var sGroupId, sPredicate;
+			var bDeepCreate, sGroupId, sPredicate;
 
+			if (that.isTransient()) {
+				return;
+			}
 			if (!(oInitialData && oInitialData["@$ui5.keepTransientPath"])) {
 				// refreshSingle requires the new key predicate in oContext.getPath()
 				sPredicate = _Helper.getPrivateAnnotation(oCreatedEntity, "predicate");
@@ -838,20 +852,17 @@ sap.ui.define([
 					that.oModel.checkMessages();
 				}
 			}
-			if (that.isTransient()) {
-				return;
-			}
 			that.fireEvent("createCompleted", {context : oContext, success : true});
+			bDeepCreate = _Helper.getPrivateAnnotation(oCreatedEntity, "deepCreate");
+			_Helper.deletePrivateAnnotation(oCreatedEntity, "deepCreate");
 			sGroupId = that.getGroupId();
-			if (bSkipRefresh) {
-				oContext.updateAfterCreate();
-				return; // do not wait for late property requests to be finished!
-			}
 			if (that.oModel.isApiGroup(sGroupId)) {
 				sGroupId = "$auto";
 			}
-
-			return that.refreshSingle(oContext, that.lockGroup(sGroupId));
+			// currently the optimized update w/o bSkipRefresh is restricted to deep create
+			return bSkipRefresh || bDeepCreate
+				? oContext.updateAfterCreate(bSkipRefresh, sGroupId)
+				: that.refreshSingle(oContext, that.lockGroup(sGroupId));
 		}, function (oError) {
 			oGroupLock.unlock(true); // createInCache failed, so the lock might still be blocking
 			throw oError;
@@ -940,17 +951,11 @@ sap.ui.define([
 				sPredicate = _Helper.getPrivateAnnotation(aResults[i], "predicate");
 				sContextPath = sPath + (sPredicate || "/" + i$skipIndex);
 				oContext = this.mPreviousContextsByPath[sContextPath];
-				if (oContext
-						&& (that.bKeepCreated || !oContext.created() || oContext.isKeepAlive())) {
+				if (oContext && (!oContext.created() || oContext.isKeepAlive())) {
 					// reuse the previous context, unless it is created (and persisted), but not
 					// kept alive
 					delete this.mPreviousContextsByPath[sContextPath];
-					if (that.bKeepCreated) {
-						this.iCreatedContexts += 1;
-						this.iActiveContexts += 1;
-					} else {
-						oContext.iIndex = i$skipIndex;
-					}
+					oContext.iIndex = i$skipIndex;
 					oContext.checkUpdate();
 				} else {
 					oContext = Context.create(oModel, this, sContextPath, i$skipIndex);
@@ -958,7 +963,6 @@ sap.ui.define([
 				this.aContexts[iStart + i] = oContext;
 			}
 		}
-		that.bKeepCreated = false;
 		// destroy previous contexts which are not reused or kept-alive
 		this.destroyPreviousContextsLater(Object.keys(this.mPreviousContextsByPath));
 		if (iCount !== undefined) { // server count is available or "non-empty short read"
@@ -1194,28 +1198,42 @@ sap.ui.define([
 	ODataListBinding.prototype.doCreateCache = function (sResourcePath, mQueryOptions, oContext,
 			sDeepResourcePath, sGroupId, oOldCache) {
 		var oCache,
-			aKeepAlivePredicates;
+			aKeepAlivePredicates,
+			mKeptElementsByPredicate;
 
 		if (oOldCache && oOldCache.getResourcePath() === sResourcePath
 				&& oOldCache.$deepResourcePath === sDeepResourcePath) {
 			aKeepAlivePredicates = this.getKeepAlivePredicates();
 			if (this.iCreatedContexts || this.iDeletedContexts || aKeepAlivePredicates.length) {
-				oOldCache.reset(aKeepAlivePredicates, sGroupId);
 				// 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);
+				oOldCache.reset(aKeepAlivePredicates, sGroupId, mQueryOptions,
+					this.mParameters.$$aggregation, this.isGrouped());
 
 				return oOldCache;
 			}
 		}
 
 		mQueryOptions = this.inheritQueryOptions(mQueryOptions, oContext);
-
-		oCache = this.getCacheAndMoveKeepAliveContexts(sResourcePath, mQueryOptions)
+		oCache = this.getCacheAndMoveKeepAliveContexts(sResourcePath, mQueryOptions);
+		if (oCache && this.mParameters.$$aggregation) {
+			mKeptElementsByPredicate = {};
+			aKeepAlivePredicates = this.getKeepAlivePredicates();
+			aKeepAlivePredicates.forEach(function (sPredicate) {
+				mKeptElementsByPredicate[sPredicate] = oCache.getValue(sPredicate);
+			});
+			oCache.setActive(false);
+			oCache = undefined; // create _AggregationCache instead of _CollectionCache
+		}
+		oCache = oCache
 			|| _AggregationCache.create(this.oModel.oRequestor, sResourcePath, sDeepResourcePath,
-				this.mParameters.$$aggregation, mQueryOptions, this.oModel.bAutoExpandSelect,
+				mQueryOptions, this.mParameters.$$aggregation, this.oModel.bAutoExpandSelect,
 				this.bSharedRequest, this.isGrouped());
-		if (this.bSharedRequest) {
+		if (mKeptElementsByPredicate) {
+			aKeepAlivePredicates.forEach(function (sPredicate) {
+				oCache.addKeptElement(mKeptElementsByPredicate[sPredicate]);
+			});
+		} else if (this.bSharedRequest) {
 			oCache.registerChangeListener("", this);
 		}
 
@@ -1490,13 +1508,15 @@ sap.ui.define([
 	 * @returns {sap.ui.base.SyncPromise<string>}
 	 *   A promise that is resolved with the download URL.
 	 * @throws {Error}
-	 *   If the binding is unresolved
+	 *   If the binding is unresolved or is {@link #isTransient transient} (part of a
+	 *   {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}),
 	 *
 	 * @private
 	 */
 	ODataListBinding.prototype.fetchDownloadUrl = function () {
 		var mUriParameters = this.oModel.mUriParameters;
 
+		this.checkTransient();
 		if (!this.isResolved()) {
 			throw new Error("Binding is unresolved");
 		}
@@ -1790,10 +1810,14 @@ sap.ui.define([
 	 *   The filter type to be used
 	 * @returns {this}
 	 *   <code>this</code> to facilitate method chaining
-	 * @throws {Error}
-	 *   If there are pending changes that cannot be ignored or an unsupported operation mode is
-	 *   used (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
-	 *   <br>
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> there are pending changes that cannot be ignored,
+	 *     <li> the binding is {@link #isTransient transient} (part of a
+	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}),
+	 *     <li> an unsupported operation mode is used (see
+	 *       {@link sap.ui.model.odata.v4.ODataModel#bindList}).
+	 *   </ul>
 	 *   The following pending changes are ignored:
 	 *   <ul>
 	 *     <li> changes relating to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive}
@@ -1812,6 +1836,7 @@ sap.ui.define([
 	ODataListBinding.prototype.filter = function (vFilters, sFilterType) {
 		var aFilters = _Helper.toArray(vFilters);
 
+		this.checkTransient();
 		if (this.sOperationMode !== OperationMode.Server) {
 			throw new Error("Operation mode has to be sap.ui.model.odata.OperationMode.Server");
 		}
@@ -1888,8 +1913,9 @@ sap.ui.define([
 	 *     <li> "$NodeProperty" holds the path to the property which provides the hierarchy node
 	 *       value. That property is always $select'ed automatically and can be accessed as usual.
 	 *   </ul>
-	 * @returns {object}
-	 *   The current data aggregation object, incl. some default values
+	 * @returns {object|undefined}
+	 *   The current data aggregation object, incl. some default values, or <code>undefined</code>
+	 *   if there is no data aggregation
 	 *
 	 * @public
 	 * @since 1.109.0
@@ -2512,7 +2538,9 @@ sap.ui.define([
 	 *     <li> the binding is unresolved,
 	 *     <li> the given context path does not match this binding,
 	 *     <li> the binding's root binding is suspended,
-	 *     <li> or {@link sap.ui.model.odata.v4.Context#setKeepAlive} fails
+	 *     <li> the binding is {@link #isTransient transient} (part of a
+	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}).
+	 *     <li> {@link sap.ui.model.odata.v4.Context#setKeepAlive} fails
 	 *   </ul>
 	 *
 	 * @public
@@ -2527,7 +2555,9 @@ sap.ui.define([
 			iPredicateIndex = _Helper.getPredicateIndex(sPath),
 			sResolvedPath = this.getResolvedPath();
 
+		this.checkKeepAlive();
 		this.checkSuspended();
+		this.checkTransient();
 		_Helper.checkGroupId(sGroupId);
 		if (!oContext) {
 			if (!sResolvedPath) {
@@ -2540,8 +2570,10 @@ sap.ui.define([
 			this.mPreviousContextsByPath[sPath] = oContext;
 			this.oCachePromise.then(function (oCache) {
 				// call ASAP so that dependent property bindings find the entity in the cache
-				var oElement = oCache.createEmptyElement(sPath.slice(iPredicateIndex));
+				var oElement = {};
 
+				_Helper.setPrivateAnnotation(oElement, "predicate", sPath.slice(iPredicateIndex));
+				oCache.addKeptElement(oElement);
 				if (sGroupId) {
 					_Helper.setPrivateAnnotation(oElement, "groupId", sGroupId);
 				}
@@ -2570,7 +2602,12 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataListBinding.prototype.getKeepAlivePredicates = function () {
-		var sBindingPath = this.getHeaderContext().getPath();
+		var sBindingPath;
+
+		if (!this.getHeaderContext()) {
+			return [];
+		}
+		sBindingPath = this.getHeaderContext().getPath();
 
 		return Object.values(this.mPreviousContextsByPath).concat(this.aContexts)
 			.filter(function (oContext) {
@@ -2879,8 +2916,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * Prepares the binding for a deep create if there is a transient parent context. Adds a
-	 * transient collection to the parent binding's cache.
+	 * Prepares the nested binding for a deep create if there is a transient parent context. Adds a
+	 * transient collection to the parent binding's cache. Creates contexts for nested entities in
+	 * the initial data.
 	 *
 	 * @param {sap.ui.model.odata.v4.Context} [oContext]
 	 *   The parent context or <code>undefined</code> for absolute bindings
@@ -2893,8 +2931,11 @@ sap.ui.define([
 	 */
 	// @override sap.ui.model.odata.v4.ODataBinding#prepareDeepCreate
 	ODataListBinding.prototype.prepareDeepCreate = function (oContext, mQueryOptions) {
+		var that = this;
+
 		if (!(oContext && oContext.isTransient && oContext.isTransient()) || this.bDeepCreate) {
 			// only relevant if the context is transient and the binding is not in deep create yet
+			this.bDeepCreate = false;
 			return false;
 		}
 
@@ -2904,8 +2945,27 @@ sap.ui.define([
 		// (in adjustPredicate)
 		this.mCacheQueryOptions = mQueryOptions;
 		oContext.withCache(function (oCache, sPath) {
-			oCache.addTransientCollection(sPath, mQueryOptions && mQueryOptions.$select);
-		}, this.sPath);
+				return oCache.addTransientCollection(sPath, mQueryOptions && mQueryOptions.$select);
+			}, this.sPath
+		).then(function (aInitialDataCollection) {
+			var sResolvedPath = that.getResolvedPath();
+
+			aInitialDataCollection.forEach(function (oInitialData, i) {
+				var oContext,
+					sTransientPredicate
+						= _Helper.getPrivateAnnotation(oInitialData, "transientPredicate"),
+					oPromise = _Helper.getPrivateAnnotation(oInitialData, "promise");
+
+				oContext = Context.create(that.oModel, that, sResolvedPath + sTransientPredicate,
+					i - aInitialDataCollection.length, oPromise, false, true);
+				oContext.created().catch(function () { /* avoid "Uncaught (in promise) */ });
+
+				_Helper.setPrivateAnnotation(oInitialData, "context", oContext);
+				_Helper.setPrivateAnnotation(oInitialData, "firstCreateAtEnd", false);
+				_Helper.deletePrivateAnnotation(oInitialData, "promise");
+			});
+			// The binding gets these contexts via restoreCreated later
+		});
 
 		return true;
 	};
@@ -3006,8 +3066,6 @@ sap.ui.define([
 			aDependentBindings = that.getDependentBindings();
 			that.reset(ChangeReason.Refresh, !oCache || (bKeepCacheOnError ? false : undefined),
 				sGroupId); // this may reset that.oRefreshPromise
-			that.bKeepCreated = that.bDeepCreate;
-			that.bDeepCreate = false;
 			return SyncPromise.all(
 				refreshAll(aDependentBindings).concat(oPromise, oKeptElementsPromise)
 			).then(function () {
@@ -3327,6 +3385,9 @@ sap.ui.define([
 	 *   A Promise that resolves with an {@link sap.ui.model.Filter} representing the entries with
 	 *   messages; it resolves with <code>null</code> if the binding is not resolved or if there is
 	 *   no message for any entry
+	 * @throws {Error}
+	 *   If the binding is {@link #isTransient transient} (part of a
+	 *   {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}).
 	 *
 	 * @protected
 	 * @see sap.ui.model.ListBinding#requestFilterForMessages
@@ -3339,6 +3400,7 @@ sap.ui.define([
 			sResolvedPath = this.oHeaderContext && this.oHeaderContext.getPath(),
 			that = this;
 
+		this.checkTransient();
 		if (!sResolvedPath) {
 			return Promise.resolve(null);
 		}
@@ -3732,10 +3794,13 @@ sap.ui.define([
 	 *     <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 {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive}
-	 *       context,
+	 *       context when switching the use case of data aggregation (recursive hierarchy, pure data
+	 *       aggregation, or none at all),
 	 *     <li> there are pending changes,
 	 *     <li> a recursive hierarchy is requested, but the model does not use the
-	 *       <code>autoExpandSelect</code> parameter.
+	 *       <code>autoExpandSelect</code> parameter,
+	 *     <li> the binding is {@link #isTransient transient} (part of a
+	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}),
 	 *   </ul>
 	 *
 	 * @example <caption>First group level is product category including subtotals for the net
@@ -3764,17 +3829,25 @@ sap.ui.define([
 	ODataListBinding.prototype.setAggregation = function (oAggregation) {
 		var mParameters;
 
-		function hasKeptAliveContext(aContexts) {
-			return aContexts.some(function (oContext) {
-				return oContext && oContext.isKeepAlive();
-			});
+		/*
+		 * Returns the use case of data aggregation (recursive hierarchy, pure data aggregation, or
+		 * none at all) as <code>true</code>, <code>false</code>, or <code>undefined</code>.
+		 *
+		 * @param {object} [oAggregation]
+		 *   An object holding the information needed for data aggregation
+		 * @returns {boolean|undefined}
+		 *   The use case of data aggregation
+		 */
+		function useCase(oDataAggregationObject) {
+			return oDataAggregationObject && !!oDataAggregationObject.hierarchyQualifier;
 		}
 
+		this.checkTransient();
 		if (this.hasPendingChanges()) {
 			throw new Error("Cannot set $$aggregation due to pending changes");
 		}
-		if (hasKeptAliveContext(this.aContexts)
-				|| hasKeptAliveContext(Object.values(this.mPreviousContextsByPath))) {
+		if (useCase(this.mParameters.$$aggregation) !== useCase(oAggregation)
+				&& this.getKeepAlivePredicates().length) {
 			throw new Error("Cannot set $$aggregation due to a kept-alive context");
 		}
 
@@ -3783,7 +3856,6 @@ sap.ui.define([
 			delete mParameters.$$aggregation;
 		} else {
 			mParameters.$$aggregation = _Helper.clone(oAggregation);
-			this.resetKeepAlive();
 		}
 		this.applyParameters(mParameters, "");
 	};
@@ -3876,9 +3948,14 @@ sap.ui.define([
 	 * @returns {this}
 	 *   <code>this</code> to facilitate method chaining
 	 * @throws {Error}
-	 *   If there are pending changes that cannot be ignored or an unsupported operation mode is
-	 *   used (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
-	 *   <br>
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> there are pending changes that cannot be ignored,
+	 *     <li> the binding is {@link #isTransient transient} (part of a
+	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}),
+	 *     <li> an unsupported operation mode is used (see
+	 *       {@link sap.ui.model.odata.v4.ODataModel#bindList}).
+	 *   </ul>
 	 *   The following pending changes are ignored:
 	 *   <ul>
 	 *     <li> changes relating to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive}
@@ -3896,6 +3973,7 @@ sap.ui.define([
 	ODataListBinding.prototype.sort = function (vSorters) {
 		var aSorters = _Helper.toArray(vSorters);
 
+		this.checkTransient();
 		if (this.sOperationMode !== OperationMode.Server) {
 			throw new Error("Operation mode has to be sap.ui.model.odata.OperationMode.Server");
 		}
@@ -3931,13 +4009,37 @@ sap.ui.define([
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataBinding#updateAfterCreate
 	 */
-	ODataListBinding.prototype.updateAfterCreate = function () {
-		// After a create in the parent binding a refresh is needed unless it was a deep create
-		var oPromise = this.iCreatedContexts
-				? asODataParentBinding.prototype.updateAfterCreate.apply(this) // deep create
-				: this.refreshInternal("");
+	ODataListBinding.prototype.updateAfterCreate = function (bSkipRefresh, sGroupId) {
+		var oPromise,
+			oSideEffectsPromise,
+			that = this;
 
-		this.bDeepCreate = false;
+		if (this.iCreatedContexts) { // deep create
+			if (bSkipRefresh) {
+				this.reset(ChangeReason.Change, true); // throw the old, transient contexts away
+			} else {
+				this.reset(undefined, true); // silently throw the old, transient contexts away
+				// ensure that we have new contexts
+				oSideEffectsPromise = this.fetchContexts(0, Infinity, 0, _GroupLock.$cached)
+					.then(function () {
+						that.iCurrentEnd = that.aContexts.length;
+						return that.requestSideEffects(sGroupId,
+							_Helper.getMissingPropertyPaths(
+								that.fetchValue("", null, true).getResult(),
+								that.mAggregatedQueryOptions));
+					}).then(function () {
+						// do not fire until requestSideEffects is finished to avoid unwanted
+						// late property requests
+						that._fireChange({reason : ChangeReason.Change});
+					});
+			}
+			oPromise = SyncPromise.all([
+				oSideEffectsPromise,
+				asODataParentBinding.prototype.updateAfterCreate.apply(this, arguments)
+			]);
+		} else { // full refresh to see if the server created some
+			oPromise = this.refreshInternal("", sGroupId);
+		}
 
 		return oPromise;
 	};

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

@@ -157,7 +157,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.112.0
+		 * @version 1.113.0
 		 */
 		ODataMetaModel = MetaModel.extend("sap.ui.model.odata.v4.ODataMetaModel", {
 				constructor : constructor
@@ -706,6 +706,7 @@ sap.ui.define([
 		this.sDefaultBindingMode = BindingMode.OneTime;
 		this.mETags = {};
 		this.sLanguage = sLanguage;
+		// no need to use UI5Date.getInstance as only the timestamp is relevant
 		this.oLastModified = new Date(0);
 		this.oMetadataPromise = null;
 		this.oModel = oModel;
@@ -3479,8 +3480,10 @@ sap.ui.define([
 		}
 
 		// handle & remove Date, ETag and Last-Modified headers
+		// no need to use UI5Date.getInstance as only the timestamp is relevant
 		oLastModified = mScope.$LastModified ? new Date(mScope.$LastModified) : null;
 		this.mETags[sUrl] = mScope.$ETag ? mScope.$ETag : oLastModified;
+		// no need to use UI5Date.getInstance as only the timestamp is relevant
 		oDate = mScope.$Date ? new Date(mScope.$Date) : new Date();
 		oLastModified = oLastModified || oDate; // @see #getLastModified
 		if (this.oLastModified < oLastModified) {

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

@@ -227,7 +227,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.Model
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.112.0
+		 * @version 1.113.0
 		 */
 		ODataModel = Model.extend("sap.ui.model.odata.v4.ODataModel",
 			/** @lends sap.ui.model.odata.v4.ODataModel.prototype */{
@@ -881,8 +881,9 @@ sap.ui.define([
 	 *   Whether this binding is considered for a match when {@link #getKeepAliveContext} is called;
 	 *   only the value <code>true</code> is allowed. Must not be combined with <code>$apply</code>,
 	 *   <code>$$aggregation</code>, <code>$$canonicalPath</code>, or <code>$$sharedRequest</code>.
-	 *   If the binding is relative, <code>$$ownRequest</code> must be set as well.
-	 *   Supported since 1.99.0
+	 *   If the binding is relative, <code>$$ownRequest</code> must be set as well. Supported since
+	 *   1.99.0; since 1.113.0 it can be combined with <code>$$aggregation</code> for a recursive
+	 *   hierarchy.
 	 * @param {string} [mParameters.$$groupId]
 	 *   The group ID to be used for <b>read</b> requests triggered by this binding; if not
 	 *   specified, either the parent binding's group ID (if the binding is relative) or the

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

@@ -333,19 +333,27 @@ sap.ui.define([
 	 * @param {object} mParameters
 	 *   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 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#isKeepAlive kept-alive} context of this binding.
-	 *   Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts
-	 *   of a {@link #getRootBinding root binding} do not count as pending changes. Since 1.108.0,
-	 *   {@link sap.ui.model.odata.v4.Context#delete deleted} contexts do not count as pending
-	 *   changes.
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> there are pending changes that cannot be ignored,
+	 *     <li> the binding is {@link #isTransient transient} (part of a
+	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}),
+	 *     <li> <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.
+	 *   </ul>
+	 *   The following exceptions apply:
+	 *   <ul>
+	 *     <li> Since 1.90.0, binding-specific parameters are ignored if they are unchanged.
+	 *     <li> 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.
+	 *     <li> Since 1.97.0, pending changes are ignored if they relate to a
+	 *       {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} context of this binding.
+	 *     <li> Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts
+	 *       of a {@link #getRootBinding root binding} do not count as pending changes.
+	 *     <li> Since 1.108.0, {@link sap.ui.model.odata.v4.Context#delete deleted} contexts do not
+	 *       count as pending changes.
+	 *   </ul>
 	 *
 	 * @public
 	 * @since 1.45.0
@@ -386,6 +394,7 @@ sap.ui.define([
 			}
 		}
 
+		this.checkTransient();
 		if (!mParameters) {
 			throw new Error("Missing map of binding parameters");
 		}
@@ -1057,7 +1066,7 @@ sap.ui.define([
 	 * @see sap.ui.model.odata.v4.ODataBinding#hasPendingChangesInDependents
 	 */
 	ODataParentBinding.prototype.hasPendingChangesInDependents = function (bIgnoreKeptAlive0,
-			bIgnoreInactiveCaches) {
+			sPathPrefix) {
 		return this.getDependentBindings().some(function (oDependent) {
 			var oCache = oDependent.oCache,
 				bHasPendingChanges,
@@ -1080,20 +1089,20 @@ sap.ui.define([
 			} else if (oDependent.hasPendingChangesForPath("")) {
 				return true;
 			}
-			if (oDependent.mCacheByResourcePath && !bIgnoreInactiveCaches) {
+			if (oDependent.mCacheByResourcePath) {
 				bHasPendingChanges = Object.keys(oDependent.mCacheByResourcePath)
 					.some(function (sPath) {
 						var oCacheForPath = oDependent.mCacheByResourcePath[sPath];
 
-						return oCacheForPath !== oCache // don't ask again
+						return (!sPathPrefix || sPath.startsWith(sPathPrefix.slice(1)))
+							&& oCacheForPath !== oCache // don't ask again
 							&& oCacheForPath.hasPendingChangesForPath("");
 					});
 				if (bHasPendingChanges) {
 					return true;
 				}
 			}
-			return oDependent.hasPendingChangesInDependents(bIgnoreKeptAlive,
-				bIgnoreInactiveCaches);
+			return oDependent.hasPendingChangesInDependents(bIgnoreKeptAlive, sPathPrefix);
 		})
 		|| this.oModel.withUnresolvedBindings("hasPendingChangesInCaches",
 				this.getResolvedPath().slice(1));
@@ -1217,8 +1226,7 @@ sap.ui.define([
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataBinding#resetChangesInDependents
 	 */
-	ODataParentBinding.prototype.resetChangesInDependents = function (aPromises,
-			bIgnoreInactiveCaches) {
+	ODataParentBinding.prototype.resetChangesInDependents = function (aPromises, sPathPrefix) {
 		this.getDependentBindings().forEach(function (oDependent) {
 			aPromises.push(oDependent.oCachePromise.then(function (oCache) {
 				if (oCache) {
@@ -1228,14 +1236,16 @@ sap.ui.define([
 			}).unwrap());
 
 			// mCacheByResourcePath may have changes nevertheless
-			if (oDependent.mCacheByResourcePath && !bIgnoreInactiveCaches) {
+			if (oDependent.mCacheByResourcePath) {
 				Object.keys(oDependent.mCacheByResourcePath).forEach(function (sPath) {
-					oDependent.mCacheByResourcePath[sPath].resetChangesForPath("");
+					if (!sPathPrefix || sPath.startsWith(sPathPrefix.slice(1))) {
+						oDependent.mCacheByResourcePath[sPath].resetChangesForPath("");
+					}
 				});
 			}
 			// Reset dependents, they might have no cache, but pending changes in
 			// mCacheByResourcePath
-			oDependent.resetChangesInDependents(aPromises, bIgnoreInactiveCaches);
+			oDependent.resetChangesInDependents(aPromises, sPathPrefix);
 		});
 	};
 
@@ -1442,9 +1452,9 @@ sap.ui.define([
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataBinding#updateAfterCreate
 	 */
-	ODataParentBinding.prototype.updateAfterCreate = function () {
+	ODataParentBinding.prototype.updateAfterCreate = function (bSkipRefresh, sGroupId) {
 		return SyncPromise.all(this.getDependentBindings().map(function (oDependentBinding) {
-			return oDependentBinding.updateAfterCreate();
+			return oDependentBinding.updateAfterCreate(bSkipRefresh, sGroupId);
 		}));
 	};
 

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

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @mixes sap.ui.model.odata.v4.ODataBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.112.0
+		 * @version 1.113.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