@openui5/sap.ui.core 1.121.1 → 1.122.0

package/src/sap/ui/model/odata/v2/ODataTreeBinding.js

@@ -38,8 +38,9 @@ sap.ui.define([
 	 *   The binding path, either absolute or relative to a given <code>oContext</code>
 	 * @param {sap.ui.model.Context} [oContext]
 	 *   The parent context which is required as base for a relative path
-	 * @param {sap.ui.model.Filter | sap.ui.model.Filter[]} [vFilters]
-	 *   The application filters to be used initially
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [vFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters]
 	 *   Map of binding parameters
 	 * @param {boolean} [mParameters.transitionMessagesOnly=false]
@@ -89,8 +90,8 @@ sap.ui.define([
 	 * @param {object} [mParameters.navigation]
 	 *   <b>Deprecated since 1.44:</b> A map describing the navigation properties between entity
 	 *   sets, which is used for constructing and paging the tree
-	 * @param {sap.ui.model.Sorter | sap.ui.model.Sorter[]} [vSorters]
-	 *   The dynamic sorters to be used initially
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [vSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in
 	 *   <code>vFilters</code> together with other filters
@@ -102,7 +103,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.TreeBinding
 	 * @hideconstructor
 	 * @public
-	 * @version 1.121.1
+	 * @version 1.122.0
 	 */
 	var ODataTreeBinding = TreeBinding.extend("sap.ui.model.odata.v2.ODataTreeBinding", /** @lends sap.ui.model.odata.v2.ODataTreeBinding.prototype */ {
 
@@ -1629,11 +1630,12 @@ sap.ui.define([
 	 * For more information, see {@link sap.ui.model.odata.v2.ODataModel#bindTree}.
 	 * <b>Note:</b> {@link sap.ui.model.odata.OperationMode.Auto} is deprecated since 1.102.0.
 	 *
-	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} aFilters
-	 *   Filter or array of filters to apply
-	 * @param {sap.ui.model.FilterType} sFilterType
-	 *   Type of the filter which should be adjusted. If it is not given,
-	 *   the type <code>FilterType.Control</code> is assumed
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.odata.v2.ODataModel#bindTree}; a falsy value is treated as an empty array and thus
+	 *   removes all filters of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType=sap.ui.model.FilterType.Control]
+	 *   The type of the filter to replace
 	 * @param {boolean} [bReturnSuccess]
 	 *   Whether to return <code>true</code> or <code>false</code>, instead of <code>this</code>,
 	 *   depending on whether the filtering has been done
@@ -1808,8 +1810,9 @@ sap.ui.define([
 	 * applied locally on the client.
 	 * <b>Note:</b> {@link sap.ui.model.odata.OperationMode.Auto} is deprecated since 1.102.0.
 	 *
-	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} aSorters
-	 *   The Sorter or an Array of sap.ui.model.Sorter instances
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters to use; they replace the sorters given in {@link sap.ui.model.odata.v2.ODataModel#bindTree}; a
+	 *   falsy value is treated as an empty array and thus removes all sorters
 	 * @param {boolean} [bReturnSuccess]
 	 *   Whether to return <code>true</code> or <code>false</code>, instead of <code>this</code>,
 	 *   depending on whether the sorting has been done

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

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.39.0
-		 * @version 1.121.1
+		 * @version 1.122.0
 		 */
 		Context = BaseContext.extend("sap.ui.model.odata.v4.Context", {
 				constructor : constructor
@@ -348,6 +348,24 @@ sap.ui.define([
 		);
 	};
 
+	/**
+	 * Deregisters the given change listener if it is registered for its path. Note: This
+	 * method is for special cases with a header context and the path "@$ui5.context.isSelected"
+	 * and should not be confused with <code>Cache#deregisterChangeListener</code>.
+	 *
+	 * @param {sap.ui.model.odata.v4.ODataPropertyBinding} oListener - The listener to be removed
+	 * @returns {boolean} - If this function has handled the deregistering
+	 *
+	 * @private
+	 */
+	Context.prototype.deregisterChangeListener = function (oListener) {
+		if (this.mChangeListeners && oListener.getPath() === "@$ui5.context.isSelected") {
+			_Helper.removeByPath(this.mChangeListeners, "", oListener);
+			return true;
+		}
+		return false;
+	};
+
 	/**
 	 * Destroys this context, that is, it removes this context from all dependent bindings and drops
 	 * references to binding and model, so that the context cannot be used anymore; it keeps path
@@ -373,6 +391,7 @@ sap.ui.define([
 			oDependentBinding.setContext(undefined);
 		});
 		this.oBinding = undefined;
+		delete this.mChangeListeners;
 		this.oCreatedPromise = undefined;
 		// keep oDeletePromise so that isDeleted does not unexpectedly become false
 		this.oSyncCreatePromise = undefined;
@@ -477,6 +496,19 @@ sap.ui.define([
 			}
 			throw new Error("Must not modify a deleted entity: " + this);
 		}
+
+		if (sPath === "@$ui5.context.isSelected") {
+			this.setSelected(vValue);
+
+			if (oGroupLock) {
+				oGroupLock.unlock();
+				oGroupLock = null;
+			}
+			if (this.oBinding.getHeaderContext?.() === this) {
+				return SyncPromise.resolve();
+			}
+		}
+
 		if (oGroupLock && this.isTransient() && !this.isInactive()) {
 			oValue = this.getValue();
 			oPromise = oValue && _Helper.getPrivateAnnotation(oValue, "transient");
@@ -577,6 +609,22 @@ sap.ui.define([
 		}, sPath, /*bSync*/false, /*bWithOrWithoutCache*/true);
 	};
 
+	/**
+	 * Sets the selected state for this context.
+	 *
+	 * @param {boolean} bSelected
+	 *   Whether this context is to be selected
+	 *
+	 * @private
+	 * @see #setSelected
+	 */
+	Context.prototype.doSetSelected = function (bSelected) {
+		this.bSelected = bSelected;
+		if (this.oBinding) {
+			this.oBinding.onKeepAliveChanged(this); // selected contexts are effectively kept alive
+		}
+	};
+
 	/**
 	 * Expands the group node that this context points to.
 	 *
@@ -663,25 +711,43 @@ sap.ui.define([
 	 * @returns {sap.ui.base.SyncPromise}
 	 *   A promise on the outcome of the binding's <code>fetchValue</code> call; it is rejected
 	 *   in case cached values are asked for, but not found
+	 * @throws {Error} If this context is a header context and no or empty path is given and
+	 *   a listener is given.
 	 *
 	 * @private
+	 * @see #getObject
+	 * @see #getProperty
 	 */
 	Context.prototype.fetchValue = function (sPath, oListener, bCached) {
-		var oBinding = this.oBinding;
+		var oBinding = this.oBinding,
+			that = this;
 
 		if (this.iIndex === iVIRTUAL) {
 			return SyncPromise.resolve(); // no cache access for virtual contexts
 		}
-		if (oBinding.getHeaderContext && oBinding.getHeaderContext() === this) {
+		if (oBinding.getHeaderContext?.() === this) {
 			if (sPath && sPath.startsWith(this.sPath)) {
 				sPath = sPath.slice(this.sPath.length + 1);
 			}
 			if (!sPath) {
-				return oBinding.fetchValue(this.sPath + "/$count", oListener, bCached)
-					.then(function (iCount) {
-						return {$count : iCount};
-					});
-			} else if (sPath !== "$count") {
+				if (oListener) {
+					throw new Error("Cannot register change listener for header context object");
+				}
+				return oBinding.fetchValue(this.sPath + "/$count", null, bCached).then((iCount) => {
+					return {
+						"@$ui5.context.isSelected" : that.bSelected,
+						$count : iCount
+					};
+				});
+			} else if (sPath === "@$ui5.context.isSelected") {
+				// @$ui5.context.isSelected is a virtual property for header contexts and not part
+				// of the cache (in contrast to row contexts, where it is saved in the cache).
+				// Therefore, change listeners are saved and fired via the header context
+				this.mChangeListeners ??= {};
+				_Helper.addByPath(this.mChangeListeners, "", oListener);
+
+				return SyncPromise.resolve(this.bSelected);
+			} else if (sPath !== "$count" && sPath !== "@$ui5.context.isSelected") {
 				throw new Error("Invalid header path: " + sPath);
 			}
 		}
@@ -851,8 +917,8 @@ sap.ui.define([
 	 * Returns <code>undefined</code> if the data is not (yet) available; no request is triggered.
 	 * Use {@link #requestObject} for asynchronous access.
 	 *
-	 * The header context of a list binding only delivers <code>$count</code> (wrapped in an object
-	 * if <code>sPath</code> is "").
+	 * The header context of a list binding only delivers <code>$count</code> and
+	 * <code>@$ui5.context.isSelected</code> (wrapped in an object if <code>sPath</code> is "").
 	 *
 	 * @param {string} [sPath=""]
 	 *   A path relative to this context
@@ -860,7 +926,7 @@ sap.ui.define([
 	 *   The requested value
 	 * @throws {Error}
 	 *   If the context's root binding is suspended or if the context is a header context and the
-	 *   path is neither empty nor "$count".
+	 *   path is neither empty, "$count", nor "@ui5.context.isSelected".
 	 *
 	 * @public
 	 * @see sap.ui.model.Context#getObject
@@ -886,8 +952,8 @@ sap.ui.define([
 	 *     <li> this context is not part of a recursive hierarchy.
 	 *   </ul>
 	 *
-	 * @experimental As of version 1.120.0
 	 * @public
+	 * @since 1.122.0
 	 */
 	Context.prototype.getParent = function () {
 		if (!this.oBinding.fetchOrGetParent) {
@@ -914,7 +980,8 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li> the context's root binding is suspended,
 	 *     <li> the value is not primitive,
-	 *     <li> or the context is a header context and the path is not "$count"
+	 *     <li> or the context is a header context and the path is not "$count" or
+	 *        "@ui5.context.isSelected".
 	 *   </ul>
 	 *
 	 * @public
@@ -1157,7 +1224,9 @@ sap.ui.define([
 
 	/**
 	 * Tells whether this context is currently selected, but not {@link #delete deleted} on the
-	 * client.
+	 * client. Since 1.122.0 the selection state can also be accessed via instance annotation
+	 * "@$ui5.context.isSelected" at the entity. Note that the annotation does not take the deletion
+	 * state into account.
 	 *
 	 * @returns {boolean} Whether this context is currently selected
 	 *
@@ -1376,8 +1445,8 @@ sap.ui.define([
 	 * Note that the function clones the result. Modify values via
 	 * {@link sap.ui.model.odata.v4.Context#setProperty}.
 	 *
-	 * The header context of a list binding only delivers <code>$count</code> (wrapped in an object
-	 * if <code>sPath</code> is "").
+	 * The header context of a list binding only delivers <code>$count</code> and
+	 * <code>@$ui5.context.isSelected</code> (wrapped in an object if <code>sPath</code> is "").
 	 *
 	 * In case of a {@link sap.ui.model.odata.v4.ODataContextBinding#getBoundContext context
 	 * binding's bound context} that hasn't requested its data yet, this method causes an initial
@@ -1394,7 +1463,7 @@ sap.ui.define([
 	 *   A promise on the requested value
 	 * @throws {Error}
 	 *   If the context's root binding is suspended, or if the context is a header context and the
-	 *   path is neither empty nor "$count"
+	 *   path is neither empty, "$count", nor "@$ui5.context.isSelected".
 	 *
 	 * @public
 	 * @see #getBinding
@@ -1412,8 +1481,6 @@ sap.ui.define([
 	 * Requests the parent node (in case of a recursive hierarchy; see
 	 * {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation}).
 	 *
-	 * Note: <strong>DO NOT</strong> call {@link #setKeepAlive} on the resulting context!
-	 *
 	 * @returns {Promise<sap.ui.model.odata.v4.Context|null>} A promise which:
 	 *   <ul>
 	 *     <li> Resolves if successful with either the parent node or <code>null</code> for a root
@@ -1426,9 +1493,9 @@ sap.ui.define([
 	 *     <li> this context is not part of a recursive hierarchy.
 	 *    </ul>
 	 *
-	 * @experimental As of version 1.120.0
 	 * @public
 	 * @see #getParent
+	 * @since 1.122.0
 	 */
 	Context.prototype.requestParent = function () {
 		if (!this.oBinding.fetchOrGetParent) {
@@ -1450,7 +1517,7 @@ sap.ui.define([
 	 *   given property paths that format corresponding to the properties' EDM types and constraints
 	 * @returns {Promise<any>}
 	 *   A promise on the requested value or values; it is rejected if a value is not primitive or
-	 *   if the context is a header context and a path is not "$count"
+	 *   if the context is a header context and a path is not "$count" or "@$ui5.context.isSelected"
 	 * @throws {Error}
 	 *   If the context's root binding is suspended
 	 *
@@ -2019,7 +2086,10 @@ sap.ui.define([
 	/**
 	 * Sets a new value for the property identified by the given path. The path is relative to this
 	 * context and is expected to point to a structural property with primitive type or, since
-	 * 1.85.0, to an instance annotation.
+	 * 1.85.0, to an instance annotation. Since 1.122.0 the client-side annotation
+	 * "@$ui5.context.isSelected" can be given as a path. Note: Writing to a client-side
+	 * annotation never triggers a PATCH request, even if <code>sGroupId</code> is given.
+	 * Thus, reverting the value of this annotation cannot be done via {@link #resetChanges}.
 	 *
 	 * @param {string} sPath
 	 *   A path relative to this context
@@ -2027,7 +2097,8 @@ sap.ui.define([
 	 *   The new value which must be primitive
 	 * @param {string} [sGroupId]
 	 *   The group ID to be used for the PATCH request; if not specified, the update group ID for
-	 *   the context's binding is used, see {@link #getUpdateGroupId}. Since 1.74.0, you can use
+	 *   the context's binding is used, see {@link #getUpdateGroupId}. When writing to a client-side
+	 *   annotation, <code>null</code> is used automatically. Since 1.74.0, you can use
 	 *   <code>null</code> to prevent the PATCH request.
 	 * @param {boolean} [bRetry]
 	 *   Since 1.85.0, if <code>true</code> the property is not reset if the PATCH request failed.
@@ -2094,10 +2165,12 @@ sap.ui.define([
 	};
 
 	/**
-	 * Determines whether this context is currently selected. If the preconditions of
-	 * {@link #setKeepAlive} hold, a best effort is made to implicitly keep a selected context alive
-	 * in order to preserve the selection state. While a context is currently
-	 * {@link #delete deleted} on the client, it does not appear as {@link #isSelected selected}.
+	 * Sets whether this context is currently selected. While a context is currently
+	 * {@link #delete deleted} on the client, it does not appear as {@link #isSelected selected}. If
+	 * the preconditions of {@link #setKeepAlive} hold, a best effort is made to implicitly keep a
+	 * selected context alive in order to preserve the selection state. Once the selection is no
+	 * longer needed, for example because you perform an operation on this context which logically
+	 * removes it from its list, you need to reset the selection.
 	 *
 	 * <b>Note:</b> It is unsafe to keep a reference to a context instance which is not
 	 * {@link #isKeepAlive kept alive}.
@@ -2118,10 +2191,18 @@ sap.ui.define([
 		if (bSelected && this.isDeleted()) {
 			throw new Error("Must not select a deleted entity: " + this);
 		}
-		this.bSelected = bSelected;
-		if (this.oBinding) {
-			this.oBinding.onKeepAliveChanged(this); // selected contexts are effectively kept alive
+		if (bSelected !== this.bSelected) {
+			if (this.mChangeListeners) {
+				_Helper.fireChange(this.mChangeListeners, "", bSelected);
+			}
+			this.withCache((oCache, sPath) => {
+				if (this.oBinding) {
+					oCache.setProperty("@$ui5.context.isSelected", bSelected, sPath);
+				} // else: context already destroyed
+			}, "");
 		}
+
+		this.doSetSelected(bSelected);
 	};
 
 	/**

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

@@ -560,9 +560,11 @@ sap.ui.define([
 							throw oError;
 						});
 					}
-					that.oFetchCacheCallToken = undefined; // cleanup
-					return that.createAndSetCache(mQueryOptions, sResourcePath, oContext,
-						sGroupId, oCallToken.oOldCache);
+					return that.oModel.waitForKeepAliveBinding(that).then(function () {
+						that.oFetchCacheCallToken = undefined; // cleanup
+						return that.createAndSetCache(mQueryOptions, sResourcePath, oContext,
+							sGroupId, oCallToken.oOldCache);
+					});
 				});
 			}
 
@@ -1207,7 +1209,9 @@ sap.ui.define([
 	 * group ID and notifies the control that new data is available.
 	 *
 	 * Refresh is supported for bindings which are not relative to an
-	 * {@link sap.ui.model.odata.v4.Context}.
+	 * {@link sap.ui.model.odata.v4.Context}, as well as (since 1.122.0) for bindings with the
+	 * <code>$$ownRequest</code> parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}
+	 * and {@link sap.ui.model.odata.v4.ODataModel#bindContext})
 	 *
 	 * Note: When calling {@link #refresh} multiple times, the result of the request triggered by
 	 * the last call determines the binding's data; it is <b>independent</b> of the order of calls
@@ -1392,7 +1396,7 @@ sap.ui.define([
 	 * @since 1.87.0
 	 */
 	ODataBinding.prototype.requestRefresh = function (sGroupId) {
-		if (!this.isRoot()) {
+		if (!this.mParameters?.$$ownRequest && !this.isRoot()) {
 			throw new Error("Refresh on this binding is not supported");
 		}
 		if (this.hasPendingChanges(true)) {

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

@@ -74,7 +74,7 @@ sap.ui.define([
 		 * @mixes sap.ui.model.odata.v4.ODataParentBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.121.1
+		 * @version 1.122.0
 		 *
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getGroupId as #getGroupId
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getRootBinding as #getRootBinding

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.121.1
+		 * @version 1.122.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
@@ -934,7 +934,7 @@ sap.ui.define([
 				return;
 			}
 
-			oContext.setSelected(false);
+			oContext.doSetSelected(false);
 			that.removeCreated(oContext);
 			return Promise.resolve().then(function () {
 				// Fire the change asynchronously so that Cache#delete is finished and #getContexts
@@ -1073,9 +1073,10 @@ sap.ui.define([
 				sPredicate = _Helper.getPrivateAnnotation(aResults[i], "predicate");
 				sContextPath = sPath + (sPredicate || "/" + i$skipIndex);
 				oContext = this.mPreviousContextsByPath[sContextPath];
-				if (oContext && (!oContext.created() || oContext.isEffectivelyKeptAlive())) {
+				if (oContext && (!oContext.created() || oContext.isEffectivelyKeptAlive()
+						|| this.mParameters.$$aggregation?.hierarchyQualifier)) {
 					// reuse the previous context, unless it is created (and persisted), but not
-					// kept alive
+					// kept alive; always reuse created contexts in a recursive hierarchy
 					delete this.mPreviousContextsByPath[sContextPath];
 					oContext.iIndex = i$skipIndex;
 					oContext.checkUpdate();
@@ -1885,7 +1886,7 @@ sap.ui.define([
 	  * @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>}
+	 *     Promise<sap.ui.model.odata.v4.Context>|sap.ui.base.SyncPromise}
 	 *   <ul>
 	 *     <li> The parent node if already known,
 	 *     <li> <code>null</code> if the given node is a root node and thus has no parent,
@@ -2721,7 +2722,8 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the header context which allows binding to <code>$count</code>.
+	 * Returns the header context which allows binding to <code>$count</code> or
+	 * <code>@$ui5.context.isSelected</code>.
 	 *
 	 * @returns {sap.ui.model.odata.v4.Context|null}
 	 *   The header context or <code>null</code> if the binding is relative and has no context
@@ -3479,7 +3481,8 @@ sap.ui.define([
 				} else {
 					that.fetchCache(that.oContext, false, /*bKeepQueryOptions*/true,
 						bKeepCacheOnError ? sGroupId : undefined);
-					oKeptElementsPromise = that.refreshKeptElements(sGroupId);
+					oKeptElementsPromise = that.refreshKeptElements(sGroupId,
+						/*bIgnorePendingChanges*/ bKeepCacheOnError);
 					if (that.iCurrentEnd > 0) {
 						oPromise = that.createRefreshPromise(
 							/*bPreventBubbling*/bKeepCacheOnError
@@ -3538,13 +3541,15 @@ sap.ui.define([
 	 *
 	 * @param {string} sGroupId
 	 *   The effective group ID
+	 * @param {boolean} bIgnorePendingChanges
+	 *   Whether kept elements are refreshed although there are pending changes.
 	 * @returns {sap.ui.base.SyncPromise}
 	 *   A promise which is resolved without a defined result, or rejected with an error if the
 	 *   refresh fails.
 	 *
 	 * @private
 	 */
-	ODataListBinding.prototype.refreshKeptElements = function (sGroupId) {
+	ODataListBinding.prototype.refreshKeptElements = function (sGroupId, bIgnorePendingChanges) {
 		var that = this;
 
 		return this.oCachePromise.then(function (oCache) {
@@ -3558,7 +3563,7 @@ sap.ui.define([
 					if (iIndex >= 0) { // Note: implies oContext.created()
 						that.removeCreated(oContext);
 					}
-				});
+				}, false, bIgnorePendingChanges);
 		}).catch(function (oError) {
 			that.oModel.reportError("Failed to refresh kept-alive elements", sClassName, oError);
 			throw oError;

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

@@ -156,7 +156,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.121.1
+		 * @version 1.122.0
 		 */
 		ODataMetaModel = MetaModel.extend("sap.ui.model.odata.v4.ODataMetaModel", {
 				constructor : constructor
@@ -1773,7 +1773,8 @@ sap.ui.define([
 					oProperty = bInsideAnnotation ? {} : oType[sPropertyName];
 					if (!oProperty) {
 						if (sPropertyName.includes("@")) {
-							if (sPropertyName.includes("@$ui5.")) {
+							if (sPropertyName.includes("@$ui5.")
+									&& sPropertyName !== "@$ui5.context.isSelected") {
 								error("Read-only path must not be updated");
 							}
 							bInsideAnnotation = true;
@@ -2859,7 +2860,7 @@ sap.ui.define([
 	 * with a dot, which is stripped before lookup; see the <code>&lt;template:alias></code>
 	 * instruction for XML Templating. In case of an absolute name, it is searched in
 	 * <code>mParameters.scope</code> first and then in the global namespace. (Using the global
-	 * namespace is @deprecated as of version 1.120.3). The names "requestCurrencyCodes" and
+	 * namespace is deprecated as of version 1.120.3). The names "requestCurrencyCodes" and
 	 * "requestUnitsOfMeasure" default to {@link #requestCurrencyCodes} and
 	 * {@link #requestUnitsOfMeasure} resp. if not present in <code>mParameters.scope</code>. This
 	 * function is called with the current object (or primitive value) and additional details and

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

@@ -235,7 +235,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.Model
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.121.1
+		 * @version 1.122.0
 		 */
 		ODataModel = Model.extend("sap.ui.model.odata.v4.ODataModel",
 			/** @lends sap.ui.model.odata.v4.ODataModel.prototype */{
@@ -1073,7 +1073,8 @@ sap.ui.define([
 	};
 
 	/**
-	 * Method not supported
+	 * Method not supported, use {@link #bindList} with <code>mParameters.$$aggregation</code>
+	 * instead.
 	 *
 	 * @param {string} _sPath
 	 * @param {sap.ui.model.Context} [_oContext]
@@ -1772,6 +1773,8 @@ sap.ui.define([
 	 *   A list of all dependent bindings, never <code>null</code>
 	 *
 	 * @private
+	 * @since 1.122.0
+	 * @ui5-restricted sap.fe
 	 */
 	ODataModel.prototype.getDependentBindings = function (oParent) {
 		return this.aAllBindings.filter(function (oBinding) {
@@ -2852,6 +2855,28 @@ sap.ui.define([
 		return sClassName + ": " + this.sServiceUrl;
 	};
 
+	/**
+	 * Waits until the temporary keep-alive binding matching the given binding has created its
+	 * cache, if required and there is such a binding.
+	 *
+	 * @param {sap.ui.model.odata.v4.ODataBinding} oBinding
+	 *   The binding that possibly needs the cache of a temporary keep-alive binding
+	 * @returns {sap.ui.base.SyncPromise}
+	 *   A promise which is resolved without a defined result when that cache is available
+	 *
+	 * @private
+	 */
+	ODataModel.prototype.waitForKeepAliveBinding = function (oBinding) {
+		if (oBinding.mParameters?.$$getKeepAliveContext) {
+			// $$canonicalPath is not allowed, binding path and resource path are (almost) identical
+			const oTemporaryBinding = this.mKeepAliveBindingsByPath[oBinding.getResolvedPath()];
+			if (oTemporaryBinding) {
+				return oTemporaryBinding.oCachePromise;
+			}
+		}
+		return SyncPromise.resolve();
+	};
+
 	/**
 	 * Iterates over this model's unresolved bindings and calls the function with the given name on
 	 * each unresolved binding, passing the given parameter. Iteration stops if a function call on

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.121.1
+		 * @version 1.122.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
@@ -101,6 +101,9 @@ sap.ui.define([
 			this.sGroupId = undefined;
 			this.bNoPatch = false;
 		}
+		if (this.sPath === "@$ui5.context.isSelected") {
+			this.bNoPatch = true;
+		}
 		this.oCheckUpdateCallToken = undefined;
 		this.oContext = oContext;
 		this.bHasDeclaredType = undefined; // whether the binding info declares a type
@@ -338,7 +341,8 @@ sap.ui.define([
 			});
 			if (bForceUpdate && vValue.isFulfilled()) {
 				if (vType && vType.isFulfilled && vType.isFulfilled()) {
-					this.oType = vType.getResult();
+					PropertyBinding.prototype.setType
+						.call(this, vType.getResult(), this.sInternalType);
 				}
 				this.vValue = vValue.getResult();
 			}
@@ -352,7 +356,7 @@ sap.ui.define([
 
 			if (oCallToken === that.oCheckUpdateCallToken) { // latest call to checkUpdateInternal
 				that.oCheckUpdateCallToken = undefined;
-				that.oType = oType;
+				PropertyBinding.prototype.setType.call(that, oType, that.sInternalType);
 				if (oCallToken.forceUpdate || that.vValue !== vValue) {
 					that.bInitial = false;
 					that.vValue = vValue;
@@ -370,11 +374,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * Deregisters the binding as change listener from its cache or operation binding ($Parameter).
+	 * Deregisters the binding as change listener from its context if applicable. If not, it will be
+	 * deregistered from the cache or operation binding ($Parameter).
 	 *
 	 * @private
 	 */
 	ODataPropertyBinding.prototype.deregisterChangeListener = function () {
+		if (this.bRelative && this.oContext?.deregisterChangeListener?.(this)) {
+			return;
+		}
 		if (this.sReducedPath) {
 			this.doDeregisterChangeListener(this.sReducedPath, this);
 		}
@@ -687,7 +695,7 @@ sap.ui.define([
 						// Note: this.oType => this.sReducedPath
 						&& _Helper.getMetaPath(this.oModel.resolve(this.sPath, oContext))
 							!== _Helper.getMetaPath(this.sReducedPath)) {
-						this.oType = undefined;
+						PropertyBinding.prototype.setType.call(this, undefined, this.sInternalType);
 					}
 					this.sReducedPath = undefined;
 				}
@@ -736,7 +744,10 @@ sap.ui.define([
 	 * be updated on the server, an error is logged to the console and added to the message manager
 	 * as a technical message. Unless preconditions fail synchronously, a
 	 * {@link sap.ui.model.odata.v4.ODataModel#event:propertyChange 'propertyChange'} event is
-	 * fired and provides a promise on the outcome of the asynchronous operation.
+	 * fired and provides a promise on the outcome of the asynchronous operation. Since 1.122.0
+	 * this method allows updates to the client-side annotation "@$ui5.context.isSelected". Note:
+	 * Changing the value of a client-side annotation never triggers a PATCH request, no matter
+	 * which <code>sGroupId</code> is given. Thus, it cannot be reverted via {@link #resetChanges}.
 	 *
 	 * @param {any} vValue
 	 *   The new value which must be primitive
@@ -744,7 +755,8 @@ sap.ui.define([
 	 *   The group ID to be used for this update call; if not specified, the update group ID for
 	 *   this binding (or its relevant parent binding) is used, see {@link #getUpdateGroupId}.
 	 *   Valid values are <code>undefined</code>, '$auto', '$auto.*', '$direct' or application group
-	 *   IDs as specified in {@link sap.ui.model.odata.v4.ODataModel}.
+	 *   IDs as specified in {@link sap.ui.model.odata.v4.ODataModel}. When writing to a client-side
+	 *   annotation, this parameter is ignored.
 	 * @throws {Error} If
 	 *   <ul>
 	 *     <li> the binding's root binding is suspended.