eml 轉 pdf java – 使用 GroupDocs 轉換電子郵件為 PDF

在許多企業中，將電子郵件訊息存檔為不可變更的 PDF 對於合規、法律取證以及輕鬆共享至關重要。本教學展示如何使用 GroupDocs.Conversion 將 .eml 檔案轉換為 Java 中的 PDF，同時讓您完全控制最終文件中顯示的電子郵件欄位。您將看到如何隱藏敏感標頭、設定 Maven 相依性，以及為大量批次優化效能。

快速解答

• 哪個函式庫負責電子郵件轉 PDF 的轉換？ GroupDocs.Conversion for Java.
• 需要哪個 Maven 套件？ com.groupdocs:groupdocs-conversion.
• 我可以隱藏寄件者/收件者資訊嗎？ 是的 — 使用 EmailLoadOptions 來控制可見性。
• 生產環境是否需要授權？ 需要有效的 GroupDocs 授權才能在非試用模式下使用。
• 支援哪個 Java 版本？ Java 8 或更高版本。

什麼是電子郵件轉 PDF 轉換？

電子郵件轉 PDF 轉換會將 .msg、.eml 或其他電子郵件格式轉換為靜態、可攜帶的 PDF 文件。此過程保留原始訊息版面，同時允許您編輯（遮蔽）敏感資訊，如電子郵件地址、標頭或 CC/BCC 欄位，以及附件。

為何在 Java 中使用 GroupDocs.Conversion？

GroupDocs.Conversion 提供一個 java pdf conversion library，支援超過 100 種輸入與輸出格式，包括 EML、MSG、PDF、DOCX 與 HTML。它提供細緻的 EmailLoadOptions，讓您精確決定電子郵件的哪些部分會顯示在 PDF 中，且可與 Maven 無縫整合，方便相依性管理。

前置條件

• Java Development Kit (JDK) 8+ 已安裝。
• Maven 用於相依性管理（請參閱下方 maven dependency groupdocs conversion 章節）。
• 具備 Java 與 Maven 專案的基本熟悉度。

設定 GroupDocs.Conversion for Java

將 GroupDocs 儲存庫與轉換相依性加入您的 pom.xml。這是您需要的 groupdocs conversion maven 設定。

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/conversion/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-conversion</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

取得授權

• Free Trial – 無償探索所有功能。
• Temporary License – 申請短期金鑰以延長評估。
• Purchase – 取得完整授權以供生產環境部署。

如何使用進階選項將 eml 轉換為 pdf（Java）？

EmailLoadOptions 定義在轉換過程中哪些電子郵件部分會被渲染。載入您的 .eml 檔案、設定要顯示的欄位，然後呼叫轉換器——只需幾個簡潔步驟。本回答在 70 個字以內提供完整工作流程。您將建立 EmailLoadOptions、設定 PDF 轉換設定，並呼叫 convert 方法，處理可能拋出的例外。

步驟 1：設定 Email 載入選項

EmailLoadOptions 讓您切換個別電子郵件區段（如寄件者、收件者與標頭）的可見性。

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions loadOptions = new EmailLoadOptions();
loadOptions.setDisplayHeader(false);
loadOptions.setDisplayFromEmailAddress(false);
loadOptions.setDisplayToEmailAddress(false);
loadOptions.setDisplayEmailAddress(false);
loadOptions.setDisplayCcEmailAddress(false);
loadOptions.setDisplayBccEmailAddress(false);
loadOptions.setConvertOwned(false); // Prevent conversion of fields that are owned by the document

步驟 2：初始化 Converter

Converter 是使用提供的載入與轉換選項執行轉換的引擎。

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG", () -> loadOptions);

步驟 3：設定 PDF 轉換選項

PdfConvertOptions 設定 PDF 輸出參數，例如頁面大小與壓縮。

PdfConvertOptions options = new PdfConvertOptions();

步驟 4：執行轉換

