文档

版本说明

更新时间:
一键部署

本文介绍Java SDK的版本信息,包含使用限制、下载链接、发布时间、更新点等,以便您按需获取适用的Java SDK收发消息。

使用限制

  • JDK 1.8适用于所有Java ons-client版本,JDK 1.6仅支持ons-client v1.8.4.Final及之前的版本使用。为避免升级SDK版本时出现JDK兼容性问题,建议您下载JDK 1.8版本。

  • 目前仅华东1(杭州)、华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华南1(深圳)、西南1(成都)、中国香港、德国(法兰克福)和印度尼西亚(雅加达)地域支持将客户端升级为2.x.x.Final版本,其他地域请勿将SDK升级到Java SDK 2.x.x Final版本,否则将无法访问云消息队列 RocketMQ 版服务。

  • Java SDK 2.x.x.Final仅支持通过VPC网络访问云消息队列 RocketMQ 版,不支持经典网络访问。

    若您使用存量云消息队列 RocketMQ 版实例并通过经典网络访问,请勿将Java SDK升级到V2.x.x.Final版本,否则将无法访问云消息队列 RocketMQ 版实例。

  • Java SDK 2.x.x.Final仅支持有命名空间的实例,若您使用的实例无命名空间,请勿将客户端版本升级到Java SDK 2.x.x.Final。

    5.x版本实例默认都有命名空间,4.x版本实例可在云消息队列 RocketMQ 版控制台实例详情页面的基础信息区域查看是否有命名空间。

  • 获取Maven依赖,请参见准备环境

2.0.6.Final

发布时间

发布内容

使用范围

下载

2023-09-28

问题修复

logback和guava的安全漏洞。

目前仅华东1(杭州)、华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华南1(深圳)、西南1(成都)、德国(法兰克福)和印度尼西亚(雅加达)地域支持该版本SDK,其他地域待开放。

ons-client-2.0.6.Final

2.0.5.Final

发布时间

发布内容

使用范围

下载

2023-02-23

功能优化

  • 日志增加异步支持。

问题修复

  • 修复批量消费等待时间无法指定的问题。

  • 修复部分安全漏洞。

目前仅华东1(杭州)、华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华南1(深圳)、西南1(成都)、德国(法兰克福)和印度尼西亚(雅加达)地域支持该版本SDK,其他地域待开放。

ons-client-2.0.5.Final

2.0.3.Final

发布时间

发布内容

使用范围

下载

2022-08-17

问题修复

  • 修复高版本JDK中,消费线程池无法调节至32个线程以上的问题。

目前仅华东1(杭州)、华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华南1(深圳)、西南1(成都)、德国(法兰克福)和印度尼西亚(雅加达)地域支持该版本SDK,其他地域待开放。

ons-client-2.0.3.Final

2.0.2.Final

发布时间

发布内容

使用范围

下载

2022-06-16

问题修复

  • 修复消息发送时,有小概率触发死锁的问题。

目前仅如下地域支持该版本SDK,其他地域待开放。

  • 西南1(成都)

  • 华北1(青岛)

  • 华南1(深圳)

ons-client-2.0.2.Final

2.0.1.Final

发布时间

发布内容

使用范围

下载

2021-11-29

功能优化

  • 补充消息轨迹数据。

目前仅如下地域支持该版本SDK,其他地域待开放。

  • 西南1(成都)

  • 华北1(青岛)

  • 华南1(深圳)

ons-client-2.0.1.Final

2.0.0.Final

发布时间

发布内容

使用范围

下载

2021-10-18

功能优化

  • 负载均衡:以消息为粒度进行负载,负载更加均衡。

  • 仪表盘:新增消息堆积、消息各环节耗时、成功率等相关指标。

  • 消息轨迹:新增定时和延时、事务消息及消费环节相关轨迹参数。

  • 顺序消息:最大重试次数变更为16次。

  • 事务消息:优化事务消息异常场景处理逻辑。

  • 广播消费:支持定制消费者启动时的消费位点。

  • Push消费:支持消费速度限流;消费线程数异常场景逻辑优化。

  • 日志配置:日志默认路径变更;增加日志级别;增加对环境变量的支持。

  • 客户端创建:异常场景逻辑优化。

问题修复

  • 修复RAM角色实现跨云账号STS授权场景下,updateCredential方法调用频率较高时,三元组(AccessKey ID、AccessKey Secret和STS Token)更新不具备原子性而导致的鉴权失败问题。

说明

具体变更内容,请参见Java SDK版本说明

目前仅如下地域支持该版本SDK,其他地域待开放。

  • 西南1(成都)

  • 华北1(青岛)

  • 华南1(深圳)

ons-client-2.0.0.Final

1.9.1.Final

发布时间

发布内容

下载

2024-07-15

问题修复

升级Guava版本至32.1.2-jre,修复安全漏洞CVE-2023-2976。

ons-client-1.9.1.Final

重要

本次安全漏洞修复升级了Guava版本,为避免出现JDK兼容性问题,建议JDK使用1.8及以上版本。详情请参考Guava版本ReleaseNote

1.9.0.Final

发布时间

发布内容

下载

2024-04-10

新特性

增加namespace参数,支持5.0 Serverless版实例公网访问。

ons-client-1.9.0.Final

1.8.8.8.Final

发布时间

发布内容

下载

2023-02-06

问题修复

增加可修改配置项clientCloseSocketIfTimeout,可用于快速关闭异常的TCP连接。

ons-client-1.8.8.8.Final

1.8.8.7.Final

发布时间

发布内容

下载

2023-01-11

问题修复

  • 修复批量消费时消息轨迹丢失的问题。

  • 修复批量消费未设置最大等待时间从而导致部分消息消费失败的问题。

