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

以程式方式管理電子郵件附件是從事自動化歸檔、安全掃描或資料抽取流程的 Java 開發人員的常見需求。在本教學中，您將學習 如何從 msg 檔案中提取附件、列印其中繼資料，並了解此方法在實務專案中的價值。

快速解答

  • What library should I use? GroupDocs.Parser for Java.
  • Can I extract attachments from .msg files? Yes, the API provides direct access to each attachment.
  • Do I need a license? A trial works for evaluation; a full license is required for production.
  • Which Java version is supported? Java 8 or higher.
  • Is bulk processing possible? Absolutely – combine the sample code with loops or parallel streams.

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

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

為什麼使用 GroupDocs.Parser for Java？

  • Robust format support – Handles .msg, .eml, and many other email formats.
  • Metadata access – Retrieve file paths, sizes, and custom attributes without manual parsing.
  • Simple API – Minimal code required to open a message, iterate attachments, and read content.
  • Performance‑focused – Uses streaming and try‑with‑resources to keep memory usage low.

前置條件

  • Java Development Kit (JDK): Version 8 or newer.
  • IDE: IntelliJ IDEA, Eclipse, or any Java‑compatible editor.
  • GroupDocs.Parser library: Added via Maven or manual JAR inclusion (see below).

設定 GroupDocs.Parser for Java

Maven 設定

Add the following configurations to your pom.xml file to integrate GroupDocs.Parser via Maven:

<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>

直接下載

Alternatively, download the latest version from the GroupDocs.Parser for Java releases page. Add the JAR file to your project’s classpath manually.

取得授權

GroupDocs offers several licensing options:

  • Free Trial: Limited‑feature evaluation.
  • Temporary License: Full access during a short evaluation period.
  • Commercial License: Required for production deployments.

Include the acquired license file as described in the official documentation to unlock all features.

基本初始化

Here’s a minimal example that proves the library is correctly referenced:

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();
        }
    }
}

Now that the parser is ready, let’s dive into the core task: how to extract attachments from msg and print their metadata.

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

步驟 1：初始化 Parser 物件

Create a Parser instance pointing at the .msg file you want to process:

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

步驟 2：提取附件

Use the container API to retrieve every attachment embedded in the email:

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 解析電子郵件附件）

For each ContainerItem, open a dedicated parser instance. This lets you read the attachment’s content if it’s a text‑based format:

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：列印附件中繼資料

Now that you have each attachment object, you can display its metadata—file path, size, and any custom attributes:

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: Upgrade to the latest GroupDocs.Parser version if you encounter UnsupportedDocumentFormatException.
  • Null Attachments: Verify that the source .msg actually contains attachments; some messages are body‑only.
  • Memory Consumption: When processing large mailboxes, handle attachments in batches and close parsers promptly (the try‑with‑resources pattern already helps).

實務應用

Extracting and printing attachment metadata is useful for:

  1. Data Archiving: Store attachments alongside their metadata for compliance audits.
  2. Email Filtering: Automatically route messages based on attachment type or size.
  3. Security Scanning: Feed metadata into malware‑detection pipelines before deep content inspection.

效能建議

  • Resource Management: Always use try‑with‑resources to free native handles.
  • Batch Processing: Process a limited number of emails per thread to keep memory usage predictable.
  • Parallel Execution: Leverage Java’s ExecutorService to parse multiple .msg files concurrently.

常見問答

Q: How do I handle a large number of .msg files efficiently?
A: Combine the sample code with a thread pool (e.g., Executors.newFixedThreadPool) and process each file in its own task. Remember to keep the parser instances short‑lived to avoid memory leaks.

Q: Can I extract attachments from encrypted or password‑protected emails?
A: GroupDocs.Parser supports encrypted .msg files when you provide the correct password through the Parser constructor overload.

Q: What metadata fields are available for each attachment?
A: Typical fields include FilePath, Size, CreationTime, and any custom properties that Outlook stores (e.g., ContentId).

Q: Is there a way to filter attachments by file type before parsing?
A: Yes, inspect item.getFilePath() or metadata.getName() for the file extension and skip unwanted types.

Q: Does the library work on non‑Windows platforms?
A: GroupDocs.Parser is cross‑platform; it runs on any OS that supports Java 8+.

結論

You now have a complete, production‑ready workflow for extract attachments from msg files and print their metadata using GroupDocs.Parser for Java. This foundation lets you build richer solutions—archiving pipelines, security scanners, or custom email processors—while keeping your code clean and performant.

Explore additional capabilities such as full‑text extraction, structured data parsing, or converting attachments to other formats. The GroupDocs documentation provides deeper examples and API references to help you extend this tutorial further.

最後更新： 2026-01-27
測試版本： GroupDocs.Parser 25.5
作者： GroupDocs