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.