我們很高興宣佈 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 |
升級前需檢查的行為變更
- PDF 清理移除更多內容。
Metadata.sanitize()現在會從 PDF 文件中移除註解、附件、書籤、表單欄位與數位簽章;在 26.11 之前僅移除註解。如果需要保留這些項目,請不要對 PDF 呼叫sanitize()——只移除您需要的屬性即可。 - 壓縮檔以副檔名辨識。 RAR、7z、TAR 以及新加入的壓縮檔格式會依副檔名偵測,因此從
InputStream或 URI 載入壓縮檔時需要明確設定格式(見下方)。 - 電子郵件寄件者屬性重新命名。 在屬性清單中,寄件者屬性現在稱為
SenderEmailAddress而非Sender。依名稱查找屬性的程式碼必須改用新名稱。EmailPackage.getSender()已棄用,建議改用getSenderEmailAddress()。 - 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。