Java 開発者がレポート、メール本文、または組み込みドキュメントを作成する際、動的な Web コンテンツを生成することは頻繁な要件です。Conholdate.Total for Java は、手動で文字列を処理することなく、Java で HTML ファイルの作成を簡素化する堅牢な SDK を提供します。このガイドでは、Java で HTML ファイルを作成する方法、ライブラリの設定、変換オプションの構成、外部リソースを含む単一の HTML ファイルを生成する完全な例の実行方法を学びます。最後まで読むと、サポートされている任意のソースドキュメントから Java で HTML ファイルを生成できるようになります。

JavaでHTMLファイルを生成する完全な作業例

この例では、DOCX、PDF、PPTX、またはサポートされている任意のドキュメントを、外部リソースを含む単一のHTMLファイルに変換する方法を示します。

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.HtmlConvertOptions;
import java.io.File;

public class HtmlConversionDemo {
    public static void main(String[] args) {
        // Input document (any supported format: .docx, .pdf, .pptx, etc.)
        String inputPath = "input.docx";

// Output HTML file
        String outputPath = "output.html";

// Folder where images and other resources will be stored
        String resourcesFolder = "output_resources";

// Ensure the resources folder exists
        File resFolder = new File(resourcesFolder);
        if (!resFolder.exists()) {
            resFolder.mkdirs();
        }

Converter converter = null;
        try {
            // Initialize the converter with the source document
            converter = new Converter(inputPath);

// Configure HTML conversion options
            HtmlConvertOptions htmlOptions = new HtmlConvertOptions();

// Store images and CSS in a separate folder
            htmlOptions.setResourcesFolder(resourcesFolder);
            htmlOptions.setResourcesFolderName("resources");

// Do not embed images directly into HTML (keeps file size lower)
            htmlOptions.setEmbedImages(false);

// Convert the whole document (0 means all pages)
            htmlOptions.setPageNumber(0);

// Produce a single HTML file (all pages merged)
            htmlOptions.setRenderToSinglePage(true);

// Image quality for extracted pictures (0‑100)
            htmlOptions.setQuality(90);

// Performance tweaks for large documents
            htmlOptions.setMaxPages(0); // 0 = no limit
            htmlOptions.setUsePdfRender(true); // use PDF renderer when possible

// Perform the conversion
            converter.convert(outputPath, htmlOptions);

System.out.println("HTML file created successfully at: " + outputPath);
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        } finally {
            // Release native resources
            if (converter != null) {
                try {
                    converter.close();
                } catch (Exception ignored) {
                }
            }
        }
    }
}

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。

JavaでHTMLファイルを作成する方法

変換プロセスは、主に3つのコンポーネント、Converter、HtmlConvertOptions、およびリソース処理ロジックによって駆動されます。以下に、上記のコードのステップバイステップの内訳を示します。

  1. Initialize the Converter - Converter クラスはソース ドキュメントをロードします。
converter = new Converter(inputPath);

このクラスは API リファレンス に記載されています。

  1. HTML オプションの構成 - HtmlConvertOptions を使用すると、画像や CSS の保存場所、画像を埋め込むかどうか、出力を単一ページにするかを制御できます。
HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);
  1. パフォーマンス調整を設定 - 大きなドキュメントの場合、ページ制限を調整し、PDFレンダラーを選択して速度を向上させることができます。
htmlOptions.setMaxPages(0);
htmlOptions.setUsePdfRender(true);
  1. 変換を実行する - convert メソッドは HTML ファイルを書き込み、リソース フォルダーを作成します。
converter.convert(outputPath, htmlOptions);
  1. クリーンアップ - 常に Converter を閉じてネイティブリソースを解放します。
if (converter != null) {
    converter.close();
}

JavaでHTMLファイルをマージ

Setting htmlOptions.setRenderToSinglePage(true) は、ソース ドキュメントのすべてのページを単一の HTML ファイルに結合します。これは、複数のセクションを 1 つの統合された出力にまとめる必要がある場合に便利です。

JavaでHTMLファイルを生成する

別々のページを希望する場合は、htmlOptions.setRenderToSinglePage(false) を設定してください。これにより、SDK はソースページごとに 1 つの HTML ファイルを生成し、指定されたリソース フォルダー内の画像と CSS を引き続き処理します。

環境の準備

コードを実行する前に、Conholdate.Total の Maven リポジトリと依存関係をプロジェクトの pom.xml に追加してください。

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

最新の JAR ファイルは、ダウンロードページ から直接取得できます。SDK は Java 8 以上が必要で、標準的な JVM 上で動作します。

結論

JavaでHTMLファイルを作成することは、Conholdate.Total for Java を使用すれば簡単になります。ライブラリは形式の検出、リソースの抽出、ページのマージを処理するため、低レベルの文字列操作ではなくビジネスロジックに集中できます。製品を本番環境で使用する際は有効なライセンスを取得することを忘れないでください。評価用にはtemporary license page が利用可能で、詳細な価格情報はpricing page に掲載されています。上記の手順に従えば、Javaアプリケーションから直接HTMLレポート、メール、または任意のウェブコンテンツを生成できるようになります。

よくある質問

  • JavaでConholdate.Totalを使用してHTMLファイルを作成する方法は？
    完全なコード例に示されているように、Converter クラスと HtmlConvertOptions を組み合わせて使用します。SDK は画像、CSS の抽出およびページの結合を自動で処理します。

  • JavaでこのSDKを使用してHTMLファイルを結合できますか？
    はい。htmlOptions.setRenderToSinglePage(true) を有効にすると、すべてのページが単一のHTML出力に結合されます。

  • HTML変換でサポートされているソース形式は何ですか？
    SDKはDOCX、PDF、PPTX、XLSX、およびその他多数の形式をサポートしています。完全な一覧については、公式ドキュメントをご覧ください。

  • ライセンスと価格の詳細はどこで取得できますか？
    試用ライセンスについてはtemporary license pageをご覧いただき、商用オプションについてはpricing pageをご確認ください。

Read More