如何使用 GroupDocs.Viewer for Java 旋轉特定 PDF 頁面

在 PDF 中旋轉特定頁面對於對齊文件、修正掃描圖像或微調簡報投影片可能是必需的。在本指南中，您將學習如何使用 GroupDocs.Viewer 以程式方式旋轉特定 PDF 頁面，無論您需要將 PDF 旋轉 90 度、翻轉整個區段，或在一次呼叫中處理多個頁面。

使用 GroupDocs.Viewer for Java 旋轉特定 PDF 頁面

使用 GroupDocs.Viewer for Java 旋轉特定 PDF 頁面

您將學到的內容

  • 在 Java 專案中設定 GroupDocs.Viewer（包括 Maven GroupDocs Viewer 配置）
  • 以程式方式旋轉特定 PDF 頁面（將 PDF 旋轉 90 度、180 度等）
  • 最佳使用的關鍵配置
  • 實作過程中常見問題的故障排除

快速答案

  • 什麼函式庫可以在 Java 中旋轉 PDF 頁面？ GroupDocs.Viewer for Java 提供內建的旋轉支援，無需外部工具。
  • 我可以將單一頁面旋轉 90 度嗎？ 可以 – 在 viewer 實例上呼叫 rotatePage(pageNumber, Rotation.ON_90_DEGREE)。
  • 開發需要授權嗎？ 臨時授權可免費評估；正式環境需要完整授權。
  • 需要 Maven 嗎？ Maven 為建議的相依管理工具，但您也可以使用 Gradle 或手動加入 JAR。
  • 如何呈現旋轉後的頁面？ 使用 HtmlViewOptions 搭配 viewer.view(documentPath, viewOptions) 取得反映旋轉的 HTML 輸出。

什麼是旋轉特定 PDF 頁面？

rotate specific pdf pages 指的是在 PDF 文件中變更個別頁面的方向，同時保持其餘頁面不變的能力。此操作於渲染時執行，原始 PDF 檔案保持不變。

為什麼要旋轉特定 PDF 頁面？

在一般伺服器等級的虛擬機上，您可以在 0.05 秒以下旋轉單一頁面，實現對掃描合約、簡報投影片或包含錯誤方向掃描的多頁發票的即時預覽。此細緻的控制消除昂貴的後處理工具需求，並在大規模數位化專案中將人工工作減少最高 70%。

前置條件

必要的函式庫與相依性

  • Java Development Kit (JDK) 8 或更新版本。
  • 如 IntelliJ IDEA 或 Eclipse 等 IDE。
  • 用於相依管理的 Maven。

環境設定需求

  1. Maven 設定 – 在 pom.xml 中加入 GroupDocs.Viewer。
  2. 取得授權 – 從 GroupDocs 獲取臨時授權。請造訪 GroupDocs Free Trial 或在 GroupDocs Temporary License Page 申請臨時授權。

為 Java 設定 GroupDocs.Viewer

要使用 Maven 將 GroupDocs.Viewer 整合至您的 Java 專案，請更新 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>

基本初始化與設定

Viewer 是載入文件並協調渲染操作的核心類別。建立實例後，您可以呼叫如 view 或 rotatePage 等方法。

Path YOUR_DOCUMENT_DIRECTORY = Path.of("YOUR_DOCUMENT_DIRECTORY");
Path YOUR_OUTPUT_DIRECTORY = Path.of("YOUR_OUTPUT_DIRECTORY");

// Format for page file paths
Path pageFilePathFormat = YOUR_OUTPUT_DIRECTORY.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

如何使用 GroupDocs.Viewer 旋轉特定 PDF 頁面

使用 GroupDocs.Viewer 旋轉特定 PDF 頁面涉及兩個主要步驟：首先，使用 rotatePage 方法為每個目標頁面指定所需的旋轉；其次，使用 HtmlViewOptions 渲染文件，使旋轉在輸出中得以呈現。此方法保持原始 PDF 不變，同時提供正確方向的 HTML。

步驟 1：設定頁面旋轉

rotatePage 是接受零基頁索引與 Rotation 列舉值的方法。該列舉提供三個選項：ON_90_DEGREE、ON_180_DEGREE 和 ON_270_DEGREE。

