全部產品
Search

搜尋本產品

    ApsaraMQ for RocketMQ：版本說明

    文件中心

    ApsaraMQ for RocketMQ：版本說明

    更新時間：Feb 09, 2025

    本文介紹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

    後續步驟

    準備環境