@openui5/sap.ui.core 1.103.1 → 1.106.0

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

@@ -16,7 +16,7 @@ sap.ui.define(['./Model'],
 	 * @extends sap.ui.model.Model
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.MetaModel

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

@@ -7,13 +7,15 @@
 // Provides the base implementation for all model implementations
 sap.ui.define([
 	'sap/ui/core/message/MessageProcessor',
+	'./ManagedObjectBindingSupport',
 	'./BindingMode',
 	'./Context',
 	'./Filter',
 	"sap/base/util/deepEqual",
 	"sap/base/util/each"
 ],
-	function(MessageProcessor, BindingMode, Context, Filter, deepEqual, each) {
+	function(MessageProcessor, ManagedObjectBindingSupport, BindingMode, Context, Filter, deepEqual,
+		each) {
 	"use strict";
 
 
@@ -49,7 +51,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.message.MessageProcessor
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.Model
@@ -102,7 +104,6 @@ sap.ui.define([
 		}
 	});
 
-
 	/**
 	 * Map of event names, that are provided by the model.
 	 */
@@ -719,7 +720,7 @@ sap.ui.define([
 	 * @param {sap.ui.model.Context} [oContext] Context with which the path should be resolved
 	 * @param {object} [mParameters] Additional model-specific parameters
 	 *
-	 * @returns {any}
+	 * @returns {any|undefined}
 	 *   The value for the given path/context or <code>undefined</code> if data could not be found
 	 * @public
 	 */
@@ -1118,7 +1119,7 @@ sap.ui.define([
 	 * model type.
 	 * @abstract
 	 * @public
-	 * @returns {sap.ui.model.MetaModel}
+	 * @returns {sap.ui.model.MetaModel|undefined}
 	 *   The meta model or <code>undefined</code> if no meta model exists.
 	 */
 	Model.prototype.getMetaModel = function() {
@@ -1229,6 +1230,16 @@ sap.ui.define([
 		}
 	}
 
+	/**
+	 * Introduces data binding support on the ManagedObject prototype via mixin.
+	 * Called by the ManagedObject during property propagation.
+	 * @param {sap.ui.base.ManagedObject.prototype} ManagedObject
+	 *   the sap.ui.base.ManagedObject.prototype
+	 */
+	Model.prototype.mixinBindingSupport = function(ManagedObject) {
+		Object.assign(ManagedObject, ManagedObjectBindingSupport);
+	};
+
 	return Model;
 
 });

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

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/EventProvider', "sap/base/assert"],
 	 * @extends sap.ui.base.EventProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 *
 	 * @param {int} iSelectionMode <code>sap.ui.model.SelectionModel.SINGLE_SELECTION</code> or <code>sap.ui.model.SelectionModel.MULTI_SELECTION</code>
 	 *

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

@@ -46,7 +46,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.model.Type
 	 * @public
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 */
 	var SimpleType = Type.extend("sap.ui.model.SimpleType", /** @lends sap.ui.model.SimpleType.prototype */ {
 
@@ -109,7 +109,7 @@ sap.ui.define([
 	 *
 	 * @param {any} vValue
 	 *   The value to be validated
-	 * @returns {void|Promise}
+	 * @returns {void|Promise<undefined>}
 	 *   <code>undefined</code> or a <code>Promise</code> resolving with an undefined value
 	 * @throws {sap.ui.model.ValidateException}
 	 *   If at least one of the type constraints are not met; the message of the exception is

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

@@ -78,11 +78,11 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/Log"],
 		},
 
 		/**
-		 * Returns a group object, at least containing a key property for group detection.
+		 * Returns a group object, at least containing a "key" property for group detection.
 		 * May contain additional properties as provided by a custom group function.
 		 *
 		 * @param {sap.ui.model.Context} oContext the binding context
-		 * @return {object} An object containing a key property and optional custom properties
+		 * @return {Object<string, any>} An object containing a key property and optional custom properties
 		 * @public
 		 */
 		getGroup : function(oContext) {

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

@@ -12,7 +12,7 @@ sap.ui.define([],
 	/**
 	 * Different modes for setting the auto expand mode on tree or analytical bindings.
 	 *
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 * @enum {string}
 	 * @alias sap.ui.model.TreeAutoExpandMode
 	 * @protected

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

@@ -19,7 +19,7 @@ sap.ui.define(['sap/ui/base/Object'],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @public
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 */
 	var Type = BaseObject.extend("sap.ui.model.Type", /** @lends sap.ui.model.Type.prototype */ {
 

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

@@ -6,8 +6,9 @@
 sap.ui.define([
 	"sap/base/util/deepEqual",
 	"sap/base/util/extend",
+	"sap/base/util/isPlainObject",
 	"sap/base/util/merge"
-], function (deepEqual, extend, merge) {
+], function (deepEqual, extend, isPlainObject, merge) {
 	"use strict";
 
 	/**
@@ -19,6 +20,7 @@ sap.ui.define([
 		// @see sap.base.util.*
 		deepEqual : deepEqual,
 		extend : extend,
+		isPlainObject : isPlainObject,
 		merge : merge
 	};
 

package/src/sap/ui/model/analytics/odata4analytics.js

@@ -285,14 +285,14 @@ sap.ui.define([
 			} else if (mParameter && mParameter.modelVersion === AnalyticalVersionInfo.V2) {
 				// Check if the user wants a V2 model
 				ODataModelClass = sap.ui.require("sap/ui/model/odata/v2/ODataModel") ||
-					sap.ui.requireSync("sap/ui/model/odata/v2/ODataModel");
+					sap.ui.requireSync("sap/ui/model/odata/v2/ODataModel"); // legacy-relevant: fallback for missing dependency
 				this._oModel = new ODataModelClass(oModelReference.sServiceURI);
 				this._iVersion = AnalyticalVersionInfo.V2;
 				checkForMetadata();
 			} else {
 				//default is V1 Model
 				ODataModelClass = sap.ui.require("sap/ui/model/odata/ODataModel") ||
-					sap.ui.requireSync("sap/ui/model/odata/ODataModel");
+					sap.ui.requireSync("sap/ui/model/odata/ODataModel"); // legacy-relevant: fallback for missing dependency
 				this._oModel = new ODataModelClass(oModelReference.sServiceURI);
 				this._iVersion = AnalyticalVersionInfo.V1;
 				checkForMetadata();

package/src/sap/ui/model/base/ManagedObjectModel.js

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */

package/src/sap/ui/model/json/JSONModel.js

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.ClientModel
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 * @public
 	 * @alias sap.ui.model.json.JSONModel
 	 */
@@ -383,7 +383,7 @@ sap.ui.define([
 	 *   The path to the property
 	 * @param {sap.ui.model.Context} [oContext]
 	 *   The context which will be used to retrieve the property
-	 * @return {any}
+	 * @return {any|null|undefined}
 	 *   The value of the property. If the property is not found, <code>null</code> or
 	 *   <code>undefined</code> is returned.
 	 * @public

package/src/sap/ui/model/message/MessageModel.js

@@ -29,7 +29,7 @@ sap.ui.define(['sap/ui/model/BindingMode', 'sap/ui/model/ClientModel', 'sap/ui/m
 	 * @extends sap.ui.model.ClientModel
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 *
 	 * @param {sap.ui.core.message.MessageManager} oMessageManager The MessageManager instance
 	 * @public

package/src/sap/ui/model/odata/AnnotationHelper.js

@@ -364,7 +364,7 @@ sap.ui.define([
 			 *   <code>Edm.NavigationPropertyPath</code>, <code>Edm.Path</code>, or
 			 *   <code>Edm.PropertyPath</code> embedded within an entity set or entity type;
 			 *   the context's model must be an {@link sap.ui.model.odata.ODataMetaModel}
-			 * @returns {string}
+			 * @returns {string|undefined}
 			 *   the path to the entity set, or <code>undefined</code> if no such set is found. In
 			 *   this case, a warning is logged to the console.
 			 * @public
@@ -412,7 +412,7 @@ sap.ui.define([
 			 * @param {sap.ui.model.Context} oContext
 			 *   a context which must point to the qualified name of an entity type;
 			 *   the context's model must be an {@link sap.ui.model.odata.ODataMetaModel}
-			 * @returns {string}
+			 * @returns {string|undefined}
 			 *   the path to the entity type with the given qualified name,
 			 *   or <code>undefined</code> if no such type is found. In this case, a warning is
 			 *   logged to the console.
@@ -449,7 +449,7 @@ sap.ui.define([
 			 *   a context which must point to an object with a <code>String</code> property, which
 			 *   holds the qualified name of the function import;
 			 *   the context's model must be an {@link sap.ui.model.odata.ODataMetaModel}
-			 * @returns {string}
+			 * @returns {string|undefined}
 			 *   the path to the function import with the given qualified name,
 			 *   or <code>undefined</code> if no function import is found. In this case, a warning
 			 *   is logged to the console.
@@ -550,7 +550,7 @@ sap.ui.define([
 			 *   <code>Edm.Path</code> or <code>Edm.PropertyPath</code>, embedded within an entity
 			 *   set or entity type;
 			 *   the context's model must be an {@link sap.ui.model.odata.ODataMetaModel}
-			 * @returns {string}
+			 * @returns {string|undefined}
 			 *   the path to the target, or <code>undefined</code> in case the path cannot be
 			 *   resolved. In this case, a warning is logged to the console.
 			 * @public

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

@@ -25,7 +25,7 @@ sap.ui.define([
 	 *
 	 * @author SAP SE
 	 * @version
-	 * 1.103.1
+	 * 1.106.0
 	 *
 	 * @public
 	 * @deprecated As of version 1.66, please use {@link sap.ui.model.odata.v2.ODataAnnotations} instead.

package/src/sap/ui/model/odata/ODataMessageParser.js

@@ -84,7 +84,7 @@ var sClassName = "sap.ui.model.odata.ODataMessageParser",
  * @extends sap.ui.core.message.MessageParser
  *
  * @author SAP SE
- * @version 1.103.1
+ * @version 1.106.0
  * @public
  * @alias sap.ui.model.odata.ODataMessageParser
  */
@@ -170,11 +170,11 @@ ODataMessageParser.prototype.parse = function(oResponse, oRequest, mGetEntities,
 		// Status us 4XX or 5XX - parse body
 		try {
 			aMessages = this._parseBody(oResponse, mRequestInfo);
-			this._logErrorMessages(aMessages, oRequest, sStatusCode);
 		} catch (ex) {
 			aMessages = this._createGenericError(mRequestInfo);
-			Log.error("Request failed with status code " + sStatusCode + ": " + oRequest.method
-				+ " " + oRequest.requestUri, ex, sClassName);
+			Log.debug("Failed to parse error messages from the response body", ex, sClassName);
+		} finally {
+			this._logErrorMessages(aMessages, oRequest, sStatusCode);
 		}
 	} else {
 		// Status neither ok nor error, may happen if no network connection is available (some

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

@@ -207,7 +207,7 @@ sap.ui.define([
 	 * {@link #loaded loaded} has been resolved!
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 * @alias sap.ui.model.odata.ODataMetaModel
 	 * @extends sap.ui.model.MetaModel
 	 * @public
@@ -663,7 +663,7 @@ sap.ui.define([
 	 *   "/ProductSet(1)/ToSupplier/BusinessPartnerID"; this equals the
 	 *   <a href="http://www.odata.org/documentation/odata-version-2-0/uri-conventions#ResourcePath">
 	 *   resource path</a> component of a URI according to OData V2 URI conventions
-	 * @returns {sap.ui.model.Context}
+	 * @returns {sap.ui.model.Context|null}
 	 *   the context for the corresponding metadata object, i.e. an entity type or its property,
 	 *   or <code>null</code> in case no path is given
 	 * @throws {Error} in case no context can be determined
@@ -764,7 +764,7 @@ sap.ui.define([
 	 *   an entity type as returned by {@link #getODataEntityType getODataEntityType}
 	 * @param {string} sName
 	 *   the name of a navigation property within this entity type
-	 * @returns {object}
+	 * @returns {object|null}
 	 *   the OData association end or <code>null</code> if no such association end is found
 	 * @public
 	 */
@@ -790,7 +790,7 @@ sap.ui.define([
 	 *   an entity type as returned by {@link #getODataEntityType getODataEntityType}
 	 * @param {string} sName
 	 *   the name of a navigation property within this entity type
-	 * @returns {object}
+	 * @returns {object|null}
 	 *   the OData association set end or <code>null</code> if no such association set end is found
 	 * @public
 	 */
@@ -821,7 +821,7 @@ sap.ui.define([
 	 *   a qualified name, e.g. "ACME.Address"
 	 * @param {boolean} [bAsPath=false]
 	 *   determines whether the complex type is returned as a path or as an object
-	 * @returns {object|string}
+	 * @returns {object|string|undefined|null}
 	 *   (the path to) the complex type with the given qualified name; <code>undefined</code> (for
 	 *   a path) or <code>null</code> (for an object) if no such type is found
 	 * @public
@@ -836,7 +836,7 @@ sap.ui.define([
 	 *
 	 * @param {boolean} [bAsPath=false]
 	 *   determines whether the entity container is returned as a path or as an object
-	 * @returns {object|string}
+	 * @returns {object|string|undefined|null}
 	 *   (the path to) the default entity container; <code>undefined</code> (for a path) or
 	 *   <code>null</code> (for an object) if no such container is found
 	 * @public
@@ -875,7 +875,7 @@ sap.ui.define([
 	 *   a simple name, e.g. "ProductSet"
 	 * @param {boolean} [bAsPath=false]
 	 *   determines whether the entity set is returned as a path or as an object
-	 * @returns {object|string}
+	 * @returns {object|string|undefined|null}
 	 *   (the path to) the entity set with the given simple name; <code>undefined</code> (for a
 	 *   path) or <code>null</code> (for an object) if no such set is found
 	 * @public
@@ -892,7 +892,7 @@ sap.ui.define([
 	 *   a qualified name, e.g. "ACME.Product"
 	 * @param {boolean} [bAsPath=false]
 	 *   determines whether the entity type is returned as a path or as an object
-	 * @returns {object|string}
+	 * @returns {object|string|undefined|null}
 	 *   (the path to) the entity type with the given qualified name; <code>undefined</code> (for a
 	 *   path) or <code>null</code> (for an object) if no such type is found
 	 * @public
@@ -909,7 +909,7 @@ sap.ui.define([
 	 *   a simple or qualified name, e.g. "Save" or "MyService.Entities/Save"
 	 * @param {boolean} [bAsPath=false]
 	 *   determines whether the function import is returned as a path or as an object
-	 * @returns {object|string}
+	 * @returns {object|string|undefined|null}
 	 *   (the path to) the function import with the given simple name; <code>undefined</code> (for
 	 *   a path) or <code>null</code> (for an object) if no such function import is found
 	 * @public
@@ -980,7 +980,7 @@ sap.ui.define([
 	 *   <b>BEWARE</b> that this array is modified by removing each part which is understood!
 	 * @param {boolean} [bAsPath=false]
 	 *   determines whether the property is returned as a path or as an object
-	 * @returns {object|string}
+	 * @returns {object|string|undefined|null}
 	 *   (the path to) the last OData property found; <code>undefined</code> (for a path) or
 	 *   <code>null</code> (for an object) if no property was found at all
 	 * @public

package/src/sap/ui/model/odata/ODataMetadata.js

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * Implementation to access OData metadata
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.odata.ODataMetadata
@@ -1709,17 +1709,20 @@ sap.ui.define([
 				// names of the entity keys are the same. Otherwise it is not guaranteed that the
 				// function parameter name is equal to the corresponding key property of the
 				// resulting entity type.
+				// Parameter values need to be encoded, property names contain only the characters
+				// _A-Za-z0-9 which don't need to be encoded.
 				if (aPropertyReferences.length === 1) {
 					sParameterName = aPropertyReferences[0].name;
 					if (mFunctionParameters[sParameterName]) {
-						sId = mFunctionParameters[sParameterName];
+						sId = encodeURIComponent(mFunctionParameters[sParameterName]);
 					}
 				} else {
 					aKeys = [];
 					for (i = 0; i < aPropertyReferences.length; i += 1) {
 						sParameterName = aPropertyReferences[i].name;
 						if (mFunctionParameters[sParameterName]) {
-							aKeys.push(sParameterName + "=" + mFunctionParameters[sParameterName]);
+							aKeys.push(sParameterName + "="
+								+ encodeURIComponent(mFunctionParameters[sParameterName]));
 						}
 					}
 					sId = aKeys.join(",");

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

@@ -76,7 +76,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 *
 	 * @public
 	 * @deprecated As of version 1.48, please use {@link sap.ui.model.odata.v2.ODataModel} instead.