如何使用 GroupDocs.Viewer for Java 將文件轉換為 HTML

在當今的數位環境中，您常常需要 將文件轉換為 HTML，以便能即時在任何網頁瀏覽器中顯示，且不需要額外的外掛程式或軟件。GroupDocs.Viewer for Java 透過載入本機檔案、將每頁渲染為自包含的 HTML，並將所有必要的資源（圖片、CSS、字型）直接嵌入輸出中，使此轉換變得簡單直觀。本教學將帶您完整了解工作流程——從 Maven 設定到渲染選項——讓您能在數分鐘內開始提供即時可在網頁上顯示的文件。

Load and Render Documents as HTML with GroupDocs.Viewer for Java

Load and Render Documents as HTML with GroupDocs.Viewer for Java

快速答案

  • 將 DOCX 轉換為 HTML 最快的方法是什麼？ 使用 Viewer 搭配 HtmlViewOptions.forEmbeddedResources() —— 它會一次性渲染完成。
  • 在正式環境中需要授權嗎？ 是的，商業授權會移除評估限制並解鎖完整 API 功能。
  • 我能渲染大於 200 MB 的 PDF 嗎？ GroupDocs 會逐頁處理大型檔案，因此即使是數百頁的 PDF，記憶體使用量仍保持在低水平。
  • 可以從網路共享載入檔案嗎？ 當然可以——只需提供 UNC 路徑或使用 FileInputStream。
  • 需要哪個版本的 Java？ Java 8 或以上；此函式庫相容於 Java 11、17 以及更新的 LTS 版本。

什麼是「將文件轉換為 HTML」？

將文件轉換為 HTML 是將原生檔案格式（DOCX、PDF、PPTX 等）轉換為瀏覽器可直接渲染的標準 HTML 標記的過程。產生的 HTML 通常是自包含的，意味著圖片、字型與樣式皆已嵌入，允許無需額外資源即可順暢檢視。

為什麼使用 GroupDocs.Viewer for Java 來將文件轉換為 HTML？

GroupDocs.Viewer 支援 超過 50 種輸入格式，且在標準伺服器上，對於一般 10 頁文件，可在 2 秒內將每頁渲染為獨立的 HTML 檔案。它亦提供 零相依性渲染——不需要 Microsoft Office 或 Adobe 產品——因此非常適合對授權限制有顧慮的雲端原生或本地部署環境。

前置條件

  • GroupDocs.Viewer for Java ≥ 25.2（可透過 Maven 取得）。
  • 已安裝 Java 8+ 開發工具包。
  • 具備 Java 檔案 I/O 與 Maven 專案結構的基本認識。

必要的函式庫與相依性

  • com.groupdocs:groupdocs-viewer:25.2（或更新版本）

環境設定需求

  • 您選擇的 IDE（IntelliJ IDEA、Eclipse、VS Code 等）。
  • 能存取來源文件所在的本機檔案系統。

知識前提

  • 了解 Java 路徑（Path、Files）。
  • 基本的 HTML 概念（標籤、嵌入資源）。

設定 GroupDocs.Viewer for Java

Maven 設定

在您的 pom.xml 檔案中加入以下相依性：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-viewer</artifactId>
    <version>25.2</version>
</dependency>

定義說明： groupdocs-viewer Maven 套件包含載入、解析及將文件渲染為 HTML、PDF 或影像格式所需的所有類別。

取得授權

License 類別會驗證您的產品金鑰，並為 JVM 會話解鎖完整的 API 功能。

GroupDocs.Viewer 提供三種授權模式：

  • 免費試用 – 支援所有格式，單文件限制 10 頁。
  • 臨時授權 – 30 天完整功能授權，用於 CI 管線測試。
  • 商業授權 – 按開發者或按伺服器授權，移除所有評估限制，並提供高級支援。

在應用程式啟動時套用您的授權金鑰：

com.groupdocs.viewer.License license = new com.groupdocs.viewer.License();
license.setLicense("YOUR_LICENSE_PATH_OR_STRING");

定義說明： License 類別驗證您的產品金鑰，並為當前 JVM 會話解鎖完整的 API 功能。

實作指南

載入與渲染文件

Viewer 是用於載入與渲染文件的主要類別。

本節說明如何載入本機檔案並以嵌入資源的方式渲染為 HTML。

步驟 1：使用佔位符定義路徑

設定來源文件路徑以及寫入 HTML 檔案的輸出目錄。

定義說明： Path 物件以平台無關的方式表示檔案系統位置。

步驟 2：設定檔案格式與檢視選項

HtmlViewOptions 設定文件渲染為 HTML 的方式。

設定檢視器，使其每頁產生一個 HTML 檔案，並嵌入所有資產。

定義說明： HtmlViewOptions.forEmbeddedResources() 告訴檢視器將圖片、CSS 與字型直接內嵌至每個 HTML 頁面，消除外部相依性。

步驟 3：使用 GroupDocs Viewer 載入並渲染文件

建立 Viewer 實例，載入文件，並以先前定義的選項呼叫 view 方法。

