Siamo felici di annunciare il rilascio di GroupDocs.Conversion for Java 26.10, disponibile a partire da ottobre 2026. Questa versione introduce il supporto per la conversione di archivi ISO e UUE (uuencode), la conversione di immagini HEIC tramite un connettore decoder configurabile e la possibilità di rimuovere i metadati di documento incorporati e personalizzati durante la conversione di documenti WordProcessing, Spreadsheet, Presentation e PDF. Include inoltre miglioramenti nella rilevazione del tipo di file, nella dimensione delle pagine, nella conservazione dei margini e corregge diversi bug, inclusa una regressione critica dalla versione 26.9 in cui la prima chiamata a License.setLicense() falliva.
Novità di questa versione
- [Funzionalità] Converti archivi ZIP, 7z, TAR e CPIO in ISO (CONVERSIONNET-7079)
- [Funzionalità] Converti archivi ISO in ZIP, 7z, TAR e CPIO (CONVERSIONNET-7078)
- [Funzionalità] Converti UUE in Bzip2, Gzip, Lzip, LZMA, XZ, Unix Z, Zstandard, UUE e formati di archivio supportati (CONVERSIONNET-7154)
- [Funzionalità] Converti Bzip2, Gzip, LZMA, XZ, Unix Z e Zstandard in UUE (CONVERSIONNET-7155)
- [Funzionalità] Supporta la conversione da immagini HEIC tramite un connettore decoder (CONVERSIONNET-7140)
- [Miglioramento] Migliora il rilevamento del tipo di file quando LoadOptions non specificano un formato (CONVERSIONNET-7161)
- [Miglioramento] Rimuovi i metadati durante la conversione da documenti PDF (CONVERSIONNET-7131)
- [Miglioramento] Rimuovi i metadati durante la conversione da documenti Presentation (CONVERSIONNET-7130)
- [Miglioramento] Rimuovi i metadati durante la conversione da documenti Spreadsheet (CONVERSIONNET-7129)
- [Miglioramento] Rimuovi i metadati durante la conversione da documenti WordProcessing (CONVERSIONNET-7128)
- [Bug] Rispetta il tipo di file specificato in LoadOptions durante la conversione per nome file (CONVERSIONNET-7089)
- [Bug] Correggi la conversione da diagramma a immagine su macOS e Linux (CONVERSIONNET-7088)
- [Bug] Applica correttamente la dimensione della pagina richiesta (CONVERSIONNET-7080)
- [Bug] Includi colonne MPP personalizzate nell’output della conversione (CONVERSIONNET-6905)
- [Bug] Correggi la conversione da HTML a RTF tramite PDF (CONVERSIONNET-6969)
- [Bug] Correggi l’estrazione di file di testo nativi e convertiti incorporati nei documenti Word (CONVERSIONNET-7138)
- [Bug] Correggi il recupero delle informazioni del documento PDF (CONVERSIONNET-7183)
- [Attività] Implementa token di cancellazione nelle operazioni di conversione e nei salvataggi (CONVERSIONJAVA-3265)
- [Attività] Rendi la conversione annullabile (CONVERSIONJAVA-3266)
- [Bug] Correggi IllegalAccessError alla prima chiamata License.setLicense(), che lasciava la libreria in modalità valutazione (regressione in 26.9) (CONVERSIONJAVA-3300)
Modifiche all’API pubblica
Supporto alla conversione ISO e UUE
Usa CompressionConvertOptions.setFormat(...) con CompressionFileType.Iso o CompressionFileType.Uue.
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.Iso);
try (Converter converter = new Converter("input.zip")) {
converter.convert("converted.iso", options);
}
ISO supporta la conversione da e verso ZIP, 7z, TAR e CPIO, e la conversione ISO a ISO.
UUE può essere convertito in Bzip2, Gzip, Lzip, LZMA, XZ, Unix Z, Zstandard, UUE, ZIP, 7z, TAR, CPIO e ISO.
La conversione in UUE è supportata da Bzip2, Gzip, LZMA, XZ, Unix Z e Zstandard. Lzip a UUE non è supportato.
Supporto alla conversione HEIC
Configura un’implementazione di com.groupdocs.conversion.integration.heic.IHeicConnector usando
RasterImageLoadOptions.setHeicConnector(...) e passa tali opzioni di caricamento a Converter quando carichi un’immagine HEIC.
Il connettore fornisce il decoder HEIC; è necessaria un’implementazione del decoder per la conversione HEIC.
IHeicConnector.getBitmapInfo(InputStream) restituisce un bitmap decodificato. Il suo metodo predefinito
getDecodedBitmapInfo(InputStream) adatta quel bitmap a com.groupdocs.conversion.contracts.BitmapInfo.
I connettori possono sovrascrivere quest’ultimo metodo per fornire direttamente i dati pixel decodificati.
Rimozione dei metadati
WordProcessingLoadOptions, SpreadsheetLoadOptions, PresentationLoadOptions e PdfLoadOptions implementano
IMetadataLoadOptions e espongono setClearBuiltInDocumentProperties(boolean) e
setClearCustomDocumentProperties(boolean), con i relativi getter. Entrambe le opzioni hanno valore predefinito false.
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setClearBuiltInDocumentProperties(true);
loadOptions.setClearCustomDocumentProperties(true);
try (Converter converter = new Converter("input.docx", () -> loadOptions)) {
converter.convert("converted.pdf", new PdfConvertOptions());
}
Margini di pagina nullable e impostazioni predefinite del foglio di calcolo
I getter dei margini in IPageMarginConvertOptions, PdfConvertOptions e WordProcessingConvertOptions ora restituiscono
Float invece di float. I margini hanno valore predefinito null, il che preserva i margini del documento sorgente quando applicabile.
I setter accettano valori Float nullable; le sovraccariche dei setter primitive float rimangono disponibili.
Ricompila le applicazioni contro la libreria aggiornata. Il codice che esegue l’unboxing del risultato di un getter del margine deve gestire null.
Imposta margini espliciti per mantenere un layout a margine fisso.
SpreadsheetLoadOptions.getAllColumnsInOnePagePerSheet() e getSkipEmptyRowsAndColumns() hanno ora valore predefinito false.
Impostali esplicitamente a true se la tua applicazione richiede tutte le colonne su una pagina o l’omissione di righe e colonne vuote.
Opzioni di caricamento email
Rimosse le obsolete metodologie EmailLoadOptions.getDisplayEmailAddress() e setDisplayEmailAddress(boolean).
Usa invece getDisplayFromEmailAddress() e setDisplayFromEmailAddress(boolean).
Rilevamento del formato nelle opzioni di caricamento
Le opzioni di caricamento che coprono più tipi di file non assegnano più un formato predefinito. Quando Format non è specificato, il formato sorgente viene rilevato dall’input. Un formato specificato esplicitamente viene rispettato durante il caricamento per nome file.
Nuove funzionalità
Questa versione introduce nuovi formati, controlli sui metadati e correzioni di conversione:
- Aggiunta la conversione da e verso archivi ISO.
- Aggiunta la conversione da e verso UUE (uuencode), con le coppie di formati elencate di seguito.
- Aggiunta la conversione di immagini HEIC tramite un connettore decoder configurabile.
- Aggiunte opzioni per rimuovere le proprietà di documento incorporate e personalizzate durante la conversione di documenti WordProcessing, Spreadsheet, Presentation e PDF.
- Migliorato il rilevamento del tipo di file, la dimensione delle pagine e la conservazione dei margini del documento sorgente.
- Corretta la conversione da diagramma a immagine su macOS e Linux, le colonne MPP personalizzate, l’estrazione di testo incorporato e la selezione delle pagine PDF.
- Corretta una regressione nella 26.9 in cui la prima chiamata a License.setLicense() generava IllegalAccessError e lasciava la libreria in modalità valutazione.
Esempio di codice
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.Iso);
try (Converter converter = new Converter("input.zip")) {
converter.convert("converted.iso", options);
}
Come ottenere l’aggiornamento
Maven
Aggiorna al pacchetto GroupDocs.Conversion più recente tramite Maven:
GroupDocs.Conversion per Java 26.10
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>26.10</version>
</dependency>