关于saprfc:SAP-UI5-OData-V4-模型的构造方式

13次阅读

共计 2002 个字符，预计需要花费 6 分钟才能阅读完成。

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 模型应该疏忽该申请标头。

正文完