遷移至 Rapid SDK v4.1.0 及後續版本

有哪些變更

在 Rapid SDK v4.1.0 中，我們引入了一種基於操作的 SDK 互動新範式。

在之前的版本中，互動如下：

rapidClient.operationX(requestXData, param1, param2, param3, ...,paramN);

在最新版本中，互動改為：

OperationXParams operationXParams = OperationXParams.builder()
        .param1("value1")
        .param2("value2")
        .paramN("valueN")
        .build();
OperationX operationX = new OperationX(requestXData, operationXParams);
rapidClient.execute(operationX);

備註：

operationX: 代表待執行的操作。

>> 參閱一些使用範例

舊方法已不再適用，後續版本會將其移除。

為什麼做出此項變更？

轉向採用「operation-based」互動模型，為 Rapid 的使用提供了更統一且可擴展的方法。此變更也為未來的增強功能和功能奠定基礎，確保向下相容性。

此外，新模型將互動流程簡化為單一的execute 方法，無需再使用多個 operation-specific 方法。

如何進行遷移？

如果您使用的是較舊版的openworld-java-sdk-rapid SDK，請先按照以下步驟操作。

變更品牌後的 Java SDK 更新

我們為 Rapid API 變更了 Java SDK 的品牌 (從 openworld-java-sdk-rapid 變更為 rapid-sdk)，這將影響使用它的任何應用程式。

SDK 名稱、命名空間，以及例外情況 ID 均已變更。若要使用此更新後的 SDK，您需要：

請在專案依賴項中使用套件名稱。
從新的命名空間匯入模型。
請將例外處理程序更新為新的例外類別。
調整日誌訊息的前綴。

SDK 名稱

變更品牌前：

變更品牌後的 SDK：

命名空間

變更品牌前	變更品牌後的 SDK
import `com.expediagroup.openworld.sdk.rapid.client.RapidClient`	import `com.expediagroup.sdk.rapid.client.RapidClient`
import `com.expediagroup.openworld.sdk.rapid.models.*`	`import com.expediagroup.sdk.rapid.models.*`

例外

變更品牌前	變更品牌後的 SDK
`OpenWorldException`	`ExpediaGroupException`
`OpenWorldServiceException`	`ExpediaGroupServiceException`
`OpenWorldClientException`	`ExpediaGroupClientException`

記錄訊息前置字元

變更品牌前	變更品牌後的 SDK
`ExpediaSDK`	`ExpediaGroupSDK`

如果您使用 rapid-sdk 相依性，那麼您只需要：

將 rapid-sdk 相依性更新為 4.1.0 或後續版本。
請重構您的程式碼，以便透過 SDK 採用新的「operation-based」互動模式。

>> 請參閱我們的「使用範例」頁面以了解更多資訊