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-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 이상으로 업데이트합니다.
SDK를 사용하여 새로운 ‘ operation-based ’ 상호작용 모델을 적용하도록 코드를 리팩토링하십시오.

>> 사용 예시 페이지에서 자세히 알아보기