使用 GroupDocs Viewer for Java 旋轉頁面 90 度

當您需要在文件中 旋轉頁面 90 度——無論是 PDF、Word 檔案或試算表——以程式方式執行可節省時間並避免手動錯誤。在本進階指南中，我們將逐步說明如何使用 GroupDocs Viewer for Java 旋轉任何支援文件的第一頁。完成後，您將擁有一段可直接套用於自己專案的可重用程式碼片段。

Rotate the First Page of a Document with GroupDocs.Viewer for Java

快速解答

「rotate page 90 degrees」是什麼意思？ 會將選取的頁面順時針旋轉四分之一圈。
哪個函式庫負責旋轉？ GroupDocs Viewer for Java 提供 rotatePage 方法。
可以用 Java 旋轉 PDF 頁面嗎？ 可以——使用相同的 rotatePage 呼叫；它支援 PDF、DOCX、XLSX 等格式。
需要授權嗎？ 免費試用可用於開發；正式環境需購買授權。
此操作會佔用大量記憶體嗎？ 若及時關閉 Viewer 實例則不會；請參考下方效能建議。

什麼是「rotate page 90 degrees」？

旋轉頁面 90 度會將頁面從直向（portrait）重新導向為橫向（landscape），或反之，且不會改變底層內容。這在簡報、列印僅支援橫向的圖形，或校正側向掃描的文件時特別實用。

為什麼要使用 GroupDocs Viewer for Java 旋轉頁面？

GroupDocs Viewer 抽象化了處理數十種檔案格式的複雜性。它允許您在保持原始檔案完整的前提下，對單頁執行旋轉等轉換。API 流暢、執行緒安全，且可在任何 Java 8+ 執行環境上運行。

前置條件

GroupDocs.Viewer for Java（最新版本）
JDK 8 或更新版本
Maven（或 Gradle）用於相依管理
IntelliJ IDEA 或 Eclipse 等 IDE
基本的 Java I/O 知識

設定 GroupDocs.Viewer for Java

將 GroupDocs 套件庫與相依項目加入 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>

取得授權

免費試用 – 從 GroupDocs 官方網站下載。
臨時授權 – 若需要延長評估期間，可提出申請。
正式授權 – 生產環境部署時請購買授權。

基本 Viewer 初始化

以下程式碼示範建立 Viewer 實例的最小寫法，請完整保留：

import com.groupdocs.viewer.Viewer;

// Initialize Viewer with your document path
try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    // Perform operations...
}

步驟說明：旋轉第一頁 90 度

1. 匯入所需套件

這些匯入讓您可以使用 PDF 渲染選項與旋轉列舉值。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.Rotation;

2. 定義輸出位置並建立 Viewer

將佔位路徑替換為實際的目錄路徑。

import java.nio.file.Path;

public class RotateSpecificPage {
    public static void run() {
        Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RotateSpecificPage");
        Path outputFilePath = outputDirectory.resolve("output.pdf");

        try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("Sample.docx"))) {
            // Proceed with the rotation steps below...
        }
    }
}

3. 設定 PDF 檢視選項並套用旋轉

rotatePage 方法接受頁碼（以 1 為基礎）與 Rotation 列舉值。

PdfViewOptions viewOptions = new PdfViewOptions(outputFilePath);

// Specify which page to rotate (1 for first page) and the rotation angle
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

4. 渲染文件

最後呼叫 view 產生已旋轉的 PDF。

viewer.view(viewOptions);

工作原理

PdfViewOptions 告訴 Viewer 輸出 PDF 檔案。
rotatePage(int, Rotation) 只會旋轉您指定的頁面，其他頁面保持不變。
此方法支援 ON_90_DEGREE、ON_180_DEGREE 與 ON_270_DEGREE。

常見問題與解決方案

症狀	可能原因	解決方法
FileNotFoundException	路徑不正確或資料夾遺失	驗證 `YOUR_OUTPUT_DIRECTORY` 和 `YOUR_DOCUMENT_DIRECTORY` 是否存在且可讀取。
Unsupported file format	嘗試旋轉 Viewer 不支援的格式	檢查 [GroupDocs Viewer supported formats] 頁面。
No rotation visible	使用錯誤的頁碼（0 為基礎）	請記住 `rotatePage` 使用 1 為基礎的索引。
Out‑of‑memory errors on large docs	在單一執行緒中渲染大量大型檔案	請順序處理文件，或使用具有受限併發數的執行緒池。

實務應用

簡報調整 – 即時將直向投影片轉為橫向。
批次文件校正 – 自動修正側向掃描的 PDF。
列印就緒輸出 – 確保橫向圖形在直向紙張上正確列印。

效能建議

及時關閉資源 – try‑with‑resources 區塊會自動釋放 Viewer。
批次處理 – 處理多個檔案時，可在每個執行緒內重複使用同一個 Viewer 實例以降低開銷。
監控記憶體 – 對於超過 100 MB 的文件，建議將輸出串流至磁碟，而非全部保留於記憶體。

常見問答

Q: 可以一次旋轉多個頁面嗎？
A: 可以——對每個需要旋轉的頁碼呼叫 rotatePage()。

Q: 渲染後有辦法撤銷旋轉嗎？
A: 直接撤銷不可行。必須重新渲染文件且不使用旋轉選項。

Q: 哪些檔案格式在 GroupDocs Viewer 中支援頁面旋轉？
A: DOCX、PDF、PPTX、XLSX 以及官方文件中列出的其他多種格式。

Q: 如何在大量文件中自動批次旋轉頁面？
A: 將程式碼包在迴圈中，遍歷檔案路徑集合，對每個檔案套用相同的 rotatePage 邏輯。

Q: 處理旋轉時的最佳錯誤處理方式是什麼？
A: 將 Viewer 的使用包在 try‑catch 區塊內，記錄例外資訊，並視需要繼續處理下一個檔案。