Fazendo a transição para o SDK da Rapid v4.1.0 e posterior

O que mudou

No SDK da Rapid v4.1.0, introduzimos um novo paradigma para interação do SDK com base em operações.

Nas versões anteriores, a interação era a seguinte:

rapidClient.operationX(requestXData, param1, param2, param3, ...,paramN);

Na versão mais recente, a interação foi modificada para:

OperationXParams operationXParams = OperationXParams.builder()
        .param1("value1")
        .param2("value2")
        .paramN("valueN")
        .build();
OperationX operationX = new OperationX(requestXData, operationXParams);
rapidClient.execute(operationX);

Observações:

  • operationX: representa a operação a ser executada. Consulte Exemplos de uso para exemplos reais.
  • Os métodos antigos estão obsoletos e vão ser removidos em versões futuras.

Por que a mudança?

A transição para um modelo de interação baseado em operação com o SDK oferece uma abordagem mais uniforme e extensível para o uso da Rapid API. Essa mudança também abre caminho para melhorias e recursos futuros, garantindo compatibilidade com versões anteriores.

Além disso, o novo modelo simplifica a interação para um único método execute, eliminando a necessidade de vários métodos específicos da operação.

Como migrar?

Se você estiver usando o SDK openworld-java-sdk-rapid mais antigo, comece seguindo os passos abaixo

Atualização do SDK para Java com mudança de marca

O SDK para Java passou por uma mudança de marca para a Rapid API, sendo renomeado de openworld-java-sdk-rapid para rapid-sdk. Isso afeta todos os aplicativos que usam o SDK.

O nome do SDK, namespace e os IDs de exceções mudaram. Para usar esse SDK atualizado, você vai precisar:

  • Usar o nome do pacote nas dependências do projeto
  • Importar os modelos dos novos namespaces
  • Atualizar os manipuladores de exceção com as novas classes de exceção
  • Ajustar o prefixo de mensagens de registro

Nome do SDK

Antes da mudança de marca

SDK renomeado

Namespace

Antes da mudança de marcaSDK renomeado
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.*

Exceções

Antes da mudança de marcaSDK renomeado
OpenWorldExceptionExpediaGroupException
OpenWorldServiceExceptionExpediaGroupServiceException
OpenWorldClientExceptionExpediaGroupClientException

Prefixo da mensagem de registro

Antes da mudança de marcaSDK renomeado
ExpediaSDKExpediaGroupSDK

Se você estiver usando a dependência rapid-sdk, precisa apenas:

  1. Atualizar a sua dependência rapid-sdk para a versão 4.1.0 ou posterior.
  2. Refatorar o seu código para adotar o novo modelo de interação baseado em operação com o SDK.

Para ver instruções detalhadas sobre como usar o novo SDK da Rapid, consulte os Exemplos de uso atualizados.

Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.