將文件轉換為 PDF（使用 GroupDocs Viewer for Java）

在現代應用程式中，將文件轉換為 PDF 對於一致的渲染、可靠的歸檔以及輕鬆分享至關重要。本教學說明 如何將 docx 轉換為 pdf（以及其他格式），使用 GroupDocs Viewer for Java，帶領您完成設定、程式碼範例與效能技巧，讓您能在 Java 專案中整合可靠的 PDF 轉換功能。

使用 GroupDocs.Viewer for Java 將文件轉換為 PDF

快速解答

  • 什麼是 GroupDocs Viewer for Java？ 它是一個 Java 函式庫，可將 100 多種文件格式渲染為 PDF、HTML 或圖像，無需 Microsoft Office。
  • 如何開始轉換文件？ 加入 Maven 依賴、建立 Viewer 實例、設定 PdfViewOptions，然後呼叫 view()。
  • 我需要授權嗎？ 免費試用可用於評估；正式環境需購買商業授權。
  • 我可以轉換大型檔案嗎？ 可以——使用記憶體串流並及時關閉，以降低記憶體使用量。
  • 支援哪些格式？ DOCX、XLSX、PPTX、PDF、圖像等多種格式（請參閱文件）。

什麼是 GroupDocs Viewer for Java？

GroupDocs.Viewer for Java 是一個伺服器端的 Java 函式庫，可將超過 100 種文件格式（包括 DOCX、XLSX、PPTX、PDF 與圖像）渲染為 PDF、HTML 或圖像檔案，無需 Microsoft Office 或其他第三方軟體。它讓開發人員能在本地或雲端產生高保真度的 PDF，簡化文件檢視與歸檔。

為何在 PDF 轉換中使用 GroupDocs Viewer for Java？

GroupDocs Viewer 可在不將整個檔案載入記憶體的情況下處理數百頁的文件，與傳統辦公自動化方式相比，可降低高達 30 % 的記憶體使用量。它在 100 多種支援格式上保證 99 % 的版面相似度，且純 Java 架構免除本機 Office 安裝需求，簡化在 Linux 容器與無伺服器環境的部署。

前置條件

在深入程式碼之前，請確保您已具備以下條件：

  • 必要的函式庫

    • GroupDocs.Viewer for Java（版本 25.2）– 支援 100 多種輸入與輸出格式。

  • 環境設定需求

    • Java Development Kit (JDK) 8 或更高版本已安裝。
    • 使用如 IntelliJ IDEA 或 Eclipse 等 IDE，以提升開發舒適度。

  • 知識前提

    • 基本的 Java 程式設計技能。
    • 熟悉 Maven 以管理相依性。

設定 GroupDocs Viewer for Java

如何將 GroupDocs.Viewer 加入 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>

取得授權

  • Free Trial – 無償探索所有功能。
  • Temporary License – 使用限時金鑰進行完整評估。
  • Purchase – 取得商業授權以供正式使用。

如何初始化 Viewer

Viewer 類別是所有轉換操作的入口點；它負責文件載入、渲染與資源清理。使用以下程式碼片段，以您的授權檔案建立 Viewer 實例：

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document")) {
            // Your conversion code will go here.
        } catch (IOException e) {
            System.out.println("Error initializing GroupDocs.Viewer: " + e.getMessage());
        }
    }
}

實作指南

如何將文件轉換為 PDF

載入來源檔案、設定 PDF 選項、渲染，最後取得 PDF 串流——共四個簡潔步驟。

載入來源文件、設定 PDF 檢視選項、渲染檔案，最後取得 PDF 位元組。此模式同樣適用於 DOCX、XLSX、PPTX 與圖像檔案。

步驟 1 – 使用 Viewer 開啟來源檔案

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Further processing will be done here.
}

步驟 2 – 使用記憶體串流準備 PDF 檢視選項

MemoryFileStreamFactory streamFactory = new MemoryFileStreamFactory();
PdfViewOptions options = new PdfViewOptions(streamFactory);

步驟 3 – 將文件渲染為 PDF

viewer.view(options);

步驟 4 – 取得產生的 PDF 串流

InputStream pdfStream = streamFactory.getStream();
pdfStream.close(); // Always remember to close streams after usage.

常見問題與除錯

  • Incorrect file paths – 請確認路徑指向現有且可讀取的檔案。
  • Out‑of‑date library – 請確保使用最新的 GroupDocs.Viewer 版本（25.2 或更新）。
  • Unclosed streams – 忘記關閉 InputStream 可能導致記憶體泄漏，尤其是大型檔案。

實務應用

  1. Document Archiving – 將所有紀錄以 PDF 形式保存，以確保長期保存且格式不可變更的保證。
  2. Web Publishing – 即時產生報告或文章的 PDF 版本，讓終端使用者可一鍵下載。
  3. Data Security – 發佈 PDF 而非可編輯的原始檔，以降低意外修改或資料外洩的風險。

效能考量

  • Memory Management – 如範例所示使用 MemoryFileStreamFactory，並及時關閉串流，以降低堆積使用量。
  • Profiling – 轉換大型文件時監控 CPU 與堆積使用情況；在一般 4 核心伺服器上，GroupDocs Viewer 可在 5 秒內處理 500 頁文件。

常見問答

Q: 如何在我的 Java 專案中設定 GroupDocs.Viewer？
A: 將上述 Maven 相依性加入您的 pom.xml，取得授權，並建立 Viewer 類別的實例。

Q: 是否能使用 GroupDocs.Viewer 轉換任何文件格式？
A: 是的，該函式庫支援超過 100 種格式，包括 DOCX、XLSX、PPTX、PDF 以及常見的圖像類型。

Q: 若轉換失敗該怎麼辦？
A: 再次確認檔案路徑、確保使用正確的函式庫版本，並驗證授權金鑰是否有效。

Q: 如何有效處理大型文件？
A: 使用記憶體串流，完成後立即關閉，並考慮使用 PageStream API 逐頁處理文件。

Q: 在哪裡可以取得 GroupDocs.Viewer 的支援？
A: 前往 GroupDocs 支援論壇 取得社群協助與官方支援。

資源

最後更新: 2026-05-11
測試環境: GroupDocs.Viewer 25.2 for Java
作者: GroupDocs

相關教學