GroupDocs.Conversion for Java 26.9 – Destaques da Versão de Setembro de 2026

Estamos felizes em anunciar o lançamento do GroupDocs.Conversion for Java v26.9. Esta versão de setembro de 2026 introduz o cancelamento cooperativo para conversão de documentos, adiciona conversões entre formatos de fluxo comprimido e fornece um nome de módulo Java estável. Também atualiza os pares de conversão de arquivos anunciados, de modo que aplicativos que selecionam conversões dinamicamente devem revisar os pares disponíveis antes de atualizar.

O que há de novo nesta versão

O JAR da versão também declara Automatic-Module-Name: com.groupdocs.conversion para aplicativos que utilizam o sistema de módulos Java.

Alterações na API pública

Cancelamento cooperativo

Duas novas classes, com.groupdocs.conversion.CancellationToken e com.groupdocs.conversion.CancellationTokenSource, permitem que um aplicativo solicite que uma conversão seja interrompida. Todos os métodos públicos Converter.convert(...) e Converter.convertPageByPage(...) agora possuem sobrecargas com um parâmetro final CancellationToken. O executor de conversão fluente também adiciona ConversionExecutor.convert(CancellationToken).

As sobrecargas existentes permanecem disponíveis e utilizam CancellationToken.NONE, portanto as chamadas de conversão existentes não requerem alterações.

Crie uma fonte de token e passe seu token para a conversão:

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

Chame cancellationSource.cancel() quando o usuário cancelar um trabalho ou quando o aplicativo decidir interrompê-lo. O cancelamento é verificado entre as operações de conversão: uma operação já em execução termina antes que o cancelamento seja observado. A conversão então lança java.util.concurrent.CancellationException.

A saída já gravada não é revertida, portanto os aplicativos devem lidar com saída parcial ao cancelar um trabalho. Uma fonte cancelada não pode ser redefinida; crie uma nova fonte para um novo trabalho. Passar um token nulo gera NullPointerException.

Conversões de fluxo comprimido

A versão 26.9 suporta as seguintes fontes e destinos de fluxo comprimido, incluindo conversão no mesmo formato:

Unix Z é suportado como origem, mas não como destino nesta versão.

Use CompressionConvertOptions.setFormat(...) para selecionar o formato de saída. Por exemplo, converta um fluxo Gzip para 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);
}

Compatibilidade de conversão de arquivos

Os pares de conversão de arquivos anunciados agora estão restritos a conversões dentro de ZIP, 7z, TAR e CPIO. Aplicativos que dependiam dos pares de arquivo-para-fluxo-comprimido anunciados anteriormente devem revisar as conversões disponíveis antes de atualizar. Os formatos de fonte e destino de fluxo comprimido listados acima descrevem um grupo separado de conversões suportadas.

Nome de módulo Java estável

O JAR da versão declara a seguinte entrada no manifesto:

Automatic-Module-Name: com.groupdocs.conversion

Isso fornece aos aplicativos que utilizam o sistema de módulos Java um nome de módulo estável. Um aplicativo modular pode referenciá-lo em module-info.java:

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

Como obter a atualização

Maven

Adicione o repositório GroupDocs e a dependência 26.9 ao seu pom.xml, ou atualize a versão na sua dependência existente:

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

Você também pode navegar pelo repositório Maven do GroupDocs.Conversion for Java.

Download direto

Baixe o pacote Java na página de lançamentos do GroupDocs.Conversion for Java.

Recursos

• Notas completas da versão
• Documentação
• Free Support Forum