@openui5/sap.ui.core 1.92.0 → 1.93.3

package/src/sap/ui/core/theming/ThemeHelper.js

@@ -0,0 +1,94 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	'sap/base/Log'
+], function (Log) {
+	"use strict";
+
+	// TODO reset map onThemeChanged
+	var mLibThemeMetadata = {};
+
+	/**
+	 *
+	 * @since 1.92.0
+	 * @alias sap.ui.core.theming.ThemeHelper
+	 * @static
+	 * @namespace
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+	var ThemeHelper = {};
+
+	ThemeHelper.reset = function () {
+		mLibThemeMetadata = {};
+	};
+
+	ThemeHelper.getMetadata = function (sLibId) {
+		if (!sLibId) {
+			return null;
+		}
+
+		var sLibName = sLibId.replace("sap-ui-theme-", "").replace(/\./g, "-");
+		if (mLibThemeMetadata[sLibName]) {
+			return mLibThemeMetadata[sLibName];
+		}
+
+		var oMetadata, sMetadataJSON;
+
+		var oBodyStyle = window.getComputedStyle(document.body || document.documentElement);
+		var sVariablesMarker = oBodyStyle.getPropertyValue("--sapUiTheme-" + sLibName).trim();
+
+		// Try first to read the metadata from the CSS variables in case CSS variables are supported
+		if (sVariablesMarker) {
+			// read metadata
+			sMetadataJSON = oBodyStyle.getPropertyValue("--sapThemeMetaData-UI5-" + sLibName).trim();
+		}
+		// Fallback to inline metadata in case no CSS variables are supported or metadata is only available inline
+		if (!sMetadataJSON) {
+			var oMetadataElement = document.createElement("span");
+			oMetadataElement.classList.add("sapThemeMetaData-UI5-" + sLibName);
+			document.documentElement.appendChild(oMetadataElement);
+			var sDataUri = window.getComputedStyle(oMetadataElement).getPropertyValue("background-image");
+			document.documentElement.removeChild(oMetadataElement);
+
+			var aDataUriMatch = /\(["']?data:text\/plain;utf-8,(.*?)['"]?\)/i.exec(sDataUri);
+			if (!aDataUriMatch || aDataUriMatch.length < 2) {
+				return null;
+			}
+
+			var sMetaData = aDataUriMatch[1];
+
+			// The following lines of code are moved unchanged from ThemeCheck in order to not introduce any regressions but
+			// neverteheless it's not fully clear if detection of URI encoding and URI decoding itself (especially manual encoding of spaces)
+			// is necessary
+
+			// Try to detect URI encoding by checking for first and last character for not encoded characters
+			if (sMetaData.charAt(0) !== "{" && sMetaData.charAt(sMetaData.length - 1) !== "}") {
+				try {
+					sMetaData = decodeURI(sMetaData);
+				} catch (ex) {
+					// ignore
+				}
+			}
+
+			// Remove superfluous escaping of double quotes
+			sMetaData = sMetaData.replace(/\\"/g, '"');
+
+			// Replace encoded spaces => not clear if this is really necessary and if there is any valid case where spaces are URI encoded
+			//							 but we could not detect URI encoding. Keep coding in order to avoid regression.
+			sMetadataJSON = sMetaData.replace(/%20/g, " ");
+		}
+		try {
+			oMetadata = JSON.parse(sMetadataJSON);
+			mLibThemeMetadata[sLibName] = oMetadata;
+		} catch (ex) {
+			Log.error("Could not parse theme metadata for library " + sLibName + ".");
+		}
+		return oMetadata;
+	};
+
+	return ThemeHelper;
+});

package/src/sap/ui/core/tmpl/DOMAttribute.js

@@ -19,7 +19,7 @@ sap.ui.define(['sap/ui/core/Element', 'sap/ui/core/library'],
 	 * @class
 	 * Represents a DOM attribute of a DOM element.
 	 * @extends sap.ui.core.Element
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @public
 	 * @since 1.15

package/src/sap/ui/core/tmpl/DOMElement.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @class
 	 * Represents a DOM element. It allows to use databinding for the properties and nested DOM attributes.
 	 * @extends sap.ui.core.Control
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @public
 	 * @since 1.15

package/src/sap/ui/core/tmpl/HandlebarsTemplate.js

@@ -46,7 +46,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.tmpl.Template
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.tmpl.HandlebarsTemplate
 	 * @since 1.15
 	 * @deprecated since 1.56

package/src/sap/ui/core/tmpl/Template.js

@@ -48,7 +48,7 @@ function(
 	 * @extends sap.ui.base.ManagedObject
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.tmpl.Template
 	 * @since 1.15
 	 * @deprecated since 1.56, use an {@link sap.ui.core.mvc.XMLView XMLView} or {@link sap.ui.core.mvc.JSView JSView} instead.
@@ -558,6 +558,7 @@ function(
 				// instance if found
 				if (sId) {
 					var theTemplate = sap.ui.getCore().getTemplate(sId);
+					// eslint-disable-next-line no-unsafe-negation
 					if (!theTemplate instanceof Template) {
 						throw new Error("Object for id \"" + sId + "\" is no sap.ui.core.tmpl.Template!");
 					} else {

package/src/sap/ui/core/tmpl/TemplateControl.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * @class
 	 * This is the base class for all template controls. Template controls are declared based on templates.
 	 * @extends sap.ui.core.Control
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @public
 	 * @since 1.15

package/src/sap/ui/core/util/AsyncHintsHelper.js

@@ -12,7 +12,7 @@ sap.ui.define([], function() {
 	 *
 	 * @class Utility class for asyncHints
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @private
 	 * @ui5-restricted sap.ushell

package/src/sap/ui/core/util/Export.js

@@ -141,7 +141,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @since 1.22.0
 	 *
 	 * @public

package/src/sap/ui/core/util/ExportCell.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/core/Element'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @since 1.22.0
 	 *
 	 * @public

package/src/sap/ui/core/util/ExportColumn.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @since 1.22.0
 	 *
 	 * @public

package/src/sap/ui/core/util/ExportRow.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @since 1.22.0
 	 *
 	 * @public

package/src/sap/ui/core/util/ExportType.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/ManagedObject'],
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @since 1.22.0
 	 *
 	 * @public

package/src/sap/ui/core/util/ExportTypeCSV.js

@@ -38,7 +38,7 @@ sap.ui.define(['./ExportType'],
 	 * @extends sap.ui.core.util.ExportType
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @since 1.22.0
 	 *
 	 * @public

package/src/sap/ui/core/util/File.js

@@ -13,7 +13,7 @@ sap.ui.define(["sap/ui/thirdparty/jquery"],
 	 * Utility class to handle files.
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @namespace
 	 *
 	 * @public

package/src/sap/ui/core/util/LibraryInfo.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @private
 	 * @alias sap.ui.core.util.LibraryInfo
 	 */

package/src/sap/ui/core/util/MockServer.js

@@ -31,7 +31,7 @@ sap.ui
 			 * @extends sap.ui.base.ManagedObject
 			 * @abstract
 			 * @author SAP SE
-			 * @version 1.92.0
+			 * @version 1.93.3
 			 * @public
 			 * @alias sap.ui.core.util.MockServer
 			 */
@@ -3702,13 +3702,32 @@ sap.ui
 			/**
 			 * Enum for the method.
 			 * @public
+			 * @enum {string}
 			 */
 			MockServer.HTTPMETHOD = {
+				/**
+				 * @public
+				 */
 				GET: "GET",
+				/**
+				 * @public
+				 */
 				POST: "POST",
+				/**
+				 * @public
+				 */
 				DELETE: "DELETE",
+				/**
+				 * @public
+				 */
 				PUT: "PUT",
+				/**
+				 * @public
+				 */
 				MERGE: "MERGE",
+				/**
+				 * @public
+				 */
 				PATCH: "PATCH"
 			};
 

package/src/sap/ui/core/util/PasteHelper.js

@@ -13,7 +13,7 @@ sap.ui.define([ "sap/ui/core/Core", "sap/ui/model/ParseException", "sap/ui/model
 	 *
 	 * @class Parses and validates data on the <code>paste</code> event of an SAPUI5 table.
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @private
 	 * @ui5-restricted sap.ui.table.Table, sap.m.Table, sap.m.plugins.PasteProvider
 	 * @alias sap.ui.core.util.PasteHelper

package/src/sap/ui/core/util/reflection/BaseTreeModifier.js

@@ -43,6 +43,24 @@ sap.ui.define([
 	 */
 	return /** @lends sap.ui.core.util.reflection.BaseTreeModifier */{
 
+		/**
+		 * Function determining the control targeted by the change. It is also possible to pass an extensionpoint selector.
+		 * In this case an extension point is referenced in the selector but the parent control of the extensionpoint will be returned.
+		 *
+		 * @param {object} oSelector - Target of a flexibility change
+		 * @param {string} [oSelector.id] - ID of the control targeted by the change. (name or id property is mandatory for selector)
+		 * @param {boolean} [oSelector.isLocalId] - <code>true</code> if the ID within the selector is a local ID or a global ID
+		 * @param {string} [oSelector.name] - Name of the extension point targeted by the change. (name or id property is mandatory for selector)
+		 * @param {sap.ui.core.UIComponent} oAppComponent - Application component
+		 * @param {Element} oView - For XML processing only: XML node of the view
+		 * @returns {Promise<sap.ui.base.ManagedObject|Element>} Control representation targeted within the selector, wrapped in a Promise
+		 * @throws {Error} In case no control could be determined, an error is thrown
+		 * @public
+		 */
+		bySelectorExtensionPointEnabled: function (oSelector, oAppComponent, oView) {
+			return Promise.resolve(this.bySelector(oSelector, oAppComponent, oView));
+		},
+
 		/**
 		 * Function determining the control targeted by the change.
 		 *

package/src/sap/ui/core/util/serializer/HTMLViewSerializer.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './Serializer', './delegate/HTML', '
 	 * @class HTMLViewSerializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.HTMLViewSerializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/Serializer.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/base/EventProvider', "sap/base/assert"],
 	 * @class Serializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.Serializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/ViewSerializer.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './HTMLViewSerializer', './XMLViewSe
 	 * @class ViewSerializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.ViewSerializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/XMLViewSerializer.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './Serializer', './delegate/XML', 's
 	 * @class XMLViewSerializer class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.XMLViewSerializer
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/delegate/Delegate.js

@@ -17,7 +17,7 @@ sap.ui.define(['sap/ui/base/EventProvider'],
 	 * @class Abstract serializer delegate class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.delegate.Delegate
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide

package/src/sap/ui/core/util/serializer/delegate/HTML.js

@@ -19,7 +19,7 @@ sap.ui.define(['./Delegate', "sap/base/strings/hyphenate", "sap/base/util/deepEq
 	 * @class HTML serializer delegate class.
 	 * @extends sap.ui.core.util.serializer.delegate.Delegate
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.delegate.HTML
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide
@@ -132,7 +132,7 @@ sap.ui.define(['./Delegate', "sap/base/strings/hyphenate", "sap/base/util/deepEq
 			}
 			return oValue;
 		}, function (sName, oValue) {
-			return (oValue !== null && typeof oValue !== undefined && oValue !== "");
+			return (oValue !== null && oValue !== "");
 		});
 
 		// write properties

package/src/sap/ui/core/util/serializer/delegate/XML.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @class XML serializer delegate class.
 	 * @extends sap.ui.core.util.serializer.delegate.Delegate
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.util.serializer.delegate.XML
 	 * @private
 	 * @ui5-restricted sap.watt, com.sap.webide
@@ -149,7 +149,7 @@ sap.ui.define([
 			}
 			return oValue;
 		}, function (sName, oValue) {
-			return (oValue !== null && typeof oValue !== undefined && oValue !== "");
+			return (oValue !== null && oValue !== "");
 		});
 
 		// write properties

package/src/sap/ui/core/ws/ReadyState.js

@@ -12,7 +12,7 @@ sap.ui.define(function() {
 	/**
 	 * Defines the different ready states for a WebSocket connection.
 	 *
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @enum {int}
 	 * @public
 	 * @alias sap.ui.core.ws.ReadyState

package/src/sap/ui/core/ws/SapPcpWebSocket.js

@@ -21,7 +21,7 @@ sap.ui.define(['./WebSocket', "sap/base/Log"],
 	 * @class WebSocket class implementing the pcp-protocol.
 	 * @extends sap.ui.core.ws.WebSocket
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.ws.SapPcpWebSocket
 	 */
 	var SapPcpWebSocket = WebSocket.extend("sap.ui.core.ws.SapPcpWebSocket", /** @lends sap.ui.core.ws.SapPcpWebSocket.prototype */ {

package/src/sap/ui/core/ws/WebSocket.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @class Basic WebSocket class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.core.ws.WebSocket
 	 */
 	var WebSocket = EventProvider.extend("sap.ui.core.ws.WebSocket", /** @lends sap.ui.core.ws.WebSocket.prototype */ {

package/src/sap/ui/debug/ControlTree.js

@@ -33,7 +33,7 @@ sap.ui.define('sap/ui/debug/ControlTree', [
 	 * @class Control Tree used for the Debug Environment
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus, Frank Weigel
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @alias sap.ui.debug.ControlTree
 	 * @private
 	 */

package/src/sap/ui/debug/DebugEnv.js

@@ -16,7 +16,7 @@ sap.ui.define('sap/ui/debug/DebugEnv', ['sap/ui/base/Interface', './ControlTree'
 	 * @class Central Class for the Debug Environment
 	 *
 	 * @author Martin Schaus, Frank Weigel
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 * @private
 	 * @alias sap.ui.debug.DebugEnv
 	 */

package/src/sap/ui/debug/PropertyList.js

@@ -39,7 +39,7 @@ sap.ui.define('sap/ui/debug/PropertyList', [
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @param {sap.ui.core.Core}
 	 *            oCore the core instance to use for analysis

package/src/sap/ui/events/jquery/EventSimulation.js

@@ -19,7 +19,8 @@ sap.ui.define([
 	/**
 	 * @namespace
 	 * @alias module:sap/ui/events/jquery/EventSimulation
-	 * @public
+	 * @private
+	 * @ui5-restricted sap.ui.core
 	 */
 	var oEventSimulation = {};
 
@@ -32,10 +33,10 @@ sap.ui.define([
 	 * This function adds the simulated event prefixed with string "sap" to ControlEvents.events.
 	 *
 	 * When UIArea binds to the simulated event with prefix, it internally binds to the original events with the given handler and
-	 * also provides the additional configuration data in the follwing format:
+	 * also provides the additional configuration data in the following format:
 	 *
 	 * {
-	 * 	domRef: // the dom reference of the UIArea
+	 * 	domRef: // the DOM reference of the UIArea
 	 * 	eventName: // the simulated event name
 	 * 	sapEventName: // the simulated event name with sap prefix
 	 * 	eventHandle: // the handler that should be registered to simulated event with sap prefix
@@ -116,8 +117,8 @@ sap.ui.define([
 			sTouchStartControlId = $DomRef.data("__touchstart_control"),
 			oTouchStartControlDOM = sTouchStartControlId && window.document.getElementById(sTouchStartControlId);
 
-		// Checks if the mouseout event should be handled, the mouseout of the inner dom shouldn't be handled when the mouse cursor
-		// is still inside the control's root dom node
+		// Checks if the mouseout event should be handled, the mouseout of the inner DOM shouldn't be handled when the mouse cursor
+		// is still inside the control's root DOM node
 		if (oEvent.type === "mouseout" && !checkMouseEnterOrLeave(oEvent, oConfig.domRef)
 			&& (!oTouchStartControlDOM || !checkMouseEnterOrLeave(oEvent, oTouchStartControlDOM))
 		) {
@@ -379,7 +380,7 @@ sap.ui.define([
 		//
 		// UIArea binds to both touchstart and saptouchstart event and saptouchstart internally also binds to touchstart event. Before
 		// jQuery version 1.9.1, the touchstart event handler is called before the saptouchstart event handler and our flags (e.g. _sapui_handledByUIArea)
-		// still work. However since the order of event registration is inversed from jQuery version 1.9.1, the saptouchstart event hanlder is called
+		// still work. However since the order of event registration is inversed from jQuery version 1.9.1, the saptouchstart event handler is called
 		// before the touchstart one, our flags don't work anymore.
 		//
 		// Therefore jQuery version needs to be checked in order to decide the event order in ControlEvents.events.

package/src/sap/ui/events/jquery/EventTriggerHook.js

@@ -37,7 +37,7 @@ sap.ui.define([
 					oEvent.stopImmediatePropagation();
 					if (bIsLoggable) {
 						t1 = window.performance.now();
-						Log.debug("Perf: jQuery trigger supression event handler " + oEvent.type + " took " + (t1 - t0) + " milliseconds.");
+						Log.debug("Perf: jQuery trigger suppression event handler " + oEvent.type + " took " + (t1 - t0) + " milliseconds.");
 					}
 					return false; //prevent further jQuery processing.
 				}

package/src/sap/ui/model/ClientModel.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.Model
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @param {string} [oData] URL where to load the data from
 	 * @public

package/src/sap/ui/model/CompositeDataState.js

@@ -14,7 +14,7 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	 * @extends sap.ui.model.DataState
 	 *
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 *
 	 * @public
 	 * @alias sap.ui.model.CompositeDataState

package/src/sap/ui/model/CompositeType.js

@@ -39,7 +39,7 @@ sap.ui.define(['./SimpleType'],
 	 *   <code>true</code>.
 	 * @extends sap.ui.model.SimpleType
 	 * @public
-	 * @version 1.92.0
+	 * @version 1.93.3
 	 */
 	var CompositeType = SimpleType.extend("sap.ui.model.CompositeType", /** @lends sap.ui.model.CompositeType.prototype */ {
 

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

@@ -103,6 +103,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 	/**
 	 * Sets the force refresh flag of the context. If this is set, the context will force a refresh of dependent
 	 * bindings, when the context is propagated.
+	 *
+	 * @deprecated since 1.93.0; only supported by the OData V2 Model; use V2 specific Context
+	 *   instead
 	 * @private
 	 * @param {boolean} bForceRefresh the force refresh flag
 	 */
@@ -112,6 +115,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 
 	/**
 	 * This method returns, whether dependent bindings need to be refreshed.
+	 *
+	 * @deprecated since 1.93.0; only supported by the OData V2 Model; use V2 specific Context
+	 *   instead
 	 * @private
 	 * @return {boolean} the force refresh flag
 	 */
@@ -123,6 +129,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 	 * Sets the preliminary flag of the context. If this is set, the context is not yet linked to actual model
 	 * data, but does just contain path information. This can be used by dependent bindings to send their request
 	 * in parallel to the request of the context binding.
+	 *
+	 * @deprecated since 1.93.0; only supported by the OData V2 Model; use V2 specific Context
+	 *   instead
 	 * @private
 	 * @param {boolean} bPreliminary the preliminary flag
 	 */
@@ -132,6 +141,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 
 	/**
 	 * This method returns, whether the context is preliminary.
+	 *
+	 * @deprecated since 1.93.0; only supported by the OData V2 Model; use V2 specific Context
+	 *   instead
 	 * @private
 	 * @ui5-restricted sap.suite.ui.generic
 	 * @return {boolean} the preliminary flag
@@ -143,6 +155,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 	/**
 	 * Sets the updated flag of the context. If this is set, the context was updated. E.g. the path changed from
 	 * a preliminary path to the canonical one.
+	 *
+	 * @deprecated since 1.93.0; only supported by the OData V2 Model; use V2 specific Context
+	 *   instead
 	 * @private
 	 * @param {boolean} bUpdated the preliminary flag
 	 */
@@ -152,6 +167,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 
 	/**
 	 * This method returns, whether the context is updated.
+	 *
+	 * @deprecated since 1.93.0; only supported by the OData V2 Model; use V2 specific Context
+	 *   instead
 	 * @private
 	 * @return {boolean} the updated flag
 	 */
@@ -159,6 +177,17 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 		return this.bUpdated;
 	};
 
+	/**
+	 * Whether this context has changed. By default this context cannot be changed but subclasses
+	 * can override this behaviour.
+	 *
+	 * @return {boolean} Whether this context has changed
+	 * @private
+	 */
+	 Context.prototype.hasChanged = function() {
+		return this.isUpdated() || this.isRefreshForced();
+	};
+
 	/**
 	 * Compares the two given Contexts. Returns true if the context instances are not equal,
 	 * if the new context is updated or if the new context is refreshed.
@@ -169,17 +198,8 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 	 * @private
 	 */
 	Context.hasChanged = function(oOldContext, oNewContext) {
-		var bChanged = false;
-
-		if (oOldContext !== oNewContext) {
-			bChanged = true;
-		} else if (oNewContext && oNewContext.isUpdated()) {
-			bChanged = true;
-		} else if (oNewContext && oNewContext.isRefreshForced()) {
-			bChanged = true;
-		}
-
-		return bChanged;
+		return oOldContext !== oNewContext
+			|| !!oNewContext && !!oNewContext.hasChanged();
 	};
 
 	/**