我们很高兴宣布 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 归档格式 | 功能 |
| — | 支持 Apple Archive (AAR) 格式 | 功能 |
| METADATANET-4083 | 支持 OGG (Vorbis) 音频格式 | 功能 |
| METADATANET-4077 | 支持 FictionBook 2 (FB2) 电子书格式(只读) | 功能 |
| — | 支持 MOBI 电子书格式 | 功能 |
| METADATANET-4094 | 使用新的 Metadata(URI) 构造函数从网络资源加载文档 |
功能 |
| METADATANET-4121 | MSG:Internet message ID、billing、HTML 和 RTF 正文;EML:可编辑附件 | 功能 |
| METADATANET-4123, METADATANET-4124 | MSG:会话主题、显示名称、加密和签名标志、发件人及“代表发送”地址、回复地址、已读回执以及其他 MAPI 属性 | 功能 |
| METADATANET-4110, METADATANET-4111 | Email:getSenderEmailAddress()、可编辑的 MSG 发件人名称、正文和类别 |
增强 |
| METADATANET-4099 | MSG:可编辑的投递时间、客户端提交时间和头部 | 增强 |
| — | EmailHeaderPackage.set(String, PropertyValue) 添加或更新电子邮件头部 |
增强 |
| — | WordProcessing:HyperlinksChanged、ScaleCrop 和 SharedDoc 属性 |
增强 |
| METADATANET-4139 | Metadata.sanitize() 移除 PDF 附件、书签、表单字段和数字签名 |
增强 |
| METADATANET-4140 | 新标签 Tags.getTime().getDelivery() 和 Tags.getTool().getCompression();更多属性被标记 |
增强 |
| METADATAJAVA-718 | 更新 Aspose 库 | 增强 |
| — | CAD 图纸的预览为空 | 修复 |
| — | RAR、7z 和 TAR 归档可能被识别为 MP3 文件 | 修复 |
| — | AVIF 图像可能被识别为 MP3、MOV 或 HEIF 文件 | 修复 |
| — | 小幅修复:原始标签的 equals/hashCode 一致性、空安全 JSON 导入、大小运算溢出、ZIP 打包后关闭流 | 修复 |
升级前需检查的行为更改
- 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 一致性、空安全 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 包。