GroupDocs Viewer for Javaでページを90度回転する

ドキュメント（PDF、Word ファイル、スプレッドシートなど）で ページを90度回転 する必要がある場合、プログラムで行うことで時間を節約し、手動エラーを防止できます。この上級ガイドでは、GroupDocs Viewer for Java を使用して、サポートされている任意のドキュメントの最初のページを回転する正確な手順を解説します。最後まで読むと、プロジェクトに組み込める再利用可能なスニペットが手に入ります。

GroupDocs.Viewer for Javaでドキュメントの最初のページを回転する

クイック回答

“ページを90度回転” は何を意味しますか？ 選択したページを時計回りに90度回転させます。
回転を処理するライブラリはどれですか？ GroupDocs Viewer for Java が rotatePage メソッドを提供します。
JavaでPDFページを回転できますか？ はい、同じ rotatePage 呼び出しを使用します。PDF、DOCX、XLSX などでも動作します。
ライセンスは必要ですか？ 開発には無料トライアルで動作しますが、本番環境では有料ライセンスが必要です。
この操作はメモリ集中的ですか？ Viewer インスタンスをすぐに閉じれば問題ありません。以下のパフォーマンスヒントをご参照ください。

“ページを90度回転” とは何ですか？

ページを90度回転すると、ページの向きが縦向きから横向き（またはその逆）に変更され、コンテンツ自体は変更されません。プレゼンテーションや横向きのみのグラフィック印刷、横向きにスキャンされた文書の修正などに特に便利です。

なぜ 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 の設定

pom.xml に 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>

ライセンス取得

無料トライアル – 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 ブロックで囲み、例外をログに記録し、必要に応じて次のファイルの処理を続行します。

リソース

ドキュメント: GroupDocs Viewer Java Documentation
API リファレンス: GroupDocs API Reference
ダウンロード: Get GroupDocs Viewer for Java
購入: Buy a License
無料トライアル: Try Free
一時ライセンス: Request Temporary License
サポート: GroupDocs Forum

最終更新日: 2026-01-18
テスト環境: GroupDocs Viewer 25.2 for Java
作者: GroupDocs