我们很高兴宣布 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 打包后关闭流 修复

升级前需检查的行为更改

  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 一致性、空安全 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 包。

资源