Nos complace anunciar el lanzamiento de GroupDocs.Conversion for Java v26.9. Esta versión de septiembre 2026 introduce la cancelación cooperativa para la conversión de documentos, añade conversiones entre formatos de flujo comprimido y proporciona un nombre de módulo Java estable. También actualiza los pares de conversión de archivos anunciados, por lo que las aplicaciones que seleccionan conversiones de forma dinámica deberían revisar los pares disponibles antes de actualizar.

Qué hay de nuevo en esta versión

La clave .NET a continuación identifica las funciones portadas a Java; los resúmenes describen los formatos compatibles con esta versión de Java.

Clave Categoría Cambio
CONVERSIONNET-6880 Funcionalidad Soporta cancelación cooperativa mediante tokens de cancelación
CONVERSIONNET-7032 Funcionalidad Convertir Bzip2, Gzip, XZ y Unix Z a LZMA
CONVERSIONNET-7019 Funcionalidad Convertir LZMA a Bzip2 y Gzip
CONVERSIONNET-7020 Funcionalidad Convertir Unix Z a Bzip2 y Gzip
CONVERSIONNET-7030 Funcionalidad Convertir Bzip2, Gzip, LZMA y Unix Z a XZ
CONVERSIONNET-7029 Funcionalidad Convertir XZ a Bzip2 y Gzip
CONVERSIONNET-7028 Funcionalidad Convertir Gzip a Bzip2
CONVERSIONNET-7021 Funcionalidad Convertir Bzip2 a Gzip
CONVERSIONJAVA-3238 Tarea Resolver hallazgos de verificación de paquetes en groupdocs-conversion-26.7.jar

El JAR de la versión también declara Automatic-Module-Name: com.groupdocs.conversion para aplicaciones que usan el sistema de módulos de Java.

Cambios en la API pública

Cancelación cooperativa

Dos nuevas clases, com.groupdocs.conversion.CancellationToken y com.groupdocs.conversion.CancellationTokenSource, permiten a una aplicación solicitar que una conversión se detenga. Todos los métodos públicos Converter.convert(...) y Converter.convertPageByPage(...) ahora tienen sobrecargas con un parámetro final CancellationToken. El ejecutor de conversión fluida también añade ConversionExecutor.convert(CancellationToken).

Las sobrecargas existentes siguen disponibles y usan CancellationToken.NONE, por lo que las llamadas de conversión actuales no requieren cambios.

Cree una fuente de token y pase su token a la conversión:

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")) {
    // Un controlador de cancelación de la aplicación puede llamar a cancellationSource.cancel()
    // desde otro hilo mientras se ejecuta esta conversión.
    converter.convert(
        "converted.pdf",
        new PdfConvertOptions(),
        cancellationSource.getToken()
    );
} catch (CancellationException ex) {
    System.out.println("Conversion was cancelled.");
}

Llame a cancellationSource.cancel() cuando el usuario cancele una tarea o la aplicación decida detenerla. La cancelación se verifica entre operaciones de conversión: una operación que ya está en ejecución termina antes de que se observe la cancelación. La conversión entonces lanza java.util.concurrent.CancellationException.

La salida ya escrita no se revierte, por lo que las aplicaciones deben manejar la salida parcial al cancelar una tarea. Una fuente cancelada no puede restablecerse; cree una nueva fuente para una nueva tarea. Pasar un token nulo genera NullPointerException.

Conversiones de flujos comprimidos

La versión 26.9 admite los siguientes orígenes y destinos de flujos comprimidos, incluida la conversión del mismo formato:

Dirección Formatos compatibles
Origen Bzip2 (Bz2), Gzip (Gz y Gzip), LZMA (Lzma), XZ (Xz), Unix Z (Z)
Destino Bzip2, Gzip, LZMA, XZ

Unix Z se admite como origen, pero no como destino en esta versión.

Utilice CompressionConvertOptions.setFormat(...) para seleccionar el formato de salida. Por ejemplo, convierta un flujo Gzip a 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);
}

Compatibilidad de conversión de archivos

Los pares de conversión de archivos anunciados ahora están restringidos a conversiones dentro de ZIP, 7z, TAR y CPIO. Las aplicaciones que dependían de los pares de archivo‑a‑flujo comprimido anunciados previamente deberían revisar las conversiones disponibles antes de actualizar. Los formatos de origen y destino de flujo comprimido enumerados arriba describen un grupo separado de conversiones compatibles.

Nombre de módulo Java estable

El JAR de la versión declara la siguiente entrada del manifiesto:

Automatic-Module-Name: com.groupdocs.conversion

Esto proporciona a las aplicaciones que usan el sistema de módulos de Java un nombre de módulo estable. Una aplicación modular puede referirse a él en module-info.java:

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

Cómo obtener la actualización

Maven

Agregue el repositorio de GroupDocs y la dependencia 26.9 a su pom.xml, o actualice la versión en su dependencia 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>

También puede explorar el GroupDocs.Conversion for Java Maven repository.

Descarga directa

Descargue el paquete Java desde la página de GroupDocs.Conversion for Java releases.

Recursos