使用 GroupDocs.Editor Java 提取 docx 圖像以編輯文件

在現代企業中，快速且可靠地 extract images docx 是自動化工作流程的關鍵。無論您需要 convert docx to html、在網頁門戶嵌入圖像，或建立 batch process word docs 流程，GroupDocs.Editor for Java 提供高效、無需 Microsoft Office 的解決方案。本指南將逐步說明您所需的一切——從環境設定到進階編輯——讓您能在幾分鐘內構建自動化報告生成的解決方案。

快速解答

  • 載入 Word 檔案的主要類別是什麼？ Editor
  • 哪個方法回傳用於編輯的 HTML 標記？ edit() returns an EditableDocument
  • 如何從 Word 文件中提取圖像？ Use getAllResources() on the EditableDocument
  • 我可以將編輯後的內容儲存回磁碟嗎？ Yes, call save() on the EditableDocument
  • 開發時需要授權嗎？ A free trial or temporary license works for testing; a full license is required for production

什麼是「extract images docx」？

Extract images docx 指的是載入 .docx 檔案，將其轉換為可編輯的 HTML 表示，並提取所有嵌入的圖像、字型或樣式表。這讓您能完整控制每個資源，便於將它們分別儲存、重新放置於 CDN，或嵌入其他文件中。

為什麼要使用 GroupDocs.Editor for Java？

GroupDocs.Editor 提供完整的功能集，使其成為企業級文件處理的理想選擇。它支援超過 30 種輸入與輸出格式，能處理高達 500 MB 的檔案而不需將整個文件載入記憶體，並提供簡單的 Java API，易於與現有應用程式整合。

  • 完整的 Word 支援 – 無需 Microsoft Office 即可編輯、提取與轉換。
  • 無縫的 HTML 轉換 – 非常適合基於 Web 的編輯器或 CMS 整合。
  • 強大的資源處理 – 一次呼叫即可取得圖像、字型與 CSS。
  • 可擴展的效能 – 適用於批次處理與大規模報告生成。
  • 便利的 Java API – 可自然地與 Java 8+ 及主流 IDE 搭配使用。

先決條件

  • Java Development Kit (JDK) 8 或更新版本。
  • 如 IntelliJ IDEA 或 Eclipse 等 IDE。
  • 基本的 Java 知識與 Maven 使用經驗。

必需的函式庫

在專案中加入 GroupDocs.Editor 函式庫。使用 Maven 將其作為相依性加入：

<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 下載最新版本。

授權取得

要使用 GroupDocs.Editor，您可以先使用免費試用、申請臨時授權，或購買正式授權。此函式庫即開即用，評估後只需更新授權檔案即可切換至正式授權。

如何使用 GroupDocs.Editor Java 建立可編輯文件？

Editor 類別負責載入文件並提供編輯功能，而 EditableDocument 代表以可編輯 HTML 形式載入的檔案。兩者結合可實現簡單的端對端工作流程，用於提取資源、修改內容與儲存變更。

直接答案

使用 .docx 檔案路徑實例化 Editor 類別，呼叫 edit() 取得 EditableDocument，依需求修改 HTML，最後呼叫 save() 以持久化變更。此端對端流程讓您能在幾行 Java 程式碼內提取圖像、編輯內容並重新產生文件。

安裝

  1. Add Dependency – 確保 pom.xml 包含上述的 Maven 片段。
  2. Download JAR – 若您偏好手動設定，請從官方 GroupDocs site 下載最新的 JAR。
  3. Configure License – 將您的 GroupDocs.Editor.lic 檔案放置於 resources 資料夾，或以程式方式設定。

基本初始化

Editor 是 GroupDocs.Editor Java 的核心類別，用於載入、編輯與儲存文件。

import com.groupdocs.editor.Editor;

// Initialize Editor with a sample Word document
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx");

這行簡單的程式碼即可提供完整功能的編輯器，能載入、編輯與儲存文件。

逐步指南

步驟 1：將文件載入為 EditableDocument

EditableDocument 代表已載入的 Word 檔案，以可編輯的 HTML 形式呈現。

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;

// Load the document into an EditableDocument
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx");
EditableDocument beforeEdit = editor.edit();
  • Editor – 處理檔案 I/O 與格式偵測。
  • EditableDocument – 提供 HTML 標記與資源存取。

步驟 2：編輯 Word 內容（如何編輯 word）

您現在可以操作 HTML 字串、替換佔位符或更新樣式。變更完成後，呼叫 save() 以持久化。

步驟 3：提取圖像與其他資源

GroupDocs.Editor 讓您輕鬆提取所有嵌入的資源，這正是 extract images docx 的做法。

import com.groupdocs.editor.htmlcss.resources.IHtmlResource;
import java.util.List;

// Extract embedded HTML, images, fonts, and CSS
String allAsHtmlInsideOneString = beforeEdit.getEmbeddedHtml();
List<IHtmlResource> allResources = beforeEdit.getAllResources();

