JavaでHTMLをJPGに変換

レポートダッシュボード、メールニュースレター、またはドキュメントアーカイブを作成する際、Web ページを画像スナップショットに変換する必要が頻繁にあります。Aspose.OCR Cloud SDK for Java は、プログラムから HTML コンテンツを高品質な JPG 画像としてレンダリングできる強力なクラウドベースのライブラリを提供します。このガイドでは、Java で HTML を JPG に変換する方法を学びます。単一ファイル変換、バッチ処理、パフォーマンスのベストプラクティスをカバーします。

JavaでのHTMLからJPGへの変換 - 前提条件とセットアップ

開始する前に、以下のものが揃っていることを確認してください：

Java 8 以上がインストールされていること。
依存関係管理のための Maven または Gradle。
OCR サービス用の APP SID と APP KEY を持つ Aspose Cloud アカウント。
Aspose OCR Cloud エンドポイントへのネットワークアクセス。

以下の Maven 依存関係を使用して SDK をプロジェクトに追加します。同じ座標はダウンロードページで入手できます。

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-ocr-cloud</artifactId>
    <version>25.9.0</version>
</dependency>

サンプルコードの最初の部分に示されているように、必要なクラスをインポートし、認証情報を構成する必要があります。

JavaでHTMLをJPGに変換 - ステップバイステップの手順

ステップ 1: ソースドキュメントのロードと認証情報の設定

Configuration オブジェクトを作成し、APP SID と APP KEY を設定します。これにより、ライブラリの認証が準備されます。

Configuration config = new Configuration();
config.setAppSid(APP_SID);
config.setAppKey(APP_KEY);

ステップ 2: OCR API の初期化

構成で OcrApi をインスタンス化します。API リファレンスは公式 API リファレンスで利用できます。

OcrApi ocrApi = new OcrApi(config);

ステップ 3: 変換リクエストを作成

ConvertDocumentRequest を作成し、HTML ファイルを添付し、出力形式として jpg を指定します。

ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFile(new File(inputHtmlPath));
request.setOutputFormat("jpg");

ステップ 4: 変換を実行する

convertDocument を呼び出して変換を実行します。レスポンスには JPG バイトが含まれています。

ConvertDocumentResponse response = ocrApi.convertDocument(request);

ステップ5：JPG バイトをディスクに書き込む

返されたバイト配列を FileOutputStream を使用してファイルに保存します。

try (FileOutputStream fos = new FileOutputStream(outputJpgPath)) {
    fos.write(response.getFileData());
}

ステップ 6（オプション）：バッチ変換ループ

バッチ処理の場合、フォルダー内のすべての .HTML ファイルを反復処理し、各ファイルに対してステップ 3‑5 を繰り返し、変換結果をログに記録します。

for (Path htmlPath : htmlFiles) {
    // Build request, execute conversion, write output (same as above)
    System.out.println("Converted: " + htmlPath + " -> " + outputJpgPath);
}

JavaでHTMLをJPGに変換する - 完全なコード例

次のプログラムは、Aspose.OCR Cloud SDK for Java を使用した単一ファイルおよびバッチ変換の両方を示しています。

import com.aspose.ocr.cloud.ApiException;
import com.aspose.ocr.cloud.Configuration;
import com.aspose.ocr.cloud.api.OcrApi;
import com.aspose.ocr.cloud.model.ConvertDocumentRequest;
import com.aspose.ocr.cloud.model.ConvertDocumentResponse;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.file.*;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class HtmlToJpgConverter {

// Replace with your actual Aspose OCR Cloud credentials
    private static final String APP_SID = "YOUR_APP_SID";
    private static final String APP_KEY = "YOUR_APP_KEY";

// Single conversion example
    private static void convertSingleHtml(String inputHtmlPath, String outputJpgPath) throws IOException, ApiException {
        // Prepare SDK configuration
        Configuration config = new Configuration();
        config.setAppSid(APP_SID);
        config.setAppKey(APP_KEY);

// Initialize API instance
        OcrApi ocrApi = new OcrApi(config);

// Build request
        ConvertDocumentRequest request = new ConvertDocumentRequest();
        request.setFile(new File(inputHtmlPath));
        request.setOutputFormat("jpg");

// Execute conversion
        ConvertDocumentResponse response = ocrApi.convertDocument(request);

// Write the resulting JPG bytes to file
        try (FileOutputStream fos = new FileOutputStream(outputJpgPath)) {
            fos.write(response.getFileData());
        }
    }

// Batch conversion example
    private static void convertBatchHtml(String inputFolder, String outputFolder) throws IOException, ApiException {
        // Prepare SDK configuration
        Configuration config = new Configuration();
        config.setAppSid(APP_SID);
        config.setAppKey(APP_KEY);

// Initialize API instance
        OcrApi ocrApi = new OcrApi(config);

// Ensure output directory exists
        Files.createDirectories(Paths.get(outputFolder));

// Collect all .html files from the input folder
        List<Path> htmlFiles;
        try (Stream<Path> walk = Files.walk(Paths.get(inputFolder))) {
            htmlFiles = walk.filter(Files::isRegularFile)
                    .filter(p -> p.toString().toLowerCase().endsWith(".html"))
                    .collect(Collectors.toList());
        }

// Process each file
        for (Path htmlPath : htmlFiles) {
            String fileNameWithoutExt = com.google.common.io.Files.getNameWithoutExtension(htmlPath.getFileName().toString());
            String outputJpgPath = Paths.get(outputFolder, fileNameWithoutExt + ".jpg").toString();

// Build request
            ConvertDocumentRequest request = new ConvertDocumentRequest();
            request.setFile(htmlPath.toFile());
            request.setOutputFormat("jpg");

// Execute conversion
            ConvertDocumentResponse response = ocrApi.convertDocument(request);

// Write JPG output
            try (FileOutputStream fos = new FileOutputStream(outputJpgPath)) {
                fos.write(response.getFileData());
            }

System.out.println("Converted: " + htmlPath + " -> " + outputJpgPath);
        }
    }

public static void main(String[] args) {
        try {
            // Example of single file conversion
            convertSingleHtml("sample.html", "sample.jpg");

// Example of batch conversion
            convertBatchHtml("input_html", "output_jpg");
        } catch (IOException | ApiException e) {
            e.printStackTrace();
        }
    }
}

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

