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: 실행할 작업을 나타냅니다. 실제 예를 보려면 사용 예를 참조해 주세요.
  • 이전 메서드는 더 이상 사용되지 않으며 향후 버전에서 제거될 예정입니다.

변경해야 하는 이유

SDK를 사용한 작업 기반 상호 작용 모델로 전환하면 Rapid API 사용을 위한 보다 균일하고 확장 가능한 접근 방식이 제공됩니다. 이러한 변경은 향후 개선 사항과 기능을 위한 기반을 마련하여 이전 버전과의 호환성을 보장합니다.

또한 새로운 모델은 단일 execute 메서드로 상호 작용을 단순화하여 여러 작업 관련 메서드가 필요하지 않습니다.

마이그레이션하는 방법

이전 openworld-java-sdk-rapid SDK를 사용하는 경우 다음 단계부터 시작해 주세요.

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

Rapid API용 Java SDK를 openworld-java-sdk-rapid에서 rapid-sdk로 리브랜딩했으며, 이를 사용하는 모든 애플리케이션에 영향을 미칩니다.

SDK 이름, 네임스페이스, 예외 ID가 변경되었습니다. 이 업데이트된 SDK를 사용하려면 다음을 수행해야 합니다.

  • 프로젝트 종속성에 패키지 이름 사용
  • 새 네임스페이스에서 모델 가져오기
  • 새로운 예외 클래스로 예외 처리기 업데이트
  • 로그 메시지 접두사 조정

SDK 이름

리브랜딩 전

리브랜딩된 SDK

네임스페이스

리브랜딩 전리브랜딩된 SDK
import com.expediagroup.openworld.sdk.rapid.client.RapidClientimport com.expediagroup.sdk.rapid.client.RapidClient
import com.expediagroup.openworld.sdk.rapid.models*import com.expediagroup.sdk.rapid.models*

예외

리브랜딩 전리브랜딩된 SDK
OpenWorldExceptionExpediaGroupException
OpenWorldServiceExceptionExpediaGroupServiceException
OpenWorldClientExceptionExpediaGroupClientException

로깅 메시지 접두사

리브랜딩 전리브랜딩된 SDK
ExpediaSDKExpediaGroupSDK

rapid-sdk 종속성을 사용하는 경우 다음만 수행하면 됩니다.

  1. rapid-sdk 종속성을 버전 4.1.0 이상으로 업데이트합니다.
  2. 코드를 리팩터링하여 SDK를 사용한 새로운 작업 기반 상호 작용 모델을 채택합니다.

새로운 Rapid SDK 사용에 대한 자세한 지침은 업데이트된 사용 예를 참조해 주세요.

이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 만드는 데 도움을 주셔서 감사합니다!