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-rapidSDK를 사용 중인 경우 다음 단계부터 시작하세요.

리브랜딩된 Java SDK로 업데이트

Rapid API용 Java SDK를 openworld-java-sdk-rapid에서 rapid-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 이상으로 업데이트합니다.
코드를 리팩터링하여 새로운 operation-based 상호작용 모델을 SDK에 적용하세요.

새로운 Rapid SDK 사용에 대한 자세한 지침은 다음을 참조하세요. 업데이트된 사용 예제 를 참조하세요.