Release notes for the Enterprise TCP client SDK for Java - ApsaraMQ for RocketMQ: Central de Documentação do Alibaba Cloud

Esta página lista cada versão do SDK de cliente TCP para Java com data, alterações, disponibilidade regional e link para baixe. Selecione a versão adequada do SDK para sua carga de trabalho e avalie atualizações.

Compatibilidade e restrições

Requisitos de JDK

Todas as versões do SDK são compatíveis com o JDK 1.8.
O JDK 1.6 tem suporte apenas na V1.8.4.Final e anteriores. Para evitar problemas de compatibilidade durante atualizações, use o JDK 1.8.

Restrições da V2.x.x.Final

Antes de atualizar para a V2.x.x.Final, confirme se todas as condições a seguir são atendidas:

Disponibilidade por região: A V2.x.x.Final está disponível apenas nas seguintes regiões: China (Hangzhou), China (Qingdao), China (Pequim), China (Zhangjiakou), China (Hohhot), China (Shenzhen), China (Chengdu), China (Hong Kong), Alemanha (Frankfurt) e Indonésia (Jacarta). Não atualize em outras regiões.
Acesso exclusivo via VPC: A V2.x.x.Final conecta-se ao ApsaraMQ for RocketMQ somente por meio de Virtual Private Clouds (VPCs). Caso sua instância utilize a rede clássica, não atualize.
Namespace obrigatório: A V2.x.x.Final funciona apenas com instâncias que possuem namespaces. Todas as instâncias do ApsaraMQ for RocketMQ 5.x incluem namespaces por padrão. Para uma instância 4.x, verifique a seção Basic Information na página Instance Details no console do ApsaraMQ for RocketMQ.

Dependência Maven

Para obter as coordenadas Maven e instruções de configuração, consulte Preparar o ambiente.

Versões V2.x.x

Estas versões estão disponíveis apenas nas regiões listadas para cada release. Consulte as restrições da V2.x.x.Final para requisitos de rede e namespace.

2.0.6.Final

Data de lançamento: 28/09/2023

Correções de bugs:

Correção de vulnerabilidades de segurança no logback e Guava.

Regiões: China (Hangzhou), China (Qingdao), China (Pequim), China (Zhangjiakou), China (Hohhot), China (Shenzhen), China (Chengdu), Alemanha (Frankfurt), Indonésia (Jacarta)

Baixe: ons-client-2.0.6.Final

2.0.5.Final

Data de lançamento: 23/02/2023

Recursos:

Adição de registro de logs assíncrono.

Correções de bugs:

Correção de um problema que impedia a configuração do tempo de espera para consumo em lote.
Correção de diversas vulnerabilidades de segurança.

Regiões: China (Hangzhou), China (Qingdao), China (Pequim), China (Zhangjiakou), China (Hohhot), China (Shenzhen), China (Chengdu), Alemanha (Frankfurt), Indonésia (Jacarta)

Baixe: ons-client-2.0.5.Final

2.0.3.Final

Data de lançamento: 17/08/2022

Correções de bugs:

Correção de um problema que limitava o tamanho do pool de threads a 32 em versões mais recentes do JDK.

Regiões: China (Hangzhou), China (Qingdao), China (Pequim), China (Zhangjiakou), China (Hohhot), China (Shenzhen), China (Chengdu), Alemanha (Frankfurt), Indonésia (Jacarta)

Baixe: ons-client-2.0.3.Final

2.0.2.Final

Data de lançamento: 16/06/2022

Correções de bugs:

Eliminação de um potencial deadlock durante o envio de mensagens.

Regiões: China (Chengdu), China (Qingdao), China (Shenzhen)

Baixe: ons-client-2.0.2.Final

2.0.1.Final

Data de lançamento: 29/11/2021

Recursos:

Inclusão de dados de rastreamento de mensagens.

Regiões: China (Chengdu), China (Qingdao), China (Shenzhen)

Baixe: ons-client-2.0.1.Final

2.0.0.Final

Data de lançamento: 18/10/2021

Recursos:

Balanceamento de carga: Adoção de balanceamento no nível de mensagem para distribuição mais uniforme entre os consumidores.
Painel: Novas métricas para mensagens acumuladas, duração por etapa e taxa de sucesso desde a produção até o consumo.
Rastreamento de mensagens: Expansão dos resultados de consulta de rastreamento com parâmetros para mensagens agendadas, atrasadas, transacionais e detalhes de consumo.
Mensagens ordenadas: Aumento da contagem máxima de tentativas para 16.
Consumo por broadcast: Habilitação de offsets personalizados na inicialização do consumidor.
Modo push: Adição de controle de fluxo de consumo. Aprimoramento da lógica de processamento quando a contagem de threads de consumo estiver anormal.
Logs: Alteração do caminho padrão de logs. Inclusão de níveis de log e suporte a variáveis de ambiente.

