使用 GroupDocs.Conversion for Java 将电子邮件转换为 PDF：高级选项指南

将电子邮件消息转换为 PDF 是归档、共享以及确保数据隐私的常见需求。在本教程中，您将掌握使用 GroupDocs.Conversion for Java 进行 电子邮件转 PDF 转换，学习如何隐藏或显示特定的电子邮件字段，以及如何微调过程以获得最佳性能。

快速答复

• 哪个库处理电子邮件转 PDF 转换？ GroupDocs.Conversion for Java。
• 需要哪个 Maven 构件？ com.groupdocs:groupdocs-conversion。
• 可以隐藏发件人/收件人详情吗？ 可以——使用 EmailLoadOptions 控制可见性。
• 生产环境需要许可证吗？ 非试用使用需提供有效的 GroupDocs 许可证。
• 支持的 Java 版本是？ Java 8 或更高。

什么是电子邮件转 PDF 转换？

电子邮件转 PDF 转换将 .msg、.eml 或其他电子邮件格式转换为静态、可移植的 PDF 文档。此过程在保留原始消息布局的同时，允许您编辑敏感信息，如电子邮件地址、标题或 CC/BCC 字段。

为什么选择 GroupDocs.Conversion for Java？

GroupDocs.Conversion 提供简洁的 API、强大的格式支持以及细粒度的加载选项，让您可以精确决定邮件的哪些部分出现在最终 PDF 中。它还可与 Maven 无缝集成，使依赖管理变得简单直观。

前置条件

• Java Development Kit (JDK) 8+ 已安装。
• Maven 用于依赖管理（请参阅下文的 groupdocs conversion maven 部分）。
• 具备 Java 和 Maven 项目的基本知识。

设置 GroupDocs.Conversion for Java

首先，将 GroupDocs 仓库和转换依赖添加到 pom.xml。这就是您需要的 groupdocs conversion maven 配置。

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

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-conversion</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

许可证获取

• 免费试用 – 免费体验全部功能。
• 临时许可证 – 申请短期密钥以进行扩展评估。
• 购买 – 获取完整许可证用于生产部署。

实现指南

使用高级选项将电子邮件转换为 PDF

下面提供了一个逐步演示，展示如何 将 msg 转换为 pdf 并自定义字段可见性。

步骤 1：配置 Email Load Options

创建 EmailLoadOptions 实例并关闭不希望出现在 PDF 中的字段。

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions loadOptions = new EmailLoadOptions();
loadOptions.setDisplayHeader(false);
loadOptions.setDisplayFromEmailAddress(false);
loadOptions.setDisplayToEmailAddress(false);
loadOptions.setDisplayEmailAddress(false);
loadOptions.setDisplayCcEmailAddress(false);
loadOptions.setDisplayBccEmailAddress(false);
loadOptions.setConvertOwned(false); // Prevent conversion of fields that are owned by the document

步骤 2：初始化 Converter

在创建 Converter 对象时传入已配置的加载选项。

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG", () -> loadOptions);

步骤 3：设置 PDF 转换选项

您可以使用 PdfConvertOptions 进一步自定义 PDF 输出。此示例中默认设置已足够。

PdfConvertOptions options = new PdfConvertOptions();

步骤 4：执行转换

调用 convert 方法，提供目标路径以及上述定义的选项。

converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertEmailWithAlteringFieldsVisibility.pdf", options);

按文档类型的加载选项

了解如何加载不同文档类型对于灵活转换至关重要。下面给出针对电子邮件的重点示例。

步骤 1：配置 Email Load Options（复用）

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions emailLoadOptions = new EmailLoadOptions();
emailLoadOptions.setDisplayHeader(false);
emailLoadOptions.setDisplayFromEmailAddress(false);
emailLoadOptions.setDisplayToEmailAddress(false);
emailLoadOptions.setDisplayEmailAddress(false);
emailLoadOptions.setDisplayCcEmailAddress(false);
emailLoadOptions.setDisplayBccEmailAddress(false);
emailLoadOptions.setConvertOwned(false); // Do not convert owned fields

步骤 2：使用 Email Load Options 初始化 Converter

Converter emailConverter = new Converter("EMAIL_FILE_PATH", () -> emailLoadOptions);

实际应用

以下是 电子邮件转 PDF 转换 的三种真实场景：

1. 法律文档 – 在向客户共享邮件证据前对个人数据进行编辑。
2. 企业归档 – 将内部通信存储为标准化、只读的格式。
3. 个人组织 – 将重要消息保存为干净的 PDF 档案，避免泄露不必要的地址信息。

性能考虑

• 优化文件大小 – 处理较小的批次或在转换后压缩 PDF。
• 内存管理 – 利用 Java 垃圾回收，避免一次性将大型邮件全部加载到内存。
• 保持更新 – 定期升级至最新的 GroupDocs.Conversion 版本，以获取性能改进。

常见问题与解决方案

常见问答

问：什么是 GroupDocs.Conversion for Java？
答：它是一个 Java 库，支持 100 多种文件格式之间的转换，包括电子邮件转 PDF 转换。

问：如何在转换过程中确保电子邮件隐私？
答：使用 EmailLoadOptions 在转换前关闭发件人、收件人以及 CC/BCC 地址等字段。

问：除了电子邮件，我还能转换其他文档类型吗？
答：可以，库还支持 Word、Excel、PowerPoint、图像等多种格式。

问：转换大型邮件的内存需求是多少？
答：分配足够的堆空间（例如 -Xmx2g），并考虑批量处理文件。

问：在哪里可以获取更多关于 GroupDocs.Conversion 的信息？
答：访问官方文档和API 参考。

资源

• 文档： GroupDocs.Conversion for Java Docs
• API 参考： GroupDocs.Conversion API Reference

最后更新： 2026-01-18
测试环境： GroupDocs.Conversion 25.2
作者： GroupDocs