过渡到 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 方法的需求。
如何迁移?
如果您使用的是旧版 SDK,请从以下步骤开始。openworld-java-sdk-rapid
更新至重新命名的 Java SDK
我们对 Rapid API 的 Java SDK 从 openworld-java-sdk-rapid 重新命名为 rapid-sdk,这将对使用它的各个 App 产生影响。
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或更高版本。 - 重构您的代码,使其采用新的 operation-based 与 SDK 的交互模型。