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