@openui5/sap.ui.core 1.93.3 → 1.96.2

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

@@ -137,7 +137,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @alias sap.ui.model.odata.type.Int64
 	 * @param {object} [oFormatOptions]

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

@@ -115,7 +115,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @abstract
 	 * @alias sap.ui.model.odata.type.ODataType

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

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 */
 	var Raw = ODataType.extend("sap.ui.model.odata.type.Raw", {
 			constructor : function (oFormatOptions, oConstraints) {

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @alias sap.ui.model.odata.type.SByte
 	 * @param {object} [oFormatOptions]

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

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @alias sap.ui.model.odata.type.Single
 	 * @param {object} [oFormatOptions]

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

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.51.0
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 */
 	var Stream = ODataType.extend("sap.ui.model.odata.type.Stream", {
 			constructor : function (oFormatOptions, oConstraints) {

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

@@ -84,7 +84,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @alias sap.ui.model.odata.type.String
 	 * @param {object} [oFormatOptions]

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

@@ -154,7 +154,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @alias sap.ui.model.odata.type.Time
 	 * @param {object} [oFormatOptions]

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

@@ -110,7 +110,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 */
 	var TimeOfDay = ODataType.extend("sap.ui.model.odata.type.TimeOfDay", {
 			constructor : function (oFormatOptions, oConstraints) {

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.93.3
+	 * @version 1.96.2
 	 */
 	var Unit = BaseUnit.extend("sap.ui.model.odata.type.Unit", {
 		constructor : function (oFormatOptions, oConstraints, aDynamicFormatOptionNames) {

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

@@ -19,6 +19,18 @@ sap.ui.define([
 	 *   An absolute path without trailing slash, for example "/Products(1)/ToSupplier"
 	 * @param {string} [sDeepPath=sPath]
 	 *   The absolute deep path including all intermediate paths of the binding hierarchy
+	 * @param {sap.ui.base.SyncPromise} [oCreatePromise]
+	 *   A sync promise that is given when this context has been created by
+	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry}.
+	 *
+	 *   When the entity represented by this context has been successfully persisted in the back
+	 *   end, the given promise resolves.
+	 *
+	 *   When the entity is deleted before it has been persisted in the back end via
+	 *   {@link sap.ui.model.odata.v2.ODataModel#resetChanges} with the
+	 *   <code>bDeleteCreatedEntities</code> parameter set to <code>true</code>, the given promise
+	 *   rejects with an object <code>oError</code> containing the error information, where
+	 *   <code>oError.aborted === true</code>.
 	 * @alias sap.ui.model.odata.v2.Context
 	 * @author SAP SE
 	 * @class Implementation of an OData V2 model's context.
@@ -31,6 +43,7 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li>an OData binding</li>
 	 *     <li>a view element</li>
+	 *     <li>{@link sap.ui.model.odata.v2.ODataModel#callFunction}</li>
 	 *     <li>{@link sap.ui.model.odata.v2.ODataModel#createBindingContext}</li>
 	 *     <li>{@link sap.ui.model.odata.v2.ODataModel#createEntry}</li>
 	 *   </ul>
@@ -39,13 +52,15 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.93.0
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 */
 	var Context = BaseContext.extend("sap.ui.model.odata.v2.Context", {
-			constructor : function (oModel, sPath, sDeepPath) {
+			constructor : function (oModel, sPath, sDeepPath, oCreatePromise) {
 				BaseContext.call(this, oModel, sPath);
-				// whether a new entity was created by ODataModel#createEntry and not yet persisted
-				this.bCreated = false;
+				// Promise returned by #created for a context of a newly created entity which
+				// resolves when the entity is persisted or rejects if the creation is aborted; set
+				// it lazily to avoid "Uncaught (in promise)" errors
+				this.oCreatePromise = undefined;
 				// the absolute path including all intermediate paths of the binding hierarchy;
 				// used to compute the full target of messages
 				this.sDeepPath = sDeepPath || sPath;
@@ -54,12 +69,51 @@ sap.ui.define([
 				// whether this context's path may be used to create the request URL for dependent
 				// bindings even if no data has been loaded for the context's entity
 				this.bPreliminary = false;
+				// SyncPromise for a context created via
+				// sap.ui.model.odata.v2.ODataModel#createEntry; used internally to detect
+				// synchronously whether the promise is already fulfilled
+				this.oSyncCreatePromise = oCreatePromise;
 				// whether the context is updated, e.g. path changed from a preliminary path to the
 				// canonical one
 				this.bUpdated = false;
 			}
 		});
 
+	/**
+	 * Returns a promise on the creation state of this context if it has been created via
+	 * {@link sap.ui.model.odata.v2.ODataModel#createEntry}; otherwise returns
+	 * <code>undefined</code>.
+	 *
+	 * As long as the promise is not yet resolved or rejected, the entity represented by this
+	 * context is transient.
+	 *
+	 * Once the promise is resolved, the entity for this context is stored in the back end and
+	 * {@link #getPath} returns a path including the key predicate of the new entity.
+	 *
+	 * @returns {Promise}
+	 *   A promise for a context which has been created via
+	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry}, otherwise <code>undefined</code>.
+	 *
+	 *   When the entity represented by this context has been persisted in the back end, the promise
+	 *   resolves without data.
+	 *
+	 *   When the entity is deleted before it has been persisted in the back end via
+	 *   {@link sap.ui.model.odata.v2.ODataModel#resetChanges} with the
+	 *   <code>bDeleteCreatedEntities</code> parameter set to <code>true</code>, the promise rejects
+	 *   with an object <code>oError</code> containing the error information, where
+	 *   <code>oError.aborted === true</code>.
+	 *
+	 * @public
+	 * @since 1.96.0
+	 */
+	Context.prototype.created = function () {
+		if (this.oSyncCreatePromise && !this.oCreatePromise) {
+			// ensure to return a promise that is resolved w/o data
+			this.oCreatePromise = Promise.resolve(this.oSyncCreatePromise).then(function () {});
+		}
+
+		return this.oCreatePromise;
+	};
 
 	/**
 	 * Gets the absolute deep path including all intermediate paths of the binding hierarchy. This
@@ -68,7 +122,7 @@ sap.ui.define([
 	 * @return {string} The deep path
 	 * @private
 	 */
-	 Context.prototype.getDeepPath = function () {
+	Context.prototype.getDeepPath = function () {
 		return this.sDeepPath;
 	};
 
@@ -81,7 +135,7 @@ sap.ui.define([
 	 * @see sap.ui.model.odata.v2.Context#isUpdated
 	 * @see sap.ui.model.odata.v2.Context#isRefreshForced
 	 */
-	 Context.prototype.hasChanged = function() {
+	Context.prototype.hasChanged = function () {
 		return this.bUpdated || this.bForceRefresh;
 	};
 
@@ -94,7 +148,7 @@ sap.ui.define([
 	 * @private
 	 * @ui5-restricted sap.suite.ui.generic
 	 */
-	 Context.prototype.isPreliminary = function () {
+	Context.prototype.isPreliminary = function () {
 		return this.bPreliminary;
 	};
 
@@ -105,10 +159,28 @@ sap.ui.define([
 	 * @return {boolean} Whether dependent bindings need to be refreshed
 	 * @private
 	 */
-	 Context.prototype.isRefreshForced = function () {
+	Context.prototype.isRefreshForced = function () {
 		return this.bForceRefresh;
 	};
 
+	/**
+	 * For a context created using {@link sap.ui.model.odata.v2.ODataModel#createEntry}, the method
+	 * returns <code>true</code> if the context is transient or <code>false</code> if the context is
+	 * not transient. A transient context represents an entity created on the client which has not
+	 * been persisted in the back end.
+	 *
+	 * @returns {boolean}
+	 *   Whether this context is transient if it has been created using
+	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry}; returns <code>undefined</code> if the
+	 *   context has not been created using {@link sap.ui.model.odata.v2.ODataModel#createEntry}
+	 *
+	 * @public
+	 * @since 1.94.0
+	 */
+	Context.prototype.isTransient = function () {
+		return this.oSyncCreatePromise && this.oSyncCreatePromise.isPending();
+	};
+
 	/**
 	 * Whether this context was updated. For example the path changed from a preliminary path to the
 	 * canonical one.
@@ -116,7 +188,7 @@ sap.ui.define([
 	 * @return {boolean} Whether the context is updated
 	 * @private
 	 */
-	 Context.prototype.isUpdated = function () {
+	Context.prototype.isUpdated = function () {
 		return this.bUpdated;
 	};
 

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

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides class sap.ui.model.odata.v2.ODataAnnotations
 sap.ui.define([
 	"sap/base/assert",
@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @class Annotation loader for OData V2 services
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @public
 	 * @since 1.37.0
@@ -684,7 +684,7 @@ sap.ui.define([
 
 	/**
 	 * Loads a given source (sap.ui.model.odata.v2.ODataAnnotations.Source) if necessary and returns a promise that resolves
-	 * if the source could be loaded or no laoding is necessary. In case the source type is neither "xml" nor "url" or
+	 * if the source could be loaded or no loading is necessary. In case the source type is neither "xml" nor "url" or
 	 * the loading of the source fails, the promise rejects.
 	 *
 	 * @param {sap.ui.model.odata.v2.ODataAnnotations.Source} mSource The source to be loaded

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

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 //Provides an abstraction for list bindings
 sap.ui.define([
 	"sap/base/util/deepExtend",
@@ -73,57 +73,54 @@ sap.ui.define([
 	 * @see sap.ui.model.Binding.prototype.initialize
 	 */
 	ODataContextBinding.prototype.initialize = function() {
-		var that = this,
-			sResolvedPath,
-			bCreatedRelative = this.isRelative() && this.oContext && this.oContext.bCreated,
+		var oContext, bReloadNeeded, sResolvedPath,
 			bPreliminary = this.oContext && this.oContext.isPreliminary(),
-			bReloadNeeded;
+			bRelativeAndTransient = this.isRelative()
+				&& this.oContext && this.oContext.isTransient && this.oContext.isTransient(),
+			that = this;
 
 		// don't fire any requests if metadata is not loaded yet.
 		if (!this.oModel.oMetadata.isLoaded() || !this.bInitial) {
 			return;
 		}
-
 		this.bInitial = false;
-
 		// If context is preliminary and usePreliminary is not set, exit here
 		if (bPreliminary && !this.bUsePreliminaryContext) {
 			return;
 		}
-
 		// if path cannot be resolved or parent context is created, set element context to null
 		sResolvedPath = this.getResolvedPath();
-		if (!sResolvedPath || bCreatedRelative) {
+		if (!sResolvedPath || bRelativeAndTransient) {
 			this.oElementContext = null;
 			this._fireChange({ reason: ChangeReason.Context });
+
 			return;
 		}
-
 		// check whether a request is necessary and create binding context
 		bReloadNeeded = this.oModel._isReloadNeeded(sResolvedPath, this.mParameters);
 		if (bReloadNeeded) {
 			this.fireDataRequested();
 			this.bPendingRequest = true;
 		}
-		var oContext = this.oModel.createBindingContext(this.sPath, this.oContext, this.mParameters, function(oContext) {
+		oContext = this.oModel.createBindingContext(this.sPath, this.oContext, this.mParameters,
+				function (oNewContext) {
 			var oData,
-				bUpdated = oContext && oContext.isUpdated(),
-				bForceRefresh = oContext && oContext.isRefreshForced();
+				bForceRefresh = oNewContext && oNewContext.isRefreshForced(),
+				bUpdated = oNewContext && oNewContext.isUpdated();
 
-			if (that.bCreatePreliminaryContext && oContext && that.oElementContext) {
+			if (that.bCreatePreliminaryContext && oNewContext && that.oElementContext) {
 				that.oElementContext.setPreliminary(false);
-				that.oModel._updateContext(that.oElementContext, oContext.getPath());
+				that.oModel._updateContext(that.oElementContext, oNewContext.getPath());
 				that._fireChange({ reason: ChangeReason.Context }, false, true);
-			} else if (!oContext || Context.hasChanged(oContext, that.oElementContext)) {
-				that.oElementContext = oContext;
+			} else if (!oNewContext || Context.hasChanged(oNewContext, that.oElementContext)) {
+				that.oElementContext = oNewContext;
 				that._fireChange({ reason: ChangeReason.Context }, bForceRefresh, bUpdated);
 			}
-
 			if (bReloadNeeded) {
 				if (that.oElementContext) {
 					oData = that.oElementContext.getObject(that.mParameters);
 				}
-				// register datareceived call as callAfterUpdate
+				// register data received call as callAfterUpdate
 				that.oModel.callAfterUpdate(function() {
 					that.fireDataReceived({data: oData});
 				});
@@ -209,16 +206,17 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataContextBinding.prototype._refresh = function(bForceUpdate, mChangedEntities) {
-		var that = this, oData, sKey, oStoredEntry, bChangeDetected = false,
+		var oContext, sContextPath, oData, sKey, oStoredEntry,
+			bChangeDetected = false,
 			mParameters = this.mParameters,
-			bCreatedRelative = this.isRelative() && this.oContext && this.oContext.bCreated,
+			bRelativeAndTransient = this.isRelative()
+				&& this.oContext && this.oContext.isTransient && this.oContext.isTransient(),
 			sResolvedPath = this.getResolvedPath(),
-			sContextPath;
+			that = this;
 
-		if (this.bInitial || bCreatedRelative) {
+		if (this.bInitial || bRelativeAndTransient) {
 			return;
 		}
-
 		if (mChangedEntities) {
 			//get entry from model. If entry exists get key for update bindings
 			oStoredEntry = this.oModel._getObject(this.sPath, this.oContext);
@@ -241,19 +239,20 @@ sap.ui.define([
 				mParameters = extend({},this.mParameters);
 				mParameters.groupId = this.sRefreshGroupId;
 			}
-			var oContext = this.oModel.createBindingContext(this.sPath, this.oContext, mParameters, function(oContext) {
-				if (that.bCreatePreliminaryContext && oContext && that.oElementContext) {
+			oContext = this.oModel.createBindingContext(this.sPath, this.oContext, mParameters,
+					function (oNewContext) {
+				if (that.bCreatePreliminaryContext && oNewContext && that.oElementContext) {
 					that.oElementContext.setPreliminary(false);
-					that.oModel._updateContext(that.oElementContext, oContext.getPath());
+					that.oModel._updateContext(that.oElementContext, oNewContext.getPath());
 					that._fireChange({ reason: ChangeReason.Context }, false, true);
-				} else if (Context.hasChanged(oContext, that.oElementContext) || bForceUpdate) {
-					that.oElementContext = oContext;
+				} else if (Context.hasChanged(oNewContext, that.oElementContext) || bForceUpdate) {
+					that.oElementContext = oNewContext;
 					that._fireChange({ reason: ChangeReason.Context }, bForceUpdate);
 				}
 				if (that.oElementContext) {
 					oData = that.oElementContext.getObject(that.mParameters);
 				}
-				//register datareceived call as  callAfterUpdate
+				//register data received call as callAfterUpdate
 				if (sResolvedPath) {
 					that.oModel.callAfterUpdate(function() {
 						that.fireDataReceived({data: oData});
@@ -281,51 +280,42 @@ sap.ui.define([
 	 * @private
 	 */
 	ODataContextBinding.prototype.setContext = function(oContext) {
-		var that = this,
-			oBindingContext,
-			oData,
-			sResolvedPath,
-			bCreated = oContext && oContext.bCreated,
-			bPreliminary = oContext && oContext.isPreliminary(),
+		var oBindingContext, sContextPath, oData, bReloadNeeded, sResolvedPath,
 			bForceUpdate = oContext && oContext.isRefreshForced(),
+			bPreliminary = oContext && oContext.isPreliminary(),
+			bTransient = oContext && oContext.isTransient && oContext.isTransient(),
 			bUpdated = oContext && oContext.isUpdated(),
-			sContextPath, bReloadNeeded;
+			that = this;
 
 		// If binding is initial or not a relative binding, nothing to do here
 		if (this.bInitial || !this.isRelative()) {
 			return;
 		}
-
 		// If context is preliminary and usePreliminary is not set, exit here
 		if (bPreliminary && !this.bUsePreliminaryContext) {
 			return;
 		}
-
 		if (bUpdated && this.bUsePreliminaryContext) {
 			this._fireChange({ reason: ChangeReason.Context });
+
 			return;
 		}
-
 		if (Context.hasChanged(this.oContext, oContext)) {
-
-
 			this.oContext = oContext;
-
 			sResolvedPath = this.getResolvedPath();
-
 			// If path doesn't resolve or parent context is created, reset current context
-			if (!sResolvedPath || bCreated) {
+			if (!sResolvedPath || bTransient) {
 				if (this.oElementContext !== null) {
 					this.oElementContext = null;
 					this._fireChange({ reason: ChangeReason.Context });
 				}
+
 				return;
 			}
-
 			// Create new binding context and fire change
 			oData = this.oModel._getObject(this.sPath, this.oContext);
-			bReloadNeeded =  bForceUpdate || this.oModel._isReloadNeeded(sResolvedPath, this.mParameters);
-
+			bReloadNeeded =  bForceUpdate
+				|| this.oModel._isReloadNeeded(sResolvedPath, this.mParameters);
 			if (sResolvedPath && bReloadNeeded) {
 				this.fireDataRequested();
 				this.bPendingRequest = true;
@@ -344,7 +334,7 @@ sap.ui.define([
 					if (that.oElementContext) {
 						oData = that.oElementContext.getObject(that.mParameters);
 					}
-					//register datareceived call as  callAfterUpdate
+					//register data received call as callAfterUpdate
 					that.oModel.callAfterUpdate(function() {
 						that.fireDataReceived({data: oData});
 					});