@openui5/sap.ui.core 1.97.1 → 1.99.1

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

@@ -18,7 +18,35 @@ sap.ui.define([
 		iGenerationCounter = 0,
 		oModule,
 		// index of virtual context used for auto-$expand/$select
-		iVIRTUAL = -9007199254740991/*Number.MIN_SAFE_INTEGER*/;
+		iVIRTUAL = -9007199254740991/*Number.MIN_SAFE_INTEGER*/,
+		/**
+		 * @alias sap.ui.model.odata.v4.Context
+		 * @author SAP SE
+		 * @class Implementation of an OData V4 model's context.
+		 *
+		 *   The context is a pointer to model data as returned by a query from a
+		 *   {@link sap.ui.model.odata.v4.ODataContextBinding} or a
+		 *   {@link sap.ui.model.odata.v4.ODataListBinding}. Contexts are always and only
+		 *   created by such bindings. A context for a context binding points to the complete query
+		 *   result. A context for a list binding points to one specific entry in the binding's
+		 *   collection. A property binding does not have a context, you can access its value via
+		 *   {@link sap.ui.model.odata.v4.ODataPropertyBinding#getValue}.
+		 *
+		 *   Applications can access model data only via a context, either synchronously with the
+		 *   risk that the values are not available yet ({@link #getProperty} and
+		 *   {@link #getObject}) or asynchronously ({@link #requestProperty} and
+		 *   {@link #requestObject}).
+		 *
+		 *   Context instances are immutable except for their indexes.
+		 * @extends sap.ui.model.Context
+		 * @hideconstructor
+		 * @public
+		 * @since 1.39.0
+		 * @version 1.99.1
+		 */
+		Context = BaseContext.extend("sap.ui.model.odata.v4.Context", {
+				constructor : constructor
+			});
 
 	/*
 	 * Fetches and formats the primitive value at the given path.
@@ -54,6 +82,10 @@ sap.ui.define([
 		});
 	}
 
+	//*********************************************************************************************
+	// Context
+	//*********************************************************************************************
+
 	/**
 	 * Do <strong>NOT</strong> call this private constructor. In the OData V4 model you cannot
 	 * create contexts at will: retrieve them from a binding or a view element instead.
@@ -73,70 +105,53 @@ sap.ui.define([
 	 *   {@link #created}
 	 * @param {number} [iGeneration=0]
 	 *   The unique number for this context's generation, which can be retrieved via
-	 *   {@link #getGeneration}.
+	 *   {@link #getGeneration}
+	 * @param {boolean} [bInactive]
+	 *   Whether this context is inactive and will only be sent to the server after the first
+	 *   property update
 	 * @throws {Error}
 	 *   If an invalid path is given
-	 *
-	 * @alias sap.ui.model.odata.v4.Context
-	 * @author SAP SE
-	 * @class Implementation of an OData V4 model's context.
-	 *
-	 *   The context is a pointer to model data as returned by a query from a
-	 *   {@link sap.ui.model.odata.v4.ODataContextBinding} or a
-	 *   {@link sap.ui.model.odata.v4.ODataListBinding}. Contexts are always and only
-	 *   created by such bindings. A context for a context binding points to the complete query
-	 *   result. A context for a list binding points to one specific entry in the binding's
-	 *   collection. A property binding does not have a context, you can access its value via
-	 *   {@link sap.ui.model.odata.v4.ODataPropertyBinding#getValue}.
-	 *
-	 *   Applications can access model data only via a context, either synchronously with the risk
-	 *   that the values are not available yet ({@link #getProperty} and {@link #getObject}) or
-	 *   asynchronously ({@link #requestProperty} and {@link #requestObject}).
-	 *
-	 *   Context instances are immutable except for their indexes.
-	 * @extends sap.ui.model.Context
-	 * @hideconstructor
-	 * @public
-	 * @since 1.39.0
-	 * @version 1.97.1
 	 */
-	var Context = BaseContext.extend("sap.ui.model.odata.v4.Context", {
-			constructor : function (oModel, oBinding, sPath, iIndex, oCreatePromise, iGeneration) {
-				if (sPath[0] !== "/") {
-					throw new Error("Not an absolute path: " + sPath);
-				}
-				if (sPath.endsWith("/")) {
-					throw new Error("Unsupported trailing slash: " + sPath);
-				}
-				BaseContext.call(this, oModel, sPath);
-				this.oBinding = oBinding;
-				this.oCreatedPromise = oCreatePromise
-					// ensure to return a promise that is resolved w/o data
-					&& Promise.resolve(oCreatePromise).then(function () {});
-				this.oSyncCreatePromise = oCreatePromise;
-				this.iGeneration = iGeneration || 0;
-				this.iIndex = iIndex;
-				this.bKeepAlive = false;
-				this.fnOnBeforeDestroy = undefined;
-			}
-		});
+	function constructor(oModel, oBinding, sPath, iIndex, oCreatePromise, iGeneration,
+			bInactive) {
+		if (sPath[0] !== "/") {
+			throw new Error("Not an absolute path: " + sPath);
+		}
+		if (sPath.endsWith("/")) {
+			throw new Error("Unsupported trailing slash: " + sPath);
+		}
+		BaseContext.call(this, oModel, sPath);
+		this.oBinding = oBinding;
+		this.oCreatedPromise = oCreatePromise
+			// ensure to return a promise that is resolved w/o data
+			&& Promise.resolve(oCreatePromise).then(function () {});
+		this.oSyncCreatePromise = oCreatePromise;
+		this.iGeneration = iGeneration || 0;
+		this.bInactive = bInactive || undefined; // be in sync with the annotation
+		this.iIndex = iIndex;
+		this.bKeepAlive = false;
+		this.fnOnBeforeDestroy = undefined;
+	}
 
 	/**
 	 * Deletes the OData entity this context points to.
 	 *
-	 * @param {sap.ui.model.odata.v4.lib._GroupLock} oGroupLock
-	 *   A lock for the group ID to be used for the DELETE request; if no group ID is specified, it
-	 *   defaults to the binding's <code>getUpdateGroupId()</code>
+	 * @param {sap.ui.model.odata.v4.lib._GroupLock} [oGroupLock]
+	 *   A lock for the group ID to be used for the DELETE request; w/o a lock, no DELETE is sent.
+	 *   For a transient entity, the lock is ignored (use NULL)!
 	 * @param {object} [oETagEntity]
 	 *   An entity with the ETag of the binding for which the deletion was requested. This is
 	 *   provided if the deletion is delegated from a context binding with empty path to a list
-	 *   binding.
+	 *   binding. W/o a lock, this is ignored.
 	 * @param {boolean} [bDoNotRequestCount]
 	 *   Whether not to request the new count from the server; useful in case of
-	 *   {@link #replaceWith} where it is known that the count remains unchanged
+	 *   {@link #replaceWith} where it is known that the count remains unchanged; w/o a lock this
+	 *   should be true
 	 * @returns {Promise}
 	 *   A promise which is resolved without a result in case of success, or rejected with an
 	 *   instance of <code>Error</code> in case of failure
+	 * @throws {Error}
+	 *   If the cache promise for this binding is not yet fulfilled, or if the cache is shared
 	 *
 	 * @private
 	 * @see sap.ui.model.odata.v4.Context#delete
@@ -144,8 +159,8 @@ sap.ui.define([
 	Context.prototype._delete = function (oGroupLock, oETagEntity, bDoNotRequestCount) {
 		var that = this;
 
-		if (this.isTransient()) {
-			return this.oBinding._delete(oGroupLock, "n/a", this, bDoNotRequestCount);
+		if (!oGroupLock) {
+			return this.oBinding._delete(null, "n/a", this, null, true);
 		}
 		return this.fetchCanonicalPath().then(function (sCanonicalPath) {
 			return that.oBinding._delete(oGroupLock, sCanonicalPath.slice(1), that, oETagEntity,
@@ -178,6 +193,17 @@ sap.ui.define([
 		});
 	};
 
+	/**
+	 * Updates all dependent bindings of this context.
+	 *
+	 * @private
+	 */
+	Context.prototype.checkUpdate = function () {
+		this.oModel.getDependentBindings(this).forEach(function (oDependentBinding) {
+			oDependentBinding.checkUpdate();
+		});
+	};
+
 	/**
 	 * Updates all dependent bindings of this context.
 	 *
@@ -185,10 +211,10 @@ sap.ui.define([
 	 *   A promise resolving without a defined result when the update is finished
 	 * @private
 	 */
-	Context.prototype.checkUpdate = function () {
+	Context.prototype.checkUpdateInternal = function () {
 		return SyncPromise.all(
 			this.oModel.getDependentBindings(this).map(function (oDependentBinding) {
-				return oDependentBinding.checkUpdate();
+				return oDependentBinding.checkUpdateInternal();
 			})
 		);
 	};
@@ -256,10 +282,14 @@ sap.ui.define([
 	 *   The group ID to be used for the DELETE request; if not specified, the update group ID for
 	 *   the context's binding is used, see {@link #getUpdateGroupId}; the resulting group ID must
 	 *   not have {@link sap.ui.model.odata.v4.SubmitMode.API}. Since 1.81, if this context is
-	 *   transient (see {@link #isTransient}), no group ID needs to be specified.
+	 *   transient (see {@link #isTransient}), no group ID needs to be specified. Since 1.98.0, you
+	 *   can use <code>null</code> to prevent the DELETE request in case of a kept-alive context
+	 *   that is not in the collection and of which you know that it does not exist on the server
+	 *   anymore (for example, a draft after activation).
 	 * @param {boolean} [bDoNotRequestCount]
 	 *   Whether not to request the new count from the server; useful in case of
-	 *   {@link #replaceWith} where it is known that the count remains unchanged (since 1.97.0)
+	 *   {@link #replaceWith} where it is known that the count remains unchanged (since 1.97.0).
+	 *   Since 1.98.0, this is implied if a <code>null</code> group ID is used.
 	 * @returns {Promise}
 	 *   A promise which is resolved without a result in case of success, or rejected with an
 	 *   instance of <code>Error</code> in case of failure, e.g. if the given context does not point
@@ -274,25 +304,39 @@ sap.ui.define([
 	 *   someone else and report success.
 	 * @throws {Error} If the given group ID is invalid, if this context's root binding is
 	 *   suspended, or if this context is not transient (see {@link #isTransient}) and has pending
-	 *   changes (see {@link #hasPendingChanges})
+	 *   changes (see {@link #hasPendingChanges}), or if a <code>null</code> group ID is used with
+	 *   a context which is not kept-alive (see {@link #isKeepAlive}) or is still in the collection
+	 *   (has an index, see {@link #getIndex})
 	 *
 	 * @function
 	 * @public
 	 * @since 1.41.0
 	 */
 	Context.prototype.delete = function (sGroupId, bDoNotRequestCount) {
-		var oGroupLock,
+		var oGroupLock = null,
 			oModel = this.oModel,
 			that = this;
 
-		oModel.checkGroupId(sGroupId);
 		this.oBinding.checkSuspended();
 		if (this.isTransient()) {
-			sGroupId = sGroupId || "$direct";
+			sGroupId = null;
 		} else if (this.hasPendingChanges()) {
 			throw new Error("Cannot delete due to pending changes");
+		} else if (sGroupId === null) {
+			if (!(this.bKeepAlive && this.iIndex === undefined)) {
+				throw new Error("Cannot delete " + this);
+			}
+		}
+		if (sGroupId === null) {
+			bDoNotRequestCount = true;
+		} else {
+			oModel.checkGroupId(sGroupId);
+			oGroupLock = this.oBinding.lockGroup(sGroupId, true, true);
+			sGroupId = oGroupLock.getGroupId();
+			if (this.oModel.isApiGroup(sGroupId)) {
+				throw new Error("Illegal update group ID: " + sGroupId);
+			}
 		}
-		oGroupLock = this.oBinding.lockGroup(sGroupId, true, true);
 
 		return this._delete(oGroupLock, /*oETagEntity*/null, bDoNotRequestCount).then(function () {
 			var sResourcePathPrefix = that.sPath.slice(1);
@@ -303,7 +347,9 @@ sap.ui.define([
 				oBinding.removeCachesAndMessages(sResourcePathPrefix, true);
 			});
 		}).catch(function (oError) {
-			oGroupLock.unlock(true);
+			if (oGroupLock) {
+				oGroupLock.unlock(true);
+			}
 			oModel.reportError("Failed to delete " + that, sClassName, oError);
 			throw oError;
 		});
@@ -362,7 +408,7 @@ sap.ui.define([
 
 		if (this.oModel.bAutoExpandSelect) {
 			sPath = oMetaModel.getReducedPath(
-				_Helper.buildPath(this.sPath, sPath),
+				this.oModel.resolve(sPath, this),
 				this.oBinding.getBaseForPathReduction());
 		}
 		return this.withCache(function (oCache, sCachePath, oBinding) {
@@ -413,6 +459,11 @@ sap.ui.define([
 						return oCache.setProperty(oResult.propertyPath, vValue, sEntityPath);
 					}
 
+					if (that.isInactive()) {
+						oBinding.fireCreateActivate(that);
+						that.bInactive = false;
+					}
+
 					// if request is canceled fnPatchSent and fnErrorCallback are not called and
 					// returned Promise is rejected -> no patch events
 					return oCache.update(oGroupLock, oResult.propertyPath, vValue,
@@ -488,13 +539,28 @@ sap.ui.define([
 	 * @private
 	 */
 	Context.prototype.fetchValue = function (sPath, oListener, bCached) {
+		var oBinding = this.oBinding;
+
 		if (this.iIndex === iVIRTUAL) {
 			return SyncPromise.resolve(); // no cache access for virtual contexts
 		}
+		if (oBinding.getHeaderContext && oBinding.getHeaderContext() === this) {
+			if (sPath && sPath.startsWith(this.sPath)) {
+				sPath = sPath.slice(this.sPath.length + 1);
+			}
+			if (!sPath) {
+				return oBinding.fetchValue(this.sPath, oListener, bCached)
+					.then(function (aElements) {
+						return {$count : aElements.$count};
+					});
+			} else if (sPath !== "$count") {
+				throw new Error("Invalid header path: " + sPath);
+			}
+		}
 		if (!sPath || sPath[0] !== "/") {
 			// Create an absolute path based on the context's path and reduce it. This is only
 			// necessary for data access via Context APIs, bindings already use absolute paths.
-			sPath = _Helper.buildPath(this.sPath, sPath);
+			sPath = this.oModel.resolve(sPath, this);
 			if (this.oModel.bAutoExpandSelect) {
 				sPath = this.oModel.getMetaModel()
 					.getReducedPath(sPath, this.oBinding.getBaseForPathReduction());
@@ -548,6 +614,8 @@ sap.ui.define([
 	 *   The unique number of this context's generation, or <code>0</code>
 	 *
 	 * @private
+	 * @see sap.ui.model.odata.v4.Context.createNewContext
+	 * @see #setNewGeneration
 	 */
 	Context.prototype.getGeneration = function (bOnlyLocal) {
 		if (this.iGeneration || bOnlyLocal) {
@@ -556,7 +624,6 @@ sap.ui.define([
 		return this.oBinding.getGeneration();
 	};
 
-
 	/**
 	 * Returns the group ID of the context's binding that is used for read requests. See
 	 * {@link sap.ui.model.odata.v4.ODataListBinding#getGroupId} and
@@ -635,12 +702,16 @@ sap.ui.define([
 	 * Returns <code>undefined</code> if the data is not (yet) available; no request is triggered.
 	 * Use {@link #requestObject} for asynchronous access.
 	 *
+	 * The header context of a list binding only delivers <code>$count</code> (wrapped in an object
+	 * if <code>sPath</code> is "").
+	 *
 	 * @param {string} [sPath=""]
 	 *   A path relative to this context
 	 * @returns {any}
 	 *   The requested value
 	 * @throws {Error}
-	 *   If the context's root binding is suspended
+	 *   If the context's root binding is suspended or if the context is a header context and the
+	 *   path is neither empty nor "$count".
 	 *
 	 * @public
 	 * @see sap.ui.model.Context#getObject
@@ -665,8 +736,12 @@ sap.ui.define([
 	 *   If the type is not yet available, <code>undefined</code> is returned.
 	 * @returns {any}
 	 *   The requested property value
-	 * @throws {Error}
-	 *   If the context's root binding is suspended or if the value is not primitive
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> the context's root binding is suspended,
+	 *     <li> the value is not primitive,
+	 *     <li> or the context is a header context and the path is not "$count"
+	 *   </ul>
 	 *
 	 * @public
 	 * @see sap.ui.model.Context#getProperty
@@ -744,7 +819,8 @@ sap.ui.define([
 	 * @private
 	 */
 	Context.prototype.getValue = function (sPath) {
-		var oSyncPromise, that = this;
+		var oSyncPromise,
+			that = this;
 
 		this.oBinding.checkSuspended();
 		oSyncPromise = this.fetchValue(sPath, null, true)
@@ -763,7 +839,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 transient (see {@link #isTransient}).
+	 * being {@link #isTransient transient}. Since 1.98.0, {@link #isInactive inactive} contexts are
+	 * ignored.
 	 *
 	 * @returns {boolean}
 	 *   Whether there are pending changes
@@ -795,6 +872,24 @@ sap.ui.define([
 		return this.getProperty("@$ui5.node.isExpanded");
 	};
 
+	/**
+	 * 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.
+	 *
+	 * @public
+	 * @see #isTransient
+	 * @see sap.ui.model.odata.v4.ODataListBinding#create
+	 * @see sap.ui.model.odata.v4.ODataListBinding#event:createActivate
+	 * @since 1.98.0
+	 */
+	Context.prototype.isInactive = function () {
+		return this.bInactive;
+	};
+
 	/**
 	 * Returns whether this context is kept alive.
 	 *
@@ -821,6 +916,7 @@ sap.ui.define([
 	 *   created using {@link sap.ui.model.odata.v4.ODataListBinding#create}
 	 *
 	 * @public
+	 * @see #isInactive
 	 * @since 1.43.0
 	 */
 	Context.prototype.isTransient = function () {
@@ -889,9 +985,11 @@ sap.ui.define([
 	 * @param {boolean} [bKeepCacheOnError]
 	 *   If <code>true</code>, the binding data remains unchanged if the refresh fails
 	 * @returns {sap.ui.base.SyncPromise}
-	 *   A promise resolving when all dependent bindings are refreshed; it is rejected if the
-	 *   binding's root binding is suspended and a group ID different from the binding's group ID is
-	 *   given
+	 *   A promise resolving when all dependent bindings are refreshed; it is rejected
+	 *   when the refresh fails; the promise is resolved immediately on a suspended binding
+	 * @throws {Error}
+	 *   If the binding's root binding is suspended and a group ID different from the binding's
+	 *   group ID is given
 	 *
 	 * @private
 	 */
@@ -906,7 +1004,8 @@ sap.ui.define([
 	};
 
 	/**
-	 * Replaces this context with the given other context. You probably want to delete this context
+	 * Replaces this context with the given other context "in situ", that is, at the index it
+	 * currently has in its list binding's collection. You probably want to delete this context
 	 * afterwards without requesting the new count from the server, see the
 	 * <code>bDoNotRequestCount</code> parameter of {@link #delete}.
 	 *
@@ -915,6 +1014,7 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li> this context's root binding is suspended,
 	 *     <li> this context is transient (see {@link #isTransient}),
+	 *     <li> this context is not in the collection (has no index, see {@link #getIndex}),
 	 *     <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}).
 	 *   </ul>
@@ -926,8 +1026,8 @@ sap.ui.define([
 		var oElement;
 
 		this.oBinding.checkSuspended();
-		if (this.isTransient()) {
-			throw new Error("Cannot replace a transient context: " + this);
+		if (this.iIndex === undefined || this.isTransient()) {
+			throw new Error("Cannot replace " + this);
 		}
 		if (oOtherContext.oBinding !== this.oBinding || oOtherContext.iIndex !== undefined) {
 			throw new Error("Cannot replace with " + oOtherContext);
@@ -968,12 +1068,16 @@ sap.ui.define([
 	 * Note that the function clones the result. Modify values via
 	 * {@link sap.ui.model.odata.v4.Context#setProperty}.
 	 *
+	 * The header context of a list binding only delivers <code>$count</code> (wrapped in an object
+	 * if <code>sPath</code> is "").
+	 *
 	 * If you want {@link #requestObject} to read fresh data, call {@link #refresh} first.
 	 *
 	 * @param {string} [sPath=""]
 	 *   A path relative to this context
 	 * @returns {Promise}
-	 *   A promise on the requested value
+	 *   A promise on the requested value; it is rejected if the context is a header context and the
+	 *   path is neither empty nor "$count".
 	 * @throws {Error}
 	 *   If the context's root binding is suspended
 	 *
@@ -1001,7 +1105,8 @@ sap.ui.define([
 	 *   If <code>true</code>, the values are returned in external format using UI5 types for the
 	 *   given property paths that format corresponding to the properties' EDM types and constraints
 	 * @returns {Promise}
-	 *   A promise on the requested value or values; it is rejected if a value is not primitive
+	 *   A promise on the requested value or values; it is rejected if a value is not primitive or
+	 *   if the context is a header context and a path is not "$count"
 	 * @throws {Error}
 	 *   If the context's root binding is suspended
 	 *
@@ -1360,11 +1465,29 @@ sap.ui.define([
 		this.bKeepAlive = false;
 	};
 
+	/**
+	 * Sets a new unique number for this context's generation, just like
+	 * {@link sap.ui.model.odata.v4.Context.createNewContext} does for a new context.
+	 *
+	 * @private
+	 * @see #getGeneration
+	 */
+	Context.prototype.setNewGeneration = function () {
+		iGenerationCounter += 1;
+		this.iGeneration = iGenerationCounter;
+	};
+
 	/**
 	 * Sets this context's <code>keepAlive</code> attribute. If <code>true</code> the 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.
 	 *
+	 * Normally, a context's lifecycle is managed implicitly. It is created once it is needed and
+	 * destroyed if it is not needed anymore, for example, because it is no longer part of its list
+	 * binding's collection. It is thus unsafe to keep a reference to a context instance which is
+	 * not explicitly kept alive. Once a context is not kept alive anymore, the implicit lifecycle
+	 * management again takes control and destroys the context if it is no longer needed.
+	 *
 	 * @param {boolean} bKeepAlive
 	 *   Whether to keep the context alive
 	 * @param {function} [fnOnBeforeDestroy]
@@ -1540,9 +1663,8 @@ sap.ui.define([
 		if (this.iIndex === iVIRTUAL) {
 			return SyncPromise.resolve(); // no cache access for virtual contexts
 		}
-		return this.oBinding.withCache(fnProcessor,
-			sPath[0] === "/" ? sPath : _Helper.buildPath(this.sPath, sPath),
-			bSync, bWithOrWithoutCache);
+		return this.oBinding.withCache(fnProcessor, this.oModel.resolve(sPath, this), bSync,
+			bWithOrWithoutCache);
 	};
 
 	oModule = {
@@ -1562,6 +1684,9 @@ sap.ui.define([
 		 *   A promise which is resolved with the created entity when the POST request has been
 		 *   successfully sent and the entity has been marked as non-transient; used as base for
 		 *   {@link #created}
+		 * @param {boolean} [bInactive]
+		 *   Whether this context is inactive and will only be sent to the server after the first
+		 *   property update
 		 * @returns {sap.ui.model.odata.v4.Context}
 		 *   A context for an OData V4 model
 		 * @throws {Error}
@@ -1569,8 +1694,8 @@ sap.ui.define([
 		 *
 		 * @private
 		 */
-		create : function (oModel, oBinding, sPath, iIndex, oCreatePromise) {
-			return new Context(oModel, oBinding, sPath, iIndex, oCreatePromise);
+		create : function (oModel, oBinding, sPath, iIndex, oCreatePromise, bInactive) {
+			return new Context(oModel, oBinding, sPath, iIndex, oCreatePromise, 0, bInactive);
 		},
 
 		/**