如何使用 GroupDocs.Editor for Java 建立可編輯的電郵文件

在當今的數位時代，有效管理電郵檔案對企業與個人皆相當重要。建立可編輯的電郵文件 讓您能修改內容、擷取資訊，或轉換成其他格式（如 HTML）。本教學將說明如何使用 GroupDocs.Editor for Java 載入 MSG 電郵、編輯它，並可選擇將其呈現為 HTML——同時保持程式碼簡潔且效能佳。

快速解答

「建立可編輯的電郵文件」是什麼意思？
意指將電郵檔案（例如 MSG）載入一個可程式化修改的物件中。
我可以用 Java 把電郵轉成 HTML 嗎？
可以——使用 EmailEditOptions，並從 EditableDocument 取得內嵌的 HTML。
試用這功能需要授權嗎？
提供免費試用版；正式上線需購買授權。
應該使用哪個 Maven 版本？
建議使用 GroupDocs.Editor 25.3 版或更新版本。
API 是否支援多執行緒安全？
每個 Editor 實例彼此獨立；為確保安全，請於每個執行緒建立新實例。

什麼是「建立可編輯的電郵文件」？

建立可編輯的電郵文件是指將電郵檔案（MSG、EML 等）載入 GroupDocs.Editor，讓系統解析訊息並將其各部份（主旨、內文、附件）以可編輯物件呈現。如此即可修改電郵內容、注入新 HTML，或擷取資料供後續處理。

為什麼在 Java 中使用 GroupDocs.Editor 轉換電郵為 HTML？

將 電郵轉成 HTML Java 可取得網頁可直接顯示的訊息表示，方便在瀏覽器中呈現、嵌入報告，或供其他系統使用。GroupDocs.Editor 能處理複雜的 MIME 結構、保留格式，且自動支援附件。

前置條件

安裝 Java Development Kit (JDK) 8+。
使用 Maven 進行相依管理（或手動下載 JAR）。
具備 Java I/O 與電郵格式（MSG/EML）的基本知識。
取得 GroupDocs.Editor 授權（試用版可用於評估）。

設定 GroupDocs.Editor for Java

GroupDocs.Editor 以 Maven 發佈，整合相當簡易。

Maven 設定

將以下儲存庫與相依加入 pom.xml：

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

直接下載

您也可以從 GroupDocs.Editor for Java releases 下載最新版本。

取得授權

先使用免費試用版探索功能。
取得永久授權以供正式部署。

基本初始化

以下程式碼片段示範建立 Editor 實例以處理 MSG 檔案的最小需求：

import com.groupdocs.editor.Editor;

String msgInputPath = "YOUR_DOCUMENT_DIRECTORY/sample.msg";
Editor editor = new Editor(msgInputPath);
editor.dispose();

專業提示： 完成編輯後務必呼叫 dispose()，釋放原生資源。

實作指南

我們將逐步說明 建立可編輯的電郵文件、編輯內容，並儲存結果的完整流程。

載入電郵檔案至 Editor

概述： 使用 GroupDocs.Editor API 載入 MSG 電郵檔案。

步驟 1：定義文件路徑

String msgInputPath = "YOUR_DOCUMENT_DIRECTORY/sample.msg";

步驟 2：初始化 Editor 實例

import com.groupdocs.editor.Editor;

Editor msgEditor = new Editor(msgInputPath);
// Always dispose resources after usage to free up memory.
mseEditor.dispose();

建立電郵編輯選項

概述： 設定編輯選項，告訴 Editor 哪些電郵部份可供編輯。

步驟 1：設定編輯選項

import com.groupdocs.editor.options.EmailEditOptions;

EmailEditOptions editOptions = new EmailEditOptions(EmailEditOptions.ALL);

從電郵檔案產生可編輯文件

概述： 產生可供操作或渲染為 HTML 的 EditableDocument。

步驟 1：建立 EditableDocument

import com.groupdocs.editor.EditableDocument;

