Release notes for the Enterprise TCP client SDK for Java - ApsaraMQ for RocketMQ

Cette page répertorie chaque version du SDK client TCP pour Java, avec sa date de publication, les modifications apportées, la disponibilité par région et le lien de téléchargement. Utilisez-la pour choisir la version de SDK adaptée à votre charge de travail et évaluer les mises à niveau.

Compatibilité et restrictions

Prérequis JDK

Toutes les versions du SDK prennent en charge JDK 1.8.
JDK 1.6 est pris en charge uniquement par la version V1.8.4.Final et les versions antérieures. Pour éviter les problèmes de compatibilité lors des mises à niveau, utilisez JDK 1.8.

Restrictions de la version V2.x.x.Final

Avant de passer à la version V2.x.x.Final, vérifiez que toutes les conditions suivantes sont remplies :

Disponibilité régionale : la version V2.x.x.Final est disponible uniquement dans les régions suivantes : Chine (Hangzhou), Chine (Qingdao), Chine (Pékin), Chine (Zhangjiakou), Chine (Hohhot), Chine (Shenzhen), Chine (Chengdu), Chine (Hong Kong), Allemagne (Francfort) et Indonésie (Jakarta). N'effectuez pas de mise à niveau dans d'autres régions.
Accès via VPC uniquement : la version V2.x.x.Final se connecte à ApsaraMQ for RocketMQ exclusivement via des Virtual Private Clouds (VPC). Si votre instance utilise le réseau classique, n'effectuez pas de mise à niveau.
Namespace obligatoire : la version V2.x.x.Final fonctionne uniquement avec des instances disposant de namespaces. Toutes les instances ApsaraMQ for RocketMQ 5.x intègrent des namespaces par défaut. Pour une instance 4.x, consultez la section Basic Information sur la page Instance Details de la console ApsaraMQ for RocketMQ.

Dépendance Maven

Pour les coordonnées Maven et les instructions de configuration, consultez Préparer l'environnement.

Versions V2.x.x

Ces versions sont disponibles uniquement dans les régions indiquées pour chaque version. Consultez les restrictions de la version V2.x.x.Final pour connaître les exigences relatives au réseau et aux namespaces.

2.0.6.Final

Date de publication : 2023-09-28

Corrections de bugs :

Correction de vulnérabilités de sécurité dans logback et Guava.

Régions : Chine (Hangzhou), Chine (Qingdao), Chine (Pékin), Chine (Zhangjiakou), Chine (Hohhot), Chine (Shenzhen), Chine (Chengdu), Allemagne (Francfort), Indonésie (Jakarta)

Téléchargement : ons-client-2.0.6.Final

2.0.5.Final

Date de publication : 2023-02-23

Fonctionnalités :

Ajout de la journalisation asynchrone.

Corrections de bugs :

Correction d'un problème empêchant la configuration du temps d'attente pour la consommation par lots.
Correction de diverses vulnérabilités de sécurité.

Régions : Chine (Hangzhou), Chine (Qingdao), Chine (Pékin), Chine (Zhangjiakou), Chine (Hohhot), Chine (Shenzhen), Chine (Chengdu), Allemagne (Francfort), Indonésie (Jakarta)

Téléchargement : ons-client-2.0.5.Final

2.0.3.Final

Date de publication : 2022-08-17

Corrections de bugs :

Correction d'un problème limitant la taille du pool de threads à 32 sur les versions récentes de JDK.

Régions : Chine (Hangzhou), Chine (Qingdao), Chine (Pékin), Chine (Zhangjiakou), Chine (Hohhot), Chine (Shenzhen), Chine (Chengdu), Allemagne (Francfort), Indonésie (Jakarta)

Téléchargement : ons-client-2.0.3.Final

2.0.2.Final

Date de publication : 2022-06-16

Corrections de bugs :

Correction d'un risque d'interblocage (deadlock) lors de l'envoi de messages.

Régions : Chine (Chengdu), Chine (Qingdao), Chine (Shenzhen)

Téléchargement : ons-client-2.0.2.Final

2.0.1.Final

Date de publication : 2021-11-29

Fonctionnalités :

Ajout des données de traçabilité des messages.

Régions : Chine (Chengdu), Chine (Qingdao), Chine (Shenzhen)

Téléchargement : ons-client-2.0.1.Final

2.0.0.Final

Date de publication : 2021-10-18

Fonctionnalités :

