如何使用 GroupDocs.Editor for Java 从 Word 文档中提取资源

如果您正在寻找 如何从 Word 文件中以编程方式提取资源，那么您来对地方了。在本指南中，我们将演示如何在 Java 中加载 Word 文档、编辑它，并提取图像、字体和 CSS——正是您自动化文档处理流水线所需的步骤。

您将学习：

• 如何使用 GroupDocs.Editor load word document java
• 如何 extract images java 以及其他嵌入资产
• 如何 extract css java 以便样式复用
• 将这些资源保存到磁盘的最佳实践方法
• 提取资源可节省时间和精力的真实场景

准备好简化您的文档工作流了吗？让我们开始吧！

快速答案

• “how to extract resources” 是什么意思？ 它指的是以编程方式从 Word 文件中提取图像、字体、CSS 等资源。
• 哪个库在 Java 中处理此功能？ GroupDocs.Editor for Java。
• 我需要许可证吗？ 免费试用可用于测试；生产环境需要完整许可证。
• 我可以处理 DOCX 和 DOC 文件吗？ 可以，两者均受支持。
• 处理大型文档安全吗？ 可以，但请考虑批处理和适当的内存释放。

什么是 Word 文档中的资源提取？

资源提取是指从 Word 文件中检索嵌入的项目——如图片、定制字体和样式表——以便它们可以被复用、归档或转换用于其他应用程序的过程。

为什么使用 GroupDocs.Editor for Java？

GroupDocs.Editor 提供了一个高级 API，抽象了 Office Open XML 格式的复杂性。它让您专注于 how to extract resources，而无需处理底层的 ZIP 操作或 XML 解析。

前置条件

• Maven（或直接下载 JAR）用于管理依赖。
• JDK 8+ 已在开发机器上安装。
• 一个 IDE，例如 IntelliJ IDEA 或 Eclipse，用于编辑和运行 Java 代码。

设置 GroupDocs.Editor for Java

将仓库和依赖添加到您的 pom.xml：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/editor/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

您也可以从 GroupDocs.Editor for Java releases 下载最新的 JAR。

获取许可证

• 免费试用： 适合探索 API。
• 临时许可证： 可从 GroupDocs Temporary License Page 获取。
• 完整许可证： 购买后可在生产环境中无限制使用。

基本初始化

创建一个指向 Word 文件的 Editor 实例：

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());

如何从 Word 文档中提取资源

下面我们将实现分为三个逻辑步骤：加载/编辑、提取和保存。

步骤 1：加载并准备文档进行编辑

// Initialize editor and edit options
String inputFilePath = "YOUR_DOCUMENT_DIRECTORY";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setFontExtraction(FontExtractionOptions.ExtractAll);
EditableDocument beforeEdit = editor.edit(editOptions);

FontExtractionOptions.ExtractAll 标志确保每个嵌入的字体都可用于提取。

步骤 2：提取图像、字体和样式表

List<IImageResource> images = beforeEdit.getImages();

List<FontResourceBase> fonts = beforeEdit.getFonts();

List<CssText> stylesheets = beforeEdit.getCss();

这三个调用为您提供了每种资源类型的集合，准备进行后续处理。

步骤 3：将提取的资源保存到磁盘

String outputFolderPath = "YOUR_OUTPUT_DIRECTORY";
for (int i = 0; i < images.size(); i++) {
    IImageResource oneImage = images.get(i);
    File outputFile = new File(outputFolderPath + oneImage.getFilenameWithExtension());
    oneImage.save(outputFile.getAbsolutePath());
}

for (int i = 0; i < fonts.size(); i++) {
    FontResourceBase oneFont = fonts.get(i);
    File outputFile = new File(outputFolderPath + oneFont.getFilenameWithExtension());
    oneFont.save(outputFile.getAbsolutePath());
}

for (int i = 0; i < stylesheets.size(); i++) {
    CssText oneStylesheet = stylesheets.get(i);
    File outputFile = new File(outputFolderPath + oneStylesheet.getFilenameWithExtension());
    oneStylesheet.save(outputFile.getAbsolutePath());
}

每个循环将相应的资源写入 outputFolderPath，并保留原始文件名。

步骤 4：直接获取资源内容（可选）

如果您需要原始字节或 Base64 字符串——例如，将图像嵌入 HTML 邮件中——请使用：

InputStream ms = images.get(0).getByteContent(); // raw bytes
String base64EncodedResource = images.get(0).getTextContent(); // Base64 string

常见问题及解决方案

常见问题

Q: GroupDocs.Editor 是否兼容所有 Word 文件格式？
A: 是的，它支持 DOCX、DOC 以及其他 Microsoft Word 格式。

Q: 我可以从受密码保护的文档中提取资源吗？
A: 当然可以。在创建 Editor 时通过 WordProcessingLoadOptions 提供密码。

Q: API 在处理非常大的文档时表现如何？
A: 它已针对速度进行优化，但对于超大文件，我们建议将文档拆分或顺序处理各章节。

Q: 我可以将其与 Spring Boot 或其他 Java 框架集成吗？
A: 可以。该 API 与框架无关，只需加入依赖并在需要的地方注入 Editor。

Q: 如果我只需要提取图像而不提取字体或 CSS，该怎么办？
A: 只调用 beforeEdit.getImages()，并跳过字体/CSS 提取步骤。

结论

现在，您已经拥有了使用 GroupDocs.Editor for Java 从 Word 文档中 how to extract resources 的完整、可用于生产的操作指南。通过加载文档、配置编辑选项并遍历返回的资源集合，您可以轻松实现归档、模板创建和动态内容生成的自动化。

后续步骤：

• 尝试不同的 WordProcessingEditOptions 以微调提取。
• 将此工作流与云存储 SDK 结合，直接将资源上传至 S3 或 Azure Blob。
• 探索 GroupDocs 转换 API，将提取的资产转换为其他格式。

最后更新： 2026-02-16
测试环境： GroupDocs.Editor 25.3 for Java
作者： GroupDocs