// Rotate the first page by 90 degrees clockwise.
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

// Rotate the second page by 180 degrees.
viewOptions.rotatePage(2, Rotation.ON_180_DEGREE);

步驟 2：初始化 viewer 並渲染

HtmlViewOptions 控制 PDF 轉 HTML 的轉換過程。它在套用您設定的旋轉時，仍保留版面配置、字型與嵌入資源。

Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SampleDocument.pdf"));

// Render the specified pages (1 and 2) using the configured options.
viewer.view(viewOptions, 1, 2);

// Always close the viewer to free resources.
viewer.close();

參數與設定

  • Rotation – rotatePage(pageNumber, Rotation.*)，其中旋轉選項為 ON_90_DEGREE、ON_180_DEGREE、ON_270_DEGREE。
  • HtmlViewOptions – 處理 PDF 轉 HTML 的轉換，同時保留版面與嵌入資源。
  • pdf to html java – 此類別屬於同一 API，確保忠實的視覺呈現。

常見問題與解決方案（故障排除 PDF 旋轉）

  • 路徑錯誤 – 確認 YOUR_DOCUMENT_DIRECTORY 與 YOUR_OUTPUT_DIRECTORY 存在且可存取。
  • 缺少相依性 – 確認 Maven 坐標符合最新的 GroupDocs.Viewer 版本（目前 25.2）。
  • 授權限制 – 正確套用臨時授權，否則部分功能可能被停用。
  • 記憶體激增 – 將大型 PDF 分批渲染或增加 JVM 堆積大小。

實務應用

真實案例

  1. 文件對齊 – 旋轉掃描合約以獲得正確的數位方向。
  2. 簡報調整 – 在分享前修改 PDF 內的簡報投影片。
  3. 檔案保存工作流程 – 在數位化過程中自動調整歷史文件的方向。

整合可能性

將 GroupDocs.Viewer 與基於 Java 的內容管理系統、企業入口網站或需要即時檢視 PDF 的自訂 API 結合。

效能考量

  • 資源管理 – 隨時關閉 Viewer 實例以釋放檔案句柄與記憶體。
  • Java 記憶體管理 – 處理大型 PDF 時監控堆積使用情況；考慮串流頁面而非一次載入整個檔案。
  • 最佳實踐 – 為常存取的文件快取已渲染的 HTML，可將處理時間縮短最高 60%。

結論

本教學涵蓋了 如何在 Java 中使用 GroupDocs.Viewer 旋轉特定 PDF 頁面，從 Maven 設定到渲染旋轉頁面以及處理常見陷阱。可嘗試額外功能，如加水印、格式轉換或批次處理，以進一步擴充文件工作流程。

下一步： 探索其他 GroupDocs.Viewer 功能，例如將 PDF 轉為 PNG、加入水印，或與雲端儲存服務整合。

常見問答

  • 故障排除旋轉問題 – 確認頁碼與旋轉參數正確。
  • 處理大型 PDF 檔案 – 分批處理頁面並監控記憶體使用。
  • 授權需求 – 開發使用臨時授權；正式環境需購買完整授權。
  • 旋轉多頁 – 針對不同頁碼與角度重複呼叫 rotatePage。
  • 與 Java 函式庫整合 – GroupDocs.Viewer 可無縫搭配 Spring Boot、Jakarta EE 及其他 Java 框架。

常見問題

Q: 我可以一次旋轉 PDF 的所有頁面嗎？
A: 可以。遍歷頁碼，對每個頁面呼叫 rotatePage(page, Rotation.ON_90_DEGREE)。

Q: 旋轉會影響原始 PDF 檔案嗎？
A: 不會。旋轉僅在渲染過程中套用，來源 PDF 保持不變。

Q: 如果 PDF 有密碼保護該怎麼辦？
A: 在建立 Viewer 實例時提供密碼：new Viewer(path, password)。

Q: 設定 HtmlViewOptions 時遇到 “null pointer” 錯誤該如何除錯？
A: 確認輸出目錄存在，且 pageFilePathFormat 正確解析。

Q: 在轉換為其他格式（例如 PNG）時有辦法旋轉頁面嗎？
A: 有。使用相同的 rotatePage 設定，搭配目標格式的相應 view options。

資源

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

相關教學