Melhorias:

Aprimoramento do tratamento de erros para mensagens transacionais.
Aprimoramento do tratamento de erros durante a criação do cliente.

Correções de bugs:

Correção de uma condição de corrida em updateCredential em que chamadas frequentes causavam falha na autorização entre contas para funções do Resource Access Management (RAM) via Security Token Service (STS). A causa raiz era a falta de atomicidade ao atualizar o AccessKey ID, o AccessKey secret e o token STS.

Para mais detalhes, consulte Notas de versão do SDK para Java .

Regiões: China (Chengdu), China (Qingdao), China (Shenzhen)

Baixe: ons-client-2.0.0.Final

Versões V1.x.x

1.9.1.Final

Data de lançamento: 15/07/2024

Correções de bugs:

Atualização do Guava para 32.1.2-jre e correção da vulnerabilidade de segurança CVE-2023-2976.

Baixe: ons-client-1.9.1.Final

1.9.0.Final

Data de lançamento: 10/04/2024

Recursos:

Adição do parâmetro namespace para permitir acesso via Internet a instâncias serverless do ApsaraMQ for RocketMQ 5.0.

Baixe: ons-client-1.9.0.Final

1.8.8.8.Final

Data de lançamento: 06/02/2023

Correções de bugs:

Inclusão da opção de configuração clientCloseSocketIfTimeout para fechar rapidamente conexões TCP anômalas.

Baixe: ons-client-1.8.8.8.Final

1.8.8.7.Final

Data de lançamento: 11/01/2023

Correções de bugs:

Correção da perda de rastreamentos de mensagens durante o consumo em lote.
Correção de falha no consumo de algumas mensagens devido à ausência de configuração do tempo máximo de espera para consumo em lote.

Baixe: ons-client-1.8.8.7.Final

1.8.8.5.Final

Data de lançamento: 16/05/2022

Correções de bugs:

Correção de uma condição de corrida em updateCredential em que chamadas frequentes causavam falha na autorização entre contas para funções RAM via STS, devido a atualizações não atômicas do AccessKey ID, AccessKey secret e token STS.

Esta correção aplica-se apenas à autorização por função RAM. Se você atualizar manualmente o AccessKey ID, o AccessKey secret e o token STS, o problema ainda ocorrerá.

Baixe: ons-client-1.8.8.5.Final

1.8.8.3.Final

Data de lançamento: 18/01/2022

Correções de bugs:

Correção de um problema em que a mensagem em um offset específico do consumidor era ignorada devido a erros no broker.
Ajuste da unidade de tempo incorreta para o timeout de consumo de mensagens.

Baixe: ons-client-1.8.8.3.Final

1.8.8.1.Final

Data de lançamento: 24/08/2021

Correções de bugs:

Correção de um erro que ocorria ao tentar reenviar mensagens ordenadas.
Correção da geração de mensagens duplicadas quando o cliente tentava novamente um consumo com falha em determinados cenários.

Baixe: ons-client-1.8.8.1.Final

1.8.8.Final

Data de lançamento: 02/04/2021

Melhorias:

Otimização da lógica de envio de heartbeat.
Redução do uso excessivo de memória.

Correções de bugs:

Correção de um problema em que mensagens eram devolvidas incorretamente ao broker após falha no consumidor.
Correção de uma falha em que o limite de cache de mensagens por tópico não entrava em vigor.

Baixe: ons-client-1.8.8.Final

1.8.7.4.Final

Data de lançamento: 08/02/2021

Correções de bugs:

Correção do consumo atrasado de mensagens ordenadas em certos cenários.
Correção de um problema de ocupação de portas para detecção de atividade em produtores de mensagens.

Se você utiliza a V1.8.7.1.Final ou posterior para consumir mensagens ordenadas, atualize para a versão mais recente.

Baixe: ons-client-1.8.7.4.Final

1.8.4.Final

Data de lançamento: 27/09/2019

Recursos:

Adição de suporte ao JDK 1.6.
Adição de tentativa de envio para mensagens assíncronas.
Adição de tentativa automática de reenvio síncrono quando os brokers estiverem ocupados.

