GroupDocs.Conversion for Java 26.9 – Najważniejsze informacje o wydaniu września 2026

Z przyjemnością ogłaszamy wydanie GroupDocs.Conversion for Java v26.9. To wrześniowe wydanie 2026 wprowadza współpracujące anulowanie konwersji dokumentów, dodaje konwersje pomiędzy formatami strumieni skompresowanych oraz zapewnia stabilną nazwę modułu Java. Aktualizuje także reklamowane pary konwersji archiwów, więc aplikacje, które dynamicznie wybierają konwersje, powinny przejrzeć dostępne pary przed aktualizacją.

Co nowego w tym wydaniu

Klucz .NET poniżej identyfikuje funkcje przeniesione do Javy; podsumowania opisują formaty obsługiwane przez to wydanie Javy.

Plik JAR wydania również deklaruje Automatic-Module-Name: com.groupdocs.conversion dla aplikacji korzystających z systemu modułów Java.

Zmiany w publicznym API

Współpracujące anulowanie

Dwie nowe klasy, com.groupdocs.conversion.CancellationToken i com.groupdocs.conversion.CancellationTokenSource, pozwalają aplikacji zażądać zatrzymania konwersji. Wszystkie publiczne metody Converter.convert(...) i Converter.convertPageByPage(...) mają teraz przeciążenia z dodatkowym parametrem CancellationToken. Fluentowy wykonawca konwersji również dodaje ConversionExecutor.convert(CancellationToken).

Istniejące przeciążenia pozostają dostępne i używają CancellationToken.NONE, więc istniejące wywołania konwersji nie wymagają zmian.

Utwórz źródło tokenu i przekaż jego token do konwersji:

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

Wywołaj cancellationSource.cancel(), gdy użytkownik anuluje zadanie lub aplikacja zdecyduje je zatrzymać. Anulowanie jest sprawdzane pomiędzy operacjami konwersji: operacja już uruchomiona kończy się przed wykryciem anulowania. Następnie konwersja zgłasza java.util.concurrent.CancellationException.

Wynik już zapisany nie jest wycofywany, więc aplikacje powinny obsługiwać częściowy wynik przy anulowaniu zadania. Anulowane źródło nie może być zresetowane; utwórz nowe źródło dla nowego zadania. Przekazanie null jako tokenu powoduje NullPointerException.

Konwersje strumieni skompresowanych

Wersja 26.9 obsługuje następujące źródła i cele strumieni skompresowanych, w tym konwersję w tym samym formacie:

Unix Z jest obsługiwany jako źródło, ale nie jako cel w tym wydaniu.

Użyj CompressionConvertOptions.setFormat(...), aby wybrać format wyjściowy. Na przykład, konwertuj strumień Gzip 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);
}

Zgodność konwersji archiwów

Reklamowane pary konwersji archiwów są teraz ograniczone do konwersji w obrębie ZIP, 7z, TAR i CPIO. Aplikacje, które polegały na wcześniej reklamowanych parach archiwum-do-strumienia-skompresowanego, powinny przejrzeć dostępne konwersje przed aktualizacją. Źródła i cele strumieni skompresowanych wymienione powyżej opisują osobną grupę obsługiwanych konwersji.

Stabilna nazwa modułu Java

Plik JAR wydania deklaruje następujący wpis w manifeście:

Automatic-Module-Name: com.groupdocs.conversion

To daje aplikacjom korzystającym z systemu modułów Java stabilną nazwę modułu. Aplikacja modularna może odwoływać się do niej w module-info.java:

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

Jak uzyskać aktualizację

Maven

Dodaj repozytorium GroupDocs i zależność 26.9 do swojego pom.xml, lub zaktualizuj wersję w istniejącej zależności:

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

Możesz również przeglądać repozytorium Maven GroupDocs.Conversion for Java.

Bezpośrednie pobranie

Pobierz pakiet Java ze strony GroupDocs.Conversion for Java releases.

Zasoby

• Pełne informacje o wydaniu
• Dokumentacja
• Free Support Forum