如何在 Java 中使用 GroupDocs.Viewer 從 DOCX 生成 HTML

在本指南中，您將使用 GroupDocs.Viewer 在 Java 中將 DOCX 轉換為 HTML，重點僅渲染您需要的頁面。無論您是構建合約審核門戶、電子學習模組，或是報告儀表板，以下步驟將示範如何產生輕量且自包含的 HTML，直接嵌入任何 Web UI。

快速解答

  • 「渲染頁面」是什麼意思？ 將選取的文件頁面轉換為可檢視的格式，例如 HTML。
  • 產生的格式是什麼？ 含嵌入資源（圖片、CSS、字型）的 HTML。
  • 需要授權嗎？ 試用版可用於評估；正式環境需購買完整授權。
  • 可以選擇非連續頁面嗎？ 可以 – 只需指定所需的頁碼。
  • 建議使用快取嗎？ 絕對建議，快取已渲染的 HTML 可減少頻繁存取頁面的載入時間。

使用 GroupDocs.Viewer for Java 渲染文件的選取頁面

使用 GroupDocs.Viewer for Java 渲染文件的選取頁面

您將學習

  • 在 Java 環境中設定 GroupDocs.Viewer
  • 使用 Viewer API 渲染特定文件頁面
  • 為最佳顯示配置 HTML 檢視選項
  • 實務案例與整合情境

什麼是渲染選取頁面？

渲染選取頁面會從來源文件中僅提取您指定的頁面，並將每頁轉換為自包含的 HTML 檔案。這讓您只提供相關段落，減少頻寬與載入時間，同時保留版面配置、圖片與字型。

為什麼在 Java 中將 DOCX 轉換為 HTML？

在 Java 中將 DOCX 轉換為 HTML 可產生輕量、瀏覽器即時可用的表示形式，無需外部插件，適合 Web 入口網站、電子學習與報告儀表板。嵌入式資源確保頁面在所有瀏覽器上正確顯示，避免跨來源問題。

前置條件

確保您的開發環境符合以下要求：

  1. 必備函式庫 – 在專案中加入 GroupDocs.Viewer for Java（版本 25.2 或更新）。
  2. 環境 – JDK 8 以上；IDE 如 IntelliJ IDEA 或 Eclipse。
  3. 知識 – 基本的 Java 程式設計與 Maven 依賴管理。

設定 GroupDocs.Viewer for Java

GroupDocs.Viewer for Java 是一套伺服器端函式庫，可將超過 90 種文件格式（包括 DOCX、PDF、PPT）渲染為 HTML、PDF 或圖片。

透過 Maven 安裝

將儲存庫與相依性加入您的 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>

取得授權

  • 免費試用 – 無需費用即可探索全部功能。
  • 臨時授權 – 延長試用期限。
  • 正式購買 – 生產環境必須使用完整授權。

基本初始化與設定

import com.groupdocs.viewer.Viewer;

public class DocumentViewer {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
            // Your rendering logic here
        }
    }
}

如何在 Java 中使用選取頁面將 DOCX 轉換為 HTML

HtmlViewOptions 用於設定 Viewer 輸出 HTML 時的行為，包括資源嵌入與頁面佈局。
view() 依據指定的選項渲染文件，並回傳產生的檔案。

載入 DOCX 後，使用 HtmlViewOptions 設定嵌入式資源，並將頁碼清單傳入 view() 方法，即可僅渲染這些頁面為獨立的 HTML 檔案，每個檔案皆內含圖片與 CSS，快速即時顯示。

步驟 1：設定輸出路徑

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
  • 說明：outputDirectory 為產生的 HTML 檔案儲存位置。
  • 命名：page_{0}.html 會為每個渲染的頁面建立獨立檔案。

步驟 2：設定 HTML 檢視選項

HtmlViewOptions 定義 Viewer 輸出 HTML 的方式，允許嵌入資源、設定頁面大小與控制 CSS 產生。

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
  • 說明：forEmbeddedResources() 會將圖片、CSS 與字型直接打包於每個 HTML 檔案內，省去外部依賴。

步驟 3：渲染所需頁面

try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    viewer.view(viewOptions, 1, 3);
}
  • 說明：view() 方法接受 HtmlViewOptions 以及頁碼清單。本例僅渲染第一頁與第三頁。

實務應用

渲染選取頁面在多種情境下都非常實用：

  1. 法律文件 – 僅顯示合約中相關條款。
  2. 教育平台 – 讓學生預覽特定章節，無需下載整本教材。
  3. 商業報告 – 為利害關係人提供關鍵報告段落的簡潔摘要。

效能考量

  • 記憶體管理 – 如範例所示使用 try‑with‑resources 以即時釋放 Viewer 資源。
  • 快取 – 將渲染好的 HTML 存入快取（如 Redis 或記憶體）以供頻繁存取。
  • 資源最小化 – 嵌入式資源會略增檔案大小；若頻寬受限，可考慮壓縮 HTML 輸出。
  • 可擴充性 – 由於採用串流架構，GroupDocs.Viewer 可處理最高 500 頁文件，而不必一次載入整個檔案至記憶體。

常見問題與解決方案

問題解決方案
找不到檔案再次確認絕對/相對路徑，並確保檔案確實存在。
大型文件記憶體不足僅渲染所需頁面，或增大 JVM 堆積大小（-Xmx）。
HTML 中缺少圖片確認已使用 forEmbeddedResources；否則圖片會另存。
授權錯誤將有效的 GroupDocs.Viewer.lic 檔案放置於應用程式根目錄，或以程式方式指定路徑。

常見問答

Q: 什麼是 GroupDocs.Viewer for Java？
A: GroupDocs.Viewer for Java 是一套函式庫，可在 Java 應用程式中直接渲染超過 90 種文件格式（PDF、DOCX、PPT 等）。

Q: 我可以使用此方法渲染 PDF 頁面嗎？
A: 可以 – Viewer API 同時支援 PDF 以及其他多種格式。

Q: 如何有效處理大型文件？
A: 僅渲染所需頁面，並使用快取避免重複處理。

Q: 在 HTML 檔案中嵌入資源有什麼好處？
A: 每頁產生單一自包含檔案，簡化部署且不需載入外部資產。

Q: 我在哪裡可以取得更多關於 GroupDocs.Viewer for Java 的資訊？

資源

最後更新： 2026-10-05
測試版本： GroupDocs.Viewer 25.2
作者： GroupDocs

相關教學