JavaでGroupDocs.Viewerを使用してDOCXからHTMLを生成する方法

このガイドでは、GroupDocs.Viewerを使用してJavaでDOCXからHTMLを生成し、必要なページのみをレンダリングすることに焦点を当てます。契約レビュー ポータル、eラーニング モジュール、レポート ダッシュボードのいずれを構築している場合でも、以下の手順で軽量で自己完結型のHTMLを生成し、任意のWeb UIに直接組み込む方法を示します。

クイック回答

  • “render pages” とは何ですか？ 選択したドキュメントページをHTMLなどの表示可能な形式に変換します。
  • 生成される形式は何ですか？ 画像、CSS、フォントを埋め込んだHTMLです。
  • ライセンスは必要ですか？ 評価にはトライアルで動作しますが、本番環境ではフルライセンスが必要です。
  • 連続しないページを選択できますか？ はい、必要なページ番号を任意に指定できます。
  • キャッシュは推奨されますか？ はい、レンダリングされたHTMLをキャッシュすることで頻繁にアクセスされるページのロード時間が短縮されます。

GroupDocs.Viewer for Javaでドキュメントの選択ページをレンダリング

GroupDocs.Viewer for Javaでドキュメントの選択ページをレンダリング

学べること

  • Java環境でGroupDocs.Viewerをセットアップする
  • Viewer APIを使用して特定のドキュメントページをレンダリングする
  • 最適な表示のためにHTMLビューオプションを設定する
  • 実用的なユースケースと統合シナリオ

選択ページのレンダリングとは何ですか？

選択ページのレンダリングは、ソースドキュメントから指定したページだけを抽出し、各ページを自己完結型のHTMLファイルに変換します。これにより、関連するセクションのみを提供でき、帯域幅とロード時間を削減しながら、レイアウト、画像、フォントを保持します。

なぜ Javaで DOCX を HTML に変換するのか？

JavaでDOCXをHTMLに変換すると、外部プラグインなしで動作する軽量でブラウザ対応の表現が作成され、Webポータル、eラーニング、レポートダッシュボードに最適です。埋め込みリソースにより、すべてのブラウザでページが正しく表示され、クロスオリジンの問題が解消されます。

前提条件

開発環境が以下の要件を満たしていることを確認してください：

  1. 必要なライブラリ – プロジェクトに GroupDocs.Viewer for Java（バージョン 25.2 以降）を含めます。
  2. 環境 – JDK 8 以上；IntelliJ IDEA や Eclipse などの IDE。
  3. 知識 – 基本的な Java プログラミングと Maven の依存関係管理。

GroupDocs.Viewer for Java のセットアップ

GroupDocs.Viewer for Java は、DOCX、PDF、PPT など 90 以上のドキュメント形式を HTML、PDF、画像にレンダリングするサーバーサイドライブラリです。

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>

ライセンス取得

  • 無料トライアル – すべての機能を無料で試せます。
  • 一時ライセンス – トライアル期間を超えてテストを継続できます。
  • フル購入 – 本番環境での導入には必要です。

基本的な初期化とセットアップ

import com.groupdocs.viewer.Viewer;

public class DocumentViewer {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
            // Your rendering logic here
        }
    }
}

選択ページで DOCX を HTML に変換する方法（Java）

HtmlViewOptions は、リソースの埋め込みやページレイアウトなど、Viewer が HTML 出力をレンダリングする方法を設定します。
view() は、指定されたオプションに従ってドキュメントをレンダリングし、生成されたファイルを返します。

GroupDocs.Viewer で DOCX をロードし、埋め込みリソース用に HtmlViewOptions を設定し、ページ番号のリストを view() メソッドに渡します。これにより、指定したページだけが個別の HTML ファイルとしてレンダリングされ、各ファイルに埋め込み画像と CSS が含まれ、すぐに表示できます。

手順 1: 出力パスの設定

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
  • 説明: outputDirectory は生成された HTML ファイルの保存先です。
  • 命名: page_{0}.html は各レンダリングページごとに別々のファイルを作成します。

手順 2: HTML ビューオプションの設定

HtmlViewOptions は Viewer が HTML を出力する方法を定義し、リソースの埋め込み、ページサイズの設定、CSS 生成の制御が可能です。

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
  • 説明: forEmbeddedResources() は画像、CSS、フォントを各 HTML ファイルに直接バンドルし、外部依存を排除します。

手順 3: 必要なページをレンダリング

try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    viewer.view(viewOptions, 1, 3);
}
  • 説明: view() メソッドは HtmlViewOptions とページ番号のリストを受け取ります。この例では、1 ページ目と 3 ページ目だけがレンダリングされます。

実用的な活用例

選択ページのレンダリングは多くのシナリオで便利です：

  1. 法務文書 – 契約書の該当条項のみを表示する。
  2. 教育プラットフォーム – 学生が教科書全体をダウンロードせずに特定の章をプレビューできる。
  3. ビジネスレポート – 主要なレポートセクションを表示して、ステークホルダーに簡潔な要約を提供する。

パフォーマンス上の考慮点

  • メモリ管理 – try‑with‑resources（上記参照）を使用して Viewer のリソースを速やかに解放します。
  • キャッシュ – 頻繁にアクセスされるページのレンダリング HTML をキャッシュ（例: Redis やインメモリ）に保存します。
  • リソース最小化 – 埋め込みリソースはファイルサイズを若干増加させます。帯域幅が問題になる場合は HTML 出力の圧縮を検討してください。
  • スケーラビリティ – GroupDocs.Viewer はストリーミングアーキテクチャにより、ファイル全体をメモリに読み込まずに最大 500 ページのドキュメントを処理できます。

よくある問題と解決策

問題解決策
ファイルが見つかりません絶対パスまたは相対パスを再確認し、ファイルが存在することを確認してください。
大きなドキュメントでメモリ不足必要なページだけをレンダリングするか、JVM のヒープサイズ（-Xmx）を増やしてください。
HTML に画像が欠落forEmbeddedResources が使用されているか確認してください。使用されていない場合、画像は別々に保存されます。
ライセンスエラー有効な GroupDocs.Viewer.lic ファイルをアプリケーションのルートに配置するか、プログラムでパスを指定してください。

よくある質問

Q: GroupDocs.Viewer for Java とは何ですか？
A: GroupDocs.Viewer for Java は、90 以上のドキュメント形式（PDF、DOCX、PPT など）を Java アプリケーション内で直接レンダリングできるライブラリです。

Q: この方法で PDF ページをレンダリングできますか？
A: はい、Viewer API は PDF を含む多くの形式をサポートしています。

Q: 大きなドキュメントを効率的に扱うには？
A: 必要なページだけをレンダリングし、キャッシュを利用して再処理を回避します。

Q: HTML ファイルにリソースを埋め込む利点は何ですか？
A: ページごとに単一の自己完結型ファイルが作成され、デプロイが簡素化され、外部アセットの読み込みが不要になります。

Q: GroupDocs.Viewer for Java の詳細情報はどこで入手できますか？

リソース

最終更新日: 2026-10-05
テスト環境: GroupDocs.Viewer 25.2
作者: GroupDocs

関連チュートリアル