使用 GroupDocs.Parser for Java 從 msg 提取附件

以程式方式管理電子郵件附件是構建自動歸檔、安全掃描或資料抽取工作流程的 Java 開發人員的常見需求。在本教學中，您將學習 如何從 MSG 檔案提取附件、列印其中繼資料，並了解此方法在實務專案中的價值。使用 GroupDocs.Parser for Java 可讓您高效處理大型郵箱，同時保持低記憶體使用量。

快速解答

  • 應該使用哪個函式庫？ GroupDocs.Parser for Java.
  • 我可以從 .msg 檔案提取附件嗎？ 是的，API 可直接存取每個附件。
  • 我需要授權嗎？ 試用版可用於評估；正式環境需要完整授權。
  • 支援哪個 Java 版本？ Java 8 或更高版本。
  • 是否支援批次處理？ 當然可以 — 可將範例程式碼與迴圈或平行串流結合。

什麼是「從 msg 提取附件」？

當您收到 Outlook .msg 檔案時，郵件正文與其附件會一起儲存。「從 msg 提取附件」指的是以程式方式將每個附件分離，讓您能獨立儲存、分析或轉換它們。

為什麼使用 GroupDocs.Parser for Java？

GroupDocs.Parser for Java 是專門的電子郵件解析函式庫。它支援超過 70 種輸入與輸出格式，且可在不將整個文件載入記憶體的情況下處理高達 2 GB 的檔案，因此非常適合大量情境。API 亦可即時取得附件的中繼資料（檔名、大小、建立時間），且可在任何支援 Java 8+ 的平台上執行。

前置條件

  • Java Development Kit (JDK)： 8 版或更新版本。
  • IDE： IntelliJ IDEA、Eclipse，或任何相容 Java 的編輯器。
  • GroupDocs.Parser library： 透過 Maven 或手動加入 JAR（請參考下方）。

設定 GroupDocs.Parser for Java

Maven 設定

將以下設定加入您的 pom.xml 檔案，以透過 Maven 整合 GroupDocs.Parser：

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

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

直接下載

或者，從 GroupDocs.Parser for Java releases page 下載最新版本。手動將 JAR 檔案加入專案的 classpath。

取得授權

GroupDocs 提供多種授權選項：

  • Free trial： 功能受限的評估版。
  • Temporary license： 在短期評估期間提供完整存取。
  • Commercial license： 生產環境部署必須的授權。

依官方文件說明加入取得的授權檔案，即可解鎖全部功能。

基本初始化

Parser 類別是載入與處理文件的入口點。

import com.groupdocs.parser.Parser;

public class SetupExample {
    public static void main(String[] args) {
        // Initialize the Parser object with an email file path.
        try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY/sample.msg")) {
            System.out.println("GroupDocs.Parser is set up successfully!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

現在 parser 已就緒，讓我們深入核心任務：如何從 msg 提取附件 並列印其中繼資料。

如何使用 GroupDocs.Parser 從 msg 提取附件？

載入 MSG 檔案、列舉其附件，並在幾行程式碼內列印中繼資料。以下步驟展示您需要遵循的精確順序。此方法適用於單一檔案與批次處理，且透過 try‑with‑resources 確保資源即時釋放。

步驟 1：初始化 parser 物件

提供欲分析的 MSG 檔案路徑，以建立 Parser 實例。

try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY/sample.msg")) {
    // Proceed with attachment extraction.
}

步驟 2：提取附件

Container 代表電子郵件訊息，提供對其內嵌項目（如附件）的存取。

Iterable<ContainerItem> attachments = parser.getContainer();
if (attachments == null) {
    System.out.println("No attachments found.");
    return;
}

for (ContainerItem item : attachments) {
    // Continue to parse each attachment.
}

步驟 3：解析每個附件（java 解析電子郵件附件）

ContainerItem 描述單一附件，公開其串流與中繼資料以供後續處理。

try (Parser attachmentParser = item.openParser()) {
    try (TextReader reader = attachmentParser.getText()) {
        String attachmentText = reader == null ? "No text" : reader.readToEnd();
        // Handle or process the extracted text as needed.
    }
} catch (UnsupportedDocumentFormatException ex) {
    System.out.println("Unsupported document format.");
}

步驟 4：列印附件中繼資料

metadata 物件包含每個附件的檔名、大小、建立時間等欄位。

for (ContainerItem item : attachments) {
    System.out.println("File Path: " + item.getFilePath());

    // Proceed to retrieve metadata.
}

for (MetadataItem metadata : item.getMetadata()) {
    System.out.println(String.format("%s: %s", metadata.getName(), metadata.getValue()));
}

常見問題與解決方案

  • Unsupported formats： 若遇到 UnsupportedDocumentFormatException，請升級至最新的 GroupDocs.Parser 版本。
  • Null attachments： 確認來源 .msg 確實包含附件；有些訊息僅有正文。
  • Memory consumption： 處理大型郵箱時，請分批處理附件並即時關閉 parser（try‑with‑resources 模式已協助）。

實務應用

提取並列印附件中繼資料可用於：

  1. Data archiving： 將附件與其中繼資料一起儲存，以符合稽核需求。
  2. Email filtering： 依附件類型或大小自動分流訊息。
  3. Security scanning： 在深入內容檢查前，將中繼資料送入惡意程式偵測流程。

效能建議

  • Resource management： 永遠使用 try‑with‑resources 釋放原生句柄。
  • Batch processing： 每個執行緒處理有限數量的郵件，以保持記憶體使用可預測。
  • Parallel execution： 利用 Java 的 ExecutorService 同時解析多個 .msg 檔案。

常見問答

Q: 如何有效處理大量 .msg 檔案？
A: 將範例程式碼與執行緒池（例如 Executors.newFixedThreadPool）結合，讓每個檔案在獨立任務中處理。保持 parser 實例短暫生命以避免記憶體洩漏。

Q: 我能從加密或受密碼保護的郵件中提取附件嗎？
A: 當您透過 Parser 建構子重載提供正確密碼時，GroupDocs.Parser 支援加密的 .msg 檔案。

Q: 每個附件提供哪些中繼資料欄位？
A: 常見欄位包括 FilePath、Size、CreationTime，以及任何自訂的 Outlook 屬性，如 ContentId。

Q: 有沒有方法在解析前依檔案類型過濾附件？
A: 有，檢查 item.getFilePath() 或 metadata.getName() 的副檔名，並跳過不需要的類型。

Q: 此函式庫能在非 Windows 平台上運作嗎？
A: GroupDocs.Parser 為跨平台套件，可在任何支援 Java 8+ 的作業系統上執行。

結論

您現在已擁有完整、可投入生產的工作流程，使用 GroupDocs.Parser for Java 從 msg 檔案提取附件 並列印其中繼資料。此基礎讓您能構建更完整的解決方案——歸檔管線、安全掃描器或自訂郵件處理器——同時保持程式碼簡潔且效能優異。

探索其他功能，例如全文抽取、結構化資料解析，或將附件轉換為其他格式。GroupDocs 文件 提供更深入的範例與 API 參考，協助您進一步擴充本教學。

Last Updated: 2026-08-26
測試版本： GroupDocs.Parser 25.5
作者： GroupDocs

相關教學