// Accessing specific resources
List<String> stylesheets = beforeEdit.getCssContent();
  • getEmbeddedHtml() – 回傳完整的 HTML 標記。
  • getAllResources() – 提供原始 Word 檔案中所有嵌入的圖像、字型或樣式表的清單。getAllResources() 方法回傳所有嵌入資源（如圖像與字型）的清單。
  • extract images from word – 只需遍歷 allResources 以取得 ImageResource 類型的物件。

步驟 4：調整 HTML 標記中的外部連結

如果文件中包含需指向自訂處理程式（例如 CDN）的連結，您可以即時重新寫入。

String customImagesRequesthandlerUri = "http://example.com/ImagesHandler/id=";
String htmlMarkup = beforeEdit.getContentString(customImagesRequesthandlerUri);
  • getContentString() – 為所有圖像參考注入提供的 URI 前綴，讓您能控制圖像的提供位置。getContentString() 方法回傳帶有可選 URI 前綴的 HTML，用於資源連結。

步驟 5：將編輯後的文件儲存至磁碟

完成所有編輯與資源調整後，將結果寫回 HTML 檔案（或稍後重新轉換為 DOCX）。

// Save the edited document as an HTML file
beforeEdit.save("YOUR_OUTPUT_DIRECTORY/output.html");
  • save() – 將編輯後的 HTML 及任何相關資源持久化至指定資料夾。save() 方法將編輯後的 HTML 與資源寫入輸出位置。

步驟 6：檢查釋放狀態

適當的資源管理至關重要，尤其在 batch process word docs 時。

String res = !beforeEdit.isDisposed() ? "not" : "already";
  • isDisposed() – 若文件的原生資源已釋放則回傳 true。isDisposed() 方法表示文件資源是否已被釋放。完成後務必釋放大型文件。

步驟 7：從 HTML 建立 EditableDocument

您也可以從現有的 HTML 檔案或原始標記開始，這在 convert docx to html 情境中相當方便。

import com.groupdocs.editor.EditableDocument;

// Create EditableDocument from file and markup
EditableDocument afterEditFromFile = EditableDocument.fromFile("YOUR_OUTPUT_DIRECTORY/output.html");
EditableDocument afterEditFromMarkup = EditableDocument.fromMarkup(htmlMarkup, allResources);
  • fromFile() – 載入先前由 save() 儲存的 HTML 檔案。
  • fromMarkup() – 直接從字串及其資源清單建立 EditableDocument。

如何使用 GroupDocs.Editor 將 Word 轉換為 HTML？

使用 Editor 載入 .docx，呼叫 edit()，再透過 getEmbeddedHtml() 或 getContentString() 取得 HTML，即可產生忠實的 HTML 表示。getEmbeddedHtml() 方法回傳文件的完整 HTML 標記，保留版面、字型與圖像，您可將其嵌入網頁、電子郵件，或儲存以供日後使用。

使用 GroupDocs.Editor 批次處理 Word 文件

當您需要處理數十或數百個範本時，可將上述步驟包裝於迴圈或 CompletableFuture 流程中。此方式讓您能同時處理多個檔案，同時保持低記憶體使用。請記得在每個文件處理完畢後呼叫 dispose()（或讓 GC 處理）以降低記憶體佔用。dispose() 方法釋放文件使用的原生資源。

常見問題與解決方案

  • Large documents cause OutOfMemoryError – 以串流方式處理資源，而非一次載入全部至記憶體；完成後立即釋放每個 EditableDocument。
  • Images not appearing after conversion – 確保將正確的 URI 前綴傳遞給 getContentString()，或將提取的資源複製至目標資料夾。
  • License not recognized – 檢查 GroupDocs.Editor.lic 檔案是否在 classpath 上，或在建立 Editor 前以程式方式設定授權。

常見問答

Q: 我可以使用 GroupDocs.Editor Java 編輯 PDF 嗎？
A: 可以，GroupDocs.Editor 支援包括 PDF 在內的多種格式。請參閱 API reference 了解具體方法。

Q: 我該如何有效處理大型文件？
A: 使用資源管理技巧，例如及時釋放 EditableDocument 實例，並以 Java 的 CompletableFuture 並行處理檔案。

Q: GroupDocs.Editor 是否相容所有 Java IDE？
A: 可以，支援如 IntelliJ IDEA 與 Eclipse 等主流 IDE。

Q: 在處理大量檔案時，extract images docx 的最佳方法是什麼？
A: 迭代 EditableDocument.getAllResources()，篩選出 ImageResource 物件；將它們儲存於專用資料夾或即時上傳至 CDN。

Q: 我可以將編輯後的 HTML 轉回 DOCX 檔案嗎？
A: 當然可以。saveAsDocx() 方法會將編輯後的 HTML 轉回 DOCX 檔案。完成變更後使用 EditableDocument.saveAsDocx("path/to/output.docx")。

最後更新： 2026-07-26
測試環境： GroupDocs.Editor 25.3 for Java
作者： GroupDocs

{< /blocks/products/pf/tutorial-page-section >} {< /blocks/products/pf/main-container >} {< /blocks/products/pf/main-wrap-class >} {< blocks/products/products-backtop-button >}

相關教學