ons-client-1.8.8.7.Final

1.8.8.5.Final

发布时间

发布内容

下载

2022-05-16

问题修复

  • 修复RAM角色实现跨云账号STS授权场景下,updateCredential方法调用频率较高时,三元组(AccessKey ID、AccessKey Secret和STS Token)更新不具备原子性而导致的鉴权失败问题。

说明

本次修复只针对使用RAM角色授权的场景,若您自己更新三元组,还会出现该问题。

ons-client-1.8.8.5.Final

1.8.8.3.Final

发布时间

发布内容

下载

2022-01-18

功能优化

  • 修复服务端异常导致消费位点跳过的问题。

  • 修复客户端消费超时时间单位错误的问题。

ons-client-1.8.8.3.Final

1.8.8.1.Final

发布时间

发布内容

下载

2021-08-24

功能优化

  • 修复顺序消息重试问题。

  • 优化特殊场景下客户端发送重试消息分裂出多条重复消息的问题。

ons-client-1.8.8.1.Final

1.8.8.Final

发布时间

发布内容

下载

2021-04-02

功能优化

  • 优化了心跳发送逻辑。

  • 修复了SDK占用内存过多的问题。

  • 修复了消息消费失败发回(sendMessageBack)的问题。

  • 修复了客户端Topic级别消息缓存限制未生效的问题。

ons-client-1.8.8.Final

1.8.7.4.Final

发布时间

发布内容

下载

2021-02-08

功能优化

  • 修复了特殊场景下顺序消息消费延迟的问题。

  • 修复了消息发送端探活导致的端口占用问题。

ons-client-1.8.7.4.Final

说明

若您使用1.8.7.1.Final及之后版本的Java SDK消费顺序消息,建议您将SDK客户端升级到最新版本。

1.8.4.Final

发布时间

发布内容

下载

2019-09-27

新特性

  • 支持1.6 JDK。

  • 支持异步发送重试。

  • 支持同步发送brokerbusy重试。

ons-client-1.8.4.Final

1.7.8.Final

发布时间

发布内容

下载

2018-07-06

新特性

  • 支持动态更新STS Token。

问题修复

  • 修复日志默认大小为1 GB的问题,修改后的日志默认大小为64 MB。

  • 修复日志打印双份的问题。

ons-client-1.7.8.Final

更多历史版本

1.7.7.Final

发布时间

发布内容

下载

2018-04-25

问题修复

  • 同一个进程内初始化多个Consumer或Producer实例的情况下,消息轨迹发送失败的问题,该问题在1.7.5.Final和1.7.6.Final版本中存在,建议进行升级。

ons-client-1.7.7.Final

1.7.6.Final

发布时间

发布内容

下载

2018-04-04

新特性

  • 客户端兼容任意日志框架。

问题修复

  • 修复log4j2的支持问题。

  • 修复client fetchNameserver shutdown问题。

  • 升级Fastjson至1.2.48版本。

ons-client-1.7.6.Final

1.7.5.Final

发布时间

发布内容

下载

2018-03-23

问题修复

  • 修复引入了阿里巴巴内部依赖的问题。

ons-client-1.7.5.Final

1.7.4.Final

发布时间

发布内容

下载

2018-03-02

新特性

  • 支持STS Token接入。

  • 轨迹消息发送区分优先级,默认优先发送至本集群Broker。

问题修复

  • 修复JDK 1.6兼容问题。

ons-client-1.7.4.Final

1.7.2.Final

发布时间

发布内容

下载

2018-01-25

新特性

  • 企业铂金版支持传输层加密配置,在AccessKeyId和AccessKeySecret签名链路上进行传输层加密,将具有更高的安全性。

  • 企业铂金版支持消费端SQL属性过滤功能,加强消息订阅的效率。

  • 客户端自动感知NameSrv的变化,方便进行运维切换,客户端将具有更高的可用性。

  • 客户端连接时向服务端上报精确的版本信息。

ons-client-1.7.2.Final

1.7.1.Final

发布时间

发布内容

下载

2017-12-19

新特性

  • 异步发送接口,用户可配置自定义回调线程池。

  • 异步发送接口,新增JVM -D参数,用于控制公共线程池的线程数量:Dclient.callback.executor.thread.nums=10。

问题修复

  • 修复客户端消息消费超时SendBack时未扣除缓存计数。

  • 修复客户端异步信号量过早释放问题。

ons-client-1.7.1.Final

1.7.0.Final

发布时间

发布内容

下载

2017-10-23

新特性

  • 调整客户端消息缓存策略,考虑消息条数与缓存大小两个维度。

功能优化

  • 优化客户端内置轨迹模块的ProducerName,不同的用户使用不同的值。

问题修复

  • 修复客户端Trace线程阻止客户端正常退出的问题。

  • 修复消息轨迹ShutDownHook可能重复创建的问题。

ons-client-1.7.0.Final

1.6.1.Final

发布时间

发布内容

下载

2017-08-31

功能优化

  • 为所有的客户端API添加了详细的Javadoc。

  • 优化获取客户端地址的方式,不依赖/etc/hosts中的hostname配置。

ons-client-1.6.1.Final

1.6.0.Final

发布时间

发布内容

下载

2017-07-31

新特性

  • 客户端在源码级别进行Shade,保证Debug的正确性。

  • 客户端暴露BornHost、BornTimestamp消息属性。

  • 新增BatchConsumer接口,允许用户以批量的方式消费消息。

  • 新增顺序消息、BatchConsumer与Spring集成的Demo。

功能优化

  • 针对分区有序消息,将Sharding Key放入到消息结构中。

  • 消息属性设置支持Int型的Value值。

ons-client-1.6.0.Final

后续步骤

准备环境