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

  1. 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 chiamare sanitize() su di esso — rimuovi solo le proprietà di cui hai bisogno.
  2. 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 InputStream o da un URI deve avere il formato impostato esplicitamente (vedi di seguito).
  3. Rinominata la proprietà del mittente email. Nell’elenco delle proprietà, la proprietà del mittente è ora chiamata SenderEmailAddress invece di Sender. Il codice che ricerca la proprietà per nome deve usare il nuovo nome. EmailPackage.getSender() è deprecato a favore di getSenderEmailAddress().
  4. Le intestazioni audio MPEG sono di sola lettura. MpegAudioPackage descrive 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.FB2 e Fb2RootPackage.getFb2Package() sono stati aggiunti; il formato è di sola lettura. Fb2Package ha 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.MOBI e MobiRootPackage.getMobiPackage() sono stati aggiunti. MobiPackage espone l’intestazione PDB (PDBHeader) e l’intestazione MOBI (MobiHeader). Il nome completo del libro può essere modificato con MobiHeader.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) e EmailHeaderPackage.set(String, PropertyValue) aggiungono o aggiornano le intestazioni email.
  • EmlPackage.getAttachments() e EmlPackage.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 flag isEncrypted(), isSigned() e isTemplate().
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.

Risorse