Kami dengan senang hati mengumumkan rilis GroupDocs.Conversion for Java v26.9. Rilis September 2026 ini memperkenalkan pembatalan kooperatif untuk konversi dokumen, menambahkan konversi antar format aliran terkompresi, dan menyediakan nama modul Java yang stabil. Rilis ini juga memperbarui pasangan konversi arsip yang diiklankan, sehingga aplikasi yang memilih konversi secara dinamis harus meninjau pasangan yang tersedia sebelum memperbarui.
Apa yang baru di rilis ini
Kunci masalah .NET di bawah ini mengidentifikasi fitur yang dipindahkan ke Java; ringkasannya menjelaskan format yang didukung oleh rilis Java ini.
| Kunci | Kategori | Perubahan |
|---|---|---|
| CONVERSIONNET-6880 | Fitur | Mendukung pembatalan kooperatif melalui token pembatalan |
| CONVERSIONNET-7032 | Fitur | Mengonversi Bzip2, Gzip, XZ, dan Unix Z ke LZMA |
| CONVERSIONNET-7019 | Fitur | Mengonversi LZMA ke Bzip2 dan Gzip |
| CONVERSIONNET-7020 | Fitur | Mengonversi Unix Z ke Bzip2 dan Gzip |
| CONVERSIONNET-7030 | Fitur | Mengonversi Bzip2, Gzip, LZMA, dan Unix Z ke XZ |
| CONVERSIONNET-7029 | Fitur | Mengonversi XZ ke Bzip2 dan Gzip |
| CONVERSIONNET-7028 | Fitur | Mengonversi Gzip ke Bzip2 |
| CONVERSIONNET-7021 | Fitur | Mengonversi Bzip2 ke Gzip |
| CONVERSIONJAVA-3238 | Tugas | Menyelesaikan temuan verifikasi paket di groupdocs-conversion-26.7.jar |
JAR rilis ini juga mendeklarasikan Automatic-Module-Name: com.groupdocs.conversion untuk aplikasi yang menggunakan sistem modul Java.
Perubahan API Publik
Pembatalan kooperatif
Dua kelas baru, com.groupdocs.conversion.CancellationToken dan com.groupdocs.conversion.CancellationTokenSource, memungkinkan aplikasi meminta agar konversi dihentikan. Semua metode publik Converter.convert(...) dan Converter.convertPageByPage(...) kini memiliki overload dengan parameter CancellationToken akhir. Eksekutor konversi yang fluida juga menambahkan ConversionExecutor.convert(CancellationToken).
Overload yang ada tetap tersedia dan menggunakan CancellationToken.NONE, sehingga panggilan konversi yang ada tidak memerlukan perubahan.
Buat sumber token dan berikan tokennya ke konversi:
import com.groupdocs.conversion.CancellationTokenSource;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.util.concurrent.CancellationException;
CancellationTokenSource cancellationSource = new CancellationTokenSource();
try (Converter converter = new Converter("input.docx")) {
// An application cancellation handler can call cancellationSource.cancel()
// from another thread while this conversion runs.
converter.convert(
"converted.pdf",
new PdfConvertOptions(),
cancellationSource.getToken()
);
} catch (CancellationException ex) {
System.out.println("Conversion was cancelled.");
}
Panggil cancellationSource.cancel() ketika pengguna membatalkan pekerjaan atau aplikasi memutuskan untuk menghentikannya. Pembatalan diperiksa antara operasi konversi: operasi yang sudah berjalan selesai sebelum pembatalan terdeteksi. Konversi kemudian melempar java.util.concurrent.CancellationException.
Output yang sudah ditulis tidak dibatalkan, sehingga aplikasi harus menangani output parsial saat membatalkan pekerjaan. Sumber yang dibatalkan tidak dapat direset; buat sumber baru untuk pekerjaan baru. Mengirimkan token null akan memunculkan NullPointerException.
Konversi aliran terkompresi
Versi 26.9 mendukung sumber dan target aliran terkompresi berikut, termasuk konversi dengan format yang sama:
| Arah | Format yang didukung |
|---|---|
| Sumber | Bzip2 (Bz2), Gzip (Gz dan Gzip), LZMA (Lzma), XZ (Xz), Unix Z (Z) |
| Target | Bzip2, Gzip, LZMA, XZ |
Unix Z didukung sebagai sumber, tetapi tidak sebagai target dalam rilis ini.
Gunakan CompressionConvertOptions.setFormat(...) untuk memilih format output. Misalnya, mengonversi aliran Gzip ke LZMA:
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.CompressionFileType;
import com.groupdocs.conversion.options.convert.CompressionConvertOptions;
CompressionConvertOptions options = new CompressionConvertOptions();
options.setFormat(CompressionFileType.Lzma);
try (Converter converter = new Converter("input.gz")) {
converter.convert("converted.lzma", options);
}
Kompatibilitas konversi arsip
Pasangan konversi arsip yang diiklankan kini dibatasi pada konversi di dalam ZIP, 7z, TAR, dan CPIO. Aplikasi yang bergantung pada pasangan arsip-ke-aliran terkompresi yang sebelumnya diiklankan harus meninjau konversi yang tersedia sebelum memperbarui. Format sumber dan target aliran terkompresi yang tercantum di atas menggambarkan kelompok konversi yang didukung terpisah.
Nama modul Java yang stabil
JAR rilis ini mendeklarasikan entri manifest berikut:
Automatic-Module-Name: com.groupdocs.conversion
Ini memberikan aplikasi yang menggunakan sistem modul Java nama modul yang stabil. Aplikasi modular dapat merujuknya di module-info.java:
module example.conversion {
requires com.groupdocs.conversion;
}
Cara mendapatkan pembaruan
Maven
Tambahkan repositori GroupDocs dan dependensi 26.9 ke pom.xml Anda, atau perbarui versi dalam dependensi yang ada:
<repositories>
<repository>
<id>groupdocs-artifacts-repository</id>
<url>https://repository.groupdocs.com/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>26.9</version>
</dependency>
</dependencies>
Anda juga dapat menelusuri repositori Maven GroupDocs.Conversion untuk Java.
Unduhan langsung
Unduh paket Java dari halaman rilis GroupDocs.Conversion untuk Java .