GroupDocs.Conversion for Java 26.9 – 2026年9月 リリースハイライト

私たちは GroupDocs.Conversion for Java v26.9 のリリースをお知らせできることを嬉しく思います。この2026年9月のリリースでは、ドキュメント変換の協調キャンセルを導入し、圧縮ストリーム形式間の変換を追加し、安定した Java モジュール名を提供します。また、アーカイブ変換ペアの広告を更新したため、動的に変換を選択するアプリケーションはアップグレード前に利用可能なペアを確認する必要があります。

このリリースの新機能

.NET の課題キーは Java に移植された機能を示し、概要はこの Java リリースでサポートされる形式を説明します。

リリース JAR は Automatic-Module-Name: com.groupdocs.conversion を宣言し、Java モジュールシステムを使用するアプリケーション向けに安定したモジュール名を提供します。

パブリック API の変更

協調キャンセル

新たに com.groupdocs.conversion.CancellationToken と com.groupdocs.conversion.CancellationTokenSource の 2 つのクラスが追加され、アプリケーションが変換の停止を要求できるようになりました。すべてのパブリック Converter.convert(...) および Converter.convertPageByPage(...) メソッドには、最後の CancellationToken パラメータを持つオーバーロードが追加されました。フルエントな変換実行者にも ConversionExecutor.convert(CancellationToken) が追加されました。

既存のオーバーロードは引き続き利用可能で、CancellationToken.NONE を使用するため、既存の変換呼び出しを変更する必要はありません。

トークン ソースを作成し、そのトークンを変換に渡します:

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

cancellationSource.cancel() を、ユーザーがジョブをキャンセルしたときやアプリケーションが停止を決定したときに呼び出します。キャンセルは 変換操作間 でチェックされます。すでに実行中の操作はキャンセルが検出される前に完了します。その後、変換は java.util.concurrent.CancellationException をスローします。

既に書き込まれた出力はロールバックされないため、ジョブをキャンセルする際はアプリケーション側で部分的な出力を処理する必要があります。キャンセルされたソースはリセットできないため、新しいジョブには新しいソースを作成してください。null トークンを渡すと NullPointerException が発生します。

圧縮ストリーム変換

バージョン 26.9 は、同一形式変換を含む以下の圧縮ストリームのソースとターゲットをサポートします:

Unix Z はソースとしてはサポートされていますが、このリリースではターゲットとしてはサポートされていません。

CompressionConvertOptions.setFormat(...) を使用して出力形式を選択します。例えば、Gzip ストリームを 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);
}

アーカイブ変換の互換性

広告されていたアーカイブ変換ペアは、ZIP、7z、TAR、CPIO 内の変換に限定されました。以前に広告されていたアーカイブから圧縮ストリームへのペアに依存していたアプリケーションは、アップグレード前に利用可能な変換を確認する必要があります。上記の圧縮ストリームのソースおよびターゲット形式は、別のサポート対象変換グループを示しています。

安定した Java モジュール名

リリース JAR は以下のマニフェスト エントリを宣言しています:

Automatic-Module-Name: com.groupdocs.conversion

これにより、Java モジュールシステムを使用するアプリケーションは安定したモジュール名を取得できます。モジュラーアプリケーションは module-info.java で次のように参照できます:

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

アップデートの取得方法

Maven

pom.xml に GroupDocs リポジトリと 26.9 の依存関係を追加するか、既存の依存関係のバージョンを更新してください:

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

また、GroupDocs.Conversion for Java Maven リポジトリ を参照することもできます。

直接ダウンロード

Java パッケージは GroupDocs.Conversion for Java リリース ページからダウンロードしてください。

リソース

• 完全なリリースノート
• ドキュメント
• 無料サポートフォーラム