过渡到 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
:代表要执行的操作。请参阅使用示例了解真实示例。- 旧方法已弃用,将在未来版本中删除。
为何作此改变?
向基于操作的交互模型的转变为快速使用提供了更加统一和可扩展的方法。这一改变也为未来的增强功能和特性铺平了道路,确保了向后兼容性。
此外,新模型将交互简化为单个 execute
方法,从而无需多个特定于操作的方法。
如何迁移?
如果您使用的是较旧的 openworld-java-sdk-rapid
SDK,请按照以下步骤开始。
更新至重新命名的 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
或更高版本。 - 重构您的代码以采用新的基于操作的 SDK 交互模型。
有关使用新 Rapid SDK 的详细说明,请参阅 更新的使用示例。