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로 리브랜딩했으며, 이를 사용하는 모든 애플리케이션에 영향을 미칩니다.

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

• 프로젝트 종속성에서 패키지 이름을 사용합니다.
• 새 네임스페이스에서 모델을 가져옵니다.
• 새 예외 클래스로 예외 처리기를 업데이트하세요.
• 로그 메시지 접두사를 조정합니다.

SDK 이름

리브랜딩 전:

리브랜딩된 SDK:

네임스페이스

예외

로깅 메시지 접두사

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

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

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