@openui5/sap.ui.core 1.96.2 → 1.98.0

package/src/sap/ui/model/odata/v4/lib/_ConcatHelper.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (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/odata/v4/lib/_GroupLock.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -180,7 +180,7 @@ sap.ui.define([
 	 * Returns a promise that is resolved when this lock does no longer block the given group ID.
 	 *
 	 * @param {string} sGroupId The group ID
-	 * @returns {sap.ui.base.SyncPromise}
+	 * @returns {sap.ui.base.SyncPromise|undefined}
 	 *   A promise or <code>undefined</code> if the lock does not block this group
 	 *
 	 * @public

package/src/sap/ui/model/odata/v4/lib/_Helper.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -282,10 +282,10 @@ sap.ui.define([
 		 * <code>JSON.stringify</code>.
 		 * <b>Warning: <code>Date</code> objects will be turned into strings</b>
 		 *
-		 * @param {*} vValue - Any value, including <code>undefined</code>
+		 * @param {any} vValue - Any value, including <code>undefined</code>
 		 * @param {function} [fnReplacer] - The replacer function to transform the result, see
 		 *   <code>JSON.stringify</code>
-		 * @returns {*} - A clone
+		 * @returns {any} - A clone
 		 */
 		clone : function clone(vValue, fnReplacer) {
 			return vValue === undefined || vValue === Infinity || vValue === -Infinity
@@ -361,7 +361,7 @@ sap.ui.define([
 			if (jqXHR.status === 412) {
 				sPreference = jqXHR.getResponseHeader("Preference-Applied");
 
-				if (sPreference && sPreference.replace(rWhitespace, '') === "handling=strict") {
+				if (sPreference && sPreference.replace(rWhitespace, "") === "handling=strict") {
 					oResult.strictHandlingFailed = true;
 				} else {
 					oResult.isConcurrentModification = true;
@@ -608,7 +608,7 @@ sap.ui.define([
 		 *   The object to start at
 		 * @param {string[]} aSegments
 		 *   Relative path to drill-down into, as array of segments
-		 * @returns {*}
+		 * @returns {any}
 		 *   The result matching to the given path, or <code>undefined</code> if the path leads
 		 *   into void
 		 */
@@ -633,6 +633,7 @@ sap.ui.define([
 					.replace(rAmpersand, "%26")
 					.replace(rHash, "%23")
 					.replace(rPlus, "%2B");
+
 			if (bEncodeEquals) {
 				sEncoded = sEncoded.replace(rEquals, "%3D");
 			}
@@ -699,7 +700,7 @@ sap.ui.define([
 					};
 
 				Object.keys(oMessage).forEach(function (sProperty) {
-					if (sProperty[0] === '@') {
+					if (sProperty[0] === "@") {
 						// cannot use .getAnnotation() for compatibility reasons
 						if (sProperty.endsWith(".numericSeverity")) {
 							oRawMessage.numericSeverity = oMessage[sProperty];
@@ -985,7 +986,7 @@ sap.ui.define([
 		 * @param {object} sName
 		 *   The name of the annotation without prefix "@" and namespace, e.g. ".ContentID" for a
 		 *   annotation "@Org.OData.Core.V1.ContentID"
-		 * @returns {any|undefined}
+		 * @returns {any}
 		 *   The value of the annotation, or <code>undefined</code> in case there is not exactly one
 		 *   such annotation (ignoring the alias)
 		 */
@@ -1057,7 +1058,7 @@ sap.ui.define([
 		 *   A list of key properties, either as a string or an object with one property (its name
 		 *   is the alias in the key predicate, its value is the path in the instance). If not
 		 *   given, the entity's key is used.
-		 * @returns {string}
+		 * @returns {string|undefined}
 		 *   A filter using key properties without URI encoding, e.g.
 		 *   "Sector eq 'A/B&C' and ID eq 42)", or <code>undefined</code>, if at least one key
 		 *   property is undefined
@@ -1097,7 +1098,7 @@ sap.ui.define([
 		 * @param {boolean} [bKeepSingleProperty]
 		 *   If true, the property name is not omitted if there is only one property
 		 *   (like "(ID='42')")
-		 * @returns {string}
+		 * @returns {string|undefined}
 		 *   The key predicate with proper URI encoding, e.g. "(Sector='A%2FB%26C',ID='42')" or
 		 *   "('42')", or <code>undefined</code>, if at least one key property is undefined
 		 * @throws {Error}
@@ -1138,7 +1139,7 @@ sap.ui.define([
 		 *   given, the entity's key is used
 		 * @param {boolean} [bReturnAlias]
 		 *   Whether to return the aliases instead of the keys
-		 * @returns {object}
+		 * @returns {object|undefined}
 		 *   The key properties map. For the metadata
 		 *   <Key>
 		 *    <PropertyRef Name="Info/ID" Alias="EntityInfoID"/>
@@ -1340,11 +1341,11 @@ sap.ui.define([
 			} else {
 				// must fire null to guarantee that a property binding has not
 				// this.vValue === undefined, see ODataPropertyBinding.setValue
-				_Helper.fireChange(mChangeListeners, sPath,  vNew === undefined ? null : vNew);
+				_Helper.fireChange(mChangeListeners, sPath, vNew === undefined ? null : vNew);
 				vNew = {};
 			}
 
-			if (vOld && typeof  vOld === "object") {
+			if (vOld && typeof vOld === "object") {
 				Object.keys(vOld).forEach(function (sProperty) {
 					// not covered in the new value
 					if (!vNew.hasOwnProperty(sProperty)) {
@@ -1658,12 +1659,11 @@ sap.ui.define([
 		 * @param {string} sLiteral The literal value
 		 * @param {string} sType The type
 		 * @param {string} sPath The path for this literal (for error messages)
-		 * @returns {*} The model value
+		 * @returns {any} The model value
 		 * @throws {Error} If the type is invalid or unsupported; the function only validates when a
 		 *   conversion is required
 		 */
 		parseLiteral : function (sLiteral, sType, sPath) {
-
 			function checkNaN(nValue) {
 				if (!isFinite(nValue)) { // this rejects NaN, Infinity, -Infinity
 					throw new Error(sPath + ": Not a valid " + sType + " literal: " + sLiteral);
@@ -1874,7 +1874,7 @@ sap.ui.define([
 		 * properties therein.
 		 *
 		 * Restrictions:
-		 * - oTarget and oSource are expected to have the same structure; when there is an
+		 * - oTarget and oSource are expected to have the same structure: when there is an
 		 *   object at a given path in either of them, the other one must have an object or
 		 *   <code>null</code>.
 		 * - no change events for collection-valued properties; list bindings without own cache must
@@ -1937,7 +1937,7 @@ sap.ui.define([
 		 * advertised actions.
 		 *
 		 * Restrictions:
-		 * - oOldObject and oNewObject are expected to have the same structure; when there is an
+		 * - oOldObject and oNewObject are expected to have the same structure: when there is an
 		 *   object at a given path in either of them, the other one must have an object or
 		 *   <code>null</code>.
 		 * - no change events for collection-valued properties
@@ -2004,6 +2004,36 @@ sap.ui.define([
 			});
 		},
 
+		/**
+		 * Recursively adds all properties of oSource to oTarget that do not exist there yet.
+		 * Ensures that object references in oTarget remain unchanged.
+		 *
+		 * Restrictions:
+		 * - oTarget and oSource are expected to have the same structure: when there is an
+		 *   object at a given path in either of them, the other one must have an object.
+		 *   <code>null</code>, or no property at all.
+		 * - arrays are not merged in any way, they are taken either from oSource or from oTarget
+		 *
+		 * @param {object} oTarget - The target
+		 * @param {object} oSource - The source
+		 */
+		updateNonExisting : function (oTarget, oSource) {
+			Object.keys(oSource).forEach(function (sKey) {
+				var vSourceValue = oSource[sKey],
+					vTargetValue;
+
+				if (sKey in oTarget) {
+					vTargetValue = oTarget[sKey];
+					if (vSourceValue && vTargetValue
+							&& typeof vSourceValue === "object" && !Array.isArray(vSourceValue)) {
+						_Helper.updateNonExisting(vTargetValue, vSourceValue);
+					}
+				} else {
+					oTarget[sKey] = vSourceValue;
+				}
+			});
+		},
+
 		/**
 		 * Updates the old value with the given new value for the selected properties (see
 		 * {@link #updateExisting}). If no selected properties are given or if "*" is contained in
@@ -2011,7 +2041,7 @@ sap.ui.define([
 		 * changed properties.
 		 *
 		 * Restrictions:
-		 * - oOldValue and oNewValue are expected to have the same structure; when there is an
+		 * - oOldValue and oNewValue are expected to have the same structure: when there is an
 		 *   object at a given path in either of them, the other one must have an object or
 		 *   <code>null</code>.
 		 * - "*" in aSelect does not work correctly if oNewValue contains navigation properties
@@ -2127,9 +2157,9 @@ sap.ui.define([
 		 * @param {function} fnFetchMetadata
 		 *   Function which fetches metadata for a given meta path
 		 *
-		 * @returns {object} The query options for the child binding or <code>undefined</code> in
-		 *   case the query options cannot be created, e.g. because $apply cannot be wrapped into
-		 *   $expand
+		 * @returns {object|undefined} The query options for the child binding or
+		 *   <code>undefined</code> in case the query options cannot be created, e.g. because $apply
+		 *   cannot be wrapped into $expand
 		 */
 		wrapChildQueryOptions : function (sBaseMetaPath, sChildMetaPath, mChildQueryOptions,
 				fnFetchMetadata) {

package/src/sap/ui/model/odata/v4/lib/_MetadataConverter.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -270,8 +270,8 @@ sap.ui.define([
 		// this.oAnnotatable is the Annotation itself currently.
 		var oAnnotatable = this.oAnnotatable.parent;
 
-		oAnnotatable.target[oAnnotatable.qualifiedName] =
-			aResult.length ? aResult[0] : this.getInlineAnnotationValue(oElement);
+		oAnnotatable.target[oAnnotatable.qualifiedName]
+			= aResult.length ? aResult[0] : this.getInlineAnnotationValue(oElement);
 	};
 
 	/**
@@ -327,8 +327,9 @@ sap.ui.define([
 	_MetadataConverter.prototype.postProcessLabeledElement = function (oElement, aResult) {
 		var oResult = this.oAnnotatable.target;
 
-		oResult.$LabeledElement = aResult.length ? aResult[0] :
-			this.getInlineAnnotationValue(oElement);
+		oResult.$LabeledElement = aResult.length
+			? aResult[0]
+			: this.getInlineAnnotationValue(oElement);
 		oResult.$Name = oElement.getAttribute("Name");
 		return oResult;
 	};
@@ -337,12 +338,12 @@ sap.ui.define([
 	 * Post-processing of a LabeledElementReference element within an Annotation element.
 	 *
 	 * @param {Element} oElement The element
-	 * @param {any[]} _aResult The results from child elements
+	 * @param {any[]} _aRes The results from child elements
 	 * @returns {any} The value for the JSON
 	 */
-	_MetadataConverter.prototype.postProcessLabeledElementReference = function (oElement, _aResult) {
+	_MetadataConverter.prototype.postProcessLabeledElementReference = function (oElement, _aRes) {
 		return {
-			"$LabeledElementReference" : this.resolveAlias(oElement.textContent)
+			$LabeledElementReference : this.resolveAlias(oElement.textContent)
 		};
 	};
 
@@ -567,15 +568,15 @@ sap.ui.define([
 	_MetadataConverter.prototype.processIncludeAnnotations = function (oElement) {
 		var oReference = this.reference,
 			oIncludeAnnotation = {
-				"$TermNamespace" : oElement.getAttribute("TermNamespace") + "."
+				$TermNamespace : oElement.getAttribute("TermNamespace") + "."
 			},
 			aIncludeAnnotations = this.getOrCreateArray(oReference, "$IncludeAnnotations");
 
 		this.processAttributes(oElement, oIncludeAnnotation, {
-			"TargetNamespace" : function setValue(sValue) {
+			TargetNamespace : function setValue(sValue) {
 				return sValue ? sValue + "." : sValue;
 			},
-			"Qualifier" : this.setValue
+			Qualifier : this.setValue
 		});
 
 		aIncludeAnnotations.push(oIncludeAnnotation);
@@ -628,7 +629,7 @@ sap.ui.define([
 	 *   Whether parentheses in the path segment should be handled specially for alias replacement,
 	 *   for example to address a bound action's specific overload
 	 * @param {string} sSegment The path segment
-	 * @returns {string} The path segment with aliases resolved (if there were any)
+	 * @returns {string|undefined} The path segment with aliases resolved (if there were any)
 	 */
 	_MetadataConverter.prototype.resolveAliasInParentheses = function (bHandleParentheses,
 			sSegment) {
@@ -656,7 +657,8 @@ sap.ui.define([
 	 * @returns {string} The path with aliases resolved (if there were any)
 	 */
 	_MetadataConverter.prototype.resolveAliasInPath = function (sPath, bHandleParentheses) {
-		var iAt, sTerm = "";
+		var iAt,
+			sTerm = "";
 
 		if (!sPath.includes(".")) {
 			return sPath; // no dot -> nothing to do
@@ -696,7 +698,7 @@ sap.ui.define([
 	 * Helper for processAttributes, returns sValue converted to a number.
 	 *
 	 * @param {string} sValue The attribute value in the element
-	 * @returns {number} The value as number or undefined
+	 * @returns {number|undefined} The value as number or <code>undefined</code>
 	 */
 	_MetadataConverter.prototype.setNumber = function (sValue) {
 		return sValue ? parseInt(sValue) : undefined;
@@ -733,7 +735,7 @@ sap.ui.define([
 	 *   If true, the hook processElement at the aggregate is used, otherwise the processor is
 	 *   called directly
 	 * @returns {any}
-	 *   The return value from __postProcessor or undefined if there is none
+	 *   The return value from __postProcessor or <code>undefined</code> if there is none
 	 */
 	_MetadataConverter.prototype.traverse = function (oElement, oConfig, bUseProcessElementHook) {
 		var oAnnotatable = this.oAnnotatable, // "push" oAnnotatable to the recursion stack
@@ -776,8 +778,8 @@ sap.ui.define([
 					}
 				}
 				if (oChildConfig) {
-					vChildResult =
-						this.traverse(oChildNode, oChildConfig, bUseProcessElementHook);
+					vChildResult
+						= this.traverse(oChildNode, oChildConfig, bUseProcessElementHook);
 					if (vChildResult !== undefined && oConfig.__postProcessor) {
 						// only push if the element is interested in the results and if the
 						// child element returns anything (it might be another Annotation which
@@ -809,23 +811,23 @@ sap.ui.define([
 
 		// All Annotations elements that don't have expressions as child (leaf, non-recursive)
 		oAnnotationLeafConfig = {
-			"AnnotationPath" : {__postProcessor : $$.postProcessLeaf},
-			"Binary" : {__postProcessor : $$.postProcessLeaf},
-			"Bool" : {__postProcessor : $$.postProcessLeaf},
-			"Date" : {__postProcessor : $$.postProcessLeaf},
-			"DateTimeOffset" : {__postProcessor : $$.postProcessLeaf},
-			"Decimal" : {__postProcessor : $$.postProcessLeaf},
-			"Duration" : {__postProcessor : $$.postProcessLeaf},
-			"EnumMember" : {__postProcessor : $$.postProcessLeaf},
-			"Float" : {__postProcessor : $$.postProcessLeaf},
-			"Guid" : {__postProcessor : $$.postProcessLeaf},
-			"Int" : {__postProcessor : $$.postProcessLeaf},
-			"LabeledElementReference" : {__postProcessor : $$.postProcessLabeledElementReference},
-			"NavigationPropertyPath" : {__postProcessor : $$.postProcessLeaf},
-			"Path" : {__postProcessor : $$.postProcessLeaf},
-			"PropertyPath" : {__postProcessor : $$.postProcessLeaf},
-			"String" : {__postProcessor : $$.postProcessLeaf},
-			"TimeOfDay" : {__postProcessor : $$.postProcessLeaf}
+			AnnotationPath : {__postProcessor : $$.postProcessLeaf},
+			Binary : {__postProcessor : $$.postProcessLeaf},
+			Bool : {__postProcessor : $$.postProcessLeaf},
+			Date : {__postProcessor : $$.postProcessLeaf},
+			DateTimeOffset : {__postProcessor : $$.postProcessLeaf},
+			Decimal : {__postProcessor : $$.postProcessLeaf},
+			Duration : {__postProcessor : $$.postProcessLeaf},
+			EnumMember : {__postProcessor : $$.postProcessLeaf},
+			Float : {__postProcessor : $$.postProcessLeaf},
+			Guid : {__postProcessor : $$.postProcessLeaf},
+			Int : {__postProcessor : $$.postProcessLeaf},
+			LabeledElementReference : {__postProcessor : $$.postProcessLabeledElementReference},
+			NavigationPropertyPath : {__postProcessor : $$.postProcessLeaf},
+			Path : {__postProcessor : $$.postProcessLeaf},
+			PropertyPath : {__postProcessor : $$.postProcessLeaf},
+			String : {__postProcessor : $$.postProcessLeaf},
+			TimeOfDay : {__postProcessor : $$.postProcessLeaf}
 		};
 
 		// When oAnnotationExpressionConfig is defined, it is added to this array for the recursion
@@ -833,7 +835,7 @@ sap.ui.define([
 
 		// The configuration for an <Annotation> element to be included into other configurations
 		$$.oAnnotationConfig = {
-			"Annotation" : {
+			Annotation : {
 				__xmlns : $$.sEdmNamespace,
 				__processor : $$.processAnnotation,
 				__postProcessor : $$.postProcessAnnotation,
@@ -848,60 +850,60 @@ sap.ui.define([
 			__include : aAnnotatableExpressionInclude
 		};
 		oAnnotationExpressionConfig = {
-			"And" : oOperatorConfig,
-			"Apply" : {
+			And : oOperatorConfig,
+			Apply : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessApply,
 				__include : aAnnotatableExpressionInclude
 			},
-			"Cast" : {
+			Cast : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessCastOrIsOf,
 				__include : aAnnotatableExpressionInclude
 			},
-			"Collection" : {
+			Collection : {
 				__postProcessor : $$.postProcessCollection,
 				__include : aExpressionInclude
 			},
-			"Eq" : oOperatorConfig,
-			"Ge" : oOperatorConfig,
-			"Gt" : oOperatorConfig,
-			"If" : oOperatorConfig,
-			"IsOf" : {
+			Eq : oOperatorConfig,
+			Ge : oOperatorConfig,
+			Gt : oOperatorConfig,
+			If : oOperatorConfig,
+			IsOf : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessCastOrIsOf,
 				__include : aAnnotatableExpressionInclude
 			},
-			"LabeledElement" : {
+			LabeledElement : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessLabeledElement,
 				__include : aAnnotatableExpressionInclude
 			},
-			"Le" : oOperatorConfig,
-			"Lt" : oOperatorConfig,
-			"Ne" : oOperatorConfig,
-			"Null" : {
+			Le : oOperatorConfig,
+			Lt : oOperatorConfig,
+			Ne : oOperatorConfig,
+			Null : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessNull,
 				__include : [$$.oAnnotationConfig]
 			},
-			"Not" : {
+			Not : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessNot,
 				__include : aAnnotatableExpressionInclude
 			},
-			"Or" : oOperatorConfig,
-			"Record" : {
+			Or : oOperatorConfig,
+			Record : {
 				__processor : $$.processAnnotatableExpression,
 				__postProcessor : $$.postProcessRecord,
 				__include : [$$.oAnnotationConfig],
-				"PropertyValue" : {
+				PropertyValue : {
 					__processor : $$.processPropertyValue,
 					__postProcessor : $$.postProcessPropertyValue,
 					__include : aAnnotatableExpressionInclude
 				}
 			},
-			"UrlRef" : {
+			UrlRef : {
 				__postProcessor : $$.postProcessUrlRef,
 				__include : aExpressionInclude
 			}
@@ -909,7 +911,7 @@ sap.ui.define([
 
 		// The configuration for an <Annotations> element to be included into other configurations
 		$$.oAnnotationsConfig = {
-			"Annotations" : {
+			Annotations : {
 				__processor : $$.processAnnotations,
 				__include : [$$.oAnnotationConfig]
 			}
@@ -925,20 +927,19 @@ sap.ui.define([
 		 * The configuration for a <Reference> element to be included into other configurations
 		 */
 		$$.oReferenceInclude = {
-			"Reference" : {
+			Reference : {
 				__xmlns : $$.sEdmxNamespace,
 				__processor : $$.processReference,
 				__include : [$$.oAnnotationConfig],
-				"Include" : {
+				Include : {
 					__processor : $$.processInclude
 				},
-				"IncludeAnnotations" : {
+				IncludeAnnotations : {
 					__processor : $$.processIncludeAnnotations
 				}
 			}
 		};
-
 	})(_MetadataConverter.prototype);
 
 	return _MetadataConverter;
-}, /* bExport= */false);
+}, /* bExport= */false);

package/src/sap/ui/model/odata/v4/lib/_MetadataRequestor.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -121,4 +121,4 @@ sap.ui.define([
 			};
 		}
 	};
-}, /* bExport= */false);
+}, /* bExport= */false);

package/src/sap/ui/model/odata/v4/lib/_MinMaxHelper.js

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