我們可以在 SAP UI5 應用裡使用如下的程式碼來建立一個 OData 模型例項：

```javascript
this.oVocabularyModel = new ODataModel("/sap/opu/odata/SAP/vocabulary_srv/");
```

這裡傳入一個 OData 服務的 url 作為 `ODataModel` 建構函式的輸入引數。

ODataModel 的依賴，透過如下程式碼引入：`sap/ui/model/odata/v2/ODataModel`

![](https://img-blog.csdnimg.cn/img_convert/e207573dff0d370672260645a86247fe.png)

這個建構函式的引數如下：

```javascript
new sap.ui.model.odata.v2.ODataModel(vServiceUrl, mParameters?)
```

- vServiceUrl：用於請求資料的服務的基本 URI； 此處附加的其他 URL 引數將附加到每個請求中。 如果傳遞一個物件，它將被解釋為引數物件（第二個引數）。 那麼 mParameters.serviceUrl 就變成了強制引數。

- mParameters：可選引數，是一個鍵值對。可以包含下列屬性：

(1) annotation：應從中載入註釋後設資料的 URL（或 URL 陣列）

(2) bindableResponseHeaders：設定此陣列以透過實體的 `__metadata/headers` 屬性使自定義響應標頭可繫結

(3) canonicalRequests：

模型是否嘗試計算規範 URL 以請求資料。

例如： 應用程式以具有絕對繫結路徑 `/SalesOrderSet("1")` 的表單顯示銷售訂單的詳細資訊。該表單為具有相對繫結路徑 ToLineItems 的銷售訂單行專案嵌入了一個表。如果使用者選擇了一個銷售訂單行專案（例如專案“10”），則該銷售訂單行專案的詳細資訊以另一種形式顯示，該表單還包含一個銷售訂單行專案計劃表，其中包含相對繫結路徑 ToSchedules。

如果 canonicalRequests 引數的預設值為 false，則 OData 模型將透過以下請求請求銷售訂單行專案的詳細資訊表單的資料：

- `GET /<serviceurl>/SalesOrderSet("1")/ToLineItems(SalesOrderID="1",ItemPosition="10")`
 
- `GET /<serviceurl>/SalesOrderSet("1")/ToLineItems(SalesOrderID="1",ItemPosition="10")/ToSchedules`

一些後端實現不支援資源 URL 中的多個導航屬性。在這種情況下，請將 canonicalRequests 引數設定為 true。然後，OData 模型將長資源 URL 轉換為規範 URL，並使用以下請求請求銷售訂單行專案的詳細資訊表單的資料：

- `GET /<serviceurl>/SalesOrderLineItemsSet(SalesOrderID="1",ItemPosition="10")`
 
- `GET /<serviceurl>/SalesOrderLineItemsSet(SalesOrderID="1",ItemPosition="10")/ToSchedules`</serviceurl></serviceurl></serviceurl></serviceurl>

淺談 SAP UI5 OData 模型建構函式的輸入引數

相關文章