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-rapid SDKを使用している場合は、次の手順から開始してください。

ブランド名が変更された Java SDK への更新

Java SDK for Rapid API のブランド名が openworld-java-sdk-rapid から rapid-sdk に変更されました。今回のブランド名変更はこの SDK を使用するすべてのアプリケーションに影響します。

SDK名、名前空間、例外ID が変更されました。このアップデートされたSDKを使用するには、以下が必要です：

• プロジェクトの依存関係でパッケージ名を使用します。
• 新しい名前空間からモデルをインポートします。
• 新しい例外クラスで例外ハンドラを更新します。
• ログメッセージの接頭辞を調整します。

SDK の名前

ブランド名変更前 :

ブランド名変更後の SDK :

名前空間

例外

ロギングメッセージの接頭辞

rapid-sdk の依存関係を使用している場合は、次の手順のみで済みます。

1. rapid-sdk の依存関係をバージョン 4.1.0 以降に更新します。
2. SDKで新しいoperation-basedインタラクションモデルを採用するためにコードをリファクタリングしてください。

新しいRapid SDKの詳細な使用方法については、更新された 使用例を参照してください。 更新された使用例 を参照してください。