[INTERNAL] sap.ui.model: Adds information that subclassing of standar…

…d models is not supported PS2: Comments PBC, PKS JIRA: CPOUI5MODELS-700 Change-Id: I862c4b4072ff5ee1c03ce808f8f9211df566c740
SAP · Sep 20, 2021 · db7069f · db7069f
1 parent 6d563df
commit db7069f
Show file tree

Hide file tree

Showing 8 changed files with 21 additions and 4 deletions.
diff --git a/src/sap.ui.core/src/sap/ui/model/json/JSONModel.js b/src/sap.ui.core/src/sap/ui/model/json/JSONModel.js
@@ -35,7 +35,9 @@ sap.ui.define([
 	 * @param {boolean} [bObserve] Whether to observe the JSON data for property changes (experimental)
 	 *
 	 * @class
-	 * Model implementation for JSON format
+	 * Model implementation for the JSON format.
+	 *
+	 * This model is not prepared to be inherited from.
 	 *
 	 * @extends sap.ui.model.ClientModel
 	 *

diff --git a/src/sap.ui.core/src/sap/ui/model/message/MessageModel.js b/src/sap.ui.core/src/sap/ui/model/message/MessageModel.js
@@ -20,7 +20,9 @@ sap.ui.define(['sap/ui/model/BindingMode', 'sap/ui/model/ClientModel', 'sap/ui/m
 	 * Constructor for a new JSONModel.
 	 *
 	 * @class
-	 * Model implementation for Messages
+	 * Model implementation for Messages.
+	 *
+	 * This model is not prepared to be inherited from.
 	 *
 	 * @extends sap.ui.model.ClientModel
 	 *

diff --git a/src/sap.ui.core/src/sap/ui/model/odata/ODataMetaModel.js b/src/sap.ui.core/src/sap/ui/model/odata/ODataMetaModel.js
@@ -87,6 +87,8 @@ sap.ui.define([
 	 * as a foundation and merges V4 annotations from the existing
 	 * {@link sap.ui.model.odata.ODataAnnotations} directly into the corresponding model element.
 	 *
+	 * This model is not prepared to be inherited from.
+	 *
 	 * Also, annotations from the "http://www.sap.com/Protocols/SAPData" namespace are lifted up
 	 * from the <code>extensions</code> array and transformed from objects into simple properties
 	 * with an "sap:" prefix for their name. Note that this happens in addition, thus the

diff --git a/src/sap.ui.core/src/sap/ui/model/odata/v2/ODataModel.js b/src/sap.ui.core/src/sap/ui/model/odata/v2/ODataModel.js
@@ -194,6 +194,8 @@ sap.ui.define([
 	 * See chapter {@link topic:6c47b2b39db9404582994070ec3d57a2 OData V2 Model} for a general
 	 * introduction.
 	 *
+	 * This model is not prepared to be inherited from.
+	 *
 	 * @author SAP SE
 	 * @version ${version}
 	 *

diff --git a/src/sap.ui.core/src/sap/ui/model/odata/v4/ODataMetaModel.js b/src/sap.ui.core/src/sap/ui/model/odata/v4/ODataMetaModel.js
@@ -650,6 +650,8 @@ sap.ui.define([
 	 *
 	 *   This model is read-only.
 	 *
+	 *   This model is not prepared to be inherited from.
+	 *
 	 * @extends sap.ui.model.MetaModel
 	 * @hideconstructor
 	 * @public

diff --git a/src/sap.ui.core/src/sap/ui/model/odata/v4/ODataModel.js b/src/sap.ui.core/src/sap/ui/model/odata/v4/ODataModel.js
@@ -173,6 +173,8 @@ sap.ui.define([
 	 * @author SAP SE
 	 * @class Model implementation for OData V4.
 	 *
+	 *   This model is not prepared to be inherited from.
+	 *
 	 *   Every resource path (relative to the service root URL, no query options) according to
 	 *   "4 Resource Path" in specification "OData Version 4.0 Part 2: URL Conventions" is
 	 *   a valid data binding path within this model if a leading slash is added; for example

diff --git a/src/sap.ui.core/src/sap/ui/model/resource/ResourceModel.js b/src/sap.ui.core/src/sap/ui/model/resource/ResourceModel.js
@@ -202,7 +202,10 @@ sap.ui.define([
 	 *
 	 * @alias sap.ui.model.resource.ResourceModel
 	 * @author SAP SE
-	 * @class Model implementation for resource bundles.
+	 * @class
+	 * Model implementation for resource bundles.
+	 *
+	 * This model is not prepared to be inherited from.
 	 *
 	 * This model allows to bind control properties against translatable texts. Its data is taken
 	 * from a {@link module:sap/base/i18n/ResourceBundle} and it only supports property bindings.

diff --git a/src/sap.ui.core/src/sap/ui/model/xml/XMLModel.js b/src/sap.ui.core/src/sap/ui/model/xml/XMLModel.js
@@ -38,7 +38,9 @@ sap.ui.define([
 	 * Constructor for a new XMLModel.
 	 *
 	 * @class
-	 * Model implementation for XML format
+	 * Model implementation for the XML format.
+	 *
+	 * This model is not prepared to be inherited from.
 	 *
 	 * @extends sap.ui.model.ClientModel
 	 *