Équilibrage de charge : passage à un équilibrage au niveau des messages pour une répartition plus homogène entre les consommateurs.
Tableau de bord : ajout de métriques concernant les messages accumulés, la durée par étape et le taux de réussite, de la production à la consommation.
Traçabilité des messages : enrichissement des résultats de requête de traçabilité avec des paramètres pour les messages planifiés, les messages différés, les messages transactionnels et les détails de consommation.
Messages ordonnés : augmentation du nombre maximal de tentatives à 16.
Consommation en mode broadcast : activation des offsets de consommateur personnalisés au démarrage du consommateur.
Mode push : ajout d'une limitation du débit de consommation. Amélioration de la logique de traitement lorsque le nombre de threads de consommation est anormal.
Journalisation : modification du chemin de journal par défaut. Ajout de niveaux de journalisation. Prise en charge des variables d'environnement.

Améliorations :

Amélioration de la gestion des erreurs pour les messages transactionnels.
Amélioration de la gestion des erreurs lors de la création du client.

Corrections de bugs :

Correction d'une condition de course dans updateCredential où des appels fréquents entraînaient l'échec de l'autorisation inter-comptes pour les rôles RAM via STS. La cause racine était l'absence d'atomicité lors de la mise à jour de l'AccessKey ID, de l'AccessKey secret et du jeton STS.

Pour plus de détails, consultez les Notes de version du SDK pour Java .

Régions : Chine (Chengdu), Chine (Qingdao), Chine (Shenzhen)

Téléchargement : ons-client-2.0.0.Final

Versions V1.x.x

1.9.1.Final

Date de publication : 2024-07-15

Corrections de bugs :

Mise à jour de Guava vers la version 32.1.2-jre et correction de la vulnérabilité de sécurité CVE-2023-2976.

Téléchargement : ons-client-1.9.1.Final

1.9.0.Final

Date de publication : 2024-04-10

Fonctionnalités :

Ajout du paramètre namespace pour permettre l'accès Internet aux instances serverless ApsaraMQ for RocketMQ 5.0.

Téléchargement : ons-client-1.9.0.Final

1.8.8.8.Final

Date de publication : 2023-02-06

Corrections de bugs :

Ajout de l'option de configuration clientCloseSocketIfTimeout pour fermer rapidement les connexions TCP anormales.

Téléchargement : ons-client-1.8.8.8.Final

1.8.8.7.Final

Date de publication : 2023-01-11

Corrections de bugs :

Correction d'un problème de perte de traces de messages lors de la consommation par lots.
Correction d'un problème empêchant la consommation de certains messages en raison de l'absence de configuration du temps d'attente maximal pour la consommation par lots.

Téléchargement : ons-client-1.8.8.7.Final

1.8.8.5.Final

Date de publication : 2022-05-16

Corrections de bugs :

Correction d'une condition de course dans updateCredential où des appels fréquents entraînaient l'échec de l'autorisation inter-comptes pour les rôles RAM via STS en raison de mises à jour non atomiques de l'AccessKey ID, de l'AccessKey secret et du jeton STS.

Cette correction s'applique uniquement à l'autorisation via les rôles RAM. Si vous mettez manuellement à jour l'AccessKey ID, l'AccessKey secret et le jeton STS, le problème persiste.

Téléchargement : ons-client-1.8.8.5.Final

1.8.8.3.Final

Date de publication : 2022-01-18

Corrections de bugs :

Correction d'un problème où le message à un offset de consommateur spécifique était ignoré en raison d'erreurs du broker.
Correction d'une unité de temps incorrecte pour le délai d'expiration de la consommation des messages.

Téléchargement : ons-client-1.8.8.3.Final

1.8.8.1.Final

Date de publication : 2021-08-24

Corrections de bugs :

Correction d'une erreur survenant lors de la nouvelle tentative d'envoi de messages ordonnés.
Correction d'un problème générant des messages en double lorsque le client retentait une consommation ayant échoué dans certains scénarios.

Téléchargement : ons-client-1.8.8.1.Final

1.8.8.Final

Date de publication : 2021-04-02

Améliorations :

Optimisation de la logique d'envoi des signaux heartbeat.
Réduction de l'utilisation excessive de la mémoire.

Corrections de bugs :

Correction d'un problème où les messages étaient incorrectement renvoyés au broker en cas d'échec du consommateur.
Correction d'un problème où la limite de cache de messages par topic ne prenait pas effet.

Téléchargement : ons-client-1.8.8.Final

1.8.7.4.Final

Date de publication : 2021-02-08

Corrections de bugs :

Correction de la consommation différée des messages ordonnés dans certains scénarios.
Correction d'un problème où les ports étaient occupés pour la détection de vivacité sur les producteurs de messages.

Si vous utilisez la version V1.8.7.1.Final ou ultérieure pour consommer des messages ordonnés, effectuez la mise à niveau vers la dernière version.

Téléchargement : ons-client-1.8.7.4.Final

1.8.4.Final

Date de publication : 2019-09-27

Fonctionnalités :

Prise en charge de JDK 1.6.
Ajout de la nouvelle tentative d'envoi pour les envois asynchrones.
Ajout de la nouvelle tentative d'envoi pour les envois synchrones lorsque les brokers sont saturés.

