GroupDocs.Conversion for Java 26.9 – 2026년 9월 릴리스 하이라이트

우리는 GroupDocs.Conversion for Java v26.9 릴리스를 발표하게 되어 기쁩니다. 2026년 9월 릴리스에서는 문서 변환을 위한 협력 취소 기능을 도입하고, 압축 스트림 형식 간 변환을 추가했으며, 안정적인 Java 모듈 이름을 제공합니다. 또한 광고된 아카이브 변환 쌍을 업데이트했으므로, 동적으로 변환을 선택하는 애플리케이션은 업그레이드 전에 사용 가능한 쌍을 검토해야 합니다.

이번 릴리스의 새로운 기능

아래 .NET 이슈 키는 Java로 포팅된 기능을 식별하며, 요약은 이번 Java 릴리스에서 지원되는 형식을 설명합니다.

릴리스 JAR는 Java 모듈 시스템을 사용하는 애플리케이션을 위해 Automatic-Module-Name: com.groupdocs.conversion을 선언합니다.

공개 API 변경 사항

협력 취소

두 개의 새로운 클래스 com.groupdocs.conversion.CancellationToken와 com.groupdocs.conversion.CancellationTokenSource를 통해 애플리케이션이 변환을 중단하도록 요청할 수 있습니다. 모든 공개 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이 발생합니다.

압축 스트림 변환

Version 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 저장소를 탐색할 수 있습니다.

직접 다운로드

GroupDocs.Conversion for Java 릴리스 페이지에서 Java 패키지를 다운로드합니다.

리소스

• 전체 릴리스 노트
• 문서
• 무료 지원 포럼