呼叫 convert，傳入目標檔案路徑與您先前定義的 PDF 選項。此方法回傳布林值以表示是否成功。

converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertEmailWithAlteringFieldsVisibility.pdf", options);

如何將 msg 轉換為 pdf java（重複使用相同選項）

EmailLoadOptions 定義在轉換過程中哪些電子郵件部分會被渲染。如果您需要處理 Outlook .msg 檔案，則相同的 EmailLoadOptions 與 Converter 工作流程適用。只需將來源檔案路徑換成 .msg 檔案。您也可以調整載入選項以隱藏或顯示特定標頭，並重複使用相同的 PdfConvertOptions，以在不同格式間維持一致的輸出品質。

步驟 1：設定 Email 載入選項（重複使用）

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions emailLoadOptions = new EmailLoadOptions();
emailLoadOptions.setDisplayHeader(false);
emailLoadOptions.setDisplayFromEmailAddress(false);
emailLoadOptions.setDisplayToEmailAddress(false);
emailLoadOptions.setDisplayEmailAddress(false);
emailLoadOptions.setDisplayCcEmailAddress(false);
emailLoadOptions.setDisplayBccEmailAddress(false);
emailLoadOptions.setConvertOwned(false); // Do not convert owned fields

步驟 2：使用 Email 載入選項初始化 Converter

Converter emailConverter = new Converter("EMAIL_FILE_PATH", () -> emailLoadOptions);

實務應用

以下是三個 email to pdf conversion 發揮優勢的實際情境：

1. Legal Documentation – 在與客戶分享電子郵件證據前，先遮蔽個人資料。
2. Corporate Archiving – 將內部通訊以標準化、唯讀的格式儲存，以供長期保存。
3. Personal Organization – 保持重要訊息的乾淨 PDF 檔案庫，避免暴露不必要的地址。

效能考量

• File‑size optimisation – 處理較小批次或啟用 PDF 壓縮 (PdfConvertOptions.setCompressionLevel(CompressionLevel.Maximum)) 以將典型 10 頁電子郵件的輸出控制在 2 MB 以下。
• Memory management – 使用 Java 的串流 API，並在轉換多 MB 的 .msg 檔案時增加 JVM 堆積 (-Xmx2g)。
• Version upgrades – 最新的 GroupDocs.Conversion 版本將轉換速度提升最高 30 %，相較於 24.x 版。

常見問題與解決方案

常見問答

Q: GroupDocs.Conversion for Java 是什麼？
A: 它是一個 Java 函式庫，支援超過 100 種檔案格式之間的轉換，包括電子郵件轉 PDF，具備高保真度且不需外部相依性。

Q: 如何在轉換過程中確保電子郵件隱私？
A: 在轉換前使用 EmailLoadOptions 關閉寄件者、收件者以及 CC/BCC 位址等欄位。

Q: 除了電子郵件，我可以轉換其他文件類型嗎？
A: 可以，該函式庫亦支援 Word、Excel、PowerPoint、影像等多種格式。

Q: 轉換大型電子郵件的記憶體需求為何？
A: 至少配置 2 GB 的堆積 (-Xmx2g)，並考慮分批處理檔案以維持在記憶體限制內。

Q: 我可以在哪裡找到更多關於 GroupDocs.Conversion 的資訊？
A: 請參閱官方文件與API 參考。另見GroupDocs.Conversion for Java 文件與GroupDocs.Conversion API 參考。

最後更新： 2026-05-21
測試環境： GroupDocs.Conversion 25.2
作者： GroupDocs

相關教學

• msg 轉 pdf java – 使用 GroupDocs 的電子郵件格式轉換
• 如何在 Java 中使用 GroupDocs.Conversion 以時區偏移將電子郵件轉為 PDF
• 設定 GroupDocs Conversion Maven - 在 Java 中將 CSV 轉為 PDF – 步驟指南