移轉到 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:表示要執行的操作。請參閱使用範例以了解實際範例。
  • 舊方法已不再適用,後續版本會將其移除。

為何要進行變更?

移轉到 SDK 操作型互動模型後,Rapid API 即可使用更統一且可擴充的方法。 此變更也為未來的增強功能和功能奠定基礎,確保向下相容性。

此外,新模型還將互動簡化為單一 execute 方法,因此無需使用多種操作專屬的方法。

如何移轉?

如果您使用的是較舊的 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.RapidClientimport com.expediagroup.sdk.rapid.client.RapidClient
import com.expediagroup.openworld.sdk.rapid.models.*import com.expediagroup.sdk.rapid.models.*

例外

變更品牌前變更品牌後的 SDK
OpenWorldExceptionExpediaGroupException
OpenWorldServiceExceptionExpediaGroupServiceException
OpenWorldClientExceptionExpediaGroupClientException

記錄訊息前置字元

變更品牌前變更品牌後的 SDK
ExpediaSDKExpediaGroupSDK

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

  1. rapid-sdk 相依性更新為 4.1.0 或後續版本。
  2. 重構程式碼以採用新版 SDK 操作型互動模型。

如需新版 Rapid SDK 的使用詳細說明,請參閱更新版使用範例

這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!