EditableDocument originalDoc = msgEditor.edit(editOptions);
// Obtain HTML content for client‑side manipulation (optional)
String savedHtmlContent = originalDoc.getEmbeddedHtml();
originalDoc.dispose();

建立電郵檔案的儲存選項

概述： 定義編輯後的電郵如何儲存——完整 MSG、精簡版，或僅保留特定部份。

步驟 1：定義儲存選項

import com.groupdocs.editor.options.EmailSaveOptions;

EmailSaveOptions saveOptions1 = new EmailSaveOptions(EmailSaveOptions.COMMON);
EmailSaveOptions saveOptions2 = new EmailSaveOptions(
    EmailSaveOptions.BODY | EmailSaveOptions.ATTACHMENTS);

將編輯後的文件儲存至檔案與串流

概述： 將變更寫入新 MSG 檔案或直接寫入記憶體串流以供後續處理。

步驟 1：儲存至檔案

String outputMsgPath1 = "YOUR_OUTPUT_DIRECTORY/outputFile1.msg";
mseEditor.save(originalDoc, outputMsgPath1, saveOptions1);

步驟 2：儲存至串流

import java.io.ByteArrayOutputStream;

ByteArrayOutputStream outputMsgStream = new ByteArrayOutputStream();
mseEditor.save(originalDoc, outputMsgStream, saveOptions2);
originalDoc.dispose();
mseEditor.dispose();

實務應用

真實案例

電郵歸檔： 將收到的 MSG 檔案轉換為標準化、可搜尋的格式，以便長期保存。
內容擷取： 抽取正文、主旨或附件，用於分析或遷移。
資料整合： 將電郵內容自動匯入 CRM 或工單系統，免除手動複製貼上。

整合可能性

CRM 自動化： 自動填入客戶紀錄的電郵正文與附件。
協作平台： 在 Web 入口網站中呈現電郵 HTML，供團隊審閱。

效能考量

提前釋放： 完成後立即呼叫 dispose() 釋放 Editor 與 EditableDocument。
批次處理： 處理數千封電郵時，分批執行以降低記憶體使用。
保持更新： 新版函式庫會帶來效能優化與錯誤修正，請維持 Maven 版本為最新。

常見問題與技巧

問題	為何會發生	解決方式
`NullPointerException` 於 `originalDoc.getEmbeddedHtml()`	Editor 未以正確的編輯選項初始化。	使用 `EmailEditOptions.ALL` 或指定需要的部份。
大型 MSG 檔案導致記憶體不足	整封電郵一次載入記憶體。	將大型電郵分段處理，或直接串流儲存而不提取 HTML。
儲存後附件遺失	儲存選項未包含 `ATTACHMENTS`。	建構 `EmailSaveOptions` 時加入 `EmailSaveOptions.ATTACHMENTS`。

常見問答

Q: 如何有效處理大型電郵檔案？
A: 將電郵分批處理，並在使用完 Editor 與 EditableDocument 後即時釋放資源。

Q: GroupDocs.Editor 支援所有電郵格式嗎？
A: 支援常見的 MSG 與 EML 格式。完整支援清單請參考最新文件。

Q: 我可以將 GroupDocs.Editor 整合到現有的 Java 應用程式嗎？
A: 當然可以。API 設計為即插即用——只要加入 Maven 相依並在需要的地方實例化 Editor 即可。

Q: 使用 GroupDocs.Editor 會有什麼效能影響？
A: 函式庫已針對大型檔案做最佳化，但仍建議監控記憶體使用並適時釋放資源，以免發生記憶體洩漏。

Q: 若遇到問題該向哪裡求助？
A: 可前往 support forum 或參考官方文件。

資源

文件說明： https://docs.groupdocs.com/editor/java/
API 參考： https://reference.groupdocs.com/editor/java/
下載： https://releases.groupdocs.com/editor/java/
免費試用： https://releases.groupdocs.com/editor/java/

最後更新： 2026-02-06
測試環境： GroupDocs.Editor 25.3 (Java)
作者： GroupDocs