Skip to content

Officia.Email — EML 解析与归档

能力摘要(AI 友好)OfficiaEmail 解析 EML(MIME)邮件、生成 EML,并可将邮件归档为 PDF(toPdf)。门面静态方法,纯 JDK 实现。

引入

xml
<dependency>
  <groupId>plus.ruoyi</groupId>
  <artifactId>officia-all</artifactId>
  <version>1.0.0</version>
</dependency>

仅需邮件能力时可单独引 officia-email

解析 EML

java
import plus.ruoyi.officia.email.OfficiaEmail;
import plus.ruoyi.officia.email.EmailMessage;

EmailMessage msg = OfficiaEmail.parseEml(emlBytes);   // 也有 (InputStream) / (File) 重载
// 从 EmailMessage 读取发件人/收件人/主题/正文/附件等结构化信息

生成 EML

java
byte[] eml = OfficiaEmail.writeEml(msg);              // 结构化邮件 → EML(MIME)字节

归档为 PDF

java
byte[] pdf = OfficiaEmail.toPdf(emlBytes);            // 邮件(含头/正文)归档为 PDF
byte[] pdf2 = OfficiaEmail.toPdf(emlBytes, ConvertOptions.defaults());

方法一览

方法说明
parseEml(eml)(byte[] / InputStream / File)解析 EML(MIME)为结构化 EmailMessage
writeEml(msg)结构化邮件 → EML 字节
toPdf(eml) / toPdf(eml, options)邮件归档为 PDF

常见问题

  • 编码:EML 头部/正文的 MIME 编码(Base64 / Quoted-Printable / 字符集)由解析器自动处理,中文正常还原。
  • 附件parseEml 得到的 EmailMessage 携带附件信息,可按需取出。