[Connect to OData service on Neo using SAP Cloud SDK](https://developers.sap.com/tutorials/s4sdk-odata-service-neo.html)

# Virtual Data Model

S/4HANA 系統中儲存的資料本質上結構複雜，因此很難手動查詢。因此，HANA 引入了虛擬資料模型 (VDM)，旨在從這種複雜性中抽象出來，並以語義上有意義且易於使用的方式提供資料。從 S/4HANA 系統使用資料的首選方式是透過 OData 協議。雖然出於相容性原因也支援 BAPI，但 OData 應該始終是您的首選。您可以在 SAP 的 API 業務中心找到 S/4HANA Cloud 系統的所有可用 OData 端點的列表。

SAP Cloud SDK 現在將 VDM for OData 引入 Java 世界，使 OData 端點的型別安全使用更加簡單！ VDM 是使用來自 SAP API 業務中心的資訊生成的。這意味著它與 API 業務中心提供的每個 API 相容，因此也與每個 S/4HANA Cloud 系統相容。

傳統的 OData 服務訪問方式：

讓我們來看看我們可以編寫的典型程式碼來訪問任何使用 SAP Cloud Platform SDK 進行服務開發的 OData 服務。這裡，我們從 S/4HANA 系統中檢索業務合作伙伴列表：

```java
final ErpConfigContext configContext = new ErpConfigContext();
final List<mybusinesspartnertype> businessPartners = ODataQueryBuilder
        .withEntity("/sap/opu/odata/sap/API_BUSINESS_PARTNER",
                "A_BusinessPartner")
        .select("BusinessPartner",
                "LastName",
                "FirstName",
                "IsMale",
                "IsFemale",
                "CreationDate")
        .build()
        .execute(configContext)
        .asList(MyBusinessPartnerType.class);
```

ODataQueryBuilder 代表了一種在應用程式中使用 OData 服務的簡單通用方法，非常適合支援任意服務。 從手動構建到 OData 服務的 HTTP 請求並在程式碼中處理結果，這是向前邁出的一大步，並且由 SAP Cloud SDK 在內部使用。 反過來，ODataQueryBuilder 還使用 SAP Cloud SDK 的概念來簡化與系統的通訊，這些系統由 ErpConfigContext 引用。

然而，在使用普通的 ODataQueryBuilder 方法呼叫 OData 服務時，您可能會陷入一些陷阱：

* 對於 .withEntity("/sap/opu/odata/sap/API_BUSINESS_PARTNER", "A_BusinessPartner") 您已經需要知道三件事：OData 端點服務路徑（/sap/opu/odata/sap）、端點名稱（API_BUSINESS_PARTNER ) 和端點後設資料中定義的實體集合 (A_BusinessPartner) 的名稱。

* 然後，當您想要使用 select() 函式從 BusinessPartner 實體型別中選擇特定屬性時，您需要知道這些欄位是如何命名的。但由於它們在此程式碼中僅表示為字串，因此您需要檢視後設資料以瞭解它們的呼叫方式。這同樣適用於 order() 和 filter() 等函式。當然，使用字串作為引數很容易出現拼寫錯誤，您的 IDE 很可能無法為您捕獲這些錯誤。

* 最後，您需要定義一個類，例如 MyBusinessPartnerType，其中包含表示結果的屬性及其型別的特定註釋。為此，您再次需要了解有關 OData 服務的大量詳細資訊。

# Virtual Data Model: The new way to OData

現在我們已經解釋了當前方法可能存在的缺陷，讓我們來看看 SAP Cloud SDK 的 OData VDM 如何簡化相同的任務，因為 SDK 能夠整合更多關於被呼叫系統的知識。

```java
final List<businesspartner> businessPartners =
        new DefaultBusinessPartnerService()
                .getAllBusinessPartner()
                .select(BusinessPartner.BUSINESS_PARTNER,
                        BusinessPartner.LAST_NAME,
                        BusinessPartner.FIRST_NAME,
                        BusinessPartner.IS_MALE,
                        BusinessPartner.IS_FEMALE,
                        BusinessPartner.CREATION_DATE)
                .execute();
```

使用 OData VDM，我們現在可以訪問特定 OData 服務的物件表示，在本例中為 DefaultBusinessPartnerService（BusinessPartnerService 介面的預設實現）。所以現在不再需要知道端點的服務路徑、服務名稱或實體集合名稱。我們可以呼叫該服務的 getAllBusinessPartner() 函式來從系統中檢索所有業務合作伙伴的列表。

現在看一下 select() 函式。我們可以簡單地使用 BusinessPartner 類提供的靜態欄位，而不是傳遞表示實體欄位的字串。因此，我們不僅消除了拼寫錯誤的風險，而且還使其型別安全！同樣，這同樣適用於 filter() 和 orderBy()。例如，過濾男性業務夥伴變得像 .filter(BusinessPartner.IS_MALE.eq(true)) 一樣簡單——注意型別安全的比較。

這種方法的另一個好處是可發現性。由於所有內容都表示為程式碼，因此您可以簡單地使用 IDE 的自動完成功能來檢視服務支援哪些功能以及實體包含哪些欄位：首先檢視包 com.sap.cloud.sdk 中提供的不同服務.s4hana.datamodel.odata.services，例項化你需要的服務的預設實現（類名以Default為字首），然後查 找 服務類中代表不同可用操作的方法。基於此，您可以使用返回型別的欄位來選擇要選擇的欄位和要應用的過濾器。

每個服務都由一個 Java 介面描述，例如 BusinessPartnerService。 SDK 為每個服務介面提供了一個預設的、完整的實現。相應的實現在名稱為字首為 Default 的介面名稱的類中可用，例如 DefaultBusinessPartnerService。您可以簡單地例項化該類，也可以將依賴注入與相應的 Java 框架結合使用。介面的好處是更好的測試和可擴充套件性支援。</businesspartner></mybusinesspartnertype>

使用 SAP Cloud SDK 連線 OData 服務

相關文章