Migrar da KPL 0.x para a KPL 1.x

É necessário atender aos seguintes pré-requisitos:

Adicionar dependências

Se estiver usando Maven, adicione a dependência a seguir ao arquivo pom.xml. Atualize groupid de com.amazonaws para software.amazon.kinesis e a versão 1.x.x para a versão mais recente da KPL.

<dependency>
    <groupId>software.amazon.kinesis</groupId>
    <artifactId>amazon-kinesis-producer</artifactId>
    <version>1.x.x</version> <!-- Use the latest version -->
</dependency>

Se você estiver usando Gradle, adicione o seguinte ao seu arquivo build.gradle. Substitua 1.x.x pela versão mais recente da KPL.

implementation 'software.amazon.kinesis:amazon-kinesis-producer:1.x.x'

A versão mais recente da KPL pode ser obtida no Repositório central do Maven.

Atualizar as instruções de importação para a KPL

O KPL 1.x usa o AWS SDK for Java 2.x e usa um nome de pacote atualizado que começa comsoftware.amazon.kinesis, em comparação com o nome do pacote no KPL anterior que começa com. com.amazonaws.services.kinesis

Substitua a importação de com.amazonaws.services.kinesis por software.amazon.kinesis. A tabela a seguir relaciona as importações que precisam ser substituídas.

Atualizar declarações de importação para classes de provedores AWS de credenciais

Ao migrar para o KPL 1.x, você deve atualizar pacotes e classes em suas importações no código do aplicativo KPL que são baseados no AWS SDK for Java 1.x para os correspondentes com base no 2.x. AWS SDK for Java As importações comuns na aplicação KPL são classes de provedores de credenciais. Consulte Alterações no provedor de credenciais na documentação do guia de migração AWS SDK for Java 2.x para ver a lista completa de alterações no provedor de credenciais. Aqui está a alteração comum de importação que talvez você precise fazer em suas aplicações KPL.

Importação na KPL 0.x

import com.amazonaws.auth.DefaultAWSCredentialsProviderChain;

Importação na KPL 1.x

import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;

Se você importar outros provedores de credenciais com base no AWS SDK for Java 1.x, deverá atualizá-los para os equivalentes ao AWS SDK for Java 2.x. Se você não importou nada classes/packages do AWS SDK for Java 1.x, pode ignorar essa etapa.

Atualize a configuração do provedor de credenciais na configuração da KPL

A configuração do provedor de credenciais na KPL 1.x requer os provedores de credenciais do AWS SDK for Java 2.x. Se você estiver passando provedores de credenciais para o AWS SDK for Java 1.x no KinesisProducerConfiguration substituindo o provedor de credenciais padrão, você deverá atualizá-lo com os AWS SDK for Java provedores de credenciais 2.x. Consulte Alterações no provedor de credenciais na documentação do guia de migração AWS SDK for Java 2.x para ver a lista completa de alterações no provedor de credenciais. Se não substituiu o provedor de credenciais padrão na configuração da KPL, você pode ignorar essa etapa.

Por exemplo, se você estiver substituindo o provedor de credenciais padrão da KPL com o seguinte código:

KinesisProducerConfiguration config = new KinesisProducerConfiguration();
// SDK v1 default credentials provider
config.setCredentialsProvider(new DefaultAWSCredentialsProviderChain());

É necessário atualizá-lo com o código a seguir para usar o provedor de credenciais do AWS SDK for Java 2.x:

KinesisProducerConfiguration config = new KinesisProducerConfiguration();
// New SDK v2 default credentials provider
config.setCredentialsProvider(DefaultCredentialsProvider.create());