將原始的 EML 電子郵件檔案轉換為乾淨的 HTML 是需要在瀏覽器中顯示郵件內容的 Java 應用程式的常見需求。 Aspose.Words Cloud SDK for Java 為此 Java 中的 EML 轉 HTML 轉換教學提供動力，使開發人員能輕鬆處理郵件渲染。在本指南中，您將學習如何設定 SDK、執行完整的 Java 範例、使用 cURL 呼叫 REST API，並微調轉換選項以獲得最佳效能。

Java 中 EML 轉換為 HTML 教學 - 完整程式碼範例

本範例示範如何使用 Aspose.Words Cloud SDK for Java 將 EML 檔案轉換為 HTML。

import com.aspose.words.cloud.ApiException;
import com.aspose.words.cloud.Configuration;
import com.aspose.words.cloud.WordsApi;
import com.aspose.words.cloud.model.requests.ConvertDocumentRequest;

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

public class EmlToHtmlConversionDemo {

// Replace with your actual Aspose Cloud credentials
    private static final String CLIENT_ID = "YOUR_CLIENT_ID";
    private static final String CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Input and output file paths (use realistic generic names)
    private static final String INPUT_EML_PATH = "sample.eml";
    private static final String OUTPUT_HTML_PATH = "sample.html";

public static void main(String[] args) {
        Configuration config = new Configuration(CLIENT_ID, CLIENT_SECRET);
        WordsApi wordsApi = new WordsApi(config);

File inputFile = new File(INPUT_EML_PATH);
        if (!inputFile.exists() || !inputFile.isFile()) {
            System.err.println("Input EML file not found: " + INPUT_EML_PATH);
            return;
        }

// Convert EML to HTML using streaming to handle large files efficiently
        try (InputStream fileStream = new BufferedInputStream(new FileInputStream(inputFile), 8192)) {
            ConvertDocumentRequest request = new ConvertDocumentRequest(
                    fileStream,          // Input stream of the EML file
                    "html",              // Desired output format
                    null,                // outPath (null because we handle the result locally)
                    null,                // storage (null for default)
                    null,                // loadEncoding
                    null,                // password
                    null                 // fontsLocation
            );

// Perform conversion; the SDK returns the converted document as a byte array
            byte[] htmlBytes = wordsApi.convertDocument(request);

// Validate conversion result
            if (htmlBytes == null || htmlBytes.length == 0) {
                System.err.println("Conversion returned empty result.");
                return;
            }

// Write the HTML output to disk using buffered stream for performance
            try (OutputStream outStream = new BufferedOutputStream(new FileOutputStream(OUTPUT_HTML_PATH), 8192)) {
                outStream.write(htmlBytes);
                outStream.flush();
            }

// Simple validation: check that the output file exists and is non‑empty
            if (Files.size(Paths.get(OUTPUT_HTML_PATH)) > 0) {
                System.out.println("EML successfully converted to HTML. Output file: " + OUTPUT_HTML_PATH);
            } else {
                System.err.println("Generated HTML file is empty.");
            }

} catch (ApiException apiEx) {
            System.err.println("Aspose.Words Cloud API error:");
            System.err.println("Status Code: " + apiEx.getCode());
            System.err.println("Message: " + apiEx.getMessage());
        } catch (IOException ioEx) {
            System.err.println("I/O error during conversion:");
            ioEx.printStackTrace();
        } finally {
            // Explicitly close the API client if needed (SDK manages connections internally)
            try {
                wordsApi.close();
            } catch (Exception e) {
                // Ignored – best‑effort cleanup
            }
        }
    }
}

注意： 此程式碼範例展示了核心功能。在將其用於您的專案之前，請確保更新所有檔案路徑和設定值以符合實際環境，驗證所有必要的相依項目已正確安裝，並在開發環境中徹底測試。如果遇到任何問題，請參閱官方文件或聯繫支援團隊尋求協助。

將 EML 轉換為 HTML 使用 REST API 與 cURL

您可以透過直接呼叫 Aspose.Words Cloud REST API，而不需要編寫 Java 程式碼，即可達成相同的結果。以下步驟說明如何驗證、上傳 EML 檔案、請求轉換，並下載產生的 HTML。

1. 取得存取權杖

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. 上傳來源 EML 檔案至 Aspose Cloud 儲存

將 {access_token} 替換為先前步驟中的令牌。

curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/sample.eml" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@sample.eml"

3. 將上傳的 EML 檔案轉換為 HTML

curl -X POST "https://api.aspose.cloud/v4.0/words/convert?format=html&fileName=sample.eml" \
     -H "Authorization: Bearer {access_token}" \
     -o sample.html

API 會返回已轉換的 HTML 檔案，該檔案會儲存於本機，檔名為 sample.html。

4. 下載 HTML 檔案（如果您使用了上面的 -o 旗標，則為可選）

curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/sample.html" \
     -H "Authorization: Bearer {access_token}" \
     -o sample.html

如需更多詳細資訊，請參閱官方 API 文件。

深入解析 Java 中的 EML 轉換為 HTML

本節將逐步說明在 Java 中將 EML 轉換為 HTML 的教學。

  1. 配置初始化 - 使用您的 CLIENT_ID 和 CLIENT_SECRET 建立 Configuration 物件。
Configuration config = new Configuration(CLIENT_ID, CLIENT_SECRET);
  1. API 客戶端建立 - 使用配置實例化 WordsApi。
WordsApi wordsApi = new WordsApi(config);
  1. 輸入檔案驗證 - 程式碼會檢查 sample.eml 是否存在，然後才繼續執行。
File inputFile = new File(INPUT_EML_PATH);
if (!inputFile.exists() || !inputFile.isFile()) { ... }
  1. 串流 EML 檔案 - 緩衝輸入串流能有效讀取 EML 檔案，對於大型電子郵件至關重要。
try (InputStream fileStream = new BufferedInputStream(new FileInputStream(inputFile), 8192)) { ... }
  1. 轉換請求 - ConvertDocumentRequest 告訴 SDK 將串流轉換為 html。
ConvertDocumentRequest request = new ConvertDocumentRequest(
        fileStream,
        "html",
        null, null, null, null, null);
  1. 處理結果 - 返回的位元組陣列使用緩衝輸出流寫入 sample.html。
try (OutputStream outStream = new BufferedOutputStream(new FileOutputStream(OUTPUT_HTML_PATH), 8192)) {
    outStream.write(htmlBytes);
}

如需完整的請求參數清單，請參閱 API Reference。

安裝與設定 Aspose.Words Cloud SDK for Java

將 Maven 依賴項添加到您的 pom.xml（或等效的 Gradle 片段）。這將拉取 SDK 的最新版本。

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words-cloud</artifactId>
    <version>26.9.0</version>
</dependency>

您也可以直接從下載頁面下載 JAR。
確保已安裝 Java 8 或更高版本，並且已建立 Aspose Cloud 帳戶以取得 CLIENT_ID 和 CLIENT_SECRET。

配置 EML 到 HTML 的轉換參數

ConvertDocumentRequest 建構函式接受多個可選參數，讓您能控制轉換：

  • loadEncoding - 指定來源 EML 檔案的字元編碼（如果與 UTF‑8 不同）。
  • password - 當 EML 檔案受密碼保護時使用此欄位。
  • fontsLocation - 提供包含正確呈現所需自訂字型的資料夾路徑。

在提供的程式碼中，所有可選參數皆設為 null，這會告訴 SDK 使用預設值：

ConvertDocumentRequest request = new ConvertDocumentRequest(
        fileStream,
        "html",
        null,
        null,
        null,
        null,
        null);

如果您需要調整這些選項中的任何一項，請將相應的 null 替換為您想要的值。每個參數的詳細說明可在 API Reference 中找到。

結論

Java 中的 EML 轉 HTML 轉換教學展示了將電子郵件訊息轉換為可在網頁上顯示的 HTML 是多麼簡單，使用的是 Aspose.Words Cloud SDK for Java。遵循上述步驟，即可將轉換整合到伺服器端應用程式中，高效處理大型 EML 檔案，並透過 SDK 豐富的選項自訂輸出。正式部署時需要商業授權；授權價格詳情請參閱 價格頁面，亦可取得臨時授權以供評估。立即開始轉換，提升 Java 應用程式中的電子郵件體驗。

常見問題

Java 中的 EML 轉 HTML 轉換教學如何處理不同的字符編碼？
您可以通過 ConvertDocumentRequest 的 loadEncoding 參數傳遞所需的編碼。如果為 null，SDK 會自動嘗試檢測編碼。詳情請參閱 API Reference。

我可以在一次執行中轉換多個 EML 檔案嗎？
是的。將轉換邏輯包裝在迴圈中，遍歷每個檔案路徑，重複使用相同的 WordsApi 實例。此方法可減少開銷，且非常適合批次處理。

如果生成的 HTML 缺少原始電子郵件中的圖像怎麼辦？
嵌入的圖像預設以 base64 資料 URI 形式包含在 HTML 中。如果您需要外部圖像檔案，請使用 Aspose.Email Cloud SDK 從 EML 中提取，並在 HTML 中手動引用它們。

是否有方法提升對非常大的 EML 檔案的轉換效能？
使用 BufferedInputStream 來串流輸入（如程式碼所示）可減少記憶體使用量。此外，您可以增大緩衝區大小，或在具有更多 CPU 核心的機器上執行轉換，以加快處理速度。SDK 設計用於高吞吐量情境，適合企業工作負載。

閱讀更多