@openui5/sap.ui.core 1.124.2 → 1.126.0

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

@@ -42,7 +42,8 @@ sap.ui.define([
 			DataStateChange : true,
 			patchCompleted : true,
 			patchSent : true,
-			refresh : true
+			refresh : true,
+			selectionChanged : true
 		},
 		/**
 		 * @alias sap.ui.model.odata.v4.ODataListBinding
@@ -50,14 +51,14 @@ sap.ui.define([
 		 * @class List binding for an OData V4 model.
 		 *   An event handler can only be attached to this binding for the following events:
 		 *   'AggregatedDataStateChange', 'change', 'createActivate', 'createCompleted',
-		 *   'createSent', 'dataReceived', 'dataRequested', 'DataStateChange', 'patchCompleted',
-		 *   'patchSent', and 'refresh'. For other events, an error is thrown.
+		 *   'createSent', 'dataReceived', 'dataRequested', 'DataStateChange', 'selectionChanged',
+		 *   'patchCompleted', 'patchSent', and 'refresh'. For other events, an error is thrown.
 		 * @extends sap.ui.model.ListBinding
 		 * @hideconstructor
 		 * @mixes sap.ui.model.odata.v4.ODataParentBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.124.2
+		 * @version 1.126.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
@@ -178,89 +179,30 @@ sap.ui.define([
 	asODataParentBinding(ODataListBinding.prototype);
 
 	/**
-	 * Attach event handler <code>fnFunction</code> to the 'createActivate' event of this binding.
-	 *
-	 * @param {function} fnFunction The function to call when the event occurs
-	 * @param {object} [oListener] Object on which to call the given function
-	 * @returns {this} <code>this</code> to allow method chaining
-	 *
-	 * @public
-	 * @since 1.98.0
-	 */
-	ODataListBinding.prototype.attachCreateActivate = function (fnFunction, oListener) {
-		return this.attachEvent("createActivate", fnFunction, oListener);
-	};
-
-	/**
-	 * Detach event handler <code>fnFunction</code> from the 'createActivate' event of this binding.
-	 *
-	 * @param {function} fnFunction The function to call when the event occurs
-	 * @param {object} [oListener] Object on which to call the given function
-	 * @returns {this} <code>this</code> to allow method chaining
-	 *
-	 * @public
-	 * @since 1.98.0
-	 */
-	ODataListBinding.prototype.detachCreateActivate = function (fnFunction, oListener) {
-		return this.detachEvent("createActivate", fnFunction, oListener);
-	};
-
-	/**
-	 * Attach event handler <code>fnFunction</code> to the 'createCompleted' event of this binding.
-	 *
-	 * @param {function} fnFunction The function to call when the event occurs
-	 * @param {object} [oListener] Object on which to call the given function
-	 * @returns {this} <code>this</code> to allow method chaining
-	 *
-	 * @public
-	 * @since 1.66.0
-	 */
-	ODataListBinding.prototype.attachCreateCompleted = function (fnFunction, oListener) {
-		return this.attachEvent("createCompleted", fnFunction, oListener);
-	};
-
-	/**
-	 * Detach event handler <code>fnFunction</code> from the 'createCompleted' event of this
-	 * binding.
-	 *
-	 * @param {function} fnFunction The function to call when the event occurs
-	 * @param {object} [oListener] Object on which to call the given function
-	 * @returns {this} <code>this</code> to allow method chaining
-	 *
-	 * @public
-	 * @since 1.66.0
-	 */
-	ODataListBinding.prototype.detachCreateCompleted = function (fnFunction, oListener) {
-		return this.detachEvent("createCompleted", fnFunction, oListener);
-	};
-
-	/**
-	 * Attach event handler <code>fnFunction</code> to the 'createSent' event of this binding.
-	 *
-	 * @param {function} fnFunction The function to call when the event occurs
-	 * @param {object} [oListener] Object on which to call the given function
-	 * @returns {this} <code>this</code> to allow method chaining
-	 *
-	 * @public
-	 * @since 1.66.0
+	 * @override
+	 * @see sap.ui.model.Binding#_checkDataStateMessages
 	 */
-	ODataListBinding.prototype.attachCreateSent = function (fnFunction, oListener) {
-		return this.attachEvent("createSent", fnFunction, oListener);
+	ODataListBinding.prototype._checkDataStateMessages = function (oDataState, sResolvedPath) {
+		if (sResolvedPath) {
+			oDataState.setModelMessages(this.oModel.getMessagesByPath(sResolvedPath, true));
+		}
 	};
 
 	/**
-	 * Detach event handler <code>fnFunction</code> from the 'createSent' event of this
-	 * binding.
+	 * Returns all currently existing contexts of this list binding in no special order.
 	 *
-	 * @param {function} fnFunction The function to call when the event occurs
-	 * @param {object} [oListener] Object on which to call the given function
-	 * @returns {this} <code>this</code> to allow method chaining
+	 * @returns {sap.ui.model.odata.v4.Context[]}
+	 *   All currently existing contexts of this list binding, in no special order
 	 *
-	 * @public
-	 * @since 1.66.0
+	 * @private
+	 * @see #getAllCurrentContexts
 	 */
-	ODataListBinding.prototype.detachCreateSent = function (fnFunction, oListener) {
-		return this.detachEvent("createSent", fnFunction, oListener);
+	ODataListBinding.prototype._getAllExistingContexts = function () {
+		return (this.aContexts ?? []).filter(function (oContext) {
+			return oContext;
+		}).concat(Object.values(this.mPreviousContextsByPath).filter(function (oContext) {
+			return oContext.isEffectivelyKeptAlive();
+		}));
 	};
 
 	/**
@@ -304,8 +246,8 @@ sap.ui.define([
 				this.fetchCache(this.oContext, /*bIgnoreParentCache*/true);
 			}
 			this.oHeaderContext.adjustPredicate(sTransientPredicate, sPredicate);
-			this.aContexts.forEach(function (oContext) {
-				oContext.adjustPredicate(sTransientPredicate, sPredicate, adjustPreviousData);
+			this.aContexts.forEach(function (oContext0) {
+				oContext0.adjustPredicate(sTransientPredicate, sPredicate, adjustPreviousData);
 			});
 		}
 	};
@@ -606,6 +548,64 @@ sap.ui.define([
 	 * @since 1.37.0
 	 */
 
+	/**
+	 * The 'selectionChanged' event is fired if the selection state of a context changes; for more
+	 * information see {@link sap.ui.model.odata.v4.Context#setSelected}.
+	 *
+	 * @param {sap.ui.base.Event} oEvent The event object
+	 * @param {sap.ui.model.odata.v4.ODataListBinding} oEvent.getSource() This binding
+	 * @param {function():Object<any>} oEvent.getParameters
+	 *   Function which returns an object containing all event parameters
+	 * @param {boolean} oEvent.getParameters.context
+	 *   The context for which {@link sap.ui.model.odata.v4.Context#setSelected} was called
+	 *
+	 * @event sap.ui.model.odata.v4.ODataListBinding#selectionChanged
+	 * @experimental As of version 1.126.0
+	 * @public
+	 */
+
+	/**
+	 * Attach event handler <code>fnFunction</code> to the 'createActivate' event of this binding.
+	 *
+	 * @param {function} fnFunction The function to call when the event occurs
+	 * @param {object} [oListener] Object on which to call the given function
+	 * @returns {this} <code>this</code> to allow method chaining
+	 *
+	 * @public
+	 * @since 1.98.0
+	 */
+	ODataListBinding.prototype.attachCreateActivate = function (fnFunction, oListener) {
+		return this.attachEvent("createActivate", fnFunction, oListener);
+	};
+
+	/**
+	 * Attach event handler <code>fnFunction</code> to the 'createCompleted' event of this binding.
+	 *
+	 * @param {function} fnFunction The function to call when the event occurs
+	 * @param {object} [oListener] Object on which to call the given function
+	 * @returns {this} <code>this</code> to allow method chaining
+	 *
+	 * @public
+	 * @since 1.66.0
+	 */
+	ODataListBinding.prototype.attachCreateCompleted = function (fnFunction, oListener) {
+		return this.attachEvent("createCompleted", fnFunction, oListener);
+	};
+
+	/**
+	 * Attach event handler <code>fnFunction</code> to the 'createSent' event of this binding.
+	 *
+	 * @param {function} fnFunction The function to call when the event occurs
+	 * @param {object} [oListener] Object on which to call the given function
+	 * @returns {this} <code>this</code> to allow method chaining
+	 *
+	 * @public
+	 * @since 1.66.0
+	 */
+	ODataListBinding.prototype.attachCreateSent = function (fnFunction, oListener) {
+		return this.attachEvent("createSent", fnFunction, oListener);
+	};
+
 	/**
 	 * See {@link sap.ui.base.EventProvider#attachEvent}
 	 *
@@ -628,16 +628,6 @@ sap.ui.define([
 		return ListBinding.prototype.attachEvent.apply(this, arguments);
 	};
 
-	/**
-	 * @override
-	 * @see sap.ui.model.Binding#_checkDataStateMessages
-	 */
-	ODataListBinding.prototype._checkDataStateMessages = function (oDataState, sResolvedPath) {
-		if (sResolvedPath) {
-			oDataState.setModelMessages(this.oModel.getMessagesByPath(sResolvedPath, true));
-		}
-	};
-
 	/**
 	 * Checks that deep create is possible in this binding.
 	 *
@@ -695,21 +685,26 @@ sap.ui.define([
 	 * @param {number} [iCount]
 	 *   The count of nodes affected by the collapse, in case the cache already performed it
 	 * @throws {Error}
-	 *   If the binding's root binding is suspended
+	 *   If the binding's root binding is suspended or if the given context is not part of a
+	 *   recursive hierarchy
 	 *
 	 * @private
 	 * @see #expand
 	 */
 	ODataListBinding.prototype.collapse = function (oContext, bSilent, iCount) {
+		if (this.aContexts[oContext.iIndex] !== oContext) {
+			throw new Error("Not currently part of the hierarchy: " + oContext);
+		}
+
 		iCount ??= this.oCache.collapse(
 			_Helper.getRelativePath(oContext.getPath(), this.oHeaderContext.getPath()));
 
 		if (iCount > 0) {
 			const aContexts = this.aContexts;
 			const iModelIndex = oContext.getModelIndex();
-			aContexts.splice(iModelIndex + 1, iCount).forEach((oContext) => {
-				if (!oContext.created()) {
-					this.mPreviousContextsByPath[oContext.getPath()] = oContext;
+			aContexts.splice(iModelIndex + 1, iCount).forEach((oContext0) => {
+				if (!oContext0.created()) {
+					this.mPreviousContextsByPath[oContext0.getPath()] = oContext0;
 				} // else: created (even persisted) is kept inside "context" annotation
 			});
 			for (let i = iModelIndex + 1; i < aContexts.length; i += 1) {
@@ -797,17 +792,35 @@ sap.ui.define([
 	 * the case if the complete collection has been read or if the system query option
 	 * <code>$count</code> is <code>true</code> and the binding has processed at least one request.
 	 *
-	 * Creating a new child beneath an existing and visible parent node (which must either be a leaf
-	 * or expanded, but not collapsed) is supported (@experimental as of version 1.117.0) in case of
-	 * a recursive hierarchy (see {@link #setAggregation}). The parent node must be identified via
-	 * an {@link sap.ui.model.odata.v4.Context} instance given as
+	 * Since 1.125.0, creating a new child beneath an existing and visible parent node (which must
+	 * either be a leaf or expanded, but not collapsed) is supported in case of a recursive
+	 * hierarchy (see {@link #setAggregation}). The parent node must be identified via an
+	 * {@link sap.ui.model.odata.v4.Context} instance given as
 	 * <code>oInitialData["@$ui5.node.parent"]</code> (which is immediately removed from the new
-	 * child's data). It can be <code>null</code> or absent when creating a new root node
-	 * (@experimental as of version 1.120.0). <code>bSkipRefresh</code> must be set, but both
-	 * <code>bAtEnd</code> and <code>bInactive</code> must not be set. No other creation or
+	 * child's data). It can be <code>null</code> or absent when creating a new root node.
+	 * <code>bSkipRefresh</code> must be set, but both <code>bAtEnd</code> and
+	 * <code>bInactive</code> must not be set. No other creation or
 	 * {@link sap.ui.model.odata.v4.Context#move move} must be pending, and no other modification
 	 * (including collapse of some ancestor node) must happen while this creation is pending!
 	 *
+	 * When using the <code>createInPlace</code> parameter
+	 * (see {@link #setAggregation}, @experimental as of version 1.125.0), the new
+	 * {@link sap.ui.model.odata.v4.Context#isTransient transient} child is hidden until its
+	 * {@link sap.ui.model.odata.v4.Context#created created promise} resolves, and then it is shown
+	 * at a position determined by the back end and the current sort order. Note that the returned
+	 * context is not always part of this list binding's collection and can only be used for the
+	 * following scenarios:
+	 * <ul>
+	 *   <li> The position of the new child can be retrieved by using its
+	 *     {@link sap.ui.model.odata.v4.Context#getIndex index}. If the created child does not
+	 *     become part of the hierarchy due to the search or filter criteria, the context will be
+	 *     {@link sap.ui.model.odata.v4.Context#destroy destroyed} and its
+	 *     {@link sap.ui.model.odata.v4.Context#getIndex index} is set to <code>undefined</code>.
+	 *   <li> The created context always knows its
+	 *     {@link sap.ui.model.odata.v4.Context#getPath path}, which can be used for
+	 *     {@link #getKeepAliveContext}.
+	 * </ul>
+	 *
 	 * @param {Object<any>} [oInitialData={}]
 	 *   The initial data for the created entity
 	 * @param {boolean} [bSkipRefresh]
@@ -871,6 +884,7 @@ sap.ui.define([
 		var oAggregation = this.mParameters.$$aggregation,
 			iChildIndex, // used only in case of recursive hierarchy
 			oContext,
+			bCreateInPlace = oAggregation?.createInPlace,
 			oCreatePathPromise = this.fetchResourcePath(),
 			oCreatePromise,
 			oEntityData,
@@ -879,7 +893,6 @@ sap.ui.define([
 			sResolvedPath = this.getResolvedPath(),
 			sTransientPredicate = "($uid=" + _Helper.uid() + ")",
 			sTransientPath = sResolvedPath + sTransientPredicate,
-			i,
 			that = this;
 
 		if (!sResolvedPath) {
@@ -920,6 +933,7 @@ sap.ui.define([
 		// clone data to avoid modifications outside the cache
 		// remove any property starting with "@$ui5."
 		oEntityData = _Helper.publicClone(oInitialData, true) || {};
+		let bRefresh;
 		if (oAggregation) {
 			if (!bSkipRefresh) {
 				throw new Error("Missing bSkipRefresh");
@@ -937,6 +951,7 @@ sap.ui.define([
 					throw new Error("Unsupported collapsed parent: " + oParentContext);
 				}
 				oEntityData["@$ui5.node.parent"] = oParentContext.getCanonicalPath().slice(1);
+				bRefresh = this.oCache.isRefreshNeededAfterCreate(oParentContext.iIndex);
 			} else {
 				iChildIndex = 0;
 			}
@@ -952,7 +967,7 @@ sap.ui.define([
 				return;
 			}
 
-			oContext.doSetSelected(false);
+			oContext.doSetSelected(false, true);
 			that.removeCreated(oContext);
 			return Promise.resolve().then(function () {
 				// Fire the change asynchronously so that Cache#delete is finished and #getContexts
@@ -974,7 +989,7 @@ sap.ui.define([
 		).then(function (oCreatedEntity) {
 			// The entity was created on the server
 			// Note: This code is not called for nested creates, they are always rejected
-			var bDeepCreate, sGroupId, sPredicate;
+			var bDeepCreate, sGroupId0, sPredicate;
 
 			// refreshSingle requires the new key predicate in oContext.getPath()
 			sPredicate = _Helper.getPrivateAnnotation(oCreatedEntity, "predicate");
@@ -983,27 +998,48 @@ sap.ui.define([
 				that.oModel.checkMessages();
 			}
 			that.fireEvent("createCompleted", {context : oContext, success : true});
+			if (bCreateInPlace) {
+				const iRank = _Helper.getPrivateAnnotation(oCreatedEntity, "rank");
+				oContext.iIndex = iRank;
+				if (iRank === undefined || bRefresh) {
+					oContext.destroy();
+					return;
+				}
+
+				that.insertContext(oContext, iRank);
+			}
 			bDeepCreate = _Helper.getPrivateAnnotation(oCreatedEntity, "deepCreate");
 			_Helper.deletePrivateAnnotation(oCreatedEntity, "deepCreate");
-			sGroupId = that.getGroupId();
-			if (that.oModel.isApiGroup(sGroupId)) {
-				sGroupId = "$auto";
+			sGroupId0 = that.getGroupId();
+			if (that.oModel.isApiGroup(sGroupId0)) {
+				sGroupId0 = "$auto";
 			}
 			// 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));
+				? oContext.updateAfterCreate(bSkipRefresh, sGroupId0)
+				: that.refreshSingle(oContext, that.lockGroup(sGroupId0));
 		}, function (oError) {
 			oGroupLock.unlock(true); // createInCache failed, so the lock might still be blocking
 			throw oError;
 		});
+		if (bRefresh) {
+			oCreatePromise = SyncPromise.all([
+				oCreatePromise,
+				this.requestSideEffects(sGroupId, [""])
+			]);
+		}
 
-		oContext = Context.create(this.oModel, this, sTransientPath,
-			iChildIndex ?? -this.iCreatedContexts, oCreatePromise, bInactive);
-		oContext.setSelected(this.oHeaderContext.isSelected());
+		const iIndex = bCreateInPlace ? undefined : iChildIndex ?? -this.iCreatedContexts;
+		oContext = Context.create(this.oModel, this, sTransientPath, iIndex, oCreatePromise,
+			bInactive);
+		oContext.doSetSelected(this.oHeaderContext.isSelected());
 		if (this.isTransient()) {
 			oContext.created().catch(this.oModel.getReporter());
 		}
+		if (bCreateInPlace) {
+			return oContext;
+		}
+
 		// to make sure that #fetchValue does not overtake #createInCache, avoid bCached flag!
 		oContext.fetchValue().then(function (oElement) {
 			if (oElement) {
@@ -1012,23 +1048,7 @@ sap.ui.define([
 			} // else: context already destroyed
 		});
 
-		if (iChildIndex !== undefined) {
-			this.aContexts.splice(iChildIndex, 0, oContext);
-			for (i = this.aContexts.length - 1; i > iChildIndex; i -= 1) {
-				if (this.aContexts[i]) {
-					this.aContexts[i].iIndex += 1;
-				}
-			}
-			this.iMaxLength += 1;
-		} else if (this.bFirstCreateAtEnd !== bAtEnd) {
-			this.aContexts.splice(this.iCreatedContexts - 1, 0, oContext);
-			for (i = this.iCreatedContexts - 1; i >= 0; i -= 1) {
-				this.aContexts[i].iIndex = i - this.iCreatedContexts;
-			}
-		} else {
-			this.aContexts.unshift(oContext);
-		}
-		this._fireChange({reason : ChangeReason.Add});
+		this.insertContext(oContext, iChildIndex, bAtEnd);
 
 		return oContext;
 	};
@@ -1059,21 +1079,19 @@ sap.ui.define([
 			sPath = this.getResolvedPath(),
 			sPredicate,
 			bStartBeyondRange = iStart > this.aContexts.length,
-			i,
 			that = this;
 
 		/*
 		 * Shrinks contexts to the new length, destroys unneeded contexts
 		 */
 		function shrinkContexts() {
-			var iNewLength = that.iMaxLength + that.iCreatedContexts,
-				i;
+			var iNewLength = that.iMaxLength + that.iCreatedContexts;
 
 			if (iNewLength >= that.aContexts.length) {
 				return;
 			}
 
-			for (i = iNewLength; i < that.aContexts.length; i += 1) {
+			for (let i = iNewLength; i < that.aContexts.length; i += 1) {
 				if (that.aContexts[i]) {
 					that.aContexts[i].destroy();
 				}
@@ -1085,7 +1103,7 @@ sap.ui.define([
 			bChanged = true;
 		}
 
-		for (i = 0; i < aResults.length; i += 1) {
+		for (let i = 0; i < aResults.length; i += 1) {
 			if (this.aContexts[iStart + i] === undefined && aResults[i]) {
 				bChanged = true;
 				i$skipIndex = iStart + i - this.iCreatedContexts; // index on server ($skip)
@@ -1115,7 +1133,7 @@ sap.ui.define([
 					}
 				} else {
 					oContext = Context.create(oModel, this, sContextPath, i$skipIndex);
-					oContext.setSelected(this.oHeaderContext.isSelected());
+					oContext.doSetSelected(this.oHeaderContext.isSelected());
 				}
 				this.aContexts[iStart + i] = oContext;
 			}
@@ -1365,6 +1383,50 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Detach event handler <code>fnFunction</code> from the 'createActivate' event of this binding.
+	 *
+	 * @param {function} fnFunction The function to call when the event occurs
+	 * @param {object} [oListener] Object on which to call the given function
+	 * @returns {this} <code>this</code> to allow method chaining
+	 *
+	 * @public
+	 * @since 1.98.0
+	 */
+	ODataListBinding.prototype.detachCreateActivate = function (fnFunction, oListener) {
+		return this.detachEvent("createActivate", fnFunction, oListener);
+	};
+
+	/**
+	 * Detach event handler <code>fnFunction</code> from the 'createCompleted' event of this
+	 * binding.
+	 *
+	 * @param {function} fnFunction The function to call when the event occurs
+	 * @param {object} [oListener] Object on which to call the given function
+	 * @returns {this} <code>this</code> to allow method chaining
+	 *
+	 * @public
+	 * @since 1.66.0
+	 */
+	ODataListBinding.prototype.detachCreateCompleted = function (fnFunction, oListener) {
+		return this.detachEvent("createCompleted", fnFunction, oListener);
+	};
+
+	/**
+	 * Detach event handler <code>fnFunction</code> from the 'createSent' event of this
+	 * binding.
+	 *
+	 * @param {function} fnFunction The function to call when the event occurs
+	 * @param {object} [oListener] Object on which to call the given function
+	 * @returns {this} <code>this</code> to allow method chaining
+	 *
+	 * @public
+	 * @since 1.66.0
+	 */
+	ODataListBinding.prototype.detachCreateSent = function (fnFunction, oListener) {
+		return this.detachEvent("createSent", fnFunction, oListener);
+	};
+
 	/**
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataBinding#doCreateCache
@@ -1527,13 +1589,18 @@ sap.ui.define([
 	 * @returns {sap.ui.base.SyncPromise}
 	 *   A promise that is resolved when the expand is successful and rejected when it fails
 	 * @throws {Error}
-	 *   If the binding's root binding is suspended
+	 *   If the binding's root binding is suspended or if the given context is not part of a
+	 *   recursive hierarchy
 	 *
 	 * @private
 	 * @see #collapse
 	 */
 	ODataListBinding.prototype.expand = function (oContext, bSilent) {
 		this.checkSuspended();
+		if (this.aContexts[oContext.iIndex] !== oContext) {
+			throw new Error("Not currently part of the hierarchy: " + oContext);
+		}
+
 		let bDataRequested = false;
 
 		return this.oCache.expand(this.lockGroup(),
@@ -1918,7 +1985,7 @@ sap.ui.define([
 	 *
 	 * @param {sap.ui.model.odata.v4.Context} oNode
 	 *   Some node which could have a parent
-	  * @param {boolean} [bAllowRequest]
+	 * @param {boolean} [bAllowRequest]
 	 *   Whether it is allowed to send a GET request to fetch the parent node's data
 	 * @returns {sap.ui.model.odata.v4.Context|null|undefined|
 	 *     Promise<sap.ui.model.odata.v4.Context>|sap.ui.base.SyncPromise}
@@ -1935,9 +2002,7 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataListBinding.prototype.fetchOrGetParent = function (oNode, bAllowRequest) {
-		const oAggregation = this.mParameters.$$aggregation;
-
-		if (!oAggregation || !oAggregation.hierarchyQualifier) {
+		if (!this.mParameters.$$aggregation?.hierarchyQualifier) {
 			throw new Error("Missing recursive hierarchy");
 		}
 		if (this.aContexts[oNode.iIndex] !== oNode) {
@@ -1962,6 +2027,64 @@ sap.ui.define([
 		return this.aContexts[iParentIndex];
 	};
 
+	/**
+	 * Fetches (if <code>bAllowRequest</code> is set) or gets the given node's sibling, either the
+	 * next one (via offset +1) or the previous one (via offset -1).
+	 *
+	 * @param {sap.ui.model.odata.v4.Context} oNode - A node
+	 * @param {number} iOffset - An offset, either -1 or +1
+	 * @param {boolean} [bAllowRequest]
+	 *   Whether it is allowed to send a GET request to fetch the sibling
+	 * @returns {sap.ui.model.odata.v4.Context|null|undefined
+	 * |Promise<sap.ui.model.odata.v4.Context|null>}
+	 *   The sibling's context, or <code>null</code> if no such sibling exists for sure, or
+	 *   <code>undefined</code> if we cannot tell and it is not allowed to send a request (see
+	 *   <code>bAllowRequest</code>). Or a promise (if a request was sent) which resolves with the
+	 *   sibling's context (or <code>null</code> if no such sibling exists) in case of success, or
+	 *   rejects with an instance of <code>Error</code> in case of failure.
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> the given offset is unsupported,
+	 *     <li> this binding's root binding is suspended,
+	 *     <li> the given context is {@link #isDeleted deleted}, {@link #isTransient transient}, or
+	 *       not part of a recursive hierarchy.
+	 *   </ul>
+	 *
+	 *  @private
+	 */
+	ODataListBinding.prototype.fetchOrGetSibling = function (oNode, iOffset = +1,
+			bAllowRequest = false) {
+		if (!this.mParameters.$$aggregation?.hierarchyQualifier) {
+			throw new Error("Missing recursive hierarchy");
+		}
+		if (iOffset !== -1 && iOffset !== +1) {
+			throw new Error("Unsupported offset: " + iOffset);
+		}
+		if (oNode.isDeleted() || oNode.isTransient() || this.aContexts[oNode.iIndex] !== oNode) {
+			throw new Error("Unsupported context: " + oNode);
+		}
+		this.checkSuspended();
+
+		const iSibling = this.oCache.getSiblingIndex(oNode.iIndex, iOffset);
+		if (iSibling < 0) {
+			return null;
+		}
+		if (iSibling !== undefined) {
+			this.fetchContexts(iSibling, 1, 0, _GroupLock.$cached);
+			return this.aContexts[iSibling];
+		}
+		if (!bAllowRequest) {
+			return undefined;
+		}
+
+		return this.oCache.requestSiblingIndex(oNode.iIndex, iOffset, this.lockGroup())
+			.then((iIndex) => {
+				return iIndex < 0
+					? null
+					: this.requestContexts(iIndex, 1).then((aResult) => aResult[0]);
+			});
+	};
+
 	/**
 	 * Requests the value for the given path and index; the value is requested from this binding's
 	 * cache or from its context in case it has no cache.
@@ -2000,31 +2123,6 @@ sap.ui.define([
 		});
 	};
 
-	/**
-	 * @override
-	 * @see sap.ui.model.odata.v4.ODataParentBinding#findContextForCanonicalPath
-	 */
-	ODataListBinding.prototype.findContextForCanonicalPath = function (sCanonicalPath) {
-		var aKeptAliveContexts = Object.values(this.mPreviousContextsByPath)
-				.filter(function (oCandidate) {
-					return oCandidate.isEffectivelyKeptAlive();
-				});
-
-		function check(aContexts) {
-			return aContexts.find(function (oCandidate) {
-				var oPromise;
-
-				if (oCandidate) {
-					oPromise = oCandidate.fetchCanonicalPath();
-					oPromise.caught();
-					return oPromise.getResult() === sCanonicalPath;
-				}
-			});
-		}
-
-		return check(aKeptAliveContexts) || check(this.aContexts);
-	};
-
 	/**
 	 * Filters the list with the given filters. Since 1.97.0, if filters are unchanged, no request
 	 * is sent, regardless of pending changes. Since 1.111.0, all contexts (incl. the header
@@ -2148,6 +2246,31 @@ sap.ui.define([
 		return this;
 	};
 
+	/**
+	 * @override
+	 * @see sap.ui.model.odata.v4.ODataParentBinding#findContextForCanonicalPath
+	 */
+	ODataListBinding.prototype.findContextForCanonicalPath = function (sCanonicalPath) {
+		var aKeptAliveContexts = Object.values(this.mPreviousContextsByPath)
+				.filter(function (oCandidate) {
+					return oCandidate.isEffectivelyKeptAlive();
+				});
+
+		function check(aContexts) {
+			return aContexts.find(function (oCandidate) {
+				var oPromise;
+
+				if (oCandidate) {
+					oPromise = oCandidate.fetchCanonicalPath();
+					oPromise.caught();
+					return oPromise.getResult() === sCanonicalPath;
+				}
+			});
+		}
+
+		return check(aKeptAliveContexts) || check(this.aContexts);
+	};
+
 	/**
 	 * Fires the 'createActivate' event.
 	 *
@@ -2168,14 +2291,26 @@ sap.ui.define([
 		return false;
 	};
 
+	/**
+	 * Fires the 'selectionChanged' event.
+	 *
+	 * @param {sap.ui.model.odata.v4.Context} oContext
+	 *   The context whose selection has changed
+	 *
+	 * @private
+	 */
+	ODataListBinding.prototype.fireSelectionChanged = function (oContext) {
+		this.fireEvent("selectionChanged", {context : oContext});
+	};
+
 	/**
 	 * Returns the current object holding the information needed for data aggregation, see
 	 * {@link #setAggregation}.
 	 *
 	 * @param {boolean} [bVerbose]
 	 *   Whether to additionally return the "$"-prefixed values described below which obviously
-	 *   cannot be given back to the setter (@experimental as of version 1.111.0). They are
-	 *   retrieved from the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy" and
+	 *   cannot be given back to the setter (since 1.125.0). They are retrieved from the pair of
+	 *   "Org.OData.Aggregation.V1.RecursiveHierarchy" and
 	 *   "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy" annotations at this binding's
 	 *   entity type, identified via the <code>hierarchyQualifier</code> given to
 	 *   {@link #setAggregation}.
@@ -2711,7 +2846,9 @@ sap.ui.define([
 	 *   from which the tree has been created
 	 * @returns {object} The AST of the filter tree including the static filter as string or null if
 	 *   no filters are set
+	 *
 	 * @private
+	 * @since 1.57.0
 	 * @ui5-restricted sap.ui.table, sap.ui.export
 	 */
 	// @override sap.ui.model.ListBinding#getFilterInfo
@@ -2771,28 +2908,6 @@ sap.ui.define([
 		return this.isResolved() ? this.oHeaderContext : null;
 	};
 
-	/**
-	 * Converts the view index of a context to the model index in case there are contexts created at
-	 * the end.
-	 *
-	 * @param {number} iViewIndex The view index
-	 * @returns {number} The model index
-	 *
-	 * @private
-	 */
-	ODataListBinding.prototype.getModelIndex = function (iViewIndex) {
-		if (!this.bFirstCreateAtEnd) {
-			return iViewIndex;
-		}
-		if (!this.bLengthFinal) { // created at end, but the read is pending and $count unknown yet
-			return this.aContexts.length - iViewIndex - 1;
-		}
-		return iViewIndex < this.getLength() - this.iCreatedContexts
-			? iViewIndex + this.iCreatedContexts
-			// Note: the created rows are mirrored at the end
-			: this.getLength() - iViewIndex - 1;
-	};
-
 	/**
 	 * Calls {@link sap.ui.model.odata.v4.Context#setKeepAlive} at the context for the given path
 	 * and returns it. Since 1.100.0 the function always returns such a context. If none exists yet,
@@ -2819,7 +2934,7 @@ sap.ui.define([
 	 *   </ul>
 	 *
 	 * @public
-	 * @see sap.ui.model.odata.v4.Model#getKeepAliveContext
+	 * @see sap.ui.model.odata.v4.ODataModel#getKeepAliveContext
 	 * @since 1.99.0
 	 */
 	ODataListBinding.prototype.getKeepAliveContext = function (sPath, bRequestMessages, sGroupId) {
@@ -2911,6 +3026,28 @@ sap.ui.define([
 		return this.aContexts.length ? this.aContexts.length + 10 : 0;
 	};
 
+	/**
+	 * Converts the view index of a context to the model index in case there are contexts created at
+	 * the end.
+	 *
+	 * @param {number} iViewIndex The view index
+	 * @returns {number} The model index
+	 *
+	 * @private
+	 */
+	ODataListBinding.prototype.getModelIndex = function (iViewIndex) {
+		if (!this.bFirstCreateAtEnd) {
+			return iViewIndex;
+		}
+		if (!this.bLengthFinal) { // created at end, but the read is pending and $count unknown yet
+			return this.aContexts.length - iViewIndex - 1;
+		}
+		return iViewIndex < this.getLength() - this.iCreatedContexts
+			? iViewIndex + this.iCreatedContexts
+			// Note: the created rows are mirrored at the end
+			: this.getLength() - iViewIndex - 1;
+	};
+
 	/**
 	 * Builds the value for the OData V4 '$orderby' system query option from the given sorters
 	 * and the optional static '$orderby' value which is appended to the sorters.
@@ -3078,6 +3215,39 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Inserts the given context at the given position into <code>this.aContexts</code>. The
+	 * position can be described either via a specific <code>iIndex</code>, or the relative position
+	 * in the creation area according to <code>bAtEnd</code>. Fires a change event with
+	 * <code>ChangeReason.Add</code>.
+	 *
+	 * @param {sap.ui.model.odata.v4.Context} oContext
+	 *   The context to be inserted
+	 * @param {number} [iIndex]
+	 *   The insertion index
+	 * @param {boolean} [bAtEnd]
+	 *   The relative position in the creation area
+	 */
+	ODataListBinding.prototype.insertContext = function (oContext, iIndex, bAtEnd) {
+		if (iIndex !== undefined) {
+			_Helper.insert(this.aContexts, iIndex, oContext);
+			for (let i = this.aContexts.length - 1; i > iIndex; i -= 1) {
+				if (this.aContexts[i]) {
+					this.aContexts[i].iIndex += 1;
+				}
+			}
+			this.iMaxLength += 1;
+		} else if (this.bFirstCreateAtEnd !== bAtEnd) {
+			this.aContexts.splice(this.iCreatedContexts - 1, 0, oContext);
+			for (let i = this.iCreatedContexts - 1; i >= 0; i -= 1) {
+				this.aContexts[i].iIndex = i - this.iCreatedContexts;
+			}
+		} else {
+			this.aContexts.unshift(oContext);
+		}
+		this._fireChange({reason : ChangeReason.Add});
+	};
+
 	/**
 	 * Inserts a new gap into <code>this.aContexts</code> just after the given index and with the
 	 * given positive length. Note that the given index may be the last within the array, but not
@@ -3123,7 +3293,7 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataListBinding.prototype.isAncestorOf = function (oAncestor, oDescendant) {
-		if (!this.mParameters.$$aggregation || !this.mParameters.$$aggregation.hierarchyQualifier) {
+		if (!this.mParameters.$$aggregation?.hierarchyQualifier) {
 			throw new Error("Missing recursive hierarchy");
 		}
 		if (!oDescendant) {
@@ -3283,7 +3453,8 @@ sap.ui.define([
 	 * @returns {sap.ui.base.SyncPromise<void>}
 	 *   A promise which is resolved without a defined result when the move is finished, or
 	 *   rejected in case of an error
-	 * @throws {Error} If there is no recursive hierarchy
+	 * @throws {Error} If there is no recursive hierarchy or if this binding's root binding is
+	 *   suspended
 	 *
 	 * @private
 	 */
@@ -3306,10 +3477,10 @@ sap.ui.define([
 			}
 		};
 
-		const oAggregation = this.mParameters.$$aggregation;
-		if (!oAggregation || !oAggregation.hierarchyQualifier) {
+		if (!this.mParameters.$$aggregation?.hierarchyQualifier) {
 			throw new Error("Missing recursive hierarchy");
 		}
+		this.checkSuspended();
 
 		const sUpdateGroupId = this.getUpdateGroupId();
 		const oGroupLock = this.lockGroup(sUpdateGroupId, true, true);
@@ -3323,16 +3494,21 @@ sap.ui.define([
 		const sNonCanonicalChildPath = oSiblingContext === undefined
 			? undefined
 			: oChildContext.getPath().slice(1);
+		const bUpdateSiblingIndex = oSiblingContext?.isEffectivelyKeptAlive();
 		const {promise : oPromise, refresh : bRefresh} = this.oCache.move(oGroupLock, sChildPath,
-			sParentPath, sSiblingPath, sNonCanonicalChildPath);
+			sParentPath, sSiblingPath, sNonCanonicalChildPath, bUpdateSiblingIndex);
 
 		if (bRefresh) {
 			return SyncPromise.all([
 				oPromise,
 				this.requestSideEffects(sUpdateGroupId, [""])
-			]).then(([fnGetIndex]) => {
+			]).then(([fnGetIndices]) => {
 				// Note: wait for side-effects refresh before getting index!
-				oChildContext.iIndex = fnGetIndex();
+				const [iChildIndex, iSiblingIndex] = fnGetIndices();
+				oChildContext.iIndex = iChildIndex;
+				if (bUpdateSiblingIndex) {
+					oSiblingContext.iIndex = iSiblingIndex;
+				}
 			});
 		}
 
@@ -3345,12 +3521,8 @@ sap.ui.define([
 			}
 			const iOldIndex = oChildContext.getModelIndex();
 			this.aContexts.splice(iOldIndex, 1);
-			if (iNewIndex > this.aContexts.length) {
-				this.aContexts[iNewIndex] = oChildContext;
-				// Note: no need to adjust iMaxLength
-			} else {
-				this.aContexts.splice(iNewIndex, 0, oChildContext);
-			}
+			// Note: no need to adjust iMaxLength
+			_Helper.insert(this.aContexts, iNewIndex, oChildContext);
 			setIndices(iOldIndex, iNewIndex);
 
 			if (iCollapseCount) {
@@ -3454,20 +3626,20 @@ sap.ui.define([
 				sResolvedPath = that.getResolvedPath();
 
 			that.aContexts = aInitialDataCollection.map(function (oInitialData, i) {
-				var oContext,
+				var oContext0,
 					sTransientPredicate
 						= _Helper.getPrivateAnnotation(oInitialData, "transientPredicate"),
 					oPromise = _Helper.getPrivateAnnotation(oInitialData, "promise");
 
-				oContext = Context.create(that.oModel, that, sResolvedPath + sTransientPredicate,
+				oContext0 = Context.create(that.oModel, that, sResolvedPath + sTransientPredicate,
 					i - aInitialDataCollection.length, oPromise, false, true);
-				oContext.created().catch(that.oModel.getReporter());
+				oContext0.created().catch(that.oModel.getReporter());
 
-				_Helper.setPrivateAnnotation(oInitialData, "context", oContext);
+				_Helper.setPrivateAnnotation(oInitialData, "context", oContext0);
 				_Helper.setPrivateAnnotation(oInitialData, "firstCreateAtEnd", false);
 				_Helper.deletePrivateAnnotation(oInitialData, "promise");
 
-				return oContext;
+				return oContext0;
 			});
 			that.iCreatedContexts = that.iActiveContexts = that.aContexts.length;
 			that.bFirstCreateAtEnd = false;
@@ -3613,7 +3785,7 @@ sap.ui.define([
 					if (iIndex >= 0) { // Note: implies oContext.created()
 						that.removeCreated(oContext);
 					}
-				}, false, bIgnorePendingChanges);
+				}, bIgnorePendingChanges);
 		}).catch(function (oError) {
 			that.oModel.reportError("Failed to refresh kept-alive elements", sClassName, oError);
 			throw oError;
@@ -4074,8 +4246,7 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataListBinding.prototype.reset = function (sChangeReason, bDrop, sGroupId) {
-		var oContext,
-			iCreated = 0, // index (and finally number) of created elements that we keep
+		var iCreated = 0, // index (and finally number) of created elements that we keep
 			bEmpty = this.iCurrentEnd === 0,
 			bKeepTransient = sGroupId && sGroupId !== this.getUpdateGroupId(),
 			i,
@@ -4090,7 +4261,7 @@ sap.ui.define([
 				that.mPreviousContextsByPath[oContext.getPath()] = oContext;
 			});
 			for (i = 0; i < this.iCreatedContexts; i += 1) {
-				oContext = this.aContexts[i];
+				const oContext = this.aContexts[i];
 				if (bDrop === false
 						? bKeepTransient && oContext.isTransient()
 							|| oContext.isInactive() !== undefined
@@ -4241,17 +4412,16 @@ sap.ui.define([
 	 *   used to remove the data aggregation object, which allows to set <code>$apply</code>
 	 *   explicitly afterwards. <code>null</code> is not supported.
 	 *   <br>
-	 *   Since 1.89.0, the deprecated property <code>"grandTotal like 1.84" : true</code> can be
-	 *   used to turn on the handling of grand totals like in 1.84.0, using aggregates of aggregates
-	 *   and thus allowing to filter by aggregated properties while grand totals are needed. Beware
-	 *   that methods like "average" or "countdistinct" are not compatible with this approach, and
-	 *   it cannot be combined with group levels.
+	 *   Since 1.89.0, the <b>deprecated</b> property <code>"grandTotal like 1.84" : true</code> can
+	 *   be used to turn on the handling of grand totals like in 1.84.0, using aggregates of
+	 *   aggregates and thus allowing to filter by aggregated properties while grand totals are
+	 *   needed. Beware that methods like "average" or "countdistinct" are not compatible with this
+	 *   approach, and it cannot be combined with group levels.
 	 *   <br>
-	 *   Since 1.105.0, either a recursive hierarchy or pure data aggregation is supported, but no
-	 *   mix; <code>hierarchyQualifier</code> is the leading property that decides between those two
-	 *   use cases - this is an <b>experimental API</b> and is only supported if the model uses the
-	 *   <code>autoExpandSelect</code> parameter! Since 1.117.0, it is available for read-only
-	 *   hierarchies.
+	 *   Since 1.117.0, either a read-only recursive hierarchy or pure data aggregation is
+	 *   supported, but no mix; <code>hierarchyQualifier</code> is the leading property that decides
+	 *   between those two use cases. Since 1.125.0, maintenance of a recursive hierarchy is
+	 *   supported.
 	 * @param {object} [oAggregation.aggregate]
 	 *   A map from aggregatable property names or aliases to objects containing the following
 	 *   details:
@@ -4279,10 +4449,13 @@ sap.ui.define([
 	 *       there is only one, or <code>null</code> otherwise ("multi-unit situation"). (SQL
 	 *       suggestion: <code>CASE WHEN MIN(Unit) = MAX(Unit) THEN MIN(Unit) END</code>)
 	 *   </ul>
+	 * @param {boolean} [oAggregation.createInPlace]
+	 *   Whether created nodes are shown in place at the position specified by the service
+	 *   (@experimental as of version 1.125.0); only the value <code>true</code> is allowed.
+	 *   Otherwise, created nodes are displayed out of place as the first child of their parent.
 	 * @param {number} [oAggregation.expandTo=1]
 	 *   The number (as a positive integer) of different levels initially available without calling
-	 *   {@link sap.ui.model.odata.v4.Context#expand} (@experimental as of version 1.105.0;
-	 *   available for read-only hierarchies since 1.117.0), supported only if a
+	 *   {@link sap.ui.model.odata.v4.Context#expand} (since 1.117.0), supported only if a
 	 *   <code>hierarchyQualifier</code> is given. Root nodes are on the first level. By default,
 	 *   only root nodes are available; they are not yet expanded. Since 1.120.0,
 	 *   <code>expandTo >= Number.MAX_SAFE_INTEGER</code> can be used to expand all levels
@@ -4312,14 +4485,14 @@ sap.ui.define([
 	 * @param {string} [oAggregation.hierarchyQualifier]
 	 *   The qualifier for the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy" and
 	 *   "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy" annotations at this binding's
-	 *   entity type (@experimental as of version 1.105.0; available for read-only hierarchies since
-	 *   1.117.0). If present, a recursive hierarchy without data aggregation is defined, and the
-	 *   only other supported properties are <code>expandTo</code> and <code>search</code>. A
-	 *   recursive hierarchy cannot be combined with:
+	 *   entity type (since 1.117.0). If present, a recursive hierarchy without data aggregation is
+	 *   defined, and the only other supported properties are <code>createInPlace</code>,
+	 *   <code>expandTo</code>, and <code>search</code>. A recursive hierarchy cannot be combined
+	 *   with:
 	 *   <ul>
 	 *     <li> "$search",
-	 *     <li> the <code>vGroup</code> parameter of {@link sap.ui.model.Sorter} (since 1.107.0),
-	 *     <li> shared requests (since 1.108.0).
+	 *     <li> the <code>vGroup</code> parameter of {@link sap.ui.model.Sorter},
+	 *     <li> shared requests.
 	 *   </ul>
 	 * @param {string} [oAggregation.search]
 	 *   Like the <a href=
@@ -4442,10 +4615,10 @@ sap.ui.define([
 					sResolvedPath = this.oModel.resolve(this.sPath, oContext);
 					// Note: oHeaderContext is missing only if called from c'tor
 					if (this.oHeaderContext && this.oHeaderContext.getPath() !== sResolvedPath) {
+						this.oHeaderContext.doSetSelected(false);
 						// Do not destroy the context immediately to avoid timing issues with
 						// dependent bindings, keep it in mPreviousContextsByPath to destroy it
 						// later
-						this.oHeaderContext.setSelected(false);
 						this.mPreviousContextsByPath[this.oHeaderContext.getPath()]
 							= this.oHeaderContext;
 						this.oHeaderContext = null;
@@ -4732,23 +4905,6 @@ sap.ui.define([
 		}
 	};
 
-	/**
-	 * Returns all currently existing contexts of this list binding in no special order.
-	 *
-	 * @returns {sap.ui.model.odata.v4.Context[]}
-	 *   All currently existing contexts of this list binding, in no special order
-	 *
-	 * @private
-	 * @see #getAllCurrentContexts
-	 */
-	ODataListBinding.prototype._getAllExistingContexts = function () {
-		return (this.aContexts ?? []).filter(function (oContext) {
-			return oContext;
-		}).concat(Object.values(this.mPreviousContextsByPath).filter(function (oContext) {
-			return oContext.isEffectivelyKeptAlive();
-		}));
-	};
-
 	//*********************************************************************************************
 	// "static" functions
 	//*********************************************************************************************