cURL を使用した REST API による HTML から JPG への変換

純粋な REST アプローチを好む場合、同じ変換は cURL コマンドで実行できます。ワークフローは認証、ファイルのアップロード、変換リクエスト、結果のダウンロードで構成されます。

1. 認証とアクセストークンの取得

YOUR_CLIENT_ID と YOUR_CLIENT_SECRET をあなたの認証情報に置き換えてください。

curl -X POST "https://api.aspose.cloud/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

レスポンスには、以降の呼び出しで使用する access_token が含まれています。

2. ソースHTMLファイルのアップロード

トークンを変数 $TOKEN に保存したと仮定します。

curl -X POST "https://api.aspose.cloud/v4.0/ocr/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@sample.html"

アップロードは、保存されたドキュメントを識別する fileId を返します。

3. 変換を実行する

JPG に変換をリクエストします。

curl -X POST "https://api.aspose.cloud/v4.0/ocr/convert?outputFormat=jpg&fileId=$FILE_ID" \
  -H "Authorization: Bearer $TOKEN"

レスポンスボディには JPG バイナリデータが含まれています。

4. 出力ファイルのダウンロード

バイナリストリームをローカルファイルに保存します。

curl -X GET "https://api.aspose.cloud/v4.0/ocr/download?fileId=$FILE_ID&format=jpg" \
  -H "Authorization: Bearer $TOKEN" \
  -o sample.jpg

リクエストパラメータとエラー処理の詳細については、公式 API ドキュメントをご覧ください。

結論

Java で HTML を JPG に変換するのは、Aspose.OCR Cloud SDK for Java を使用すれば簡単です。セットアップ手順に従い、提供されたコードサンプルを使用するか、cURL で REST API を呼び出すことで、任意の Web コンテンツの画像プレビューを迅速かつ確実に生成できます。本番環境での展開には適切なライセンスを取得することを忘れないでください。価格情報は製品ページに掲載されており、一時ライセンスページから一時ライセンスをリクエストできます。今すぐ HTML‑to‑JPG 変換を統合し、アプリケーションのビジュアル体験を向上させましょう。

よくある質問

Javaで大量のコードを書かずにHTMLをJPGに変換するにはどうすればよいですか？
ウォークスルーに示されたワンライナーを使用します: ConvertDocumentRequest を作成し、ファイルと outputFormat を "jpg" に設定し、次に ocrApi.convertDocument(request) を呼び出します。SDK がレンダリングを処理し、JPG バイトを返します。
JavaでHTMLファイルをJPGに一括変換できますか？
はい。サンプルの convertBatchHtml メソッドはディレクトリを走査し、各 .HTML ファイルに対してリクエストを作成し、各JPG出力を書き込みます。このアプローチは大量のコレクションでもスケーラブルです。
HTML を JPG に変換する Java コードは何ですか？
上記の完全なコード例は、必要な正確な Java コードを示しています。認証情報の設定、リクエストの構築、実行、ファイル書き込みが含まれます。
ライセンスを購入する前に変換をテストする方法はありますか？
開発中に費用なしでライブラリを評価するために、一時ライセンスページから一時ライセンスを取得できます。

JavaでのHTMLからJPGへの変換 - 前提条件とセットアップ#

JavaでHTMLをJPGに変換 - ステップバイステップの手順#

ステップ 1: ソースドキュメントのロードと認証情報の設定#

ステップ 2: OCR API の初期化#

ステップ 3: 変換リクエストを作成#

ステップ 4: 変換を実行する#

ステップ5：JPG バイトをディスクに書き込む#

ステップ 6（オプション）：バッチ変換ループ#

JavaでHTMLをJPGに変換する - 完全なコード例#

cURL を使用した REST API による HTML から JPG への変換#

1. 認証とアクセストークンの取得#

2. ソースHTMLファイルのアップロード#

3. 変換を実行する#

4. 出力ファイルのダウンロード#

結論#

よくある質問#

続きを読む#