Téléchargement : ons-client-1.8.4.Final

1.7.8.Final

Date de publication : 2018-07-06

Fonctionnalités :

Ajout du renouvellement dynamique des jetons STS.

Améliorations :

Réduction de la taille par défaut d'un fichier de journal unique, passant de 1 Go à 64 Mo.

Corrections de bugs :

Correction d'un problème générant des fichiers de journal en double.

Téléchargement : ons-client-1.7.8.Final

Versions antérieures

1.7.7.Final

Date de publication : 2018-04-25

Corrections de bugs :

Correction d'un problème empêchant l'envoi des traces de messages lorsque plusieurs instances de consommateur ou de producteur étaient initialisées dans le même processus. Ce problème affectait les versions V1.7.5 et V1.7.6. Effectuez la mise à niveau si vous utilisez l'une de ces versions.

Téléchargement : ons-client-1.7.7.Final

1.7.6.Final

Date de publication : 2018-04-04

Fonctionnalités :

Prise en charge de tous les frameworks de journalisation, y compris Apache Log4j2.

Corrections de bugs :

Correction d'un arrêt inattendu du client lors de la récupération des name servers.
Mise à jour de Fastjson vers la version 1.2.48.

Téléchargement : ons-client-1.7.6.Final

1.7.5.Final

Date de publication : 2018-03-23

Autres modifications :

Bascule vers les dépendances internes Alibaba Cloud.

Téléchargement : ons-client-1.7.5.Final

1.7.4.Final

Date de publication : 2018-03-02

Fonctionnalités :

Ajout de l'accès à ApsaraMQ for RocketMQ basé sur les jetons STS.
Ajout d'une priorité de broker pour les données de traçabilité des messages. Par défaut, les données de trace sont envoyées en priorité aux brokers du cluster actuel.

Corrections de bugs :

Correction d'un problème d'incompatibilité avec JDK 1.6.

Téléchargement : ons-client-1.7.4.Final

1.7.2.Final

Date de publication : 2018-01-25

Fonctionnalités :

Ajout du chiffrement de la couche de transport pour les instances Enterprise Platinum Edition. Les données sont chiffrées lorsque l'AccessKey ID et l'AccessKey secret sont utilisés pour générer une signature.
Ajout du filtrage des attributs SQL pour les consommateurs Enterprise Platinum Edition afin d'améliorer l'efficacité de l'abonnement.
Ajout de la détection automatique des changements de name server pour des basculements O&M transparents et une haute disponibilité.
Ajout du reporting exact de la version du client au broker lors de la connexion.

Téléchargement : ons-client-1.7.2.Final

1.7.1.Final

Date de publication : 2017-12-19

Fonctionnalités :

Ajout d'un pool de threads de rappel personnalisé pour l'envoi asynchrone de messages.
Ajout du paramètre JVM -Dclient.callback.executor.thread.nums pour contrôler la taille du pool de threads public. Exemple : définissez la valeur sur 10.

Corrections de bugs :

Correction d'un problème où le compteur de cache n'était pas décrémenté lorsqu'un message était renvoyé au broker en raison d'un délai d'expiration de la consommation.
Correction d'une libération prématurée du sémaphore asynchrone du client.

Téléchargement : ons-client-1.7.1.Final

1.7.0.Final

Date de publication : 2017-10-23

Fonctionnalités :

Mise à jour de la politique de cache des messages côté client pour prendre en charge à la fois le nombre de messages et la dimension de taille du cache.
Autorisation de différentes valeurs ProducerName dans le module de traçabilité intégré.

Corrections de bugs :

Correction d'un problème où le thread de traçabilité empêchait le client de se terminer.
Correction du ShutdownHook pour les traces de messages qui était créé plusieurs fois.

Téléchargement : ons-client-1.7.0.Final

1.6.1.Final

Date de publication : 2017-08-31

Améliorations :

Ajout de la documentation Javadoc pour toutes les opérations de l'API client.
Amélioration de la résolution d'adresse du client afin que les modifications du fichier /etc/hosts ne soient plus nécessaires.

Téléchargement : ons-client-1.6.1.Final

1.6.0.Final

Date de publication : 2017-07-31

Fonctionnalités :

Masquage du client dans le code source pour un débogage correct.
Exposition des attributs de message BornHost et BornTimestamp sur le client.
Ajout de l'opération BatchConsumer pour consommer plusieurs messages à la fois.
Ajout d'une démonstration basée sur Spring pour la consommation par lots de messages ordonnés avec BatchConsumer.

Améliorations :

Stockage de la clé de sharding dans la structure du message pour les messages partiellement ordonnés.
Ajout de la prise en charge des valeurs entières pour les paramètres d'attributs de message.

Téléchargement : ons-client-1.6.0.Final

Voir aussi

Préparer l'environnement