Transição para o Rapid SDK v4.1.0 e posterior

O que mudou

No Rapid SDK 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. Veja Exemplos de uso para exemplos do mundo real.
• Os métodos antigos estão obsoletos e vão ser removidos em versões futuras.

Qual o motivo dessa mudança?

A transição para um modelo de interação baseado em operação oferece uma abordagem mais uniforme e extensível para uso rápido. 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 de operação.

Como migrar?

Se você estiver usando o SDK openworld-java-sdk-rapid mais antigo, comece com as seguintes etapas.

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, o namespace e os IDs de exceções foram alterados. Para usar este SDK atualizado, você precisará:

• Use o nome do pacote nas dependências do projeto.
• Importe os modelos dos novos namespaces.
• Atualize os manipuladores de exceção com as novas classes de exceção.
• Ajuste o prefixo das mensagens de log.

Nome do SDK

Antes da mudança de marca:

SDK renomeado:

Namespace

Exceções

Prefixo da mensagem de registro

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. Refatore seu código para adotar o novo modelo de interação baseado em operação com o SDK.

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