使用 GroupDocs.Parser for Java 从 msg 中提取附件

以编程方式管理电子邮件附件是从事自动归档、安全扫描或数据提取流水线的 Java 开发者的常见需求。在本教程中，您将学习 如何从 msg 文件中提取附件，打印它们的元数据，并了解这种方法在实际项目中的价值。

快速答案

我应该使用哪个库？ GroupDocs.Parser for Java.
我可以从 .msg 文件中提取附件吗？ Yes, the API provides direct access to each attachment.
我需要许可证吗？ A trial works for evaluation; a full license is required for production.
支持哪个 Java 版本？ Java 8 or higher.
是否支持批量处理？ Absolutely – combine the sample code with loops or parallel streams.

什么是“从 msg 中提取附件”？

当您收到 Outlook .msg 文件时，邮件正文和其附件文件会一起存储。“从 msg 中提取附件”指的是以编程方式将每个附件文件分离出来，以便您可以独立地存储、分析或转换它们。

为什么使用 GroupDocs.Parser for Java？

强大的格式支持 – Handles .msg, .eml, and many other email formats.
元数据访问 – Retrieve file paths, sizes, and custom attributes without manual parsing.
简洁的 API – Minimal code required to open a message, iterate attachments, and read content.
性能导向 – Uses streaming and try‑with‑resources to keep memory usage low.

前置条件

Java Development Kit (JDK)： 8 版或更高。
IDE： IntelliJ IDEA、Eclipse 或任何兼容 Java 的编辑器。
GroupDocs.Parser library： 通过 Maven 或手动 JAR 引入（见下文）。

设置 GroupDocs.Parser for Java

Maven 设置

在您的 pom.xml 文件中添加以下配置，以通过 Maven 集成 GroupDocs.Parser：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/parser/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-parser</artifactId>
      <version>25.5</version>
   </dependency>
</dependencies>

直接下载

或者，从 GroupDocs.Parser for Java releases page 下载最新版本。手动将 JAR 文件添加到项目的 classpath 中。

许可证获取

GroupDocs 提供多种授权选项：

Free Trial： 功能受限的评估版。
Temporary License： 在短期评估期间的完整访问。
Commercial License： 生产部署所需的正式许可证。

按照官方文档的说明包含获取的许可证文件，以解锁全部功能。

基本初始化

下面是一个最小示例，证明库已正确引用：

import com.groupdocs.parser.Parser;

public class SetupExample {
    public static void main(String[] args) {
        // Initialize the Parser object with an email file path.
        try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY/sample.msg")) {
            System.out.println("GroupDocs.Parser is set up successfully!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

现在解析器已准备就绪，让我们深入核心任务：如何从 msg 中提取附件 并打印它们的元数据。

如何使用 GroupDocs.Parser 从 msg 中提取附件？

步骤 1：初始化 Parser 对象

创建一个指向要处理的 .msg 文件的 Parser 实例：

try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY/sample.msg")) {
    // Proceed with attachment extraction.
}

步骤 2：提取附件

使用容器 API 检索电子邮件中嵌入的所有附件：

Iterable<ContainerItem> attachments = parser.getContainer();
if (attachments == null) {
    System.out.println("No attachments found.");
    return;
}

for (ContainerItem item : attachments) {
    // Continue to parse each attachment.
}

步骤 3：解析每个附件（java parse email attachments）

对于每个 ContainerItem，打开一个专用的 parser 实例。如果附件是基于文本的格式，这样可以读取其内容：

try (Parser attachmentParser = item.openParser()) {
    try (TextReader reader = attachmentParser.getText()) {
        String attachmentText = reader == null ? "No text" : reader.readToEnd();
        // Handle or process the extracted text as needed.
    }
} catch (UnsupportedDocumentFormatException ex) {
    System.out.println("Unsupported document format.");
}

步骤 4：打印附件元数据

现在您拥有每个附件对象，可以显示其元数据——文件路径、大小以及任何自定义属性：

for (ContainerItem item : attachments) {
    System.out.println("File Path: " + item.getFilePath());

    // Proceed to retrieve metadata.
}

for (MetadataItem metadata : item.getMetadata()) {
    System.out.println(String.format("%s: %s", metadata.getName(), metadata.getValue()));
}

常见问题及解决方案

不支持的格式：Upgrade to the latest GroupDocs.Parser version if you encounter UnsupportedDocumentFormatException.
空附件：Verify that the source .msg actually contains attachments; some messages are body‑only.
内存消耗：When processing large mailboxes, handle attachments in batches and close parsers promptly (the try‑with‑resources pattern already helps).

实际应用

提取并打印附件元数据在以下场景中很有用：

Data Archiving： 将附件与其元数据一起存储，以满足合规审计。
Email Filtering： 根据附件类型或大小自动路由邮件。
Security Scanning： 在深度内容检查之前，将元数据输入恶意软件检测流水线。

性能提示

资源管理：Always use try‑with‑resources to free native handles.
批量处理：Process a limited number of emails per thread to keep memory usage predictable.
并行执行：Leverage Java’s ExecutorService to parse multiple .msg files concurrently.

常见问答

Q: 如何高效处理大量 .msg 文件？
A: 将示例代码与线程池（例如 Executors.newFixedThreadPool）结合，在每个任务中处理单个文件。记得让 parser 实例短暂使用，以避免内存泄漏。

Q: 能否从加密或受密码保护的邮件中提取附件？
A: 当通过 Parser 构造函数的重载提供正确密码时，GroupDocs.Parser 支持加密的 .msg 文件。

Q: 每个附件有哪些可用的元数据字段？
A: 常见字段包括 FilePath、Size、CreationTime，以及 Outlook 存储的任何自定义属性（例如 ContentId）。

Q: 是否可以在解析前按文件类型过滤附件？
A: 可以，检查 item.getFilePath() 或 metadata.getName() 的文件扩展名，跳过不需要的类型。

Q: 该库能在非 Windows 平台上运行吗？
A: GroupDocs.Parser 是跨平台的，可在任何支持 Java 8+ 的操作系统上运行。

结论

现在，您已经拥有一个完整、可用于生产的工作流，使用 GroupDocs.Parser for Java 从 msg 文件中提取附件 并打印其元数据。此基础使您能够构建更丰富的解决方案——归档流水线、安全扫描器或自定义邮件处理器，同时保持代码简洁且高效。

探索更多功能，例如全文提取、结构化数据解析或将附件转换为其他格式。请参考 GroupDocs 文档，其中提供了更深入的示例和 API 参考，帮助您进一步扩展本教程。

最后更新： 2026-01-27
测试版本： GroupDocs.Parser 25.5
作者： GroupDocs