Java 電子郵件解析庫 – GroupDocs.Parser 提取教學

如果您希望將功能強大的 java email parsing library 整合到您的 Java 應用程式中，您來對地方了。在本指南中，我們將說明 GroupDocs.Parser 為何突出、如何設定，以及逐步的免寫程式碼說明，從 PST/OST 檔案、EML/MSG 壓縮檔以及即時 Exchange 伺服器中提取電子郵件文字、附件與中繼資料。您還會找到實務案例、效能技巧，以及可直接使用的範例連結，讓您即刻套用。

快速解答

  • 什麼是最佳的 Java 電子郵件解析庫？ GroupDocs.Parser 是一個功能完整的 java email parsing library，支援 PST、OST、EML、MSG，以及 Exchange 伺服器來源。
  • 我可以從電子郵件中提取純文字嗎？ 是的——使用庫的 extractText() 方法即可取得乾淨的電子郵件文字（Java 風格）。
  • 我需要授權才能在生產環境使用嗎？ 測試時可使用臨時授權；在生產部署時需要商業授權。
  • 支援哪些電子郵件格式？ PST、OST、EML、MSG，以及直接的 Exchange 伺服器連線。
  • 此庫相容於 Java 11 以上嗎？ 當然——GroupDocs.Parser 可在 Java 8 及更新版本上執行，包括 Java 11、17 與 21。

什麼是 Java 電子郵件解析庫？

java email parsing library 是一組 API，負責讀取原始電子郵件檔案或伺服器串流，並將其轉換為結構化物件，如訊息、附件與標頭。它抽象化格式特有的差異，讓您專注於業務邏輯，而非低階解析。

為什麼使用 GroupDocs.Parser 進行電子郵件提取？

GroupDocs.Parser 提供統一且高效能的解決方案，以處理多種電子郵件格式。它提供單一 API 介面、快速處理、豐富的中繼資料，以及跨平台相容性。

可量化的效益

GroupDocs.Parser 支援 50+ 種輸入與輸出格式（包括 PST、OST、EML、MSG、MBOX 以及多種專有的 Exchange 格式），且可在不將整個檔案載入記憶體的情況下，為每封訊息提取 最高 200 MB 附件。其串流架構即使在處理多吉位元組的郵件檔案時，峰值記憶體使用量也低於 150 MB。

前置條件

  • 已安裝 Java Development Kit (JDK) 8 或更高版本。
  • 用於相依管理的 Maven 或 Gradle。
  • 有效的 GroupDocs.Parser for Java 授權（臨時授權可用於測試）。

Maven 相依性

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-parser</artifactId>
    <version>23.12</version>
</dependency>

專業提示： 若遇到相依解析錯誤，請加入官方文件中的儲存庫片段。

可用教學

使用 GroupDocs.Parser for Java 高效提取電子郵件中的圖片

了解如何使用 GroupDocs.Parser for Java 高效提取電子郵件檔案中的圖片。本指南涵蓋設定、實作與實務應用。

如何使用 GroupDocs.Parser Java 從 Exchange 伺服器提取電子郵件

逐步說明如何連接 Exchange、串流訊息，並在不下載整個信箱的情況下提取內容。

如何使用 GroupDocs.Parser 在 Java 中提取電子郵件文字：逐步指南

詳細說明如何載入 PST/EML 檔案、取得訊息，並提取乾淨的純文字內容。

如何在 Java 中使用 GroupDocs.Parser 提取電子郵件文字？

Parser 類別是開啟任何支援的電子郵件來源的入口點。使用 Parser 類別載入 PST 或 EML 檔案，然後呼叫 extractText() —— 這是純文字提取的核心兩步模式。此庫會自動處理多部份 MIME、HTML 轉文字的轉換，以及字元集偵測，提供乾淨的 Unicode 字串，隨時可用於索引或分析。

步驟 1：初始化 Parser

Parser 類別是 GroupDocs.Parser 開啟任何支援的電子郵件來源的入口點。

Parser parser = new Parser("path/to/mailbox.pst");

步驟 2：從特定訊息提取文字

Message 物件代表單一電子郵件，包含其內容、標頭與附件。對從 parser 取得的 Message 物件使用 extractText() 方法。此方法會回傳電子郵件內容的純文字 String。

Message message = parser.getMessage(0); // zero‑based index
String plainText = message.extractText();
System.out.println(plainText);

為什麼重要： 透過提取純文字，您可以將內容輸入搜尋索引、情感分析引擎或自動化工單系統，而不必處理 HTML 標籤或嵌入的圖片。

