Skip to content

_index.md

Latest commit

 

History

History
189 lines (146 loc) · 8.21 KB

_index.md

File metadata and controls

189 lines (146 loc) · 8.21 KB
date 2026-01-20
description 了解如何使用 GroupDocs.Viewer for Java 将 Excel 转换为 HTML，同时跳过空行——这是一种快速、内存高效的开发者解决方案。
keywords
GroupDocs.Viewer Java
skip rendering empty rows
Java spreadsheet to HTML
title 如何使用 GroupDocs.Viewer 在 Java 中将 Excel 转换为 HTML 并跳过空行
type docs
url /zh/java/advanced-rendering/skip-rendering-empty-rows-java-groupdocs-viewer/
weight 1

将 Excel 转换为 HTML 并在 Java 中使用 GroupDocs.Viewer 跳过空行

当您 将 Excel 转换为 HTML 时，渲染空行不仅会使输出杂乱，还会浪费 CPU 周期和内存。对于注重性能的 Java 开发者来说，在转换过程中 跳过空行 的能力可以产生显著的差异，尤其是在处理大型工作簿时。在本指南中，您将看到如何为 Java 设置 GroupDocs.Viewer，配置查看器以忽略空行，并渲染干净的 HTML 页面，使其加载更快且消耗更少的资源。

Skip Rendering Empty Rows with GroupDocs.Viewer for Java

快速答案

  • What does “convert Excel to HTML” mean? 它将 .xlsx 工作簿转换为一组可在浏览器中显示的 HTML 文件。
  • Why skip empty rows? 跳过空行可减小 HTML 大小，加快渲染速度，并提升用户体验。
  • Which library handles this? GroupDocs.Viewer for Java (v25.2+)。
  • Do I need a license? 免费试用可用于评估；生产环境需要完整许可证。
  • What Java version is required? JDK 8 或更高。

什么是 “convert Excel to HTML”？

将 Excel 工作簿转换为 HTML 意味着将每个工作表、单元格和样式转换为等效的 HTML 元素和 CSS。结果是一个适合网页的表示形式，可嵌入门户、仪表板或电子邮件报告中，而无需在客户端安装 Microsoft Office。

为什么使用 GroupDocs.Viewer 跳过行？

GroupDocs.Viewer 提供了一个高级 API，抽象了电子表格解析的底层细节。通过启用 setSkipEmptyRows(true) 选项，查看器会自动省略不包含数据的行，从而在无需额外编码的情况下为您提供更精简的 HTML 输出。

前置条件

  • GroupDocs.Viewer for Java (v25.2 或更高)。
  • Maven 已安装并配置。
  • JDK 8+ 和一个 IDE（IntelliJ IDEA、Eclipse 或 NetBeans）。
  • 对 Java 和 Maven 项目结构有基本了解。

设置 GroupDocs.Viewer for Java

Maven 配置

Add the repository and dependency to your pom.xml:

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

许可证获取

GroupDocs 提供了多种授权选项：

  • Free Trial：从 here 下载。
  • Temporary License：获取临时许可证 here 以测试完整功能集。
  • Purchase：生产使用时，通过 this link 购买许可证。

基本初始化

Create a simple Java class to instantiate the viewer:

import com.groupdocs.viewer.Viewer;
import java.nio.file.Path;

public class ViewerSetup {
    public static void main(String[] args) {
        // Initialize viewer with the path to your document
        try (Viewer viewer = new Viewer("path/to/your/document.xlsx")) {
            // Your rendering logic will go here
        }
    }
}

实现指南

如何在将 Excel 转换为 HTML 时跳过行

概述

启用 “skip empty rows” 选项可确保仅渲染包含数据的行，从而减小最终 HTML 大小并提升加载性能。

步骤 1：定义输出目录

Set the folder where the HTML files will be saved:

import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "page_{0}.html");

将 "YOUR_OUTPUT_DIRECTORY" 替换为服务器或本地机器上所需的路径。

步骤 2：配置 HtmlViewOptions

Create HtmlViewOptions to embed resources (images, CSS) directly into the HTML output:

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewInfoOptions = HtmlViewOptions.forEmbeddedResources(outputDirectory);

步骤 3：启用跳过空行

Tell the viewer to ignore blank rows during the conversion:

viewInfoOptions.getSpreadsheetOptions().setSkipEmptyRows(true);

步骤 4：渲染文档

Finally, render the workbook to HTML using the configured options:

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/Sample_XLSX_With_Empty_Row.xlsx")) {
    viewer.view(viewInfoOptions);
}

确保 "YOUR_DOCUMENT_DIRECTORY" 指向源 Excel 文件的位置。

故障排除技巧

  • Empty output — 验证源工作簿确实包含有数据的行；完全空白的工作表将不会生成 HTML。
  • Path problems — 确认 outputDirectory 存在且应用程序具有写入权限。

实际应用

在许多实际场景中，跳过空行非常有价值：

  1. Data Reporting — 从大型电子表格生成简洁的 HTML 报告，仅显示有数据的行。
  2. Dashboard Integration — 将干净的 HTML 表格嵌入网页仪表板，以实现更快的渲染。
  3. Document Conversion Services — 为客户提供不含多余空行的轻量级 Excel 文件 HTML 版本。

性能考虑

优化资源使用

  • Memory Management — 根据处理的工作簿大小调整 JVM 堆大小 (-Xmx)。
  • Batch Processing — 分批转换文件，以避免峰值内存消耗。

最佳实践

  • 保持 GroupDocs.Viewer 为最新版本，以获得性能改进。
  • 监控日志，留意不受支持的功能或格式错误的单元格的警告。

结论

您现在已经了解如何使用 GroupDocs.Viewer for Java 将 Excel 转换为 HTML 并高效 跳过空行。此方法不仅可以清理生成的 HTML，还能加快渲染速度并降低带宽消耗。探索 Viewer 的其他功能——如水印、PDF 转换或自定义样式——以构建完整的文档处理流水线。

FAQ 部分

1.格，但 GroupDocs.Viewer 也支持 Word 文档、PowerPoint 演示文稿和 PDF。
2. 如果我的电子表格包含隐藏行怎么办？

  • 隐藏行被视为文档结构的一部分；除非通过查看器选项显式隐藏，否则它们会被渲染。
  1. 跳过空行如何影响文件大小？
    • 删除空行可以将大型工作簿的 HTML 大小降低 10‑30 %，从而加快页面加载。
  2. GroupDocs.Viewer 适合企业应用吗？
    • 当然。它专为高观吗？注入自定义 CSS、更改字体或通过额外的 HtmlViewOptions 设置修改表格样式。

常见问题

Q: 开发构建是否需要许可证？
A: 免费试用可用于开发和测试，但生产部署需要付费许可证。

Q: 如何处理受密码保护的 Excel 文件？
A: 将造函数：new Viewer(filePath, password)。

Q: 我可以将多个工作表转换为单个 HTML 文件吗？
A: 默认情况下每个工作表会渲染到单独的页面；转换后您可以手动合并它们。

Q: 推荐使用哪个 Java 版本以获得最佳性能？
A: Java 11 或更高版本提供改进的垃圾回收和整体速度，尽管仍支持 Java 8。

Q: 是否有办法在写入磁盘前预览 HTML？
A: 有，使用 viewInfoOptions.setStreamOutput(true) 可将 HTML 作为流获取。

资源

最后更新： 2026-01-20
测试环境： GroupDocs.Viewer Java 25.2
作者： GroupDocs