@openui5/sap.ui.core 1.121.0 → 1.122.0

package/src/sap/ui/core/ws/ReadyState.js

@@ -12,7 +12,7 @@ sap.ui.define(function() {
 	/**
 	 * Defines the different ready states for a WebSocket connection.
 	 *
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 * @enum {int}
 	 * @public
 	 * @alias sap.ui.core.ws.ReadyState

package/src/sap/ui/core/ws/SapPcpWebSocket.js

@@ -21,7 +21,7 @@ sap.ui.define(['./WebSocket', "sap/base/Log"],
 	 * @class WebSocket class implementing the pcp-protocol.
 	 * @extends sap.ui.core.ws.WebSocket
 	 * @author SAP SE
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 * @alias sap.ui.core.ws.SapPcpWebSocket
 	 */
 	var SapPcpWebSocket = WebSocket.extend("sap.ui.core.ws.SapPcpWebSocket", /** @lends sap.ui.core.ws.SapPcpWebSocket.prototype */ {

package/src/sap/ui/core/ws/WebSocket.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @class Basic WebSocket class.
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 * @alias sap.ui.core.ws.WebSocket
 	 */
 	var WebSocket = EventProvider.extend("sap.ui.core.ws.WebSocket", /** @lends sap.ui.core.ws.WebSocket.prototype */ {

package/src/sap/ui/debug/ControlTree.js

@@ -34,7 +34,7 @@ sap.ui.define('sap/ui/debug/ControlTree', [
 	 * @class Control Tree used for the Debug Environment
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus, Frank Weigel
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 * @alias sap.ui.debug.ControlTree
 	 * @private
 	 */

package/src/sap/ui/debug/DebugEnv.js

@@ -37,7 +37,7 @@ sap.ui.define('sap/ui/debug/DebugEnv', [
 	 * @class Central Class for the Debug Environment
 	 *
 	 * @author Martin Schaus, Frank Weigel
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 * @private
 	 * @alias sap.ui.debug.DebugEnv
 	 * @deprecated As of Version 1.120

package/src/sap/ui/debug/PropertyList.js

@@ -32,7 +32,7 @@ sap.ui.define('sap/ui/debug/PropertyList', [
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 *
 	 * @param {sap.ui.core.Core}
 	 *            oCore Core instance of the app; version might differ!

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

@@ -27,8 +27,11 @@ sap.ui.define([
 	 * @param {sap.ui.model.Model} oModel Model instance that this binding is created for and that it belongs to
 	 * @param {string} sPath Binding path to be used for this binding, syntax depends on the concrete subclass
 	 * @param {sap.ui.model.Context} oContext Binding context relative to which a relative binding path will be resolved
-	 * @param {sap.ui.model.Sorter|sap.ui.model.Sorter[]} [aSorters] Initial sort order (can be either a sorter or an array of sorters)
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} [aFilters] Predefined filter/s (can be either a filter or an array of filters)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters] Map of optional parameters as defined by subclasses; this class does not introduce any own parameters
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in <code>aFilters</code>
@@ -320,10 +323,14 @@ sap.ui.define([
 	 * When no <code>sFilterType</code> is given, any previously configured application
 	 * filters are cleared and the given filters are used as control filters
 	 *
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} aFilters Single filter object or an array of filter objects
-	 * @param {sap.ui.model.FilterType} [sFilterType=undefined] Type of the filter which should
-	 *  be adjusted; if no type is given, then any previously configured application filters are
-	 *  cleared and the given filters are used as control filters
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.ClientModel#bindList}; a falsy value is treated as an empty array and thus removes all
+	 *   filters of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType]
+	 *   The type of the filter to replace; if no type is given, all filters previously configured with type
+	 *   {@link sap.ui.model.FilterType.Application} are cleared, and the given filters are used as filters of type
+	 *   {@link sap.ui.model.FilterType.Control}
 	 * @returns {this} returns <code>this</code> to facilitate method chaining
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in

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

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.Model
 	 *
 	 * @author SAP SE
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 *
 	 * @param {string} [oData] URL where to load the data from
 	 * @public

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

@@ -24,9 +24,12 @@ sap.ui.define([
 	 * @param {sap.ui.model.Model} oModel Model instance that this binding is created for and that it belongs to
 	 * @param {string} sPath Binding path pointing to the tree / array that should be bound; syntax is defined by subclasses
 	 * @param {sap.ui.model.Context} [oContext=null] Context object for this binding, mandatory when when a relative binding path is given
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} [aApplicationFilters=null] Predefined application filter, either a single instance or an array
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aApplicationFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters=null] Additional model specific parameters as defined by subclasses; this class does not introduce any own parameters
-	 * @param {sap.ui.model.Sorter[]} [aSorters=null] Predefined sorter/s contained in an array (optional)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in
 	 *   <code>aApplicationFilters</code> together with other filters
@@ -264,10 +267,14 @@ sap.ui.define([
 	 * results of all groups are ANDed.
 	 *
 	 * @see sap.ui.model.TreeBinding.prototype.filter
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} aFilters Single filter object or an array of filter objects
-	 * @param {sap.ui.model.FilterType} [sFilterType] Type of the filter to be adjusted; if no type
-	 *   is given, any previously configured application filters are cleared, and the given filters
-	 *   are used as control filters
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.ClientModel#bindTree}; a falsy value is treated as an empty array and thus removes all
+	 *   filters of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType]
+	 *   The type of the filter to replace; if no type is given, all filters previously configured with type
+	 *   {@link sap.ui.model.FilterType.Application} are cleared, and the given filters are used as filters of type
+	 *   {@link sap.ui.model.FilterType.Control}
 	 * @return {this} <code>this</code> to facilitate method chaining
 	 * @throws {Error} If one of the filters uses an operator that is not supported by the underlying model
 	 *   implementation or if the {@link sap.ui.model.Filter.NONE} filter instance is contained in
@@ -380,7 +387,9 @@ sap.ui.define([
 	 * The tree will be sorted level by level. So the nodes are NOT sorted absolute, but relative to
 	 * their parent node, to keep the hierarchy untouched.
 	 *
-	 * @param {sap.ui.model.Sorter[]} aSorters An array of Sorter instances which will be applied
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters to use; they replace the sorters given in {@link sap.ui.model.ClientModel#bindTree}; a falsy value
+	 *   is treated as an empty array and thus removes all sorters
 	 *
 	 * @return {this} Returns <code>this</code> to facilitate method chaining
 	 * @public

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

@@ -166,7 +166,13 @@ sap.ui.define([
 	 * @public
 	 */
 	CompositeBinding.prototype.setType = function(oType, sInternalType) {
-		var that = this;
+		const that = this;
+
+		function processPartTypes () {
+			that.oType?.processPartTypes(that.aBindings.map(function (oBinding) {
+				return oBinding.getType();
+			}));
+		}
 
 		if (oType && !(oType instanceof CompositeType)) {
 			throw new Error("Only CompositeType can be used as type for composite bindings!");
@@ -186,9 +192,10 @@ sap.ui.define([
 
 			this.bRawValues = this.oType.getUseRawValues();
 			this.bInternalValues = this.oType.getUseInternalValues();
-			this.oType.processPartTypes(this.aBindings.map(function (oBinding) {
-				return oBinding.getType();
-			}));
+			processPartTypes();
+			oType.getPartsListeningToTypeChanges().forEach((iIndex) => {
+				this.aBindings[iIndex].registerTypeChanged(processPartTypes);
+			});
 
 			if (this.bRawValues && this.bInternalValues) {
 				throw new Error(this.oType + " has both 'bUseRawValues' & 'bUseInternalValues' set to true. Only one of them is allowed to be true");

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

@@ -14,7 +14,7 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	 * @extends sap.ui.model.DataState
 	 *
 	 * @author SAP SE
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.CompositeDataState

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

@@ -39,7 +39,7 @@ sap.ui.define(['./SimpleType'],
 	 *   <code>true</code>.
 	 * @extends sap.ui.model.SimpleType
 	 * @public
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 */
 	var CompositeType = SimpleType.extend("sap.ui.model.CompositeType", /** @lends sap.ui.model.CompositeType.prototype */ {
 
@@ -122,9 +122,9 @@ sap.ui.define(['./SimpleType'],
 	 * model messages to the attached control. Prerequisite is that the corresponding binding
 	 * supports this feature, see {@link sap.ui.model.Binding#supportsIgnoreMessages}.
 	 *
-	 * @return {number[]}
+	 * @return {int[]}
 	 *   An array of indices that determine which parts of this type shall not propagate their model
-	 *   messages to the attached control
+	 *   messages to the attached control; an empty array is returned by default
 	 *
 	 * @public
 	 * @see sap.ui.model.Binding#supportsIgnoreMessages
@@ -134,6 +134,20 @@ sap.ui.define(['./SimpleType'],
 		return [];
 	};
 
+	/**
+	 * Gets the indices of the binding parts for which this type requires the binding's type for formatting
+	 * or parsing. An empty array is returned by default. Subclasses need to overwrite this function if they
+	 * are interested in type changes of the corresponding binding part.
+	 *
+	 * @returns {int[]}
+	 *   The indices of the parts with a relevant type for this composite type
+	 *
+	 * @see #processPartTypes
+	 */
+	CompositeType.prototype.getPartsListeningToTypeChanges = function () {
+		return [];
+	};
+
 	/**
 	 * Returns whether the {@link #formatValue} and {@link #parseValue} methods operate on the raw
 	 * model values instead of formatted values.

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

@@ -65,7 +65,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.DataState

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

@@ -25,10 +25,11 @@ sap.ui.define(['./Binding', './Filter', './FilterType', './Sorter', 'sap/base/ut
 	 *   Binding path for this binding; a relative path will be resolved relative to a given context
 	 * @param {sap.ui.model.Context} oContext
 	 *   Context to be used to resolve a relative path
-	 * @param {sap.ui.model.Sorter|sap.ui.model.Sorter[]} [aSorters]
-	 *   Initial sort order (can be either a sorter or an array of sorters)
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} [aFilters]
-	 *   Predefined filter/s (can be either a filter or an array of filters)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters]
 	 *   Additional, implementation-specific parameters that should be used by the new list binding;
 	 *   this base class doesn't define any parameters, check the API reference for the concrete
@@ -156,11 +157,12 @@ sap.ui.define(['./Binding', './Filter', './FilterType', './Sorter', 'sap/base/ut
 	 * Please use either the automatic grouping of filters (where applicable) or explicit
 	 * AND/OR filters, as a mixture of both is not supported.
 	 *
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} aFilters
-	 *   Single filter object or an array of filter objects
-	 * @param {sap.ui.model.FilterType} [sFilterType=undefined]
-	 *   Type of the filter which should be adjusted; if no type is given, the behavior depends on
-	 *   the model implementation
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.Model#bindList}; a falsy value is treated as an empty array and thus removes all filters
+	 *   of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType]
+	 *   The type of the filter to replace; if no type is given, the behavior depends on the model implementation
 	 * @return {this}
 	 *   Returns <code>this</code> to facilitate method chaining
 	 *
@@ -184,8 +186,9 @@ sap.ui.define(['./Binding', './Filter', './FilterType', './Sorter', 'sap/base/ut
 	 *
 	 * @function
 	 * @name sap.ui.model.ListBinding.prototype.sort
-	 * @param {sap.ui.model.Sorter|sap.ui.model.Sorter[]} aSorters
-	 *   The Sorter object or an array of sorters which defines the sort order
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters to use; they replace the sorters given in {@link sap.ui.model.Model#bindList}; a falsy value is
+	 *   treated as an empty array and thus removes all sorters
 	 * @return {this}
 	 *   Returns <code>this</code> to facilitate method chaining
 	 * @public

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.121.0
+	 * @version 1.122.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.MetaModel

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

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.message.MessageProcessor
 	 *
 	 * @author SAP SE
-	 * @version 1.121.0
+	 * @version 1.122.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.Model
@@ -627,10 +627,11 @@ sap.ui.define([
 	 *   The path pointing to the list / array that should be bound
 	 * @param {sap.ui.model.Context} [oContext]
 	 *   The context object for this databinding
-	 * @param {sap.ui.model.Sorter|sap.ui.model.Sorter[]} [aSorters]
-	 *   Initial sort order (can be either a sorter or an array of sorters)
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} [aFilters]
-	 *   Predefined filter/s (can be either a filter or an array of filters)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link sap.ui.model.ListBinding#sort} to replace them
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call
+	 *   {@link sap.ui.model.ListBinding#filter} to replace them
 	 * @param {object} [mParameters]
 	 *   Additional model-specific parameters
 	 * @throws {Error} If the {@link sap.ui.model.Filter.NONE} filter instance is contained in <code>aFilters</code>
@@ -650,12 +651,13 @@ sap.ui.define([
 	 *   The path pointing to the tree / array that should be bound
 	 * @param {sap.ui.model.Context} [oContext]
 	 *   The context object for this databinding
-	 * @param {sap.ui.model.Filter[]} [aFilters]
-	 *   Predefined filter/s contained in an array
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call
+	 *   {@link sap.ui.model.TreeBinding#filter} to replace them
 	 * @param {object} [mParameters]
 	 *   Additional model specific parameters
-	 * @param {sap.ui.model.Sorter[]} [aSorters]
-	 *   Predefined sap.ui.model.sorter/s contained in an array
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link sap.ui.model.TreeBinding#sort} to replace them
 	 * @throws {Error} If the {@link sap.ui.model.Filter.NONE} filter instance is contained in <code>aFilters</code>
 	 *   together with other filters
 	 *

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

@@ -6,14 +6,15 @@
 /*eslint-disable max-len */
 // Provides an abstract property binding.
 sap.ui.define([
-	'./Binding',
+	"./Binding",
 	"sap/ui/base/SyncPromise",
+	"sap/ui/model/ChangeReason",
 	"sap/base/Log",
 	"sap/base/assert",
-	'./SimpleType', // convenience dependency for legacy code that uses global names
-	'./DataState' // convenience dependency for legacy code that uses global names
+	"./SimpleType", // convenience dependency for legacy code that uses global names
+	"./DataState" // convenience dependency for legacy code that uses global names
 ],
-	function(Binding, SyncPromise, Log, assert) {
+	function(Binding, SyncPromise, ChangeReason, Log, assert) {
 	"use strict";
 
 	/**
@@ -337,8 +338,13 @@ sap.ui.define([
 	 * @public
 	 */
 	PropertyBinding.prototype.setType = function(oType, sInternalType) {
+		const oOldType = this.oType;
 		this.oType = oType;
 		this.sInternalType = sInternalType;
+		if (this.fnTypeChangedCallback && oType && oOldType !== oType) {
+			this.fnTypeChangedCallback();
+			this._fireChange({reason: ChangeReason.Change});
+		}
 	};
 
 	/**
@@ -388,6 +394,17 @@ sap.ui.define([
 		this.sMode = sBindingMode;
 	};
 
+	/**
+	 * Sets the callback which is called when the type of the binding is changed, if not supplied a
+	 * former callback is deregistered.
+	 *
+	 * @param {function} [fnTypeChangedCallback]
+	 *   The function to be called, if this binding's type changes
+	 */
+	PropertyBinding.prototype.registerTypeChanged = function (fnTypeChangedCallback) {
+		this.fnTypeChangedCallback = fnTypeChangedCallback;
+	};
+
 	/**
 	 * Resumes the binding update. Change events will be fired again.
 	 *

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.121.0
+	 * @version 1.122.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.121.0
+	 * @version 1.122.0
 	 */
 	var SimpleType = Type.extend("sap.ui.model.SimpleType", /** @lends sap.ui.model.SimpleType.prototype */ {
 

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.121.0
+	 * @version 1.122.0
 	 * @enum {string}
 	 * @alias sap.ui.model.TreeAutoExpandMode
 	 * @protected

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

@@ -27,12 +27,13 @@ sap.ui.define(['./Binding', './Filter', './Sorter'],
 	 *         sPath Path pointing to the tree / array that should be bound
 	 * @param {object}
 	 *         [oContext=null] Context object for this binding (optional)
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]}
-	 *         [aFilters=null] Predefined filter or an array of filters (optional)
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {string}
 	 *         [mParameters=null] Additional model specific parameters (optional)
-	 * @param {sap.ui.model.Sorter|sap.ui.model.Sorter[]}
-	 *         [aSorters=null] Predefined sorter or an array of sorters (optional)
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
 	 * @throws {Error} If the {@link sap.ui.model.Filter.NONE} filter instance is contained in
 	 *   <code>aFilters</code> together with other filters
 	 * @public
@@ -144,8 +145,12 @@ sap.ui.define(['./Binding', './Filter', './Sorter'],
 	 *
 	 * @function
 	 * @name sap.ui.model.TreeBinding.prototype.filter
-	 * @param {sap.ui.model.Filter|sap.ui.model.Filter[]} aFilters Single sap.ui.model.Filter object or an array of filter objects
-	 * @param {sap.ui.model.FilterType} sFilterType Type of the filter which should be adjusted, if it is not given, the standard behaviour applies
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters given
+	 *   in {@link sap.ui.model.Model#bindTree}; a falsy value is treated as an empty array and thus removes all filters
+	 *   of the specified type
+	 * @param {sap.ui.model.FilterType} [sFilterType]
+	 *   The type of the filter to replace; if no type is given, the behavior depends on the model implementation
 	 *
 	 * @public
 	 */
@@ -155,7 +160,9 @@ sap.ui.define(['./Binding', './Filter', './Sorter'],
 	 *
 	 * @function
 	 * @name sap.ui.model.TreeBinding.prototype.sort
-	 * @param {sap.ui.model.Sorter[]} aSorters Array of sap.ui.model.Sorter objects
+	 * @param {sap.ui.model.Sorter[]} [aSorters=[]]
+	 *   The sorters to use; they replace the sorters given in {@link sap.ui.model.Model#bindTree}; a falsy value is
+	 *   treated as an empty array and thus removes all sorters
 	 *
 	 * @public
 	 */

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.121.0
+	 * @version 1.122.0
 	 */
 	var Type = BaseObject.extend("sap.ui.model.Type", /** @lends sap.ui.model.Type.prototype */ {
 

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

@@ -232,10 +232,11 @@ sap.ui.define([
 	 *   The path pointing to the tree / array that should be bound
 	 * @param {object} [oContext=null]
 	 *   The context object for this data binding
-	 * @param {array} [aSorter=null]
-	 *   An array of predefined sorters
-	 * @param {array} [aFilters=null]
-	 *   An array of predefined filters
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorters=[]]
+	 *   The sorters used initially; call {@link #sort} to replace them
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter} to
+	 *   replace them
 	 * @param {object} [mParameters=null]
 	 *   A map containing additional binding parameters; for the <code>AnalyticalBinding</code> this
 	 *   parameter is mandatory
@@ -990,8 +991,10 @@ sap.ui.define([
 	 *
 	 * @function
 	 * @name sap.ui.model.analytics.AnalyticalBinding.prototype.filter
-	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter}
-	 *            aFilter an Array of sap.ui.model.Filter objects or a single Filter instance.
+	 * @param {sap.ui.model.Filter[]|sap.ui.model.Filter} [aFilters=[]]
+	 *   The filters to use; in case of type {@link sap.ui.model.FilterType.Application} this replaces the filters
+	 *   given in {@link sap.ui.model.odata.v2.ODataModel#bindList}; a falsy value is treated as an empty array and thus
+	 *   removes all filters of the specified type
 	 * @param {sap.ui.model.FilterType}
 	 *            [sFilterType=sap.ui.model.FilterType.Control] Type of the filter which should be adjusted.
 	 * @return {this}
@@ -1063,8 +1066,9 @@ sap.ui.define([
 	 *
 	 * @function
 	 * @name sap.ui.model.analytics.AnalyticalBinding.prototype.sort
-	 * @param {sap.ui.model.Sorter|array}
-	 *            aSorter a sorter object or an array of sorter objects which define the sort order.
+	 * @param {sap.ui.model.Sorter[]|sap.ui.model.Sorter} [aSorter=[]]
+	 *   The sorters to use; they replace the sorters given in {@link sap.ui.model.odata.v2.ODataModel#bindList}; a
+	 *   falsy value is treated as an empty array and thus removes all sorters
 	 * @return {this}
 	 *            returns <code>this</code> to facilitate method chaining.
 	 *

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

@@ -26,7 +26,7 @@ sap.ui.define(function() {
 	 * @alias sap.ui.model.analytics.BatchResponseCollector
 	 * @constructor
 	 * @public
-	 * @param {object} [mParams] optional Setup-Parameter, @see BatchResponseCollector#setup
+	 * @param {object} [mParams] optional Setup-Parameter, see {@link #setup}
 	 */
 	function BatchResponseCollector(mParams) {
 		if (mParams) {