過渡到 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：表示要執行的操作。請參閱使用範例中的 real-world 範例。
舊方法已不再適用，後續版本會將其移除。

為什麼做出此項變更？

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

此外，新模型將交互作用簡化為單一 execute方法，從而無需多個 operation-specific 方法。

如何遷移？

如果您使用的是較舊的 openworld-java-sdk-rapidSDK，請按照以下步驟開始。

變更品牌後的 Java SDK 更新

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

SDK 名稱、命名空間和異常 ID 已變更。要使用此更新的 SDK，您需要：

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

SDK 名稱

變更品牌前：

變更品牌後的 SDK：

命名空間

變更品牌前	變更品牌後的 SDK
進口 `com.expediagroup.openworld.sdk.rapid.client.RapidClient`	進口 `com.expediagroup.sdk.rapid.client.RapidClient`
進口 `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 互動模型。

有關使用新 Rapid SDK 的詳細說明，請參閱更新的使用範例。