SAP UI5 OData V4 模型的构造方式
作者:互联网
sap.ui.model.odata.v4.ODataModel 是使用 OData V4 服务的模型实现。
SAP Fiori 元素构建块 (sap.fe.macros) 必须与 SAPUI5 OData V4 模型一起使用,而不是智能控件(sap.ui.comp 库)或 sap.ui.table.AnalyticalTable(或分析表方案)。不支持 TreeTable 与 SAPUI5 OData V4 模型一起使用。
OData V4 模型主要是为 OData V4 服务设计的。 不过,也可以通过适配器使用 OData V2 服务。OData V2 和 V4 两种模型的区别,参考这个链接。
有关更多信息,请参阅:使用 OData V4 模型使用 OData V2 服务
创建 OData V4 模型实例时,需要传入一个 map
option 参数,该参数必须至少包含属性 serviceUrl 和同步模式。下面是一个例子:
sap.ui.define(["sap/ui/model/odata/v4/ODataModel"], function (ODataModel) {
var oModel = new ODataModel({
serviceUrl : "/sap/opu/odata4/IWBEP/V4_SAMPLE/default/IWBEP/V4_GW_SAMPLE_BASIC/0001/",
synchronizationMode : "None"
});
});
也可以指定自定义 query:
sap.ui.define(["sap/ui/model/odata/v4/ODataModel"], function (ODataModel) {
var oModel = new ODataModel({
serviceUrl : "/sap/opu/odata4/IWBEP/V4_SAMPLE/default/IWBEP/V4_GW_SAMPLE_BASIC/0001/?customParam=foo",
synchronizationMode : "None"
});
});
OData V4 模型允许开发人员指定是否将请求捆绑并作为批处理请求发送,以及何时发送请求。
参数 groupId 指定默认批处理组,默认为“$auto”。 可以使用参数 updateGroupId 为更新请求设置批处理组。 如果不设置此参数,将使用 groupId。
以下代码实例化了一个模型,该模型将批处理组 myAppUpdateGroup
中的所有更新请求捆绑在一起; 然后可以使用 oModel.submitBatch("myAppUpdateGroup")
发送批处理请求。
sap.ui.define(["sap/ui/model/odata/v4/ODataModel"], function (ODataModel) {
var oModel = new ODataModel({
serviceUrl : "/sap/opu/odata4/IWBEP/V4_SAMPLE/default/IWBEP/V4_GW_SAMPLE_BASIC/0001/",
synchronizationMode : "None",
updateGroupId : "myAppUpdateGroup"
});
});
也可以使用 descriptor 文件来初始化 OData V4 模型。
下面是一个例子:
"dataSources": {
"default": {
"uri": "https://services.odata.org/TripPinRESTierService/(S(id))/",
"type": "OData",
"settings": {
"odataVersion": "4.0"
}
}
}
下面是给 OData 模型设置 custom HTTP header 的方式:
"sap.ui5" : {
"models" : {
"" : {
"dataSource" : "default",
"settings" : {
"autoExpandSelect" : true,
"httpHeaders" : {
"custom" : "foo"
},
"synchronizationMode" : "None",
}
}
}
}
如果服务需要,OData V4 模型会通过“X-CSRF-Token”标头自动处理安全令牌。 为此,“X-CSRF-Token”标头以“Fetch”值开头,并将包含在每个数据请求中。 如果数据响应包含“X-CSRF-Token”标头,则该新值将被记住并从那时起使用。 如果数据请求失败,状态为 403 且“X-CSRF-Token”响应头值为“required”(不区分大小写),将获取新的安全令牌,并自动透明地重复数据请求。
使用“X-CSRF-Token”标头值“Fetch”通过服务 URL 上的 HEAD 请求获取新的安全令牌。 如果存在“X-CSRF-Token”的响应头值,则该响应值被保存到内存中以便下一次使用。
如果服务不需要“X-CSRF-Token”标头,OData V4 模型应该忽略该请求标头。
标签:OData,V4,ui,UI5,sap,ODataModel,模型 来源: https://www.cnblogs.com/sap-jerry/p/16208241.html