定義說明： Viewer 類別是渲染的入口點；它接受 File 或 InputStream，並根據提供的檢視選項產生輸出。

如何使用 GroupDocs.Viewer 將 Word 文件轉換為 HTML？

使用 new Viewer(new File("sample.docx")) 載入 DOCX，然後呼叫 viewer.view(htmlOptions)。函式庫會自動提取樣式、表格與圖片，並嵌入至產生的 HTML 頁面。此兩步驟流程確保原始 Word 檔案的視覺忠實度在瀏覽器中得以保留。

如何載入本機檔案以進行 HTML 渲染？

在建立 Viewer 時提供檔案的絕對路徑。例如，new Viewer(new File("C:/documents/report.pdf")) 會從本機磁碟讀取 PDF，並準備進行 HTML 轉換。檢視器支援所有支援的格式，因此相同的程式碼路徑可處理 DOCX、PPTX 與 XLSX 檔案。

GroupDocs.Viewer 為企業部署提供哪些授權選項？

此產品提供 按開發者 與 按伺服器 兩種授權。按開發者授權允許在單一開發者機器上無限制部署，而按伺服器授權則涵蓋特定伺服器上所有使用 API 的使用者，非常適合 SaaS 或內部網路解決方案。

如何優化大型文件的 HTML 渲染？

透過在迴圈中設定 HtmlViewOptions.setPageCount(1) 以啟用 逐頁串流，一次渲染一頁。此方法即使對於 500 頁的 PDF，也能將記憶體消耗控制在 100 MB 以下。此外，使用 HtmlViewOptions.setRenderToSinglePage(false) 可避免將整個文件載入記憶體。

疑難排解技巧

  • 確認 Maven 坐標與最新版本相符；版本不匹配常導致 ClassNotFoundException。
  • 確保授權檔案對 JVM 進程可讀；權限問題會顯示為 LicenseException。
  • 對於加密的 PDF，請透過 ViewerOptions.setPassword("yourPassword") 提供密碼。

實務應用

  1. 文件管理系統 – 將上傳的合約轉換為 HTML，以即時預覽，無需下載原始檔案。
  2. 網站入口 – 將使用者產生的報告直接嵌入網頁，提升使用者體驗並減少儲存負擔。
  3. 歸檔解決方案 – 將舊版文件儲存為 HTML，以確保未來即使檔案格式已淘汰仍能存取。
  4. 協作工具 – 在瀏覽器中渲染共享簡報，允許即時評論，無需第三方外掛。
  5. 自訂企業應用 – 將轉換整合至工作流程引擎，自動從 Word 範本產生 HTML 發票。

效能考量

  • 資源管理： 使用 try‑with‑resources 方式建立 Viewer，確保檔案句柄及時釋放。
  • 記憶體使用量： 對於超過 100 MB 的文件，啟用 HtmlViewOptions.setCacheFolderPath("temp") 將中間資料寫入磁碟。
  • 批次處理： 使用 Java 的 ForkJoinPool 平行處理檔案，但將併發數限制為 CPU 核心數，以避免 I/O 瓶頸。

結論

您現在已擁有一套完整、可投入生產環境的 將文件轉換為 HTML 指南，使用 GroupDocs.Viewer for Java。依照上述步驟，您可以將任何支援的檔案類型渲染為瀏覽器友善的 HTML，掌控授權並針對大規模情境微調效能。亦可探索 PDF 或影像渲染等其他檢視選項，以進一步擴充應用程式的功能。

常見問題

Q: 我可以將 GroupDocs.Viewer 與雲端儲存服務（如 AWS S3）一起使用嗎？
A: 可以，只需將檔案下載至暫存本機路徑或透過 InputStream 串流，然後傳入 Viewer 建構子。

Q: 能否自訂產生的 HTML CSS？
A: 當然可以。使用 HtmlViewOptions.setStyleSheet("<style>…</style>") 注入自訂樣式或連結外部樣式表。

Q: GroupDocs.Viewer 如何處理受密碼保護的文件？
A: 在呼叫 view 前透過 ViewerOptions.setPassword("mySecret") 提供密碼；函式庫會即時解密檔案。

Q: 若遇到「不支援的檔案格式」錯誤該怎麼辦？
A: 確認您使用的 GroupDocs.Viewer 版本已包含該格式的支援；如有需要，升級至最新版本。

Q: 函式庫是否支援將 Excel 試算表轉換為 HTML？
A: 支援，Excel 檔案會被渲染為帶有嵌入圖片的 HTML 表格，且公式會以靜態值呈現。

資源

最後更新： 2026-06-15
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs

<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 java.nio.file.Path;

Path YOUR_DOCUMENT_DIRECTORY = Path.of("YOUR_DOCUMENT_DIRECTORY"); // Replace with actual document path
Path outputDirectory = YOUR_DOCUMENT_DIRECTORY.resolveSibling("YOUR_OUTPUT_DIRECTORY").toAbsolutePath(); // Output directory for HTML files

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SampleDocx.docx"))) { // Replace with actual document name
    viewer.view(viewOptions); // Render the document using specified options
}

相關教學