eml to pdf java – 使用 GroupDocs 将电子邮件转换为 PDF

在许多企业中，将电子邮件归档为不可变的 PDF 对于合规、法律取证和轻松共享至关重要。本教程展示了如何在 Java 中将 .eml 文件转换为 PDF，并让您完全控制最终文档中显示的电子邮件字段。您将看到如何隐藏敏感标题、配置 Maven 依赖项以及针对大批量进行性能优化。

快速答案

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

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

电子邮件到 PDF 的转换将 .msg、.eml 或其他电子邮件格式转换为静态、可移植的 PDF 文档。此过程保留原始邮件布局，同时允许您编辑（涂黑）敏感信息，如电子邮件地址、标题或抄送/密送字段以及附件。

为什么在 Java 中使用 GroupDocs.Conversion？

GroupDocs.Conversion 提供了一个 java pdf conversion library，支持超过 100 种输入和输出格式，包括 EML、MSG、PDF、DOCX 和 HTML。它提供细粒度的 EmailLoadOptions，让您精确决定电子邮件的哪些部分出现在 PDF 中，并且能够无缝集成 Maven，便于依赖管理。

先决条件

  • 已安装 Java Development Kit (JDK) 8+。
  • Maven 用于依赖管理（请参阅下方 maven dependency groupdocs conversion 部分）。
  • 对 Java 和 Maven 项目有基本了解。

为 Java 设置 GroupDocs.Conversion

将 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>

许可证获取

  • 免费试用 – 免费探索所有功能。
  • 临时许可证 – 请求短期密钥以进行延长评估。
  • 购买 – 获取完整许可证用于生产部署。

如何使用高级选项将 eml 转换为 pdf java？

EmailLoadOptions 定义了在转换过程中渲染电子邮件的哪些部分。加载您的 .eml 文件，配置要显示的字段，并调用转换器——全部在几个简洁的步骤中完成。此答案在 70 字以内提供完整工作流。您将创建 EmailLoadOptions，设置 PDF 转换设置，并调用 convert 方法，处理可能出现的任何异常。

步骤 1：配置 Email Load Options

EmailLoadOptions 允许您切换单个电子邮件部分的可见性，例如发件人、收件人和标题。

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：执行转换

使用目标文件路径和您定义的 PDF 选项调用 convert。该方法返回一个布尔值，指示是否成功。

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

如何将 msg 转换为 pdf java（重复使用相同选项）

EmailLoadOptions 定义了在转换过程中渲染电子邮件的哪些部分。如果需要处理 Outlook .msg 文件，则相同的 EmailLoadOptions 和 Converter 工作流适用。只需将源文件路径替换为 .msg 文件。您还可以调整加载选项以隐藏或显示特定标题，并重复使用相同的 PdfConvertOptions，以在不同格式之间保持一致的输出质量。

步骤 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);

实际应用

以下是 email to pdf conversion 发光的三个真实场景：

  1. 法律文档 – 在与客户共享电子邮件证据之前编辑个人数据。
  2. 企业归档 – 将内部通信存储为标准化、只读格式，以实现长期保留。
  3. 个人组织 – 保持重要消息的干净 PDF 存档，而不暴露不必要的地址。

性能考虑因素

  • 文件大小优化 – 处理更小的批次或启用 PDF 压缩（PdfConvertOptions.setCompressionLevel(CompressionLevel.Maximum)），以使典型 10 页邮件的输出保持在 2 MB 以下。
  • 内存管理 – 在转换多兆字节 .msg 文件时使用 Java 的流 API 并增加 JVM 堆内存（-Xmx2g）。
  • 版本升级 – 最新的 GroupDocs.Conversion 版本相比 24.x 版将转换速度提升最高可达 30 %。

常见问题与解决方案

问题原因解决方案
大型 .msg 文件上的 OutOfMemoryError整个文件加载到内存中流式处理电子邮件内容或增加 JVM 堆大小（-Xmx2g）。
PDF 中缺少电子邮件正文displayHeader 设置为 true 而正文被隐藏确保 setDisplayHeader(false) 仅隐藏标题；正文保持可见。
许可证未被识别在生产环境使用试用密钥替换为有效的生产许可证文件或字符串。

常见问题

问：GroupDocs.Conversion for Java 是什么？
答：它是一个 Java 库，能够在超过 100 种文件格式之间进行转换，包括电子邮件到 PDF 的转换，具有高保真度且无需外部依赖。

问：如何在转换期间确保电子邮件隐私？
答：使用 EmailLoadOptions 在转换前关闭发件人、收件人以及抄送/密送地址等字段。

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

问：转换大型电子邮件的内存需求是什么？
答：分配至少 2 GB 的堆内存（-Xmx2g），并考虑批量处理文件以保持在内存限制内。

问：在哪里可以找到有关 GroupDocs.Conversion 的更多信息？
答：访问官方文档和API 参考。另请参阅GroupDocs.Conversion for Java 文档和GroupDocs.Conversion API 参考。

最后更新： 2026-05-21
测试版本： GroupDocs.Conversion 25.2
作者： GroupDocs

相关教程