如何從 PST 或 OST 檔案提取附件？

GroupDocs.Parser 將每個附件視為獨立的 Attachment 物件，您可以直接將其串流至磁碟。此方法避免將大型檔案載入記憶體，且支援最高 2 GB 大小的附件。Attachment 類別封裝了電子郵件的附加檔案，提供串流功能以降低記憶體使用量。

步驟 1：取得附件集合

Message 類別提供 getAttachments() 方法，回傳 Attachment 物件的清單。

List<Attachment> attachments = message.getAttachments();

步驟 2：將每個附件串流至檔案

對每個附件呼叫 save() 方法，傳入您選擇的 OutputStream。此庫會自動處理 MIME 解碼。

for (Attachment att : attachments) {
    try (FileOutputStream fos = new FileOutputStream("output/" + att.getFileName())) {
        att.save(fos);
    }
}

專業提示： 若只需要 PDF 或圖片，可依 MIME 類型 (att.getContentType()) 篩選附件，以減少 I/O 負擔。

如何連接至 Exchange 伺服器並串流電子郵件？

ExchangeClient 類別是 GroupDocs.Parser 用於 Microsoft Exchange Web Services (EWS) 與 IMAP 的高階連接器。它會逐封串流訊息，讓您不必下載整個信箱。此串流功能支援即時處理、合規監控與自動化工作流程，且不需要大量儲存空間。

步驟 1：設定 ExchangeClient

提供伺服器 URL、認證資訊，並可選擇信箱資料夾名稱。客戶端會在內部處理驗證與分頁。

ExchangeClient client = new ExchangeClient(
    "https://mail.example.com/EWS/Exchange.asmx",
    "user@example.com",
    "password"
);
client.setFolder("Inbox");

步驟 2：遍歷訊息

使用 enumerateMessages() 方法取得 Iterable<Message>，並在訊息到達時逐一處理。

for (Message msg : client.enumerateMessages()) {
    System.out.println("Subject: " + msg.getSubject());
    System.out.println("Body: " + msg.extractText());
}

為什麼重要： 串流讓您能即時處理收到的郵件，用於合規監控、自動回覆機器人或 CRM 整合，而不需大量儲存空間。

常見問題與解決方案

問題典型症狀建議解決方案
受密碼保護的 PSTParserException: Access denied將密碼傳入 Parser 建構子：new Parser("file.pst", "password")。
大型信箱記憶體不足JVM 因 java.lang.OutOfMemoryError 而崩潰啟用串流模式：parser.setLoadOptions(LoadOptions.STREAMING)。
附件內容缺失附件顯示為零位元組確保呼叫 attachment.save(outputStream) 而非讀取可能延遲載入的 attachment.getData()。
日期格式不正確日期顯示為 UTC 而非本地時間使用 msg.getMetadata().getSentDate().toInstant().atZone(ZoneId.systemDefault())。
Exchange 限流API 回傳 429 Too Many Requests實作指數退避，並遵守伺服器提供的 Retry-After 標頭。

常見問答

Q: 我可以解析受密碼保護的 PST 檔案嗎？
A: 可以。於初始化 Parser 物件時提供密碼，庫會即時解密檔案。

Q: GroupDocs.Parser 支援從 Exchange 伺服器串流嗎？
A: 當然支援。使用 ExchangeClient 類別透過 EWS 或 IMAP 連接，並遍歷訊息而不下載整個信箱。

Q: 我該如何處理大型附件而不耗盡記憶體？
A: 使用 save() 方法將附件內容直接串流至檔案或輸出串流，而非完整載入記憶體。

Q: 有辦法只提取未讀的電子郵件嗎？
A: 有。於遍歷訊息前，以適當的過濾條件 (IsRead = false) 查詢信箱。

Q: 如果電子郵件正文中包含嵌入圖片該怎麼辦？
A: 此庫將嵌入圖片視為獨立的附件物件；您可以取得它們，必要時再嵌入回 HTML 中。

其他資源

結論

透過使用 GroupDocs.Parser，您只需幾行 Java 程式碼，即可將混亂的電子郵件檔案轉換為結構化、可搜尋的資料。無論是遷移舊有信箱、建置合規儀表板，或自動化工單建立，這個 java email parsing library 為您提供所需的效能、格式支援與開發者友善的 API。探索上述連結的教學以取得具體程式碼範例，立即開始從每封訊息中提取價值。

最後更新： 2026-06-17
測試環境： GroupDocs.Parser for Java 23.12（撰寫時的最新版本）
作者： GroupDocs

相關教學