使用 GroupDocs.Watermark 在 Java 中管理電子郵件附件：完整指南

在當今的數位環境中，管理電子郵件附件對於需要歸檔文件、確保安全通訊或將電子郵件整合至更大工作流程的企業而言至關重要。本教學將帶領您使用 GroupDocs.Watermark for Java 來載入電子郵件、以 add email attachment Java 方式新增附件、處理 multiple attachments Java，並儲存更新後的訊息——同時保持程式碼簡潔且效能良好。

快速解答

  • 主要的函式庫是什麼？ GroupDocs.Watermark for Java
  • 如何新增附件？ Use EmailContent.getAttachments().add(byte[], fileName)
  • 我可以一次新增多個附件嗎？ Yes—call the add method for each file
  • 是否需要授權？ A temporary or full license is required for production use
  • 支援哪個 Java 版本？ JDK 8 or later

什麼是管理電子郵件附件？

管理電子郵件附件指的是以程式方式讀取、加入、移除或更新附加於電子郵件訊息的檔案。使用 GroupDocs.Watermark，您可以將電子郵件視為文件，操作其內容，並保留時間戳記、寄件者資訊等中繼資料。

為什麼使用 GroupDocs.Watermark for Java？

  • 強大的格式支援： Handles MSG, EML, and other email formats out‑of‑the‑box.
  • 浮水印與安全功能： Add watermarks or digital signatures to both the email body and its attachments.
  • 簡易 API： Intuitive classes like Watermarker, EmailLoadOptions, and EmailContent streamline development.

前置條件

在深入之前，請確保您已具備以下條件：

  1. Java Development Kit (JDK) 8+ 已安裝。
  2. IDE（IntelliJ IDEA、Eclipse 或 VS Code）。
  3. GroupDocs.Watermark for Java 函式庫已透過 Maven 或直接下載加入。

必要的函式庫與相依性

透過 Maven 加入函式庫：

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

或直接從 GroupDocs.Watermark for Java releases 下載。

取得授權

申請臨時授權或透過 GroupDocs 的授權頁面 購買正式授權。

設定 GroupDocs.Watermark for Java

使用電子郵件檔案路徑初始化 Watermarker：

import com.groupdocs.watermark.Watermarker;

// Initialize Watermarker
Watermarker watermarker = new Watermarker("path/to/your/file.msg");

步驟實作

載入電子郵件訊息

如何載入電子郵件訊息？
首先，匯入必要的類別，並使用 EmailLoadOptions 建立 Watermarker 實例：

import java.io.File;
import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.EmailLoadOptions;

String emailFilePath = "YOUR_DOCUMENT_DIRECTORY/message.msg";
EmailLoadOptions loadOptions = new EmailLoadOptions();
Watermarker watermarker = new Watermarker(emailFilePath, loadOptions);

您的電子郵件現在已載入至記憶體，可進行操作。

為電子郵件訊息新增附件

如何新增附件？
將欲附加的檔案讀取為位元組陣列，然後加入至電子郵件內容：

import java.io.FileInputStream;
import java.io.InputStream;

// Initialize input stream for the attachment file
File attachmentFile = new File("YOUR_DOCUMENT_DIRECTORY/sample.msg");
byte[] attachmentBytes = new byte[(int) attachmentFile.length()];
InputStream attachmentInputStream = new FileInputStream(attachmentFile);

// Read bytes from the attachment file
attachmentInputStream.read(attachmentBytes);
attachmentInputStream.close();

import com.groupdocs.watermark.contents.EmailContent;

EmailContent content = watermarker.getContent(EmailContent.class);
content.getAttachments().add(attachmentBytes, "sample.msg");

附件現在已成為電子郵件的一部份。若要新增 multiple attachments Java，請對每個檔案重複呼叫 add 方法。

儲存對電子郵件訊息的變更

完成電子郵件修改後，指定更新後檔案的儲存位置，並關閉 Watermarker 以釋放資源：

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/modified_message.msg";

watermarker.save(outputFilePath);
watermarker.close();
The modified email message is saved, and resources are released by closing the `Watermarker`.

實務應用

  • 電子郵件歸檔： Automate attachment of PDFs, invoices, or contracts to emails for regulatory compliance.
  • 文件管理系統 (DMS)： Push email content and its attachments directly into a DMS using GroupDocs.Watermark.
  • 安全通訊： Combine watermarking with attachment handling to ensure authenticity and traceability.

效能考量

  • 使用 buffered streams 處理大型檔案，以降低記憶體使用量。
  • 儲存後務必呼叫 watermarker.close()。
  • 在批次處理多封電子郵件時，重複使用同一個 Watermarker 實例以減少開銷。

常見問題與解決方案

問題解決方案
OutOfMemoryError with large MSG files使用 BufferedInputStream 讀取附件，並分塊處理。
Attachment not appearing確認位元組陣列正確代表檔案，且檔名包含正確的副檔名。
License exception檢查臨時或正式授權檔案是否正確放置並在專案中正確引用。

常見問與答

Q: 如何處理大型電子郵件檔案？
A: 使用緩衝串流以較小的區塊讀取檔案，降低記憶體消耗。

Q: 我可以一次新增多個附件嗎？
A: 可以，遍歷每個檔案，對每個附件呼叫 content.getAttachments().add(byteArray, fileName)。

Q: 如果我的電子郵件檔案已加密該怎麼辦？
A: 先使用相應的金鑰解密檔案，然後使用 EmailLoadOptions 載入。

Q: 如何取代已存在的附件？
A: 透過 content.getAttachments().remove(index) 移除舊附件，然後新增新的附件。

Q: 哪裡可以找到更多 GroupDocs.Watermark 範例？
A: 前往 GitHub repository 取得更多程式碼範例。

資源

有了本指南，您現在已具備使用 GroupDocs.Watermark 在 Java 中以程式方式 管理電子郵件附件 的堅實基礎。祝您開發順利！

最後更新： 2026-01-08
測試版本： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs