All Products
Search
Document Center

ApsaraMQ for RocketMQ:Catatan rilis untuk SDK klien TCP untuk Java

Last Updated:Mar 12, 2026

Setiap rilis SDK klien TCP untuk Java mencantumkan tanggal, perubahan, ketersediaan wilayah, dan tautan unduhannya. Gunakan halaman ini untuk memilih versi SDK yang sesuai dengan workload Anda dan mengevaluasi peningkatan.

Kompatibilitas dan batasan

Persyaratan JDK

  • Semua versi SDK mendukung JDK 1.8.

  • JDK 1.6 hanya didukung oleh V1.8.4.Final dan versi sebelumnya. Untuk menghindari masalah kompatibilitas saat upgrade, gunakan JDK 1.8.

Batasan V2.x.x.Final

Sebelum melakukan upgrade ke V2.x.x.Final, pastikan semua kondisi berikut terpenuhi:

  • Ketersediaan wilayah: V2.x.x.Final hanya tersedia di wilayah berikut: Tiongkok (Hangzhou), Tiongkok (Qingdao), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Hohhot), Tiongkok (Shenzhen), Tiongkok (Chengdu), Tiongkok (Hong Kong), Jerman (Frankfurt), dan Indonesia (Jakarta). Jangan lakukan upgrade di wilayah lain.

  • Hanya akses VPC: V2.x.x.Final hanya terhubung ke ApsaraMQ for RocketMQ melalui Virtual Private Cloud (VPC). Jika instans Anda menggunakan jaringan klasik, jangan lakukan upgrade.

  • Namespace wajib ada: V2.x.x.Final hanya berfungsi dengan instans yang memiliki namespace. Semua instans ApsaraMQ for RocketMQ 5.x memiliki namespace secara bawaan. Untuk instans 4.x, periksa bagian Basic Information pada halaman Instance Details di Konsol ApsaraMQ for RocketMQ.

Dependensi Maven

Untuk koordinat Maven dan instruksi pengaturan, lihat Persiapkan lingkungan.


Rilis V2.x.x

Rilis-rilis ini hanya tersedia di wilayah yang tercantum untuk setiap versi. Lihat Batasan V2.x.x.Final untuk persyaratan jaringan dan namespace.

2.0.6.Final

Tanggal rilis: 2023-09-28

Perbaikan bug:

  • Memperbaiki kerentanan keamanan pada logback dan Guava.

Wilayah: Tiongkok (Hangzhou), Tiongkok (Qingdao), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Hohhot), Tiongkok (Shenzhen), Tiongkok (Chengdu), Jerman (Frankfurt), Indonesia (Jakarta)

Unduh: ons-client-2.0.6.Final

2.0.5.Final

Tanggal rilis: 2023-02-23

Fitur:

  • Menambahkan logging asinkron.

Perbaikan bug:

  • Memperbaiki masalah di mana waktu tunggu untuk konsumsi batch tidak dapat dikonfigurasi.

  • Memperbaiki berbagai kerentanan keamanan.

Wilayah: Tiongkok (Hangzhou), Tiongkok (Qingdao), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Hohhot), Tiongkok (Shenzhen), Tiongkok (Chengdu), Jerman (Frankfurt), Indonesia (Jakarta)

Unduh: ons-client-2.0.5.Final

2.0.3.Final

Tanggal rilis: 2022-08-17

Perbaikan bug:

  • Memperbaiki masalah di mana ukuran kolam thread tidak dapat melebihi 32 pada versi JDK yang lebih baru.

Wilayah: Tiongkok (Hangzhou), Tiongkok (Qingdao), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Hohhot), Tiongkok (Shenzhen), Tiongkok (Chengdu), Jerman (Frankfurt), Indonesia (Jakarta)

Unduh: ons-client-2.0.3.Final

2.0.2.Final

Tanggal rilis: 2022-06-16

Perbaikan bug:

  • Memperbaiki potensi deadlock selama pengiriman pesan.

Wilayah: Tiongkok (Chengdu), Tiongkok (Qingdao), Tiongkok (Shenzhen)

Unduh: ons-client-2.0.2.Final

2.0.1.Final

Tanggal rilis: 2021-11-29

Fitur:

  • Menambahkan data jejak pesan.

Wilayah: Tiongkok (Chengdu), Tiongkok (Qingdao), Tiongkok (Shenzhen)

Unduh: ons-client-2.0.1.Final

2.0.0.Final

Tanggal rilis: 2021-10-18

Fitur:

  • Load balancing: Beralih ke balancing tingkat pesan untuk distribusi yang lebih merata di antara konsumen.

  • Dashboard: Menambahkan metrik untuk pesan terakumulasi, durasi tingkat langkah, dan tingkat keberhasilan dari produksi hingga konsumsi.

  • Jejak pesan: Memperluas hasil permintaan jejak dengan parameter untuk pesan terjadwal, pesan tertunda, pesan transaksional, dan detail konsumsi.

  • Pesan terurut: Meningkatkan jumlah maksimum percobaan ulang menjadi 16.

  • Konsumsi broadcasting: Mengaktifkan offset konsumen kustom saat startup konsumen.

  • Mode push: Menambahkan pembatasan kecepatan konsumsi. Meningkatkan logika pemrosesan ketika jumlah thread konsumsi tidak normal.

  • Logging: Mengubah path log default. Menambahkan tingkat log. Menambahkan dukungan variabel lingkungan.

Penyempurnaan:

  • Menyempurnakan penanganan error untuk pesan transaksional.

  • Menyempurnakan penanganan error selama pembuatan client.

Perbaikan bug:

  • Memperbaiki race condition dalam updateCredential di mana panggilan yang sering menyebabkan otorisasi cross-account untuk peran Resource Access Management (RAM) melalui Security Token Service (STS) gagal. Akar penyebabnya adalah kurangnya atomicity saat memperbarui ID AccessKey, Rahasia AccessKey, dan token STS.

Untuk detail lebih lanjut, lihat Catatan rilis untuk SDK untuk Java.

Wilayah: Tiongkok (Chengdu), Tiongkok (Qingdao), Tiongkok (Shenzhen)

Unduh: ons-client-2.0.0.Final


Rilis V1.x.x

1.9.1.Final

Tanggal rilis: 2024-07-15

Perbaikan bug:

  • Memperbarui Guava ke 32.1.2-jre dan memperbaiki kerentanan keamanan CVE-2023-2976.

Unduh: ons-client-1.9.1.Final

1.9.0.Final

Tanggal rilis: 2024-04-10

Fitur:

  • Menambahkan parameter namespace untuk mengaktifkan akses Internet ke instans serverless ApsaraMQ for RocketMQ 5.0.

Unduh: ons-client-1.9.0.Final

1.8.8.8.Final

Tanggal rilis: 2023-02-06

Perbaikan bug:

  • Menambahkan opsi konfigurasi clientCloseSocketIfTimeout untuk segera menutup koneksi TCP abnormal.

Unduh: ons-client-1.8.8.8.Final

1.8.8.7.Final

Tanggal rilis: 2023-01-11

Perbaikan bug:

  • Memperbaiki masalah di mana jejak pesan hilang selama konsumsi batch.

  • Memperbaiki masalah di mana beberapa pesan gagal dikonsumsi karena waktu tunggu maksimum tidak dikonfigurasi untuk konsumsi batch.

Unduh: ons-client-1.8.8.7.Final

1.8.8.5.Final

Tanggal rilis: 2022-05-16

Perbaikan bug:

  • Memperbaiki race condition dalam updateCredential di mana panggilan yang sering menyebabkan otorisasi cross-account untuk peran RAM melalui STS gagal karena pembaruan non-atomik terhadap ID AccessKey, Rahasia AccessKey, dan token STS.

Perbaikan ini hanya berlaku untuk otorisasi peran RAM. Jika Anda memperbarui secara manual ID AccessKey, Rahasia AccessKey, dan token STS, masalah tersebut tetap terjadi.

Unduh: ons-client-1.8.8.5.Final

1.8.8.3.Final

Tanggal rilis: 2022-01-18

Perbaikan bug:

  • Memperbaiki masalah di mana pesan pada offset konsumen tertentu dilewati akibat error broker.

  • Memperbaiki satuan waktu yang salah untuk timeout konsumsi pesan.

Unduh: ons-client-1.8.8.3.Final

1.8.8.1.Final

Tanggal rilis: 2021-08-24

Perbaikan bug:

  • Memperbaiki error yang terjadi saat mencoba ulang pengiriman pesan terurut.

  • Memperbaiki masalah di mana pesan duplikat dihasilkan ketika client mencoba ulang konsumsi yang gagal dalam skenario tertentu.

Unduh: ons-client-1.8.8.1.Final

1.8.8.Final

Tanggal rilis: 2021-04-02

Penyempurnaan:

  • Mengoptimalkan logika pengiriman heartbeat.

  • Mengurangi penggunaan memori berlebihan.

Perbaikan bug:

  • Memperbaiki masalah di mana pesan dikirim kembali ke broker secara salah saat konsumen gagal.

  • Memperbaiki masalah di mana batas cache pesan per topik tidak berlaku.

Unduh: ons-client-1.8.8.Final

1.8.7.4.Final

Tanggal rilis: 2021-02-08

Perbaikan bug:

  • Memperbaiki konsumsi tertunda pada pesan terurut dalam skenario tertentu.

  • Memperbaiki masalah di mana port-port digunakan untuk deteksi liveness pada produsen pesan.

Jika Anda menggunakan V1.8.7.1.Final atau versi yang lebih baru untuk mengonsumsi pesan terurut, lakukan upgrade ke versi terbaru.

Unduh: ons-client-1.8.7.4.Final

1.8.4.Final

Tanggal rilis: 2019-09-27

Fitur:

  • Menambahkan dukungan JDK 1.6.

  • Menambahkan retry pesan untuk pengiriman asinkron.

  • Menambahkan retry pesan untuk pengiriman sinkron saat broker sibuk.

Unduh: ons-client-1.8.4.Final

1.7.8.Final

Tanggal rilis: 2018-07-06

Fitur:

  • Menambahkan perpanjangan dinamis token STS.

Penyempurnaan:

  • Mengurangi ukuran file log tunggal default dari 1 GB menjadi 64 MB.

Perbaikan bug:

  • Memperbaiki masalah di mana file log duplikat dihasilkan.

Unduh: ons-client-1.7.8.Final


Rilis sebelumnya

1.7.7.Final

Tanggal rilis: 2018-04-25

Perbaikan bug:

  • Memperbaiki masalah di mana jejak pesan tidak dapat dikirim ketika beberapa instans konsumen atau produsen diinisialisasi dalam proses yang sama. Masalah ini memengaruhi V1.7.5 dan V1.7.6. Lakukan upgrade jika Anda menggunakan salah satu versi tersebut.

Unduh: ons-client-1.7.7.Final

1.7.6.Final

Tanggal rilis: 2018-04-04

Fitur:

  • Menambahkan dukungan untuk semua framework log, termasuk Apache Log4j2.

Perbaikan bug:

  • Memperbaiki shutdown client yang tidak terduga saat mengambil name server.

  • Memperbarui Fastjson ke 1.2.48.

Unduh: ons-client-1.7.6.Final

1.7.5.Final

Tanggal rilis: 2018-03-23

Perubahan lain:

  • Beralih ke dependensi internal Alibaba Cloud.

Unduh: ons-client-1.7.5.Final

1.7.4.Final

Tanggal rilis: 2018-03-02

Fitur:

  • Menambahkan akses berbasis token STS ke ApsaraMQ for RocketMQ.

  • Menambahkan prioritas broker untuk data jejak pesan. Data jejak dikirim ke broker dalam kluster saat ini terlebih dahulu secara default.

Perbaikan bug:

  • Memperbaiki masalah ketidakcocokan JDK 1.6.

Unduh: ons-client-1.7.4.Final

1.7.2.Final

Tanggal rilis: 2018-01-25

Fitur:

  • Menambahkan enkripsi lapisan transport untuk instans Enterprise Platinum Edition. Data dienkripsi saat ID AccessKey dan Rahasia AccessKey digunakan untuk menghasilkan signature.

  • Menambahkan filtering atribut SQL untuk konsumen Enterprise Platinum Edition guna meningkatkan efisiensi langganan.

  • Menambahkan deteksi otomatis perubahan name server untuk alih bencana O&M yang mulus dan ketersediaan tinggi.

  • Menambahkan pelaporan versi client eksak ke broker saat koneksi.

Unduh: ons-client-1.7.2.Final

1.7.1.Final

Tanggal rilis: 2017-12-19

Fitur:

  • Menambahkan kolam thread callback kustom untuk pengiriman pesan asinkron.

  • Menambahkan parameter JVM -Dclient.callback.executor.thread.nums untuk mengontrol ukuran kolam thread publik. Contoh: atur nilainya ke 10.

Perbaikan bug:

  • Memperbaiki masalah di mana jumlah cache tidak dikurangi saat pesan dikirim kembali ke broker akibat timeout konsumsi.

  • Memperbaiki pelepasan dini semaphore asinkron client.

Unduh: ons-client-1.7.1.Final

1.7.0.Final

Tanggal rilis: 2017-10-23

Fitur:

  • Memperbarui kebijakan cache pesan sisi client untuk mendukung dimensi jumlah pesan dan ukuran cache.

  • Mengizinkan nilai ProducerName yang berbeda dalam modul tracing bawaan.

Perbaikan bug:

  • Memperbaiki masalah di mana thread jejak mencegah client keluar.

  • Memperbaiki pembuatan ShutdownHook untuk jejak pesan yang dibuat berulang kali.

Unduh: ons-client-1.7.0.Final

1.6.1.Final

Tanggal rilis: 2017-08-31

Penyempurnaan:

  • Menambahkan Javadoc untuk semua operasi API client.

  • Menyempurnakan resolusi alamat client sehingga modifikasi /etc/hosts tidak lagi diperlukan.

Unduh: ons-client-1.6.1.Final

1.6.0.Final

Tanggal rilis: 2017-07-31

Fitur:

  • Menyembunyikan (shade) client dalam kode sumber untuk debugging yang benar.

  • Mengekspos atribut pesan BornHost dan BornTimestamp di sisi client.

  • Menambahkan operasi BatchConsumer untuk mengonsumsi beberapa pesan sekaligus.

  • Menambahkan demo berbasis Spring untuk konsumsi batch pesan terurut dengan BatchConsumer.

Penyempurnaan:

  • Menyimpan kunci sharding dalam struktur pesan untuk pesan terurut berpartisi.

  • Menambahkan dukungan nilai integer untuk pengaturan atribut pesan.

Unduh: ons-client-1.6.0.Final


Lihat juga