我們很高興宣佈 GroupDocs.Metadata for Java 26.11 已於 2026 年 11 月 正式發佈。此版本可從 八種更多格式 讀取中繼資料——五種壓縮檔格式、OGG Vorbis 音訊以及 FB2 與 MOBI 電子書——且能直接從 URI 載入文件。電子郵件支援大幅提升:MSG 檔案可顯示約 30 個額外的 MAPI 屬性,若干現有屬性變為可編輯,且 EML 附件可編輯。Metadata.sanitize() 現在可從 PDF 文件中移除更多內容,且一系列修正提升了 CAD 預覽與檔案類型偵測。

本次發行的新功能

鍵 摘要 類別
METADATANET-4251 支援 GZIP、BZ2、XZ 與 Zstandard 壓縮檔格式 Feature
— 支援 Apple Archive(AAR)格式 Feature
METADATANET-4083 支援 OGG(Vorbis)音訊格式 Feature
METADATANET-4077 支援 FictionBook 2(FB2)電子書格式(唯讀) Feature
— 支援 MOBI 電子書格式 Feature
METADATANET-4094 使用新的 Metadata(URI) 建構子從網路資源載入文件 Feature
METADATANET-4121 MSG:Internet 訊息 ID、計費、HTML 與 RTF 內容;EML:可編輯的附件 Feature
METADATANET-4123, METADATANET-4124 MSG:對話主題、顯示名稱、加密與簽章旗標、寄件者與「代表寄送」地址、回覆地址、已讀回執以及其他 MAPI 屬性 Feature
METADATANET-4110, METADATANET-4111 Email:getSenderEmailAddress()、可編輯的 MSG 寄件者名稱、內容與類別 Enhancement
METADATANET-4099 MSG:可編輯的傳送時間、客戶提交時間與標頭 Enhancement
— EmailHeaderPackage.set(String, PropertyValue) 新增或更新電子郵件標頭 Enhancement
— WordProcessing:HyperlinksChanged、ScaleCrop 與 SharedDoc 屬性 Enhancement
METADATANET-4139 Metadata.sanitize() 移除 PDF 附件、書籤、表單欄位與數位簽章 Enhancement
METADATANET-4140 新增標籤 Tags.getTime().getDelivery() 與 Tags.getTool().getCompression();更多屬性已加上標籤 Enhancement
METADATAJAVA-718 Aspose 函式庫已更新 Enhancement
— CAD 圖紙的預覽為空 Fix
— RAR、7z 與 TAR 壓縮檔可能被誤判為 MP3 檔案 Fix
— AVIF 圖片可能被誤判為 MP3、MOV 或 HEIF 檔案 Fix
— 其他小修正:原始標籤的 equals/hashCode 一致性、支援 null 的 JSON 匯入、大小運算溢位、ZIP 打包後關閉串流 Fix

升級前需檢查的行為變更

  1. PDF 清理移除更多內容。 Metadata.sanitize() 現在會從 PDF 文件中移除註解、附件、書籤、表單欄位與數位簽章;在 26.11 之前僅移除註解。如果需要保留這些項目,請不要對 PDF 呼叫 sanitize()——只移除您需要的屬性即可。
  2. 壓縮檔以副檔名辨識。 RAR、7z、TAR 以及新加入的壓縮檔格式會依副檔名偵測,因此從 InputStream 或 URI 載入壓縮檔時需要明確設定格式(見下方)。
  3. 電子郵件寄件者屬性重新命名。 在屬性清單中,寄件者屬性現在稱為 SenderEmailAddress 而非 Sender。依名稱查找屬性的程式碼必須改用新名稱。EmailPackage.getSender() 已棄用,建議改用 getSenderEmailAddress()。
  4. MPEG 音訊標頭為唯讀。 MpegAudioPackage 只描述音訊串流,其屬性(如 MPEG 版本、聲道模式、位元率與頻率)無法再透過屬性 API 變更。

新增格式

壓縮檔:AAR、GZIP、BZ2、XZ 與 Zstandard

新的 FileType 常數有 AAR、GZIP(.gz)、BZ2、XZ 與 ZSTD(.zst)。每種格式都有一個唯讀的根套件:

格式 根套件 提供的內容
AAR AarRootPackage AarPackage:總條目數、solid 標誌,以及 AarFile 條目(包含名稱、長度與目錄標誌)
GZIP GzipRootPackage GzipPackage:名稱、總條目數、壓縮與未壓縮大小
BZ2 Bz2RootPackage Bz2Package:名稱、總條目數、大小
XZ XzRootPackage XzPackage:名稱、總條目數、大小
Zstandard ZstdRootPackage ZstdPackage:名稱、總條目數、大小
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());
}

