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 への更新

Java SDK for Rapid API のブランド名が openworld-java-sdk-rapid から rapid-sdk に変更されました。今回のブランド名変更はこの 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 の使用方法について詳しくは、最新の使用例を参照してください。

このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。