GroupDocs.Conversion for Java 26.9 – Eylül 2026 Sürüm Öne Çıkanları

We’re happy to announce the release of GroupDocs.Conversion for Java v26.9. This September 2026 release introduces cooperative cancellation for document conversion, adds conversions between compressed‑stream formats, and provides a stable Java module name. It also updates the advertised archive conversion pairs, so applications that select conversions dynamically should review the available pairs before upgrading.

Bu sürümdeki yenilikler

.NET sorun anahtarları aşağıda Java’ya taşınan özellikleri tanımlar; özetler bu Java sürümünün desteklediği formatları açıklar.

Sürüm JAR’ı ayrıca Java modül sistemini kullanan uygulamalar için Automatic-Module-Name: com.groupdocs.conversion bildirir.

Genel API değişiklikleri

Kooperatif iptal

İki yeni sınıf, com.groupdocs.conversion.CancellationToken ve com.groupdocs.conversion.CancellationTokenSource, bir uygulamanın dönüşümün durmasını talep etmesini sağlar. Tüm genel Converter.convert(...) ve Converter.convertPageByPage(...) yöntemleri artık son bir CancellationToken parametresiyle aşırı yüklemelere sahiptir. Akıcı dönüşüm yürütücüsü ayrıca ConversionExecutor.convert(CancellationToken) ekler.

Mevcut aşırı yüklemeler kullanılabilir olmaya devam eder ve CancellationToken.NONE kullanır, bu nedenle mevcut dönüşüm çağrılarında değişiklik yapılması gerekmez.

Bir token kaynağı oluşturun ve token’ını dönüşüme geçirin:

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.");
}

Kullanıcı bir işi iptal ettiğinde veya uygulama durdurmaya karar verdiğinde cancellationSource.cancel() çağırın. İptal, dönüşüm işlemleri arasında kontrol edilir: zaten çalışan bir işlem, iptal gözlemlenmeden önce tamamlanır. Daha sonra dönüşüm java.util.concurrent.CancellationException fırlatır.

Zaten yazılmış çıktı geri alınmaz, bu nedenle uygulamalar bir işi iptal ederken kısmi çıktıyı ele almalıdır. İptal edilen bir kaynak sıfırlanamaz; yeni bir iş için yeni bir kaynak oluşturun. Null bir token geçirilmesi NullPointerException oluşturur.

Sıkıştırılmış akış dönüşümleri

Sürüm 26.9, aynı format dönüşümü dahil olmak üzere aşağıdaki sıkıştırılmış akış kaynaklarını ve hedeflerini destekler:

Unix Z bir kaynak olarak desteklenir, ancak bu sürümde hedef olarak desteklenmez.

CompressionConvertOptions.setFormat(...) kullanarak çıktı formatını seçin. Örneğin, bir Gzip akışını LZMA’ya dönüştürün:

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);
}

Arşiv dönüşüm uyumluluğu

İlan edilen arşiv dönüşüm çiftleri artık ZIP, 7z, TAR ve CPIO içinde dönüşümlerle sınırlıdır. Daha önce ilan edilen arşiv‑to‑sıkıştırılmış‑akış çiftlerine güvenen uygulamalar, yükseltmeden önce mevcut dönüşümleri gözden geçirmelidir. Yukarıda listelenen sıkıştırılmış akış kaynak ve hedef formatları ayrı bir desteklenen dönüşüm grubunu tanımlar.

Kararlı Java modül adı

Sürüm JAR’ı aşağıdaki manifest girdisini bildirir:

Automatic-Module-Name: com.groupdocs.conversion

Bu, Java modül sistemini kullanan uygulamalara kararlı bir modül adı sağlar. Modüler bir uygulama bunu module-info.java içinde şu şekilde referans alabilir:

module example.conversion {
    requires com.groupdocs.conversion;
}

Güncellemeyi nasıl alabilirsiniz

Maven

pom.xml dosyanıza GroupDocs deposunu ve 26.9 bağımlılığını ekleyin veya mevcut bağımlılığınızdaki sürümü güncelleyin:

<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>

Ayrıca GroupDocs.Conversion for Java Maven deposunu göz atabilirsiniz.

Doğrudan indirme

Java paketini GroupDocs.Conversion for Java releases sayfasından indirin.

Kaynaklar

• Full Release Notes
• Documentation
• Free Support Forum