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

在当今的数字环境中，管理电子邮件附件 对于需要归档文档、确保安全通信或将电子邮件集成到更大工作流的企业至关重要。本教程将手把手演示如何使用 GroupDocs.Watermark for Java 加载电子邮件、以 Java 方式添加电子邮件附件、处理 多个附件 Java，并保存更新后的邮件——整个过程代码简洁且性能优良。

快速回答

  • 主要库是什么？ GroupDocs.Watermark for Java
  • 如何添加附件？ 使用 EmailContent.getAttachments().add(byte[], fileName)
  • 可以添加多个附件吗？ 可以——对每个文件调用一次 add 方法
  • 是否需要许可证？ 生产环境必须使用临时或正式许可证
  • 支持的 Java 版本？ JDK 8 或更高版本

什么是管理电子邮件附件？

管理电子邮件附件是指以编程方式读取、添加、删除或更新电子邮件消息中附带的文件。使用 GroupDocs.Watermark，您可以将电子邮件视为文档，操作其内容，并保留时间戳、发件人信息等元数据。

为什么选择 GroupDocs.Watermark for Java？

  • 强大的格式支持： 开箱即支持 MSG、EML 等多种电子邮件格式。
  • 水印与安全功能： 可对邮件正文及其附件添加水印或数字签名。
  • 简洁的 API： Watermarker、EmailLoadOptions、EmailContent 等直观类让开发更轻松。

前置条件

在开始之前，请确保您已具备以下条件：

  1. 已安装 Java Development Kit (JDK) 8+。
  2. 已准备好 IDE（IntelliJ IDEA、Eclipse 或 VS Code）。
  3. 已通过 Maven 或直接下载方式将 GroupDocs.Watermark for Java 库加入项目。

必需的库和依赖

通过 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");

附件已成功加入邮件。若要 添加多个附件 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`.

实际应用场景

  • 邮件归档： 自动将 PDF、发票或合同等文件作为附件添加到邮件中，以满足合规要求。
  • 文档管理系统（DMS）： 直接将邮件内容及其附件推送至 DMS，使用 GroupDocs.Watermark 完成。
  • 安全通信： 将水印与附件处理相结合，确保真实性和可追溯性。

性能考虑

  • 对大文件使用 缓冲流，降低内存占用。
  • 保存后务必调用 watermarker.close()。
  • 在批量处理多封邮件时，复用同一个 Watermarker 实例以减少开销。

常见问题与解决方案

问题解决方案
OutOfMemoryError 与大型 MSG 文件使用 BufferedInputStream 读取附件，并分块处理。
附件未显示确认字节数组正确表示文件且文件名带有正确的扩展名。
许可证异常检查临时或正式许可证文件是否已正确放置并在项目中引用。

常见问答

问：如何处理大型电子邮件文件？
答：使用缓冲流分块读取文件，可降低内存消耗。

问：能一次性添加多个附件吗？
答：可以，遍历每个文件并对每个附件调用 content.getAttachments().add(byteArray, fileName)。

问：如果我的电子邮件文件被加密了怎么办？
答：先使用相应密钥解密文件，然后使用 EmailLoadOptions 加载。

问：如何替换已有的附件？
答：通过 content.getAttachments().remove(index) 删除旧附件，再添加新附件。

问：在哪里可以找到更多 GroupDocs.Watermark 示例？
答：访问 GitHub 仓库 获取更多代码示例。

资源

通过本指南，您已经掌握了使用 GroupDocs.Watermark 在 Java 中 程序化管理电子邮件附件 的基础。祝编码愉快！

最后更新： 2026-01-08
测试环境： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs