Wij zijn blij de release van GroupDocs.Conversion for Java v26.9 aan te kondigen. Deze release van september 2026 introduceert coöperatieve annulering voor documentconversie, voegt conversies tussen gecomprimeerde‑stroomformaten toe, en biedt een stabiele Java-modulenaam. Daarnaast worden de geadverteerde archief‑conversieparen bijgewerkt, zodat applicaties die conversies dynamisch selecteren de beschikbare paren moeten bekijken vóór het upgraden.
Wat is nieuw in deze release
De .NET‑issue‑sleutels hieronder identificeren functies die naar Java zijn overgezet; de samenvattingen beschrijven de formaten die door deze Java‑release worden ondersteund.
| Sleutel | Categorie | Wijziging |
|---|---|---|
| CONVERSIONNET-6880 | Functie | Ondersteun coöperatieve annulering via annulerings‑tokens |
| CONVERSIONNET-7032 | Functie | Converteer Bzip2, Gzip, XZ en Unix Z naar LZMA |
| CONVERSIONNET-7019 | Functie | Converteer LZMA naar Bzip2 en Gzip |
| CONVERSIONNET-7020 | Functie | Converteer Unix Z naar Bzip2 en Gzip |
| CONVERSIONNET-7030 | Functie | Converteer Bzip2, Gzip, LZMA en Unix Z naar XZ |
| CONVERSIONNET-7029 | Functie | Converteer XZ naar Bzip2 en Gzip |
| CONVERSIONNET-7028 | Functie | Converteer Gzip naar Bzip2 |
| CONVERSIONNET-7021 | Functie | Converteer Bzip2 naar Gzip |
| CONVERSIONJAVA-3238 | Taak | Los pakketverificatie‑bevindingen op in groupdocs-conversion-26.7.jar |
De release‑JAR verklaart ook Automatic-Module-Name: com.groupdocs.conversion voor applicaties die het Java‑modulesysteem gebruiken.
Wijzigingen in de openbare API
Coöperatieve annulering
Twee nieuwe klassen, com.groupdocs.conversion.CancellationToken en com.groupdocs.conversion.CancellationTokenSource, stellen een applicatie in staat om te verzoeken een conversie te stoppen.
Alle openbare Converter.convert(...)‑ en Converter.convertPageByPage(...)‑methoden hebben nu overloads met een laatste CancellationToken‑parameter. De vloeiende conversie‑executor voegt ook ConversionExecutor.convert(CancellationToken) toe.
Bestaande overloads blijven beschikbaar en gebruiken CancellationToken.NONE, zodat bestaande conversie‑aanroepen geen wijzigingen nodig hebben.
Maak een token‑bron aan en geef zijn token door aan de conversie:
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.");
}
Roep cancellationSource.cancel() aan wanneer de gebruiker een taak annuleert of de applicatie besluit deze te stoppen. Annulering wordt gecontroleerd tussen conversie‑operaties: een reeds lopende operatie wordt voltooid voordat de annulering wordt opgemerkt. De conversie werpt vervolgens java.util.concurrent.CancellationException.
Reeds geschreven output wordt niet teruggedraaid, dus applicaties moeten gedeeltelijke output afhandelen bij het annuleren van een taak. Een geannuleerde bron kan niet worden gereset; maak een nieuwe bron aan voor een nieuwe taak. Het doorgeven van een null‑token veroorzaakt een NullPointerException.
Gecomprimeerde‑stroomconversies
Versie 26.9 ondersteunt de volgende gecomprimeerde‑stroombronnen en -doelen, inclusief conversie binnen hetzelfde formaat:
| Richting | Ondersteunde formaten |
|---|---|
| Bron | Bzip2 (Bz2), Gzip (Gz en Gzip), LZMA (Lzma), XZ (Xz), Unix Z (Z) |
| Doel | Bzip2, Gzip, LZMA, XZ |
Unix Z wordt ondersteund als bron, maar niet als doel in deze release.
Gebruik CompressionConvertOptions.setFormat(...) om het uitvoerformaat te selecteren. Bijvoorbeeld, converteer een Gzip‑stroom naar 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);
}
Compatibiliteit van archiefconversies
De geadverteerde archief‑conversieparen zijn nu beperkt tot conversies binnen ZIP, 7z, TAR en CPIO. Applicaties die afhankelijk waren van de eerder geadverteerde archief‑naar‑gecomprimeerde‑stroom‑paren moeten de beschikbare conversies bekijken vóór het upgraden. De hierboven genoemde gecomprimeerde‑stroom‑bron‑ en -doelformaten beschrijven een aparte groep ondersteunde conversies.
Stabiele Java‑modulenaam
De release‑JAR verklaart de volgende manifest‑vermelding:
Automatic-Module-Name: com.groupdocs.conversion
Dit geeft applicaties die het Java‑modulesysteem gebruiken een stabiele modulenaam. Een modulaire applicatie kan ernaar verwijzen in module-info.java:
module example.conversion {
requires com.groupdocs.conversion;
}
Hoe de update te verkrijgen
Maven
Voeg de GroupDocs‑repository en de 26.9‑dependency toe aan uw pom.xml, of werk de versie bij in uw bestaande dependency:
<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>
U kunt ook de GroupDocs.Conversion for Java Maven repository bekijken.
Directe download
Download het Java‑pakket van de GroupDocs.Conversion for Java releases pagina.