Baixe: ons-client-1.8.4.Final

1.7.8.Final

Data de lançamento: 06/07/2018

Recursos:

Implementação de renovação dinâmica de tokens STS.

Melhorias:

Redução do tamanho padrão do arquivo de log individual de 1 GB para 64 MB.

Correções de bugs:

Correção da geração de arquivos de log duplicados.

Baixe: ons-client-1.7.8.Final

Versões anteriores

1.7.7.Final

Data de lançamento: 25/04/2018

Correções de bugs:

Correção de um problema que impedia o envio de rastreamentos de mensagens quando múltiplas instâncias de consumidor ou produtor eram inicializadas no mesmo processo. Isso afetava as versões V1.7.5 e V1.7.6. Atualize caso utilize alguma dessas versões.

Baixe: ons-client-1.7.7.Final

1.7.6.Final

Data de lançamento: 04/04/2018

Recursos:

Extensão do suporte a todos os frameworks de log, incluindo Apache Log4j2.

Correções de bugs:

Correção de encerramento inesperado do cliente ao buscar name servers.
Atualização do Fastjson para 1.2.48.

Baixe: ons-client-1.7.6.Final

1.7.5.Final

Data de lançamento: 23/03/2018

Outras alterações:

Migração para dependências internas da Alibaba Cloud.

Baixe: ons-client-1.7.5.Final

1.7.4.Final

Data de lançamento: 02/03/2018

Recursos:

Habilitação de acesso ao ApsaraMQ for RocketMQ via token STS.
Adição de prioridade de broker para dados de rastreamento de mensagens. Por padrão, os dados de rastreamento são enviados primeiro aos brokers do cluster atual.

Correções de bugs:

Correção de um problema de incompatibilidade com JDK 1.6.

Baixe: ons-client-1.7.4.Final

1.7.2.Final

Data de lançamento: 25/01/2018

Recursos:

Adição de criptografia na camada de transporte para instâncias Enterprise Platinum Edition. Os dados são criptografados quando o AccessKey ID e o AccessKey secret são usados para gerar uma assinatura.
Disponibilização de filtragem de atributos SQL para consumidores Enterprise Platinum Edition, visando melhorar a eficiência da assinatura.
Adição de detecção automática de alterações nos name servers para transições de O&M transparentes e alta disponibilidade.
Envio de relatório exato da versão do cliente ao broker durante a conexão.

Baixe: ons-client-1.7.2.Final

1.7.1.Final

Data de lançamento: 19/12/2017

Recursos:

Adição de pool de threads de callback personalizado para envio assíncrono de mensagens.
Adição do parâmetro JVM -Dclient.callback.executor.thread.nums para controlar o tamanho do pool de threads público. Exemplo: defina o valor como 10.

Correções de bugs:

Correção de um problema em que a contagem de cache não era decrementada quando uma mensagem era devolvida ao broker devido a timeout de consumo.
Correção da liberação prematura do semáforo assíncrono do cliente.

Baixe: ons-client-1.7.1.Final

1.7.0.Final

Data de lançamento: 23/10/2017

Recursos:

Atualização da política de cache de mensagens no lado do cliente para suportar dimensões de contagem de mensagens e tamanho de cache.
Permissão de diferentes valores de ProducerName no módulo de rastreamento integrado.

Correções de bugs:

Correção de um problema em que a thread de rastreamento impedia o encerramento do cliente.
Correção da criação múltipla do ShutdownHook para rastreamento de mensagens.

Baixe: ons-client-1.7.0.Final

1.6.1.Final

Data de lançamento: 31/08/2017

Melhorias:

Adição de Javadoc para todas as operações da API do cliente.
Aprimoramento da resolução de endereços do cliente, eliminando a necessidade de modificações em /etc/hosts.

Baixe: ons-client-1.6.1.Final

1.6.0.Final

Data de lançamento: 31/07/2017

Recursos:

Cliente sombreado (shaded) no código-fonte para depuração correta.
Exposição dos atributos de mensagem BornHost e BornTimestamp no cliente.
Adição da operação BatchConsumer para consumir múltiplas mensagens simultaneamente.
Inclusão de demo baseado em Spring para consumo em lote de mensagens ordenadas com BatchConsumer.

Melhorias:

Armazenamento da chave de fragmentação na estrutura da mensagem para mensagens parcialmente ordenadas.
Adição de suporte a valores inteiros para configurações de atributos de mensagem.

Baixe: ons-client-1.6.0.Final

Veja também

Preparar o ambiente