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

Java SDK for Rapid API のブランド名が openworld-java-sdk-rapid から rapid-sdk に変更されました。今回のブランド名変更はこの 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」のインタラクションモデルに対応できるよう、コードをリファクタリングしてください。

>> 詳細については、「使用例」ページをご覧ください