@openui5/sap.ui.core 1.133.0 → 1.134.0

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

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @class Annotation loader for OData V2 services
 	 *
 	 * @author SAP SE
-	 * @version 1.133.0
+	 * @version 1.134.0
 	 *
 	 * @public
 	 * @since 1.37.0
@@ -835,8 +835,9 @@ sap.ui.define([
 	 * @returns {Object<string,string>} A map of all public and private headers.
 	 */
 	ODataAnnotations.prototype._getHeaders = function() {
-		//The 'sap-cancel-on-close' header marks the OData annotation request as cancelable. This helps to save resources at the back-end.
-		return extend({"sap-cancel-on-close": true}, this.getHeaders(), {
+		// The 'sap-cancel-on-close' header marks the OData annotation request as cancelable. This helps to save
+		// resources at the back-end.
+		return extend({"sap-cancel-on-close": "true"}, this.getHeaders(), {
 			"Accept-Language": Localization.getLanguageTag().toString() // Always overwrite
 		});
 	};

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

@@ -2255,8 +2255,8 @@ sap.ui.define([
 
 	/**
 	 * Returns the count of active entries in the list if the list length is final, otherwise
-	 * <code>undefined</code>. Contrary to {#getLength}, this method does not consider inactive
-	 * entries which are created via {#create}.
+	 * <code>undefined</code>. Contrary to {@link #getLength}, this method does not consider inactive
+	 * entries which are created via {@link #create}.
 	 *
 	 * @returns {number|undefined} The count of entries
 	 *

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

@@ -218,7 +218,7 @@ sap.ui.define([
 	 * This model is not prepared to be inherited from.
 	 *
 	 * @author SAP SE
-	 * @version 1.133.0
+	 * @version 1.134.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.odata.v2.ODataModel
@@ -270,7 +270,8 @@ sap.ui.define([
 			}
 
 			// Creates a parameters map to be used for the instantiation of the code list model,
-			// based on this OData model's parameters
+			// based on this OData model's parameters; createCodeListModelParameters has to be
+			// called before the service URL is modified
 			this.mCodeListModelParams = this.createCodeListModelParameters(mParameters);
 
 			if (mParameters) {
@@ -337,7 +338,9 @@ sap.ui.define([
 			this.mChangeHandles = {};
 			this.mDeferredGroups = {};
 			this.mLaunderingState = {};
-			this.sDefaultUpdateMethod = ODataModel._fixUpdateMethod(sDefaultUpdateMethod) || UpdateMethod.MERGE;
+			/** @deprecated As of version 1.133.0, reason sap.ui.model.odata.UpdateMethod.Merge|Put */
+			sDefaultUpdateMethod = ODataModel._fixUpdateMethod(sDefaultUpdateMethod);
+			this.sDefaultUpdateMethod = sDefaultUpdateMethod || UpdateMethod.MERGE;
 
 			this.bTokenHandling = vTokenHandling !== false;
 			this.bWithCredentials = bWithCredentials === true;
@@ -973,6 +976,7 @@ sap.ui.define([
 	 *
 	 * @param {string} [sUpdateMethod] The update method to fix
 	 * @returns {string|undefined} The fixed update method
+	 * @deprecated As of version 1.133.0, reason sap.ui.model.odata.UpdateMethod.Merge|Put
 	 * @private
 	 */
 	ODataModel._fixUpdateMethod = function (sUpdateMethod) {
@@ -2157,6 +2161,9 @@ sap.ui.define([
 	 * <b>not</b> support the operation modes <code>Client</code> and <code>Auto</code>.
 	 * <b>Note:</b> {@link sap.ui.model.odata.OperationMode.Auto} is deprecated since 1.102.0.
 	 *
+	 * <b>Note:</b> OData tree bindings do neither support
+	 * {@link sap.ui.model.Binding#suspend suspend} nor {@link sap.ui.model.Binding#resume resume}.
+	 *
 	 * @param {string} sPath
 	 *   The binding path, either absolute or relative to a given <code>oContext</code>
 	 * @param {sap.ui.model.Context} [oContext]
@@ -4017,16 +4024,17 @@ sap.ui.define([
 		var sUrl, oRequest,
 		oChangeHeader = {},
 		oPayload = {},
-		bCancelOnClose = true;
+		sCancelOnClose = "true";
 
 		oPayload.__batchRequests = aBatchRequests;
 
 
 		// If one requests leads to data changes at the back-end side, the canceling of the batch request must be prevented.
 		for (var sIndex in aBatchRequests) {
-			if (aBatchRequests[sIndex] && aBatchRequests[sIndex].__changeRequests ||
-				aBatchRequests[sIndex] && aBatchRequests[sIndex].headers && !aBatchRequests[sIndex].headers['sap-cancel-on-close']) {
-				bCancelOnClose = false;
+			if (aBatchRequests[sIndex] && aBatchRequests[sIndex].__changeRequests
+				|| aBatchRequests[sIndex] && aBatchRequests[sIndex].headers
+					&& aBatchRequests[sIndex].headers['sap-cancel-on-close'] !== "true") {
+				sCancelOnClose = "false";
 				break;
 			}
 		}
@@ -4045,7 +4053,7 @@ sap.ui.define([
 		// reset
 		delete oChangeHeader["Content-Type"];
 
-		oChangeHeader['sap-cancel-on-close'] = bCancelOnClose;
+		oChangeHeader['sap-cancel-on-close'] = sCancelOnClose;
 
 		oRequest = {
 				headers : oChangeHeader,
@@ -7082,8 +7090,10 @@ sap.ui.define([
 				}
 			});
 		}
-		//The 'sap-cancel-on-close' header marks the OData request as cancelable. This helps to save resources at the back-end.
-		return extend({'sap-cancel-on-close': !!bCancelOnClose}, this.mCustomHeaders, mCheckedHeaders, this.oHeaders);
+		// The 'sap-cancel-on-close' header marks the OData request as cancelable. This helps to save resources at the
+		// back-end.
+		return extend({'sap-cancel-on-close': String(!!bCancelOnClose)}, this.mCustomHeaders, mCheckedHeaders,
+			this.oHeaders);
 	};
 
 	/**
@@ -7641,7 +7651,8 @@ sap.ui.define([
 			vProperties = mParameters.properties;
 			sGroupId = mParameters.groupId || mParameters.batchGroupId;
 			sChangeSetId = mParameters.changeSetId;
-			oContext  = mParameters.context;
+			// ignore context if path is absolute
+			oContext  = sPath.startsWith("/") ? undefined : mParameters.context;
 			fnSuccess = mParameters.success;
 			fnError   = mParameters.error;
 			fnCreated = mParameters.created;
@@ -7779,9 +7790,8 @@ sap.ui.define([
 	 * @property {string} message Error message returned by the 503 HTTP status response
 	 * @property {Date} retryAfter The earliest point in time the request may be repeated
 	 *
-	 * @private
-	 * @ui5-restricted sap.suite.ui.generic.template
-	 * @since 1.127.0
+	 * @public
+	 * @since 1.134.0
 	 */
 
 	/**
@@ -7804,9 +7814,8 @@ sap.ui.define([
 	 * @param {function(module:sap/ui/model/odata/v2/RetryAfterError):Promise<undefined>} fnRetryAfter
 	 *   A "Retry-After" handler
 	 *
-	 * @private
-	 * @ui5-restricted sap.suite.ui.generic.template
-	 * @since 1.127.0
+	 * @public
+	 * @since 1.134.0
 	 */
 	ODataModel.prototype.setRetryAfterHandler = function (fnRetryAfter) {
 		this.fnRetryAfter = fnRetryAfter;

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

@@ -103,7 +103,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.TreeBinding
 	 * @hideconstructor
 	 * @public
-	 * @version 1.133.0
+	 * @version 1.134.0
 	 */
 	var ODataTreeBinding = TreeBinding.extend("sap.ui.model.odata.v2.ODataTreeBinding", /** @lends sap.ui.model.odata.v2.ODataTreeBinding.prototype */ {
 

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

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.39.0
-		 * @version 1.133.0
+		 * @version 1.134.0
 		 */
 		Context = BaseContext.extend("sap.ui.model.odata.v4.Context", {
 				constructor : constructor
@@ -208,8 +208,7 @@ sap.ui.define([
 	 *   A promise which is resolved without a defined result when the entity represented by this
 	 *   context has been created in the back end. It is rejected with an <code>Error</code>
 	 *   instance where <code>oError.canceled === true</code> if the transient entity is deleted
-	 *   before it is created in the back end, for example via
-	 *   {@link sap.ui.model.odata.v4.Context#delete},
+	 *   before it is created in the back end, for example via {@link #delete},
 	 *   {@link sap.ui.model.odata.v4.ODataListBinding#resetChanges} or
 	 *   {@link sap.ui.model.odata.v4.ODataModel#resetChanges}, and for all nested contexts within a
 	 *   deep create. It is rejected with an <code>Error</code> instance without
@@ -435,7 +434,7 @@ sap.ui.define([
 	 *   instance of <code>Error</code> in case of failure
 	 *
 	 * @private
-	 * @see sap.ui.model.odata.v4.Context#delete
+	 * @see #delete
 	 */
 	Context.prototype.doDelete = function (oGroupLock, sEditUrl, sPath, oETagEntity, oBinding,
 			fnCallback) {
@@ -1646,8 +1645,7 @@ sap.ui.define([
 	 * any part thereof. The data is a JSON structure as described in <a href=
 	 * "https://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html"
 	 * >"OData JSON Format Version 4.0"</a>.
-	 * Note that the function clones the result. Modify values via
-	 * {@link sap.ui.model.odata.v4.Context#setProperty}.
+	 * Note that the function clones the result. Modify values via {@link #setProperty}.
 	 *
 	 * 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 "").
@@ -2119,8 +2117,7 @@ sap.ui.define([
 	/**
 	 * Resets all property changes, created entities, and entity deletions of this context. Resets
 	 * also invalid user input and inactive contexts which had their activation prevented (see
-	 * {@link sap.ui.model.odata.v4.Context#isInactive}). This function does not reset the
-	 * invocation of OData operations (see
+	 * {@link #isInactive}). This function does not reset the invocation of OData operations (see
 	 * {@link sap.ui.model.odata.v4.ODataContextBinding#invoke}). For a context which is currently
 	 * {@link #delete deleted} on the client, but not yet on the server, this method cancels the
 	 * deletion and restores the context.

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

@@ -403,7 +403,7 @@ sap.ui.define([
 	 * Destroys the object. The object must not be used anymore after this function was called.
 	 *
 	 * @public
-	 * @since 1.66
+	 * @since 1.66.0
 	 */
 	ODataBinding.prototype.destroy = function () {
 		this.mCacheByResourcePath = undefined;
@@ -422,8 +422,8 @@ sap.ui.define([
 	};
 
 	/**
-	 * Hook method for {@link sap.ui.model.odata.v4.ODataBinding#fetchCache} to create a cache for
-	 * this binding with the given resource path and query options.
+	 * Hook method for {@link #fetchCache} to create a cache for this binding with the given
+	 * resource path and query options.
 	 *
 	 * @param {string} sResourcePath
 	 *   The resource path, for example "EMPLOYEES"
@@ -1428,8 +1428,9 @@ sap.ui.define([
 	 *     <li> the binding's root binding is suspended,
 	 *     <li> there is a change of this binding which has been sent to the server and for which
 	 *       there is no response yet,
-	 *     <li> the binding is {@link #isTransient transient} (part of a
-	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}).
+	 *     <li> the binding is part of a
+	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create} because it is
+	 *       relative to a {@link sap.ui.model.odata.v4.Context#isTransient transient} context,
 	 *   </ul>
 	 *
 	 * @public
@@ -1561,7 +1562,7 @@ sap.ui.define([
 	 * @param {Promise[]} aPromises
 	 *   List of (sync) promises which is extended for each call to
 	 *   {@link sap.ui.model.odata.v4.ODataParentBinding#requestSideEffects} or
-	 *   {@link sap.ui.model.odata.v4.ODataBinding#refreshInternal}.
+	 *   {@link #refreshInternal}
 	 * @param {string} [sPrefix=""]
 	 *   Prefix for navigation property meta paths; must only be used during recursion
 	 *

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.133.0
+		 * @version 1.134.0
 		 *
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getGroupId as #getGroupId
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getRootBinding as #getRootBinding
@@ -1287,9 +1287,8 @@ sap.ui.define([
 	 *
 	 * @param {string} [sGroupId]
 	 *   The group ID to be used for the request; if not specified, the group ID for this binding is
-	 *   used, see {@link sap.ui.model.odata.v4.ODataContextBinding#constructor} and
-	 *   {@link #getGroupId}. To use the update group ID, see {@link #getUpdateGroupId}, it needs to
-	 *   be specified explicitly.
+	 *   used, see {@link #constructor} and {@link #getGroupId}. To use the update group ID, see
+	 *   {@link #getUpdateGroupId}, it needs to be specified explicitly.
 	 *   Valid values are <code>undefined</code>, '$auto', '$auto.*', '$direct', '$single', or
 	 *   application group IDs as specified in {@link sap.ui.model.odata.v4.ODataModel}. If
 	 *   '$single' is used, the request will be sent as fast as '$direct', but wrapped in a batch

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

@@ -59,7 +59,7 @@ sap.ui.define([
 		 * @mixes sap.ui.model.odata.v4.ODataParentBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.133.0
+		 * @version 1.134.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
@@ -882,9 +882,9 @@ sap.ui.define([
 	 *   <br>
 	 *   Since 1.98.0, when the first property updates happens, the context is no longer
 	 *   {@link sap.ui.model.odata.v4.Context#isInactive inactive} and the
-	 *   {@link sap.ui.model.odata.v4.ODataListBinding#event:createActivate 'createActivate'} event
-	 *   is fired. While inactive, it does not count as a {@link #hasPendingChanges pending change}
-	 *   and does not contribute to the {@link #getCount count}.
+	 *   {@link #event:createActivate 'createActivate'} event is fired. While inactive, it does not
+	 *   count as a {@link #hasPendingChanges pending change} and does not contribute to the
+	 *   {@link #getCount count}.
 	 * @returns {sap.ui.model.odata.v4.Context}
 	 *   The context object for the created entity; its method
 	 *   {@link sap.ui.model.odata.v4.Context#created} returns a promise that is resolved when the
@@ -1853,7 +1853,7 @@ sap.ui.define([
 	 *   A promise that is resolved with the download URL or <code>null</code>
 	 * @throws {Error}
 	 *   If the binding is unresolved or is {@link #isTransient transient} (part of a
-	 *   {@link sap.ui.model.odata.v4.ODataListBinding#create deep create})
+	 *   {@link #create deep create})
 	 *
 	 * @private
 	 */
@@ -1931,20 +1931,21 @@ sap.ui.define([
 				return bToLower ? "tolower(" + sText + ")" : sText;
 			}
 
-			bToLower = sEdmType === "Edm.String" && oFilter.bCaseSensitive === false;
+			bToLower = sEdmType === "Edm.String" && oFilter.isCaseSensitive() === false;
 			sFilterPath = bThese && !aFiltersNoThese?.includes(oFilter)
-				? setCase(`$these/aggregate(${oFilter.sPath})`)
-				: setCase(decodeURIComponent(oFilter.sPath));
-			sValue = setCase(_Helper.formatLiteral(oFilter.oValue1, sEdmType));
+				? setCase(`$these/aggregate(${oFilter.getPath()})`)
+				: setCase(decodeURIComponent(oFilter.getPath()));
+			sValue = setCase(_Helper.formatLiteral(oFilter.getValue1(), sEdmType));
 
-			switch (oFilter.sOperator) {
+			switch (oFilter.getOperator()) {
 				case FilterOperator.BT:
 					sFilter = sFilterPath + " ge " + sValue + " and " + sFilterPath + " le "
-						+ setCase(_Helper.formatLiteral(oFilter.oValue2, sEdmType));
+						+ setCase(_Helper.formatLiteral(oFilter.getValue2(), sEdmType));
 					break;
 				case FilterOperator.NB:
 					sFilter = wrap(sFilterPath + " lt " + sValue + " or " + sFilterPath + " gt "
-						+ setCase(_Helper.formatLiteral(oFilter.oValue2, sEdmType)), bWithinAnd);
+						+ setCase(_Helper.formatLiteral(oFilter.getValue2(), sEdmType)),
+						bWithinAnd);
 					break;
 				case FilterOperator.EQ:
 				case FilterOperator.GE:
@@ -1952,7 +1953,8 @@ sap.ui.define([
 				case FilterOperator.LE:
 				case FilterOperator.LT:
 				case FilterOperator.NE:
-					sFilter = sFilterPath + " " + oFilter.sOperator.toLowerCase() + " " + sValue;
+					sFilter = sFilterPath + " " + oFilter.getOperator().toLowerCase() + " "
+						+ sValue;
 					break;
 				case FilterOperator.Contains:
 				case FilterOperator.EndsWith:
@@ -1960,11 +1962,11 @@ sap.ui.define([
 				case FilterOperator.NotEndsWith:
 				case FilterOperator.NotStartsWith:
 				case FilterOperator.StartsWith:
-					sFilter = oFilter.sOperator.toLowerCase().replace("not", "not ")
+					sFilter = oFilter.getOperator().toLowerCase().replace("not", "not ")
 						+ "(" + sFilterPath + "," + sValue + ")";
 					break;
 				default:
-					throw new Error("Unsupported operator: " + oFilter.sOperator);
+					throw new Error("Unsupported operator: " + oFilter.getOperator());
 			}
 			return sFilter;
 		}
@@ -1985,18 +1987,18 @@ sap.ui.define([
 				return SyncPromise.resolve();
 			}
 
-			if (oFilter.aFilters) {
-				return SyncPromise.all(oFilter.aFilters.map(function (oSubFilter) {
-					return fetchFilter(oSubFilter, mLambdaVariableToPath, oFilter.bAnd, bThese);
+			if (oFilter.getFilters()) {
+				return SyncPromise.all(oFilter.getFilters().map(function (oSubFilter) {
+					return fetchFilter(oSubFilter, mLambdaVariableToPath, oFilter.isAnd(), bThese);
 				})).then(function (aFilterStrings) {
 					// wrap it if it's an 'or' filter embedded in an 'and'
-					return wrap(aFilterStrings.join(oFilter.bAnd ? " and " : " or "),
-						bWithinAnd && !oFilter.bAnd);
+					return wrap(aFilterStrings.join(oFilter.isAnd() ? " and " : " or "),
+						bWithinAnd && !oFilter.isAnd());
 				});
 			}
 
 			sResolvedPath = oMetaModel.resolve(
-				replaceLambdaVariables(oFilter.sPath, mLambdaVariableToPath), oMetaContext);
+				replaceLambdaVariables(oFilter.getPath(), mLambdaVariableToPath), oMetaContext);
 
 			return oMetaModel.fetchObject(sResolvedPath).then(function (oPropertyMetadata) {
 				var oCondition, sLambdaVariable, sOperator;
@@ -2006,23 +2008,23 @@ sap.ui.define([
 						+ sResolvedPath);
 				}
 
-				sOperator = oFilter.sOperator;
+				sOperator = oFilter.getOperator();
 				if (sOperator === FilterOperator.All || sOperator === FilterOperator.Any) {
-					oCondition = oFilter.oCondition;
-					sLambdaVariable = oFilter.sVariable;
+					oCondition = oFilter.getCondition();
+					sLambdaVariable = oFilter.getVariable();
 					if (sOperator === FilterOperator.Any && !oCondition) {
-						return oFilter.sPath + "/any()";
+						return oFilter.getPath() + "/any()";
 					}
 					// multifilters are processed in parallel, so clone mLambdaVariableToPath
 					// to allow same lambda variables in different filters
 					mLambdaVariableToPath = Object.create(mLambdaVariableToPath);
 					mLambdaVariableToPath[sLambdaVariable]
-						= replaceLambdaVariables(oFilter.sPath, mLambdaVariableToPath);
+						= replaceLambdaVariables(oFilter.getPath(), mLambdaVariableToPath);
 
 					return fetchFilter(
 						oCondition, mLambdaVariableToPath
 					).then(function (sFilterValue) {
-						return oFilter.sPath + "/" + oFilter.sOperator.toLowerCase()
+						return oFilter.getPath() + "/" + oFilter.getOperator().toLowerCase()
 							+ "(" + sLambdaVariable + ":" + sFilterValue + ")";
 					});
 				}
@@ -2317,8 +2319,8 @@ sap.ui.define([
 	 * @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> the binding is part of a {@link #create deep create} because it is relative to a
+	 *       {@link sap.ui.model.odata.v4.Context#isTransient transient} context,
 	 *     <li> an unsupported operation mode is used (see
 	 *       {@link sap.ui.model.odata.v4.ODataModel#bindList}),
 	 *     <li> the {@link sap.ui.model.Filter.NONE} filter instance is contained in
@@ -3108,8 +3110,8 @@ 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> the binding is {@link #isTransient transient} (part of a
-	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}).
+	 *     <li> the binding is part of a {@link #create deep create} because it is relative to a
+	 *       {@link sap.ui.model.odata.v4.Context#isTransient transient} context,
 	 *     <li> {@link sap.ui.model.odata.v4.Context#setKeepAlive} fails
 	 *   </ul>
 	 *
@@ -3248,7 +3250,7 @@ sap.ui.define([
 
 		this.aSorters.forEach(function (oSorter) {
 			if (oSorter instanceof Sorter) {
-				aOrderbyOptions.push(oSorter.sPath + (oSorter.bDescending ? " desc" : ""));
+				aOrderbyOptions.push(oSorter.getPath() + (oSorter.isDescending() ? " desc" : ""));
 			} else {
 				throw new Error("Unsupported sorter: " + oSorter + " - " + that);
 			}
@@ -3268,8 +3270,7 @@ sap.ui.define([
 	 * @returns {Object<any>} mQueryOptions
 	 *   The object with the query options. Query options can be provided with
 	 *   {@link sap.ui.model.odata.v4.ODataModel#bindList},
-	 *   {@link sap.ui.model.odata.v4.ODataModel#bindContext},
-	 *   {@link sap.ui.model.odata.v4.ODataListBinding#changeParameters}, and
+	 *   {@link sap.ui.model.odata.v4.ODataModel#bindContext}, {@link #changeParameters}, and
 	 *   {@link sap.ui.model.odata.v4.ODataContextBinding#changeParameters}. System query options
 	 *   can also be calculated, e.g. <code>$filter</code> can be calculated based on provided
 	 *   filter objects.
@@ -3987,10 +3988,8 @@ sap.ui.define([
 	 *   A lock for the group ID to be used for refresh
 	 * @param {boolean} [bAllowRemoval]
 	 *   Allows the list binding to remove the given context from its collection because the
-	 *   entity does not match the binding's filter anymore,
-	 *   see {@link sap.ui.model.odata.v4.ODataListBinding#filter}; a removed context is
-	 *   destroyed, see {@link sap.ui.model.Context#destroy}.
-	 *   Supported since 1.55.0
+	 *   entity does not match the binding's filter anymore, see {@link #filter}; a removed context
+	 *   is destroyed, see {@link sap.ui.model.Context#destroy}. Supported since 1.55.0
 	 *
 	 *   A removed context is destroyed unless it is
 	 *   {@link sap.ui.model.odata.v4.Context#isKeepAlive kept alive} and still exists on the
@@ -4284,8 +4283,8 @@ sap.ui.define([
 	 *   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}).
+	 *   If the binding is part of a {@link #create deep create} because it is relative to a
+	 *   {@link sap.ui.model.odata.v4.Context#isTransient transient} context
 	 *
 	 * @protected
 	 * @see sap.ui.model.ListBinding#requestFilterForMessages
@@ -4338,6 +4337,79 @@ sap.ui.define([
 		});
 	};
 
+	/**
+	 * Requests selected contexts matching the binding's filters and ordered by its sorters. A
+	 * context which is selected but no longer part of this list binding's collection (that is,
+	 * which doesn't match the filters) is not returned but still shown as selected on the UI
+	 * (see {@link #requestSelectionValidation}).
+	 *
+	 * Note: Data for all selected contexts is reread from the server, even if it is already
+	 * available on the client. Any data updates are reflected on the UI but no order is changed.
+	 *
+	 * @param {string} [sGroupId]
+	 *   The group ID to be used for the request; if not specified, the group ID for this binding is
+	 *   used, see {@link #getGroupId}. Valid values are <code>undefined</code>, '$auto', '$auto.*',
+	 *   '$direct' or application group IDs as specified in
+	 *   {@link sap.ui.model.odata.v4.ODataModel}.
+	 * @returns {Promise<sap.ui.model.odata.v4.Context[]>}
+	 *   A promise which resolves with an array of selected contexts (which may well be empty), or
+	 *   rejects with an instance of <code>Error</code> in case of failure
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> the binding uses or inherits the <code>$$sharedRequest</code> parameter
+	 *       (see {@link sap.ui.model.odata.v4.ODataModel#bindList}),
+	 *     <li> the binding uses data aggregation or a recursive hierarchy (see
+	 *       {@link #setAggregation}),
+	 *     <li> the binding's root binding is suspended,
+	 *     <li> the binding is part of a {@link #create deep create} because it is relative to a
+	 *       {@link sap.ui.model.odata.v4.Context#isTransient transient} context,
+	 *     <li> the binding's header context is selected ("Select All"),
+	 *     <li> there are pending changes,
+	 *     <li> the given group ID is invalid.
+	 *   </ul>
+	 *
+	 * @private
+	 * @since 1.134.0
+	 * @ui5-restricted sap.m.Table
+	 */
+	ODataListBinding.prototype.requestSelectedContexts = function (sGroupId) {
+		if (this.bSharedRequest) {
+			throw new Error("Unsupported $$sharedRequest at " + this);
+		}
+		if ("$$aggregation" in this.mParameters) {
+			throw new Error("Unsupported $$aggregation at " + this);
+		}
+		this.checkSuspended();
+		this.checkTransient();
+		if (this.oHeaderContext.isSelected()) {
+			throw new Error('Unsupported "Select All": ' + this.oHeaderContext);
+		}
+		if (this.hasPendingChanges()) {
+			throw new Error("Unsupported pending changes");
+		}
+		_Helper.checkGroupId(sGroupId);
+
+		const mPath2Context = {};
+		const iStartOfPredicate = this.getResolvedPath().length;
+		const aPredicatesIn = this._getAllExistingContexts()
+			.filter((oContext) => oContext.isSelected())
+			.map((oContext) => {
+				mPath2Context[oContext.getPath()] = oContext;
+
+				return oContext.getPath().slice(iStartOfPredicate);
+			});
+		if (!aPredicatesIn.length) {
+			return Promise.resolve([]);
+		}
+
+		return this.oCache.requestFilteredOrderedPredicates(aPredicatesIn, this.lockGroup(sGroupId))
+			.then((aPredicatesOut) => {
+				// Note: make sure to respect back-end sort order
+				return aPredicatesOut
+					.map((sPredicate) => mPath2Context[this.oHeaderContext.getPath() + sPredicate]);
+			});
+	};
+
 	/**
 	 * @override
 	 * @see sap.ui.model.odata.v4.ODataParentBinding#requestSideEffects
@@ -4719,8 +4791,8 @@ sap.ui.define([
 	 *     <li> there are pending changes,
 	 *     <li> a recursive hierarchy is requested, but the model does not use the
 	 *       <code>autoExpandSelect</code> parameter,
-	 *     <li> the binding is {@link #isTransient transient} (part of a
-	 *       {@link sap.ui.model.odata.v4.ODataListBinding#create deep create}),
+	 *     <li> the binding is part of a {@link #create deep create} because it is relative to a
+	 *       {@link sap.ui.model.odata.v4.Context#isTransient transient} context,
 	 *     <li> the binding has {@link sap.ui.model.Filter.NONE}
 	 *   </ul>
 	 *
@@ -4900,8 +4972,8 @@ sap.ui.define([
 	 * @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> the binding is part of a {@link #create deep create} because it is relative to a
+	 *       {@link sap.ui.model.odata.v4.Context#isTransient transient} context,
 	 *     <li> an unsupported operation mode is used (see
 	 *       {@link sap.ui.model.odata.v4.ODataModel#bindList}).
 	 *   </ul>

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

@@ -157,7 +157,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.133.0
+		 * @version 1.134.0
 		 */
 		ODataMetaModel = MetaModel.extend("sap.ui.model.odata.v4.ODataMetaModel", {
 				constructor : constructor
@@ -2435,8 +2435,8 @@ sap.ui.define([
 	 *   of "cross-service references" (see parameter <code>supportReferences</code> of
 	 *   {@link sap.ui.model.odata.v4.ODataModel#constructor}).
 	 *
-	 * @deprecated As of 1.51.0, use {@link #getETags} instead because modifications to old files
-	 *   may be shadowed by a new file in certain scenarios.
+	 * @deprecated As of version 1.51.0, use {@link #getETags} instead because modifications to old
+	 *   files may be shadowed by a new file in certain scenarios.
 	 * @public
 	 * @since 1.47.0
 	 */