如何使用 GroupDocs Viewer for Java 将 PST 转换为 HTML

Outlook PST 文件可能包含成千上万的邮件，导致提取所需信息变得困难。在本教程中，您将学习如何使用 GroupDocs Viewer for Java convert PST to HTML，通过文本或发件人/收件人过滤，并在多千兆字节邮箱中保持低内存使用。完成后，您将拥有一个可直接运行的解决方案，仅将相关邮件转换为干净的 HTML 页面。

Outlook Data Rendering and Filtering with GroupDocs.Viewer for Java

Outlook Data Rendering and Filtering with GroupDocs.Viewer for Java

快速答案

  • 本教程涵盖什么？ 使用 GroupDocs Viewer for Java 渲染和过滤 Outlook PST 文件，然后将其转换为 HTML。
  • 需要哪个库版本？ GroupDocs.Viewer for Java 25.2 或更高。
  • 我需要许可证吗？ 免费试用或临时许可证可用于测试；生产使用需要完整许可证。
  • 我可以只渲染特定的电子邮件吗？ 可以——使用内置的过滤 API 按主题、发件人或内容选择邮件。
  • 这适用于大型 PST 文件吗？ 绝对适用——过滤器让您只处理所需项目，保持内存消耗低。

什么是将 PST 转换为 HTML？

Convert PST to HTML 是指将 Outlook PST（个人存储表）文件中的电子邮件消息输出为 HTML 文档，以便在任何网页浏览器中显示。此转换保留格式、附件和内嵌图像，同时使内容可搜索并易于嵌入 Web 应用程序。

为什么使用 GroupDocs Viewer for Java 来渲染 Outlook 数据？

GroupDocs Viewer for Java 能直接渲染 Outlook PST 文件，无需安装 Microsoft Outlook。它支持 over 100 file formats，通过流式处理可处理高达数千兆字节的 PST 文件，并提供内置的过滤 API，让您仅提取关心的邮件。这些功能相比将整个邮箱加载到内存中，可将处理时间缩短最多 70 %。

前提条件

  • GroupDocs.Viewer for Java 版本 25.2 或更高（可通过 Maven 获取）
  • 已安装 Maven 以管理依赖
  • 在开发机器上已安装 Java 8 或更高版本
  • 基本熟悉 Java 语法和面向对象概念

设置 GroupDocs Viewer for Java

首先在您的 pom.xml 中添加 Maven 依赖：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

获取许可证

先使用免费试用或请求临时许可证以探索完整功能集。商业部署需要永久许可证。

基本初始化和设置

Viewer 类是所有渲染操作的入口；它加载文档、应用选项并生成输出。

import com.groupdocs.viewer.Viewer;
// Initialize the Viewer object with the path to your Outlook data file.
Viewer viewer = new Viewer("path/to/your/outlook/file.pst");

实施指南

现在环境已准备就绪，让我们逐步演示如何过滤和渲染 Outlook 数据文件。

按文本或发件人/收件人渲染和过滤消息

概述

此功能让您仅渲染匹配特定关键字、发件人地址或收件人地址的消息，从而节省时间和内存。

设置 HTML 视图选项

HTML 视图选项控制输出的格式，包括 CSS 样式和图像处理方式。

import com.groupdocs.viewer.options.HtmlViewOptions;
// Set up the output directory path
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
// Configure HTML view options to specify where rendered content should be saved.
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(outputDirectory.resolve("output.html").toString());

应用过滤器

OutlookOptions 类配置 Outlook 项目的渲染并包含过滤设置。
您可以使用 OutlookOptions 过滤 API 按主题、发件人或正文内容进行过滤。过滤在 PST 流式传输时运行，仅将匹配的项目加载到内存中。

// Create a filter for the viewer
viewOptions.setFilter((item, options) -> {
    // Example: Filter emails containing "Project" in their subject
    return item.getDocumentInfo().getSubject().contains("Project");
});

渲染文件

配置好选项和过滤器后，调用 view 方法为每封匹配的邮件生成 HTML 文件。

// Render the PST file to HTML with applied filters.
viewer.view(viewOptions);

常见问题及解决方案

  • 权限错误 – 确保应用程序对 PST 文件具有读取权限，对输出文件夹具有写入权限。
  • 缺少依赖 – 再次检查所有 Maven 坐标是否正确，并刷新项目的依赖缓存。
  • 大型 PST 性能 – 使用过滤器限制处理的项目数量，并在查看器选项中启用流式模式。

实际应用

  1. 电子邮件归档 – 自动提取并渲染与项目相关的电子邮件以进行长期存储。
  2. 合规审计 – 提取包含受监管关键字的邮件以进行法律审查。
  3. 数据迁移 – 在导入 CRM 或工单系统之前，将过滤后的 PST 内容转换为 HTML。

集成可能性

您可以将此逻辑嵌入 Spring Boot REST 接口、处理上传 PST 的后台工作者，或使用 JavaFX 构建的桌面工具中。

性能考虑因素

  • 资源优化 – 当仅需要元数据时，激活 OutlookOptions.setLoadOnlyHeaders(true)，显著降低 RAM 使用。
  • 内存管理 – 每个渲染任务后关闭 Viewer 实例，如果批量处理许多大文件，调用 System.gc()。

结论

您现在拥有一套完整的、可投入生产的 convert PST to HTML 方案，使用 GroupDocs Viewer for Java，并可通过发件人、收件人或文本进行强大过滤。将这些模式应用于简化邮件处理、满足合规要求或将数据输送至下游系统。

常见问题

Q: 使用 GroupDocs Viewer for Java 的主要目的是什么？
A: 它使开发者能够在 Java 应用程序中直接渲染和过滤包括 Outlook PST 文件在内的多种文件格式，无需外部软件。

Q: 我可以在不购买许可证的情况下使用此库吗？
A: 可以，免费试用或临时许可证可让您评估所有功能；生产部署需要完整许可证。

Q: 如何高效处理大型 PST 文件？
A: 使用过滤器仅处理所需邮件，启用流式模式，并及时关闭 Viewer 实例以释放内存。

Q: 支持的文件格式是否有限制？
A: GroupDocs Viewer 支持超过 100 种格式，包括 PST、MSG、EML、DOCX、PDF 和图像类型；请始终参考最新文档获取确切版本支持信息。

Q: 我在哪里可以获得更多支持？
A: 访问 GroupDocs 论坛 获取社区帮助，或查阅下方官方文档链接。

资源

最后更新： 2026-09-20
测试环境： GroupDocs.Viewer for Java 25.2（或更高）
作者： GroupDocs

相关教程