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.