translations.

如何使用 GroupDocs.Conversion for Java 将受密码保护的 Word 文档转换为 Excel

将受密码保护的 Word 文档转换为 Excel 电子表格是当您想要以表格形式分析或共享数据时的常见需求。在本教程中,您将学习 如何将受密码保护的 Word 文件转换为 Excel,使用 GroupDocs.Conversion API for Java,逐步操作。

快速答案

  • 我可以在没有密码的情况下转换受保护的 Word 文件吗? 否 – 必须通过加载选项提供正确的密码。
  • 电子表格支持哪些输出格式? 支持 XLS、XLSX、CSV 和 ODS。
  • 生产环境需要许可证吗? 是的,非试用部署需要有效的 GroupDocs 许可证。
  • Java 8 足够吗? 支持 Java 8 及以上版本;更新的版本同样可用。
  • 我可以只转换特定页面吗? 当然可以 – 在转换选项中使用 setPageNumbersetPagesCount

什么是 “convert password protected word”?

该短语指的是打开受密码保护的 Word 文档并将其内容转换为另一种文件类型——此处为 Excel 电子表格的过程。这对于数据提取、报告和自动化工作流非常有用。

为什么使用 GroupDocs.Conversion for Java?

GroupDocs.Conversion 提供了高级、语言原生的 API,能够处理复杂格式、密码保护和细粒度的转换设置,无需外部工具。它可靠、文档完善,并能平滑集成到 Java 应用程序中。

前提条件

  • 库和依赖项: GroupDocs.Conversion for Java(通过 Maven 添加)。
  • 环境: JDK 8+ 和 IntelliJ IDEA 或 Eclipse 等 IDE。
  • 知识要求: 基础 Java 编程、文件 I/O 和 API 使用。

设置 GroupDocs.Conversion for Java

Maven 安装

在您的 pom.xml 中添加仓库和依赖项:

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

获取许可证

首先从 GroupDocs 网站获取免费试用。若需完整访问,请购买许可证或申请临时许可证。

如何在 Java 中加载受密码保护的文档

加载受密码保护的文档需要一个包含密码的 load options 对象。此步骤会解锁文件,以便转换器读取其内容。

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

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("12345"); // Replace with your document's password.

说明: WordProcessingLoadOptions 专为 Word 文件设计。通过调用 setPassword,您授予 API 打开受保护文档的权限。

Java 将 Word 转换为电子表格 – 高级选项

文档加载后,您可以定义转换的行为——选择页面、格式和视觉缩放。

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.SpreadsheetFileType;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
options.setPageNumber(2); // Start from page 2.
options.setPagesCount(1); // Convert only one page.
options.setFormat(SpreadsheetFileType.Xls); // Output format as XLS.
options.setZoom(150); // Set zoom level for conversion (scale factor).

说明:

  • setPageNumbersetPagesCount 允许您定位特定页面范围,当只需文档的子集时非常方便。
  • setFormat 选择电子表格容器(此例为 XLS)。
  • setZoom 调整渲染比例,有助于保持布局的忠实度。

执行转换

准备好加载和转换选项后,调用 convert 方法。API 在后台处理繁重的工作。

String convertedFile = Constants.getConvertedPath("ConvertToSpreadsheetWithAdvancedOptions.xls");
Converter converter = new Converter(Constants.SAMPLE_DOCX_WITH_PASSWORD, () -> loadOptions);
converter.convert(convertedFile, options);

说明: Converter 构造函数接收源文件路径以及提供先前定义的 loadOptions 的 lambda。convert 调用将 Excel 文件写入 Constants.getConvertedPath 返回的位置。

常见问题及解决方案

症状可能原因解决方案
“Invalid password” 异常密码字符串错误或编码问题验证密码,确保没有多余的空格,并使用完全相同的大小写。
输出中缺少页面setPageNumber/setPagesCount 值不正确再次检查源 Word 文件中的页码;记住页码是从 1 开始的。
大文件导致内存不足错误将整个文档加载到内存中分块处理大文件或增大 JVM 堆大小(-Xmx)。
不支持的格式错误使用了较旧的 GroupDocs 版本升级到最新库(例如 25.2)。

实际应用

  1. 数据管理: 将月度报告转换为 Excel,以进行透视表分析。
  2. 文档归档: 将旧版 Word 文件存储为电子表格,以便更轻松查询。
  3. 工作流自动化: 将转换嵌入批处理作业,以准备下游系统所需的数据。

性能考虑

  • 在处理大量文档时复用单个 Converter 实例,以减少开销。
  • 及时关闭流(try‑with‑resources)以释放本机资源。
  • 仅在必要时调整 setZoom;更高的缩放值会增加 CPU 负载。

结论

现在,您已经掌握了一套完整的、可用于生产环境的 convert password protected word 文档转换为 Excel 电子表格的方法,使用 GroupDocs.Conversion for Java。将这些代码片段集成到您的应用中,调整选项以符合业务规则,您将前所未有地简化数据提取。

后续步骤

  • 尝试其他电子表格格式(XLSX、CSV)。
  • 通过遍历受保护文件的目录来实现批量转换。
  • 查看 GroupDocs 的其他功能,如 PDF 的水印或 OCR。

常见问题解答

  1. GroupDocs.Conversion 在 Java 中的主要用例是什么?
    GroupDocs.Conversion 允许开发者在各种格式之间转换文档,适用于数据管理和工作流自动化任务。
  2. 如何在文档转换期间处理错误?
    确保满足所有前提条件,包括正确的依赖项和文件路径。使用 Java 的异常处理机制来管理潜在问题。
  3. GroupDocs.Conversion 能处理文档批量处理吗?
    可以,通过在循环中处理多个文件来扩展 API 的批量转换功能。
  4. 可以使用此 API 转换受密码保护的 PDF 吗?
    虽然本教程侧重于 Word 文档,但 GroupDocs.Conversion 支持多种文件类型,包括使用相应加载选项的受密码保护的 PDF。
  5. 如何在转换大文件时优化内存使用?
    通过分块处理文件并利用 Java 工具确保高效的垃圾回收来进行优化。

资源


最后更新: 2026-03-08
测试版本: GroupDocs.Conversion 25.2 for Java
作者: GroupDocs