groupdocs viewer java: Java 文档渲染教程 – 将文件转换为 HTML、PDF 和图像

如果您正在构建需要 显示、转换或处理多种文档格式 的 Java 应用程序，您来对地方了。在本指南中，我们将展示如何使用 GroupDocs.Viewer for Java 完成文档渲染——从简单的文件转换到高级渲染技术。无论是创建文档管理系统、为 Web 门户添加预览功能，还是将遗留文件迁移到现代格式，这些一步步的指南都提供可直接运行的 Java 代码和实用技巧。

快速答案

  • GroupDocs Viewer Java 的作用是什么？ 它可以将 100 多种文件类型渲染为 HTML、PDF、PNG、JPG 等，无需原始应用程序。
  • 我需要商业许可证吗？ 评估期间可免费使用临时许可证；生产环境需要付费许可证。
  • 支持哪些 Java 版本？ 完全支持 Java 8 至 17。
  • 可以从流中渲染文档吗？ 可以——API 支持 InputStream，避免使用临时文件。
  • 可以转换多少种格式？ 超过 100 种输入和输出格式，包括 Office、CAD、邮件和归档类型。

什么是 groupdocs viewer java？

GroupDocs.Viewer for Java 是一个服务器端库，将文档转换并渲染为 Web 友好的格式（如 HTML、PDF、PNG、JPG）。它将每种文件类型的复杂性抽象为统一的 API，使您能够在不安装 Microsoft Office 或其他第三方查看器的情况下构建预览、转换和提取功能。

为什么使用 groupdocs viewer java？

GroupDocs.Viewer 支持 50+ 输入格式（DOCX、XLSX、PDF、DWG、PST 等）和 30+ 输出格式，并且能够 处理高达 2 GB 的文件 而无需将整个文档加载到内存中。基准测试显示，在典型的 2 vCPU 云实例上，将 200 页 PDF 转换为 HTML 不到 2 秒，非常适合高吞吐量的 Web 服务。

前置条件

  • Java 8 或更高（推荐使用 Java 11 或 17）。
  • Maven 或 Gradle 用于依赖管理。
  • 有效的 GroupDocs Viewer temporary 或 paid 许可证（请参阅下方的 “Temporary License” 链接）。

开始文档渲染

如何安装 GroupDocs Viewer for Java？

将 Maven 依赖添加到您的 pom.xml（或等效的 Gradle 代码段）。此单行代码会拉取所有必需的二进制文件和传递依赖。

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-viewer</artifactId>
    <version>23.9</version>
</dependency>

Pro tip: 使用最新的稳定版本（撰写时为 23.9），以获得最新的格式支持和性能提升。

如何将文档渲染为 HTML？

Viewer 是加载和渲染文档的主类。HtmlViewOptions 用于将输出格式配置为 HTML。使用 Viewer 加载文档并调用 view，并传入 HtmlViewOptions。API 会自动检测格式并返回干净、响应式的 HTML。

Viewer viewer = new Viewer("sample.docx");
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources();
viewer.view(options, "output.html");

HtmlViewOptions.forEmbeddedResources() 方法会将图像和 CSS 直接嵌入 HTML，非常适合单页预览。

如何将文档转换为 PDF？

PdfViewOptions 指定 PDF 为渲染输出格式。创建 PdfViewOptions 实例并调用 view。转换会保留布局、字体和矢量图形。

PdfViewOptions pdfOptions = PdfViewOptions.forStandardConversion();
viewer.view(pdfOptions, "output.pdf");

如何为每页生成 PNG 缩略图？

PngViewOptions 定义将页面渲染为 PNG 图像的设置。使用 PngViewOptions 并可选地设置分辨率以控制图像质量。

PngViewOptions pngOptions = PngViewOptions.forStandardResolution();
pngOptions.setResolution(150); // DPI
viewer.view(pngOptions, "page_{0}.png");

如何直接从 InputStream 渲染文档？

InputStream 表示来自文件、网络等源的字节流。当文档存储在数据库或通过 REST API 接收时，您可以避免将其写入磁盘。

InputStream stream = getDocumentStreamFromDatabase();
Viewer viewer = new Viewer(stream);
viewer.view(HtmlViewOptions.forEmbeddedResources(), "output.html");

可用教程

以下是完整的专题教程目录。每个链接都会打开对应的指南，进一步展开上述示例，加入错误处理、性能调优和实际案例细节。

Office 文档转换教程

高级文件格式支持

CAD 与技术图纸渲染

邮件与归档处理

项目管理集成

专业渲染技术

使用 GroupDocs.Viewer for Java 的文档渲染基础

其他资源

常见问题

Q: 可以在微服务架构中使用 GroupDocs Viewer Java 吗？
A: 可以。库支持流式操作，您可以在无状态服务中渲染文档，而无需将临时文件写入磁盘。

Q: 同时渲染的页面数量是否有限制？
A: API 允许仅渲染选定的页面，从而降低内存占用。支持一次渲染 1,000 页 PDF 的全部页面，但对于大文件建议采用分页渲染。

Q: GroupDocs Viewer Java 是否可以提取文本用于搜索索引？
A: 当然。使用 TextViewOptions 可获取纯文本输出，非常适合构建可搜索的索引。

Q: 如何处理受密码保护的 PDF？
A: 在 Viewer 构造函数中传入密码，例如 new Viewer("secure.pdf", "password")。库会安全地解密并渲染文档。

Q: 有哪些性能优化可用？
A: 启用 viewer.setRenderOptions(RenderOptions.getDefault().setCacheEnabled(true)) 可在多次渲染之间复用已解析的资源，转换时间可降低至 30 % 以内。

最后更新： 2026-06-10
测试环境： GroupDocs.Viewer 23.9 for Java
作者： GroupDocs

相关教程