groupdocs viewer java: Java 文件渲染教學 – 轉換檔案為 HTML、PDF 與圖片

如果您正在構建需要 顯示、轉換或處理各種文件格式 的 Java 應用程式，您已來到正確的教學集合。本指南將示範如何掌握 使用 GroupDocs.Viewer for Java 進行文件渲染——從簡單的檔案轉換到進階的渲染技術。無論您是建立文件管理系統、為網站入口添加預覽功能，或是將舊有檔案遷移至現代格式，這些一步步的教學都提供可直接執行的 Java 程式碼與實用技巧。

快速解答

  • GroupDocs Viewer Java 有什麼功能？ 它可以將超過 100 種檔案類型渲染為 HTML、PDF、PNG、JPG 等，且不需要原始應用程式。
  • 我需要商業授權嗎？ 評估期間可使用免費的臨時授權；正式上線則需付費授權。
  • 支援哪些 Java 版本？ 完全支援 Java 8 至 Java 17。
  • 可以從串流渲染文件嗎？ 可以——API 支援 InputStream，避免產生暫存檔。
  • 可以轉換多少種格式？ 超過 100 種輸入與輸出格式，包含 Office、CAD、電子郵件與壓縮檔等。

什麼是 groupdocs viewer java？

GroupDocs.Viewer for Java 是一個伺服器端函式庫，將文件轉換並渲染為網頁友好格式（如 HTML、PDF、PNG、JPG）。它將每種檔案類型的複雜度封裝在單一、統一的 API 後，使您能在不安裝 Microsoft Office 或其他第三方檢視器的情況下，建構預覽、轉換與抽取功能。

為什麼使用 groupdocs viewer java？

GroupDocs.Viewer 支援 50+ 輸入格式（DOCX、XLSX、PDF、DWG、PST 等）與 30+ 輸出格式，且可 處理高達 2 GB 的檔案，無需將整個文件載入記憶體。基準測試顯示，在一般 2 vCPU 雲端實例上，將 200 頁 PDF 轉換為 HTML 不到 2 秒，非常適合高吞吐量的 Web 服務。

前置條件

  • Java 8 或更新版本（建議使用 Java 11 或 17）。
  • Maven 或 Gradle 進行相依管理。
  • 有效的 GroupDocs Viewer 臨時或 付費 授權（請參閱下方「臨時授權」連結）。

開始文件渲染

如何安裝 GroupDocs Viewer for Java？

將 Maven 相依加入您的 pom.xml（或等效的 Gradle 片段）。此單行指令會自動下載所有必要的二進位檔與傳遞相依。

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

Pro tip: 使用最新的穩定版本（撰寫時為 23.9），即可獲得最新的格式支援與效能提升。

如何將文件渲染為 HTML？

Viewer 是負責載入與渲染文件的主要類別。HtmlViewOptions 設定輸出為 HTML。使用 Viewer 載入文件後，呼叫 view 並傳入 HtmlViewOptions。API 會自動偵測格式，回傳乾淨且具回應式的 HTML。

Viewer viewer = new Viewer("sample.docx");
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources();
viewer.view(options, "output.html");

HtmlViewOptions.forEmbeddedResources() 方法會將圖片與 CSS 直接嵌入 HTML，十分適合單頁預覽。

如何將文件轉換為 PDF？

PdfViewOptions 指定 PDF 為渲染的輸出格式。建立 PdfViewOptions 實例後呼叫 view。轉換過程會保留版面配置、字型與向量圖形。

PdfViewOptions pdfOptions = PdfViewOptions.forStandardConversion();
viewer.view(pdfOptions, "output.pdf");

如何為每頁產生 PNG 縮圖？

PngViewOptions 定義將頁面渲染為 PNG 圖片的設定。使用 PngViewOptions，並可選擇設定解析度以控制圖像品質。

PngViewOptions pngOptions = PngViewOptions.forStandardResolution();
pngOptions.setResolution(150); // DPI
viewer.view(pngOptions, "page_{0}.png");

如何直接從 InputStream 渲染文件？

InputStream 代表來自檔案或網路等來源的位元串流。當文件儲存在資料庫或透過 REST API 接收時，可避免寫入磁碟。

InputStream stream = getDocumentStreamFromDatabase();
Viewer viewer = new Viewer(stream);
viewer.view(HtmlViewOptions.forEmbeddedResources(), "output.html");

可用教學

以下是完整的聚焦教學目錄。每個連結皆會開啟專屬指南，進一步說明錯誤處理、效能調校與實務案例細節。

Office 文件轉換教學

進階檔案格式支援

CAD 與技術圖紙渲染

電子郵件與壓縮檔處理

專案管理整合

專門渲染技術

使用 GroupDocs.Viewer for Java 的文件渲染基礎

其他資源

常見問題

Q: 可以在微服務架構中使用 GroupDocs Viewer Java 嗎？
A: 可以。函式庫支援串流，讓您在無狀態服務中渲染文件，無需寫入暫存檔至磁碟。

Q: 同時渲染的頁數有上限嗎？
A: API 允許僅渲染選定的頁面，以降低記憶體使用量。支援一次渲染 1,000 頁的 PDF，但對於大型檔案建議分頁處理。

Q: GroupDocs Viewer Java 會提取文字供搜尋索引使用嗎？
A: 會的。使用 TextViewOptions 可取得純文字輸出，非常適合建構可搜尋的索引。

Q: 如何處理受密碼保護的 PDF？
A: 在 Viewer 建構子中傳入密碼，例如 new Viewer("secure.pdf", "password")。函式庫會安全地解密並渲染文件。

Q: 有哪些效能最佳化可用？
A: 啟用 viewer.setRenderOptions(RenderOptions.getDefault().setCacheEnabled(true)) 可在多次渲染間重用已解析的資源，將轉換時間縮短最多 30 %。

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

相關教學