Siamo lieti di annunciare il rilascio di GroupDocs.Metadata for Java 26.11, disponibile a partire da novembre 2026. Questa versione legge i metadati da otto formati aggiuntivi — cinque formati di archivio, audio OGG Vorbis e e‑book FB2 e MOBI — e può caricare un documento direttamente da un URI. Il supporto per le email cresce notevolmente: i file MSG espongono circa 30 proprietà MAPI in più, diverse proprietà esistenti diventano modificabili e gli allegati EML possono essere modificati. Metadata.sanitize() ora rimuove molto di più dai documenti PDF, e una serie di correzioni migliora le anteprime CAD e il rilevamento del tipo di file.
Novità di questa versione
| Chiave | Riepilogo | Categoria |
|---|---|---|
| METADATANET-4251 | Supporto ai formati di archivio GZIP, BZ2, XZ e Zstandard | Feature |
| — | Supporto al formato Apple Archive (AAR) | Feature |
| METADATANET-4083 | Supporto al formato audio OGG (Vorbis) | Feature |
| METADATANET-4077 | Supporto al formato e‑book FictionBook 2 (FB2) (sola lettura) | Feature |
| — | Supporto al formato e‑book MOBI | Feature |
| METADATANET-4094 | Caricamento di documenti da risorse web con i nuovi costruttori Metadata(URI) |
Feature |
| METADATANET-4121 | MSG: ID messaggio Internet, fatturazione, corpo HTML e RTF; EML: allegati modificabili | Feature |
| METADATANET-4123, METADATANET-4124 | MSG: argomento della conversazione, nomi visualizzati, flag di crittografia e firma, indirizzi del mittente e “sent representing”, reply‑to, ricevuta di lettura e altre proprietà MAPI | Feature |
| METADATANET-4110, METADATANET-4111 | Email: getSenderEmailAddress(), nome del mittente MSG modificabile, corpo e categorie |
Enhancement |
| METADATANET-4099 | MSG: tempo di consegna modificabile, ora di invio del client e intestazioni modificabili | Enhancement |
| — | EmailHeaderPackage.set(String, PropertyValue) aggiunge o aggiorna un’intestazione email |
Enhancement |
| — | WordProcessing: proprietà HyperlinksChanged, ScaleCrop e SharedDoc |
Enhancement |
| METADATANET-4139 | Metadata.sanitize() rimuove allegati PDF, segnalibri, campi modulo e firme digitali |
Enhancement |
| METADATANET-4140 | Nuovi tag Tags.getTime().getDelivery() e Tags.getTool().getCompression(); più proprietà sono etichettate |
Enhancement |
| METADATAJAVA-718 | Librerie Aspose aggiornate | Enhancement |
| — | Le anteprime dei disegni CAD erano vuote | Fix |
| — | Gli archivi RAR, 7z e TAR potevano essere riconosciuti come file MP3 | Fix |
| — | Le immagini AVIF potevano essere riconosciute come file MP3, MOV o HEIF | Fix |
| — | Correzioni minori: coerenza di equals/hashCode dei tag grezzi, importazione JSON a prova di null, overflow nell’aritmetica delle dimensioni, flussi chiusi dopo il packing ZIP | Fix |
Cambiamenti di comportamento da verificare prima dell’aggiornamento
- La sanificazione PDF rimuove di più.
Metadata.sanitize()ora rimuove annotazioni, allegati, segnalibri, campi modulo e firme digitali dai documenti PDF; prima della 26.11 rimuoveva solo le annotazioni. Se un PDF sanificato deve conservare questi elementi, non chiamaresanitize()su di esso — rimuovi solo le proprietà di cui hai bisogno. - Gli archivi sono riconosciuti dalla loro estensione. RAR, 7z, TAR e i nuovi formati di archivio vengono rilevati dall’estensione del file, quindi un archivio caricato da un
InputStreamo da un URI deve avere il formato impostato esplicitamente (vedi di seguito). - Rinominata la proprietà del mittente email. Nell’elenco delle proprietà, la proprietà del mittente è ora chiamata
SenderEmailAddressinvece diSender. Il codice che ricerca la proprietà per nome deve usare il nuovo nome.EmailPackage.getSender()è deprecato a favore digetSenderEmailAddress(). - Le intestazioni audio MPEG sono di sola lettura.
MpegAudioPackagedescrive il flusso audio, quindi le sue proprietà — come la versione MPEG, la modalità canale, il bitrate e la frequenza — non possono più essere modificate tramite l’API delle proprietà.
Nuovi formati
Archivi: AAR, GZIP, BZ2, XZ e Zstandard
Le nuove costanti FileType sono AAR, GZIP (.gz), BZ2, XZ e ZSTD (.zst). Ogni formato è fornito con un pacchetto radice di sola lettura:
| Formato | Pacchetto radice | Cosa espone |
|---|---|---|
| AAR | AarRootPackage |
AarPackage: numero totale di voci, flag solid, e voci AarFile con nome, lunghezza e flag di directory |
| GZIP | GzipRootPackage |
GzipPackage: nome, numero totale di voci, dimensione compressa e non compressa |
| BZ2 | Bz2RootPackage |
Bz2Package: nome, numero totale di voci, dimensione |
| XZ | XzRootPackage |
XzPackage: nome, numero totale di voci, dimensione |
| Zstandard | ZstdRootPackage |
ZstdPackage: nome, numero totale di voci, dimensione |
try (Metadata metadata = new Metadata("backup.gz")) {
GzipRootPackage root = metadata.getRootPackageGeneric();
GzipPackage gzip = root.getGzipPackage();
System.out.println(gzip.getName());
System.out.println(gzip.getSize());
System.out.println(gzip.getUncompressedSize());
}
Audio OGG Vorbis
FileType.OGG e OggRootPackage.getOggPackage() sono stati aggiunti. OggPackage legge i campi dei commenti Vorbis:
- titolo, album, numero traccia, artista, interprete, genere e data;
- copyright, licenza, organizzazione, descrizione, posizione, contatto e ISRC;
- la stringa del fornitore e la versione;
- eventuali commenti rimanenti, tramite
getOggUserComments().
try (Metadata metadata = new Metadata("track.ogg")) {
OggRootPackage root = metadata.getRootPackageGeneric();
OggPackage ogg = root.getOggPackage();
System.out.println(ogg.getArtist() + " - " + ogg.getTitle());
for (OggUserComment comment : ogg.getOggUserComments()) {
System.out.println(comment.getHeader() + " = " + comment.getValue());
}
}
E‑book: FB2 e MOBI
- FictionBook 2 (FB2) —
FileType.FB2eFb2RootPackage.getFb2Package()sono stati aggiunti; il formato è di sola lettura.Fb2Packageha quattro sezioni: le informazioni sul titolo e le informazioni sul titolo di origine (Fb2TitleInfo: titolo del libro, autori, generi, parole chiave, lingua e sequenza), le informazioni sul documento (Fb2DocumentInfo) e le informazioni di pubblicazione (Fb2PublishInfo). - MOBI —
FileType.MOBIeMobiRootPackage.getMobiPackage()sono stati aggiunti.MobiPackageespone l’intestazione PDB (PDBHeader) e l’intestazione MOBI (MobiHeader). Il nome completo del libro può essere modificato conMobiHeader.setFullName(String).
Caricamento da un URI
Due nuovi costruttori caricano un documento direttamente da un java.net.URI, così non è più necessario scaricare il file manualmente:
public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)
Il documento viene scaricato in memoria e poi caricato allo stesso modo di un flusso. Poiché gli archivi ora sono riconosciuti dalla loro estensione, impostare esplicitamente il formato quando si carica un archivio da un flusso o da un URI:
try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
// ...
}
Messaggi email
EmailPackage.getSenderEmailAddress()è stato aggiunto;EmailPackage.getSender()è deprecato e restituisce lo stesso valore.EmailPackage.setHeaders(EmailHeaderPackage)eEmailHeaderPackage.set(String, PropertyValue)aggiungono o aggiornano le intestazioni email.EmlPackage.getAttachments()eEmlPackage.setAttachments(EmailAttachmentPackage[])rendono modificabili gli allegati EML.
MsgPackage guadagna molte nuove proprietà:
- modificabili:
Body,Categories,SenderName,DeliveryTime,ClientSubmitTime,Billing,BodyHtml,BodyRtf,ReplyTo,ReadReceiptRequested,SenderSmtpAddress,SentRepresentingEmailAddress,SentRepresentingName,Mileage,Attachments; - sola lettura:
InternetMessageId,ConversationTopic,DisplayBcc,DisplayCc,DisplayName,DisplayNamePrefix,DisplayTo,NormalizedSubject,SubjectPrefix,SenderAddressType,SentRepresentingAddressType,SentRepresentingSmtpAddress,TransportMessageHeaders, e i flagisEncrypted(),isSigned()eisTemplate().
try (Metadata metadata = new Metadata("message.msg")) {
MsgRootPackage root = metadata.getRootPackageGeneric();
MsgPackage msg = root.getMsgPackage();
System.out.println(msg.getInternetMessageId());
msg.setSenderName("Support Team");
msg.setCategories(new String[] { "Reviewed" });
metadata.save("message-updated.msg");
}
Altri miglioramenti
Sanificazione dei documenti PDF
Metadata.sanitize() ora rimuove allegati, segnalibri, campi modulo e firme digitali dai documenti PDF, non solo le annotazioni. Questo lo rende un metodo più completo per pulire un PDF prima di condividerlo al di fuori della tua organizzazione.
Documenti WordProcessing
WordProcessingPackage guadagna tre proprietà che possono essere lette e modificate: HyperlinksChanged, ScaleCrop e SharedDoc.
Tag
Tags.getTime().getDelivery()indica il tempo di consegna dei messaggi.Tags.getTool().getCompression()indica le impostazioni di compressione dei file ZIP, PNG e PSD.
Entrambi i tag possono essere usati con ContainsTagSpecification in Metadata.findProperties, e più proprietà esistenti sono ora etichettate.
Correzioni
- Le anteprime dei disegni CAD erano vuote.
- Gli archivi RAR, 7z e TAR potevano essere riconosciuti come file MP3.
- Le immagini AVIF potevano essere riconosciute come file MP3, MOV o HEIF.
- Correzioni minori: coerenza di equals/hashCode dei tag grezzi, importazione JSON a prova di null, overflow nell’aritmetica delle dimensioni e flussi chiusi dopo il packing ZIP.
Librerie Aspose aggiornate
Le librerie Aspose incluse sono state aggiornate a: Aspose.Words 26.8, Aspose.Cells 26.9, Aspose.Slides 26.9, Aspose.PDF 26.8.1, Aspose.Email 26.8, Aspose.CAD 26.8, Aspose.PSD 26.8, Aspose.Diagram 26.9, Aspose.BarCode 26.6, Aspose.Imaging 25.12 e Aspose.ZIP 26.7.
Come ottenere l’aggiornamento
Maven
Aggiungi il repository GroupDocs e la dipendenza al tuo pom.xml:
<repositories>
<repository>
<id>groupdocs-artifacts-repository</id>
<name>GroupDocs Artifacts Repository</name>
<url>https://releases.groupdocs.com/java/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata</artifactId>
<version>26.11</version>
</dependency>
</dependencies>
Download diretto
Scarica il JAR dalla pagina di download di GroupDocs.Metadata for Java 26.11.