OGG Vorbis 音訊

新增 FileType.OGG 與 OggRootPackage.getOggPackage()。OggPackage 讀取 Vorbis 註解欄位:

  • 標題、專輯、曲目編號、藝術家、表演者、類型與日期;
  • 版權、授權、組織、描述、位置、聯絡方式與 ISRC;
  • 供應商字串與版本;
  • 其餘的註解,透過 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());
    }
}

電子書:FB2 與 MOBI

  • FictionBook 2 (FB2) — 新增 FileType.FB2 與 Fb2RootPackage.getFb2Package();此格式為唯讀。Fb2Package 包含四個區段:書名資訊與來源書名資訊(Fb2TitleInfo:書名、作者、類型、關鍵字、語言與系列)、文件資訊(Fb2DocumentInfo)以及出版資訊(Fb2PublishInfo)。
  • MOBI — 新增 FileType.MOBI 與 MobiRootPackage.getMobiPackage()。MobiPackage 提供 PDB 標頭(PDBHeader)與 MOBI 標頭(MobiHeader)。可使用 MobiHeader.setFullName(String) 編輯書籍的完整名稱。

從 URI 載入

兩個新建構子可直接從 java.net.URI 載入文件,您不再需要自行下載檔案:

public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)

文件會先下載至記憶體,然後以與從串流相同的方式載入。由於壓縮檔現在會依副檔名辨識,從串流或 URI 載入壓縮檔時請明確設定格式:

try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
    // ...
}

電子郵件訊息

  • 新增 EmailPackage.getSenderEmailAddress();EmailPackage.getSender() 已棄用,回傳相同的值。
  • EmailPackage.setHeaders(EmailHeaderPackage) 與 EmailHeaderPackage.set(String, PropertyValue) 可新增或更新電子郵件標頭。
  • EmlPackage.getAttachments() 與 EmlPackage.setAttachments(EmailAttachmentPackage[]) 讓 EML 附件可編輯。

MsgPackage 獲得多項新屬性:

  • 可編輯: Body、Categories、SenderName、DeliveryTime、ClientSubmitTime、Billing、BodyHtml、BodyRtf、ReplyTo、ReadReceiptRequested、SenderSmtpAddress、SentRepresentingEmailAddress、SentRepresentingName、Mileage、Attachments;
  • 唯讀: InternetMessageId、ConversationTopic、DisplayBcc、DisplayCc、DisplayName、DisplayNamePrefix、DisplayTo、NormalizedSubject、SubjectPrefix、SenderAddressType、SentRepresentingAddressType、SentRepresentingSmtpAddress、TransportMessageHeaders,以及旗標 isEncrypted()、isSigned()、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");
}

其他增強功能

清理 PDF 文件

Metadata.sanitize() 現在會從 PDF 文件中移除附件、書籤、表單欄位與數位簽章,而不僅是註解。這讓您在將 PDF 分享給組織外部之前,能更徹底地清理文件。

WordProcessing 文件

WordProcessingPackage 新增三個可讀寫的屬性:HyperlinksChanged、ScaleCrop 與 SharedDoc。

標籤

  • Tags.getTime().getDelivery() 標記訊息的傳送時間。
  • Tags.getTool().getCompression() 標記 ZIP、PNG 與 PSD 檔案的壓縮設定。

兩個標籤皆可在 Metadata.findProperties 中搭配 ContainsTagSpecification 使用,且更多既有屬性現在已加上標籤。

修正

  • CAD 圖紙的預覽為空。
  • RAR、7z 與 TAR 壓縮檔可能被誤判為 MP3 檔案。
  • AVIF 圖片可能被誤判為 MP3、MOV 或 HEIF 檔案。
  • 其他小修正:原始標籤的 equals/hashCode 一致性、支援 null 的 JSON 匯入、大小運算溢位,以及 ZIP 打包後關閉串流。

Aspose 函式庫已更新

隨附的 Aspose 函式庫已更新至: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 與 Aspose.ZIP 26.7。

如何取得更新

Maven

在 pom.xml 中加入 GroupDocs 倉庫與相依性:

<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>

直接下載

從 GroupDocs.Metadata for Java 26.11 下載頁面 下載 JAR。

資源