在 Java 中將 HTML 轉換為 JPG

將網頁轉換為圖像快照是建立報告儀表板、電子郵件新聞稿或文件存檔時的常見需求。 Aspose.OCR Cloud SDK for Java 提供功能強大的雲端庫，讓您能以程式方式將 HTML 內容渲染為高品質的 JPG 圖像。在本指南中，您將學習如何在 Java 中將 HTML 轉換為 JPG，涵蓋單檔轉換、批次處理以及效能最佳實踐。

HTML 轉 JPG 轉換（Java） - 前置條件與設定

開始之前，請確保您具備以下條件：

已安裝 Java 8 或更高版本。
用於相依性管理的 Maven 或 Gradle。
具有 APP SID 和 APP KEY 的 Aspose Cloud 帳戶，用於 OCR 服務。
具備對 Aspose OCR Cloud 端點的網路存取。

使用以下 Maven 依賴將 SDK 添加到您的專案中。相同的座標可在下載頁面上取得。

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

您還需要匯入所需的類別並設定您的認證，如範例程式碼的第一部分所示。

在 Java 中將 HTML 轉換為 JPG - 步驟說明

第一步：載入來源文件並設定憑證

建立一個 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，即可快速且可靠地為任何網頁內容產生圖像預覽。請記得為正式環境取得適當的授權；產品頁面上提供了價格資訊，您也可以從臨時授權頁面申請臨時授權。立即開始整合 HTML‑to‑JPG 轉換，提升應用程式的視覺體驗。

常見問題

如何在 Java 中將 HTML 轉換為 JPG，且不需要編寫大量程式碼？
使用演練中顯示的一行程式碼：建立 ConvertDocumentRequest，設定檔案與 outputFormat 為 "jpg"，然後呼叫 ocrApi.convertDocument(request)。SDK 會處理渲染並回傳 JPG 位元組。
我可以在 Java 中批量將 HTML 檔案轉換為 JPG 嗎？
是的。範例中的 convertBatchHtml 方法會遍歷目錄，為每個 .HTML 檔案建立請求，並寫入每個 JPG 輸出。此方法對大型集合具有良好的擴展性。
什麼 Java 程式碼可以將 HTML 轉換為 JPG？
上面的完整程式碼範例展示了所需的精確 Java 程式碼。它包括憑證配置、請求構建、執行以及檔案寫入。
在購買授權之前，有沒有方法測試轉換？
您可以從臨時授權頁面取得臨時授權，以在開發期間免費評估此函式庫。

HTML 轉 JPG 轉換（Java） - 前置條件與設定#

在 Java 中將 HTML 轉換為 JPG - 步驟說明#

第一步：載入來源文件並設定憑證#

步驟 2：初始化 OCR API#

步驟 3：建立轉換請求#

步驟 4：執行轉換#

步驟 5：將 JPG 位元組寫入磁碟#

步驟 6（可選）：批次轉換迴圈#

在 Java 中將 HTML 轉換為 JPG - 完整程式碼範例#

使用 cURL 的 REST API 進行 HTML 轉 JPG 轉換#

1. 驗證並取得存取權杖#

2. 上傳來源 HTML 檔案#

3. 執行轉換#

4. 下載輸出檔案#

結論#

常見問題#

閱讀更多#