From db7069fe42a9e86212d402899ebf2dae02b1262d Mon Sep 17 00:00:00 2001 From: Guenter Klatt Date: Fri, 17 Sep 2021 16:10:37 +0200 Subject: [PATCH] [INTERNAL] sap.ui.model: Adds information that subclassing of standard models is not supported PS2: Comments PBC, PKS JIRA: CPOUI5MODELS-700 Change-Id: I862c4b4072ff5ee1c03ce808f8f9211df566c740 --- src/sap.ui.core/src/sap/ui/model/json/JSONModel.js | 4 +++- src/sap.ui.core/src/sap/ui/model/message/MessageModel.js | 4 +++- src/sap.ui.core/src/sap/ui/model/odata/ODataMetaModel.js | 2 ++ src/sap.ui.core/src/sap/ui/model/odata/v2/ODataModel.js | 2 ++ src/sap.ui.core/src/sap/ui/model/odata/v4/ODataMetaModel.js | 2 ++ src/sap.ui.core/src/sap/ui/model/odata/v4/ODataModel.js | 2 ++ src/sap.ui.core/src/sap/ui/model/resource/ResourceModel.js | 5 ++++- src/sap.ui.core/src/sap/ui/model/xml/XMLModel.js | 4 +++- 8 files changed, 21 insertions(+), 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 index d6d364b1a6a8..2beffe8e327e 100644 --- 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 index 71cf6f071378..fd9ec4715d77 100644 --- 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 index 95da053305c1..1b34ce4760db 100644 --- 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 extensions 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 index 861ecfd6b393..9c3aa684bb08 100644 --- 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 index 0cb47f78a5b7..7776cec43b1f 100644 --- 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 index 3891f5c98cbb..08b3364ad189 100644 --- 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 index 8ad75d4e0782..174967b38816 100644 --- 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 index d74bb1e75623..64249890292e 100644 --- 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 *