Jsme rádi, že můžeme oznámit vydání GroupDocs.Conversion for Java v26.9. Toto zářijové vydání 2026 přináší kooperativní zrušení pro převod dokumentů, přidává převody mezi formáty komprimovaných proudů a poskytuje stabilní název Java modulu. Také aktualizuje inzerované páry archivních převodů, takže aplikace, které dynamicky vybírají převody, by měly před aktualizací zkontrolovat dostupné páry.
Co je nového v tomto vydání
.NET klíče níže identifikují funkce přenesené do Javy; souhrny popisují formáty podporované tímto Java vydáním.
| Klíč | Kategorie | Změna |
|---|---|---|
| CONVERSIONNET-6880 | Feature | Podpora kooperativního zrušení pomocí tokenů zrušení |
| CONVERSIONNET-7032 | Feature | Převod Bzip2, Gzip, XZ a Unix Z na LZMA |
| CONVERSIONNET-7019 | Feature | Převod LZMA na Bzip2 a Gzip |
| CONVERSIONNET-7020 | Feature | Převod Unix Z na Bzip2 a Gzip |
| CONVERSIONNET-7030 | Feature | Převod Bzip2, Gzip, LZMA a Unix Z na XZ |
| CONVERSIONNET-7029 | Feature | Převod XZ na Bzip2 a Gzip |
| CONVERSIONNET-7028 | Feature | Převod Gzip na Bzip2 |
| CONVERSIONNET-7021 | Feature | Převod Bzip2 na Gzip |
| CONVERSIONJAVA-3238 | Task | Vyřešení zjištění ověření balíčku v groupdocs-conversion-26.7.jar |
Uvolněný JAR také deklaruje Automatic-Module-Name: com.groupdocs.conversion pro aplikace používající systém Java modulů.
Změny veřejného API
Kooperativní zrušení
Dvě nové třídy, com.groupdocs.conversion.CancellationToken a com.groupdocs.conversion.CancellationTokenSource, umožňují aplikaci požádat o zastavení převodu. Všechny veřejné metody Converter.convert(...) a Converter.convertPageByPage(...) nyní mají přetížení s posledním parametrem CancellationToken. Fluent executor převodu také přidává ConversionExecutor.convert(CancellationToken).
Stávající přetížení zůstávají dostupná a používají CancellationToken.NONE, takže stávající volání převodu nevyžadují změny.
Vytvořte zdroj tokenu a předávejte jeho token převodu:
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.");
}
Zavolejte cancellationSource.cancel(), když uživatel zruší úlohu nebo aplikace rozhodne o jejím zastavení. Zrušení je kontrolováno mezi operacemi převodu: operace již běžící dokončí před tím, než je zrušení zaznamenáno. Převod pak vyvolá java.util.concurrent.CancellationException.
Výstup, který již byl zapsán, není vrácen zpět, takže aplikace by měly při zrušení úlohy ošetřit částečný výstup. Zrušený zdroj nelze resetovat; pro novou úlohu vytvořte nový zdroj. Předání null tokenu vyvolá NullPointerException.
Převody komprimovaných proudů
Verze 26.9 podporuje následující zdroje a cíle komprimovaných proudů, včetně převodu ve stejném formátu:
| Směr | Podporované formáty |
|---|---|
| Zdroj | Bzip2 (Bz2), Gzip (Gz a Gzip), LZMA (Lzma), XZ (Xz), Unix Z (Z) |
| Cíl | Bzip2, Gzip, LZMA, XZ |
Unix Z je podporován jako zdroj, ale v tomto vydání není cílem.
Pro výběr výstupního formátu použijte CompressionConvertOptions.setFormat(...). Například převod Gzip proudu na 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);
}
Kompatibilita archivních převodů
Inzerované páry archivních převodů jsou nyní omezeny na převody v rámci ZIP, 7z, TAR a CPIO. Aplikace, které se spoléhaly na dříve inzerované páry archiv‑na‑komprimovaný‑proud, by měly před aktualizací zkontrolovat dostupné převody. Formáty komprimovaných proudů uvedené výše popisují samostatnou skupinu podporovaných převodů.
Stabilní název Java modulu
Uvolněný JAR deklaruje následující položku manifestu:
Automatic-Module-Name: com.groupdocs.conversion
To poskytuje aplikacím používajícím systém Java modulů stabilní název modulu. Modulární aplikace může na něj odkazovat v module-info.java:
module example.conversion {
requires com.groupdocs.conversion;
}
Jak získat aktualizaci
Maven
Přidejte repozitář GroupDocs a závislost 26.9 do svého pom.xml, nebo aktualizujte verzi ve své existující závislosti:
<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>
Můžete také procházet Maven repozitář GroupDocs.Conversion pro Java.
Přímé stažení
Stáhněte Java balíček ze stránky GroupDocs.Conversion for Java releases.