Wir freuen uns, die Veröffentlichung von GroupDocs.Conversion for Java v26.9 bekannt zu geben. Dieses September‑2026‑Release führt kooperative Abbruchsteuerung für die Dokumentkonvertierung ein, fügt Konvertierungen zwischen komprimierten Stream‑Formaten hinzu und stellt einen stabilen Java‑Modulnamen bereit. Außerdem werden die beworbenen Archiv‑Konvertierungspaare aktualisiert, sodass Anwendungen, die Konvertierungen dynamisch auswählen, die verfügbaren Paare vor dem Upgrade prüfen sollten.

Was ist neu in dieser Version

Die nachstehenden .NET‑Issue‑Keys identifizieren Funktionen, die nach Java portiert wurden; die Zusammenfassungen beschreiben die von diesem Java‑Release unterstützten Formate.

Schlüssel Kategorie Änderung
CONVERSIONNET-6880 Funktion Unterstützung der kooperativen Abbruchsteuerung über Abbruch‑Token
CONVERSIONNET-7032 Funktion Konvertierung von Bzip2, Gzip, XZ und Unix Z nach LZMA
CONVERSIONNET-7019 Funktion Konvertierung von LZMA nach Bzip2 und Gzip
CONVERSIONNET-7020 Funktion Konvertierung von Unix Z nach Bzip2 und Gzip
CONVERSIONNET-7030 Funktion Konvertierung von Bzip2, Gzip, LZMA und Unix Z nach XZ
CONVERSIONNET-7029 Funktion Konvertierung von XZ nach Bzip2 und Gzip
CONVERSIONNET-7028 Funktion Konvertierung von Gzip nach Bzip2
CONVERSIONNET-7021 Funktion Konvertierung von Bzip2 nach Gzip
CONVERSIONJAVA-3238 Aufgabe Behebung von Paketverifizierungsproblemen in groupdocs-conversion-26.7.jar

Das Release‑JAR deklariert außerdem Automatic-Module-Name: com.groupdocs.conversion für Anwendungen, die das Java‑Modulsystem verwenden.

Änderungen der öffentlichen API

Kooperative Abbruchsteuerung

Zwei neue Klassen, com.groupdocs.conversion.CancellationToken und com.groupdocs.conversion.CancellationTokenSource, ermöglichen es einer Anwendung, einen Abbruch einer Konvertierung anzufordern. Alle öffentlichen Methoden Converter.convert(...) und Converter.convertPageByPage(...) besitzen nun Überladungen mit einem abschließenden Parameter CancellationToken. Der fluente Konvertierungsausführer ergänzt ebenfalls ConversionExecutor.convert(CancellationToken).

Bestehende Überladungen bleiben verfügbar und verwenden CancellationToken.NONE, sodass vorhandene Konvertierungsaufrufe keine Änderungen erfordern.

Erzeugen Sie eine Token‑Quelle und übergeben Sie ihr Token an die Konvertierung:

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")) {
    // Ein Anwendung‑Abbruch‑Handler kann cancellationSource.cancel()
    // von einem anderen Thread aus aufrufen, während diese Konvertierung läuft.
    converter.convert(
        "converted.pdf",
        new PdfConvertOptions(),
        cancellationSource.getToken()
    );
} catch (CancellationException ex) {
    System.out.println("Conversion was cancelled.");
}

Rufen Sie cancellationSource.cancel() auf, wenn der Benutzer einen Auftrag abbricht oder die Anwendung entscheidet, ihn zu stoppen. Der Abbruch wird zwischen den Konvertierungsoperationen geprüft: eine bereits laufende Operation wird beendet, bevor der Abbruch wirksam wird. Die Konvertierung wirft dann java.util.concurrent.CancellationException.

Bereits geschriebene Ausgaben werden nicht zurückgerollt, daher sollten Anwendungen bei einem Abbruch mit partiellen Ausgaben umgehen. Eine abgebrochene Quelle kann nicht zurückgesetzt werden; erstellen Sie für einen neuen Auftrag eine neue Quelle. Das Übergeben eines null‑Tokens löst NullPointerException aus.

Komprimierte‑Stream‑Konvertierungen

Version 26.9 unterstützt die folgenden komprimierten Stream‑Quellen und -Ziele, einschließlich Konvertierung im selben Format:

Richtung Unterstützte Formate
Quelle Bzip2 (Bz2), Gzip (Gz und Gzip), LZMA (Lzma), XZ (Xz), Unix Z (Z)
Ziel Bzip2, Gzip, LZMA, XZ

Unix Z wird als Quelle unterstützt, ist jedoch in diesem Release kein Ziel.

Verwenden Sie CompressionConvertOptions.setFormat(...), um das Ausgabeformat auszuwählen. Beispiel: Konvertieren eines Gzip‑Streams nach 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);
}

Kompatibilität von Archivkonvertierungen

Die beworbenen Archiv‑Konvertierungspaare sind nun auf Konvertierungen innerhalb von ZIP, 7z, TAR und CPIO beschränkt. Anwendungen, die zuvor auf die beworbenen Archiv‑zu‑komprimierter‑Stream‑Paare gesetzt haben, sollten die verfügbaren Konvertierungen vor dem Upgrade prüfen. Die oben aufgeführten komprimierten Stream‑Quellen‑ und Ziel‑Formate beschreiben eine separate Gruppe unterstützter Konvertierungen.

Stabiler Java‑Modulname

Das Release‑JAR enthält den folgenden Manifest‑Eintrag:

Automatic-Module-Name: com.groupdocs.conversion

Damit erhalten Anwendungen, die das Java‑Modulsystem nutzen, einen stabilen Modulnamen. Eine modulare Anwendung kann darauf in module-info.java verweisen:

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

So erhalten Sie das Update

Maven

Fügen Sie das GroupDocs‑Repository und die 26.9‑Abhängigkeit zu Ihrer pom.xml hinzu oder aktualisieren Sie die Versionsnummer in Ihrer bestehenden Abhängigkeit:

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

Sie können auch das GroupDocs.Conversion for Java Maven repository durchsuchen.

Direkter Download

Laden Sie das Java‑Paket von der Seite GroupDocs.Conversion for Java releases herunter.

Ressourcen