@openui5/sap.ui.core 1.105.0 → 1.106.0

package/src/sap/ui/model/odata/type/Unit.js

@@ -63,7 +63,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.type.Unit
 	 * @public
 	 * @since 1.63.0
-	 * @version 1.105.0
+	 * @version 1.106.0
 	 */
 	var Unit = BaseUnit.extend("sap.ui.model.odata.type.Unit", {
 		constructor : function (oFormatOptions, oConstraints, aDynamicFormatOptionNames) {

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

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.93.0
-	 * @version 1.105.0
+	 * @version 1.106.0
 	 */
 	var Context = BaseContext.extend("sap.ui.model.odata.v2.Context", {
 			constructor : function (oModel, sPath, sDeepPath, oCreatePromise, bInactive) {
@@ -129,7 +129,7 @@ sap.ui.define([
 	 * the entity for this context has been stored in the back end, {@link #created} returns
 	 * <code>undefined</code>.
 	 *
-	 * @returns {Promise}
+	 * @returns {Promise<any|undefined>|undefined}
 	 *   A promise for a context which has been created via
 	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry} or
 	 *   {@link sap.ui.model.odata.v2.ODataListBinding#create}, otherwise <code>undefined</code>.
@@ -176,8 +176,8 @@ sap.ui.define([
 	 *   Defines whether to update all bindings after submitting this change operation,
 	 *   see {@link #setRefreshAfterChange}. If given, this overrules the model-wide
 	 *   <code>refreshAfterChange</code> flag for this operation only.
-	 * @returns {Promise} A promise resolving with <code>undefined</code> in case of successful
-	 *   deletion or rejecting with an error in case the deletion failed
+	 * @returns {Promise<undefined>} A promise resolving with <code>undefined</code> in case of
+	 *   successful deletion or rejecting with an error in case the deletion failed
 	 * @throws {Error}
 	 *   If the given parameter map contains any other parameter than those documented above in case
 	 *   of a persistent context
@@ -308,7 +308,7 @@ sap.ui.define([
 	 * "@$ui5.context.isTransient" instance annotation at the entity, see
 	 * {@link sap.ui.model.odata.v2.ODataModel#getProperty} for details.
 	 *
-	 * @returns {boolean}
+	 * @returns {boolean|undefined}
 	 *   <ul>
 	 *   <li><code>true</code>: if the context has been created via
 	 *     {@link sap.ui.model.odata.v2.ODataModel#createEntry} or

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

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @class Annotation loader for OData V2 services
 	 *
 	 * @author SAP SE
-	 * @version 1.105.0
+	 * @version 1.106.0
 	 *
 	 * @public
 	 * @since 1.37.0

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

@@ -59,7 +59,7 @@ sap.ui.define([
 	/**
 	 * Returns the bound context.
 	 *
-	 * @returns {sap.ui.model.odata.v2.Context}
+	 * @returns {sap.ui.model.odata.v2.Context|null}
 	 *   The context object used by this context binding or <code>null</code>
 	 * @function
 	 * @name sap.ui.model.odata.v2.ODataContextBinding#getBoundContext

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

@@ -1973,7 +1973,7 @@ sap.ui.define([
 	 *   A callback function to filter only relevant messages. The callback returns whether the
 	 *   given {@link sap.ui.core.message.Message} is considered. If no callback function is given,
 	 *   all messages are considered.
-	 * @returns {Promise<sap.ui.model.Filter>}
+	 * @returns {Promise<sap.ui.model.Filter|null>}
 	 *   A Promise that resolves with a {@link sap.ui.model.Filter} representing the entries with
 	 *   messages; it resolves with <code>null</code> if the binding is not resolved or if there is
 	 *   no message for any entry

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

@@ -203,7 +203,7 @@ sap.ui.define([
 	 * This model is not prepared to be inherited from.
 	 *
 	 * @author SAP SE
-	 * @version 1.105.0
+	 * @version 1.106.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.odata.v2.ODataModel
@@ -2771,7 +2771,7 @@ sap.ui.define([
 	 * <code>undefined</code> when the <code>vValue</code> can't be interpreted.
 	 *
 	 * @param {string|object|sap.ui.model.Context} vValue The canonical entry URI, the context or entry object
-	 * @returns {string} Key of the entry or <code>undefined</code>
+	 * @returns {string|undefined} Key of the entry or <code>undefined</code>
 	 * @public
 	 */
 	ODataModel.prototype.getKey = function(vValue) {
@@ -2916,7 +2916,7 @@ sap.ui.define([
 	 *   Comma-separated list of properties or paths to properties to select
 	 * @param {string} [mParameters.expand]
 	 *   Comma-separated list of navigation properties or paths to navigation properties to expand
-	 * @returns {any}
+	 * @returns {any|undefined}
 	 *   The value for the given path and context or <code>undefined</code> if data or entity type
 	 *   cannot be found or if not all selected properties are available
 	 *
@@ -4767,7 +4767,7 @@ sap.ui.define([
 	 * @param {sap.ui.model.Context} [oContext] The binding context
 	 * @param {object} [oEntity] The entity data
 	 *
-	 * @returns {string} The found ETag (or <code>null</code> if none could be found)
+	 * @returns {string|null} The found ETag (or <code>null</code> if none could be found)
 	 * @public
 	 */
 	ODataModel.prototype.getETag = function(sPath, oContext, oEntity) {

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

@@ -94,7 +94,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.TreeBinding
 	 * @hideconstructor
 	 * @public
-	 * @version 1.105.0
+	 * @version 1.106.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/AnnotationHelper.js

@@ -17,9 +17,9 @@ sap.ui.define([
 		rUnsupportedPathSegments = /\$(?:Navigation)?PropertyPath/,
 		/**
 		 * @classdesc
-		 * A collection of methods which help to consume
-		 * <a href="http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part3-csdl.html">
-		 * OData V4 annotations</a> in XML template views. Every context argument must belong to a
+		 * A collection of methods which help to consume <a href=
+		 * "https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part3-csdl.html#_Vocabulary_and_Annotation"
+		 * >OData V4 annotations</a> in XML template views. Every context argument must belong to a
 		 * {@link sap.ui.model.odata.v4.ODataMetaModel} instance.
 		 *
 		 * @alias sap.ui.model.odata.v4.AnnotationHelper

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

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.39.0
-		 * @version 1.105.0
+		 * @version 1.106.0
 		 */
 		Context = BaseContext.extend("sap.ui.model.odata.v4.Context", {
 				constructor : constructor
@@ -258,7 +258,7 @@ sap.ui.define([
 	 * Once the promise is resolved, {@link #getPath} returns a path including the key predicate
 	 * of the new entity. This requires that all key properties are available.
 	 *
-	 * @returns {Promise}
+	 * @returns {Promise<void>|undefined}
 	 *   A promise that is resolved without data 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
@@ -322,11 +322,11 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li> the given group ID is invalid,
 	 *     <li> this context's root binding is suspended,
-	 *     <li> a <code>null</code> group ID is used with a context which is not kept-alive
-	 *       (see {@link #isKeepAlive}),
+	 *     <li> a <code>null</code> group ID is used with a context which is not
+	 *       {@link #isKeepAlive kept alive},
 	 *     <li> the context is already being deleted,
 	 *     <li> the resulting group ID has {@link sap.ui.model.odata.v4.SubmitMode.API}, and the
-	 *       context is kept alive (see {@link #isKeepAlive}), but not in the current collection,
+	 *       context is {@link #isKeepAlive kept alive}, but not in the current collection,
 	 *     <li> (only before 1.105) the resulting group ID has
 	 *       {@link sap.ui.model.odata.v4.SubmitMode.API}
 	 *   </ul>
@@ -441,7 +441,8 @@ sap.ui.define([
 	 * @private
 	 */
 	Context.prototype.doSetProperty = function (sPath, vValue, oGroupLock, bSkipRetry) {
-		var oMetaModel = this.oModel.getMetaModel(),
+		var oModel = this.oModel,
+			oMetaModel = oModel.getMetaModel(),
 			oPromise,
 			oValue,
 			that = this;
@@ -493,8 +494,7 @@ sap.ui.define([
 					 * @param {Error} oError
 					 */
 					function errorCallback(oError) {
-						that.oModel.reportError(
-							"Failed to update path " + that.oModel.resolve(sPath, that),
+						oModel.reportError("Failed to update path " + oModel.resolve(sPath, that),
 							sClassName, oError);
 						firePatchCompleted(false);
 					}
@@ -643,12 +643,13 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the "canonical path" of the entity for this context.
-	 * According to "4.3.1 Canonical URL" of the specification "OData Version 4.0 Part 2: URL
-	 * Conventions", this is the "name of the entity set associated with the entity followed by the
-	 * key predicate identifying the entity within the collection".
-	 * Use the canonical path in {@link sap.ui.core.Element#bindElement} to create an element
-	 * binding.
+	 * Returns the "canonical path" of the entity for this context. According to <a href=
+	 * "https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part2-url-conventions.html#canonical-urlurl4.1.1"
+	 * >"4.3.1 Canonical URL"</a> of the specification "OData Version 4.0 Part 2: URL Conventions",
+	 * this is the "name of the entity set associated with the entity followed by the key predicate
+	 * identifying the entity within the collection". Use the canonical path in
+	 * {@link sap.ui.core.Element#bindElement} to create an element binding.
+	 *
 	 * Note: For a transient context (see {@link #isTransient}) a wrong path is returned unless all
 	 * key properties are available within the initial data.
 	 *
@@ -708,7 +709,7 @@ sap.ui.define([
 	 *   The context's index within the binding's collection. It is <code>undefined</code> if
 	 *   <ul>
 	 *     <li> it does not belong to a list binding,
-	 *     <li> it is kept alive (see {@link #isKeepAlive}), but not in the collection currently.
+	 *     <li> it is {@link #isKeepAlive kept alive}, but not in the collection currently.
 	 *   </ul>
 	 *
 	 * @public
@@ -740,7 +741,7 @@ sap.ui.define([
 	 *   The context's index within the binding's collection. It is <code>undefined</code> if
 	 *   <ul>
 	 *     <li> it does not belong to a list binding,
-	 *     <li> it is kept alive (see {@link #isKeepAlive}), but not in the collection currently.
+	 *     <li> it is {@link #isKeepAlive kept alive}, but not in the collection currently.
 	 *   </ul>
 	 *
 	 * @private
@@ -755,10 +756,9 @@ sap.ui.define([
 	/**
 	 * Returns the value for the given path relative to this context. The function allows access to
 	 * the complete data the context points to (if <code>sPath</code> is "") or any part thereof.
-	 * The data is a JSON structure as described in
-	 * <a
-	 * href="http://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * 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.ODataPropertyBinding#setValue}.
 	 *
@@ -863,10 +863,9 @@ sap.ui.define([
 	/**
 	 * Returns the value for the given path relative to this context. The function allows access to
 	 * the complete data the context points to (if <code>sPath</code> is "") or any part thereof.
-	 * The data is a JSON structure as described in
-	 * <a
-	 * href="http://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * 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 returns the cache instance. Do not modify the result, use
 	 * {@link sap.ui.model.odata.v4.ODataPropertyBinding#setValue} instead.
 	 *
@@ -902,8 +901,8 @@ sap.ui.define([
 	 * Returns whether there are pending changes for bindings dependent on this context, or for
 	 * unresolved bindings (see {@link sap.ui.model.Binding#isResolved}) which were dependent on
 	 * this context at the time the pending change was created. This includes the context itself
-	 * being {@link #isTransient transient}. Since 1.98.0, {@link #isInactive inactive} contexts are
-	 * ignored.
+	 * being {@link #isTransient transient} or {@link #isDeleted deleted}. Since 1.98.0,
+	 * {@link #isInactive inactive} contexts are ignored.
 	 *
 	 * @returns {boolean}
 	 *   Whether there are pending changes
@@ -914,8 +913,11 @@ sap.ui.define([
 	Context.prototype.hasPendingChanges = function () {
 		return this.isTransient()
 			|| this.isDeleted()
+			|| this.getBinding().hasPendingChangesForPath(this.sPath)
 			|| this.oModel.getDependentBindings(this).some(function (oDependentBinding) {
-				return oDependentBinding.hasPendingChanges();
+				return oDependentBinding.oCache
+					? oDependentBinding.hasPendingChanges()
+					: oDependentBinding.hasPendingChangesInDependents();
 			})
 			|| this.oModel.withUnresolvedBindings("hasPendingChangesInCaches", this.sPath.slice(1));
 	};
@@ -929,7 +931,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @see #delete
-	 * @since 1.105
+	 * @since 1.105.0
 	 */
 	Context.prototype.isDeleted = function () {
 		return this.bDeleted;
@@ -955,9 +957,9 @@ sap.ui.define([
 	 * Returns whether this context is inactive. The result of this function can also be accessed
 	 * via instance annotation "@$ui5.context.isInactive" at the entity.
 	 *
-	 * @returns {boolean} <code>true</code> if this context is inactive, <code>false</code> if it
-	 *   was created in an inactive state and has been activated, and <code>undefined</code>
-	 *   otherwise.
+	 * @returns {boolean|undefined} <code>true</code> if this context is inactive,
+	 *   <code>false</code> if it was created in an inactive state and has been activated, and
+	 *   <code>undefined</code> otherwise.
 	 *
 	 * @public
 	 * @see #isTransient
@@ -970,7 +972,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns whether this context is kept alive.
+	 * Returns whether this context is kept alive even when it is removed from its binding's
+	 * collection, for example if a filter is applied and the entity represented by this context
+	 * does not match the filter criteria.
 	 *
 	 * @returns {boolean} <code>true</code> if this context is kept alive
 	 *
@@ -989,7 +993,7 @@ sap.ui.define([
 	 * if the context is not transient. The result of this function can also be accessed via
 	 * instance annotation "@$ui5.context.isTransient" at the entity.
 	 *
-	 * @returns {boolean}
+	 * @returns {boolean|undefined}
 	 *   Whether this context is transient if it is created using
 	 *   {@link sap.ui.model.odata.v4.ODataListBinding#create}; <code>undefined</code> if it is not
 	 *   created using {@link sap.ui.model.odata.v4.ODataListBinding#create}
@@ -1033,9 +1037,9 @@ sap.ui.define([
 	 *   binding, the parameter must not be used.
 	 *   Supported since 1.55.0
 	 *
-	 *   Since 1.84.0, if this context is kept alive (see {@link #isKeepAlive}), it is only
-	 *   destroyed if the corresponding entity does no longer exist in the back end. In this case,
-	 *   the <code>fnOnBeforeDestroy</code> callback passed with {@link #setKeepAlive}) is called.
+	 *   Since 1.84.0, if this context is {@link #isKeepAlive kept alive}, it is only destroyed if
+	 *   the corresponding entity does no longer exist in the back end. In this case, the
+	 *   <code>fnOnBeforeDestroy</code> callback passed with {@link #setKeepAlive}) is called.
 	 * @throws {Error}
 	 *   If the group ID is not valid, if this context has pending changes or does not represent a
 	 *   single entity (see {@link sap.ui.model.odata.v4.ODataListBinding#getHeaderContext}), if the
@@ -1093,8 +1097,9 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li> this context's root binding is suspended,
 	 *     <li> this context is transient (see {@link #isTransient}),
-	 *     <li> the given other context does not belong to the same list binding as this context, or
-	 *       is already in the collection (has an index, see {@link #getIndex}).
+	 *     <li> the given other context does not belong to the same list binding as this context, is
+	 *       already in the collection (has an index, see {@link #getIndex}), or is not
+	 *       {@link #isKeepAlive kept alive}.
 	 *   </ul>
 	 *
 	 * @public
@@ -1107,7 +1112,8 @@ sap.ui.define([
 		if (this.isTransient()) {
 			throw new Error("Cannot replace " + this);
 		}
-		if (oOtherContext.oBinding !== this.oBinding || oOtherContext.iIndex !== undefined) {
+		if (oOtherContext.oBinding !== this.oBinding || oOtherContext.iIndex !== undefined
+				|| !oOtherContext.bKeepAlive) {
 			throw new Error("Cannot replace with " + oOtherContext);
 		}
 		oElement = oOtherContext.getValue();
@@ -1116,12 +1122,14 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns a promise for the "canonical path" of the entity for this context.
-	 * According to "4.3.1 Canonical URL" of the specification "OData Version 4.0 Part 2: URL
-	 * Conventions", this is the "name of the entity set associated with the entity followed by the
-	 * key predicate identifying the entity within the collection".
-	 * Use the canonical path in {@link sap.ui.core.Element#bindElement} to create an element
-	 * binding.
+	 * Returns a promise for the "canonical path" of the entity for this context. According to
+	 * <a href=
+	 * "https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part2-url-conventions.html#canonical-urlurl4.1.1"
+	 * >"4.3.1 Canonical URL"</a> of the specification "OData Version 4.0 Part 2: URL Conventions",
+	 * this is the "name of the entity set associated with the entity followed by the key predicate
+	 * identifying the entity within the collection". Use the canonical path in
+	 * {@link sap.ui.core.Element#bindElement} to create an element binding.
+	 *
 	 * Note: For a transient context (see {@link #isTransient}) a wrong path is returned unless all
 	 * key properties are available within the initial data.
 	 *
@@ -1139,10 +1147,9 @@ sap.ui.define([
 	/**
 	 * Returns a promise on the value for the given path relative to this context. The function
 	 * allows access to the complete data the context points to (if <code>sPath</code> is "") or
-	 * any part thereof. The data is a JSON structure as described in
-	 * <a
-	 * href="http://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * 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}.
 	 *
@@ -1322,7 +1329,7 @@ sap.ui.define([
 	 *   specified, make sure that {@link #requestSideEffects} is called after the corresponding
 	 *   updates have been successfully processed by the server and that there are no pending
 	 *   changes for the affected properties.
-	 * @returns {Promise}
+	 * @returns {Promise<undefined>}
 	 *   Promise resolved with <code>undefined</code>, or rejected with an error if loading of side
 	 *   effects fails. Use it to set fields affected by side effects to read-only before
 	 *   {@link #requestSideEffects} and make them editable again when the promise resolves; in the
@@ -1708,19 +1715,46 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns a string representation of this object including the binding path.
+	 * Returns a string representation of this object including the {@link #getPath binding path),
+	 * {@link #getIndex index}, and state (see also "Context states" of
+	 * {@link topic:c9723f8265f644af91c0ed941e114d46 Creating an Entity}).
 	 *
 	 * @return {string} A string description of this binding
+	 *
 	 * @public
+	 * @see #destroy
+	 * @see #isDeleted
+	 * @see #isInactive
+	 * @see #isTransient
 	 * @since 1.39.0
 	 */
 	Context.prototype.toString = function () {
-		var sIndex = "";
+		var sSuffix = "";
+
+		if (!this.oModel) {
+			sSuffix = ";destroyed";
+		} else if (this.bDeleted) {
+			sSuffix = ";deleted";
+		}
 
 		if (this.iIndex !== undefined) {
-			sIndex = "[" + this.iIndex + (this.isTransient() ? "|transient" : "") + "]";
+			if (!sSuffix) {
+				switch (this.isTransient()) {
+					case false:
+						sSuffix = ";createdPersisted";
+						break;
+
+					case true:
+						sSuffix = this.bInactive ? ";inactive" : ";transient";
+						break;
+
+					// no default
+				}
+			}
+			sSuffix = "[" + this.iIndex + sSuffix + "]";
 		}
-		return this.sPath + sIndex;
+
+		return this.sPath + sSuffix;
 	};
 
 	/**

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

@@ -384,6 +384,15 @@ sap.ui.define([
 		this.oCache.deregisterChangeListener(sPath, oListener);
 	};
 
+	/**
+	 * @override
+	 * @see sap.ui.base.EventProvider#getEventingParent
+	 */
+	ODataBinding.prototype.getEventingParent = function () {
+		// this allows that dataRequested/dataReceived events are bubbled up to the model
+		return this.oModel;
+	};
+
 	/**
 	 * Hook method for {@link #fetchQueryOptionsForOwnCache} to determine the query options for this
 	 * binding.
@@ -635,6 +644,40 @@ sap.ui.define([
 		});
 	};
 
+	/**
+	 * Fires the 'dataReceived' event. It may be bubbled up to the model.
+	 *
+	 * @param {object} oParameters
+	 *   The event parameters
+	 * @param {object} [oParameters.data]
+	 *   An empty data object if a back-end request succeeds
+	 * @param {Error} [oParameters.error]
+	 *   The error object if a back-end request failed.
+	 * @param {boolean} [bPreventBubbling]
+	 *   Whether the dataRequested and dataReceived events must not be bubbled up to the model
+	 *
+	 * @private
+	 */
+	 // @override sap.ui.model.Binding#fireDataReceived
+	ODataBinding.prototype.fireDataReceived = function (oParameters, bPreventBubbling) {
+		this.fireEvent("dataReceived", oParameters, /*bAllowPreventDefault*/false,
+			/*bEnableEventBubbling*/!bPreventBubbling);
+	};
+
+	/**
+	 * Fires the 'dataRequested' event. It may be bubbled up to the model.
+	 *
+	 * @param {boolean} [bPreventBubbling]
+	 *   Whether the dataRequested and dataReceived events must not be bubbled up to the model
+	 *
+	 * @private
+	 */
+	 // @override sap.ui.model.Binding#fireDataRequested
+	ODataBinding.prototype.fireDataRequested = function (bPreventBubbling) {
+		this.fireEvent("dataRequested", undefined, /*bAllowPreventDefault*/false,
+			/*bEnableEventBubbling*/!bPreventBubbling);
+	};
+
 	/**
 	 * Returns all bindings which have this binding as parent binding.
 	 *
@@ -751,8 +794,8 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Returns the root binding of this binding's hierarchy, see binding
-	 * {@link topic:54e0ddf695af4a6c978472cecb01c64d Initialization and Read Requests}.
+	 * Returns the root binding of this binding's hierarchy, see
+	 * {@link topic:fccfb2eb41414f0792c165e69a878717 Initialization and Read Requests}.
 	 *
 	 * @returns {sap.ui.model.odata.v4.ODataContextBinding|sap.ui.model.odata.v4.ODataListBinding|
 	 *      sap.ui.model.odata.v4.ODataPropertyBinding|undefined}
@@ -837,7 +880,7 @@ sap.ui.define([
 	 *   {@link sap.ui.model.odata.v4.ODataListBinding#refresh refresh} (since 1.100.0),
 	 *   {@link sap.ui.model.odata.v4.ODataListBinding#sort sort}, or
 	 *   {@link sap.ui.model.odata.v4.ODataListBinding#suspend suspend} because they relate to a
-	 *   {@link sap.ui.model.odata.v4.Context#setKeepAlive kept-alive} context of this binding
+	 *   {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} context of this binding
 	 *   (since 1.97.0). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient}
 	 *   contexts of a {@link #getRootBinding root binding} are treated as kept-alive by this flag.
 	 *   Since 1.99.0, the same happens for bindings using the <code>$$ownRequest</code> parameter
@@ -1033,7 +1076,7 @@ sap.ui.define([
 	 *       binding,
 	 *     <li> or a value of type boolean is given.
 	 *   </ul> Since 1.100.0, pending changes are ignored if they relate to a
-	 *   {@link sap.ui.model.odata.v4.Context#setKeepAlive kept-alive} context of this binding, and
+	 *   {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} context of this binding, and
 	 *   {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a
 	 *   {@link #getRootBinding root binding} do not count as pending changes.
 	 *