我们常常在邮件中添加附件,以达到传输较大文件的目的。而上一篇文章只是将本机的一张图片内嵌到邮件的 HTML 格式的正文当中,这样的邮件显得不够丰富多彩。我们想要一封正文部分图文并茂,而游客附带若干附件的邮件。

下面是代码结构中3个重要的方法:

MimeBodyPart createAttachment(String fileName) 方法用于创建附件并返回;

MimeBodyPart createContent(String body, String fileName) 方法用于创建正文部分并返回;

MimeMessage createMessage(Session session) 方法用于调用上面的两个方法生成邮件。

其实,创建一个内含附件的邮件与上一篇文章中创建正文中包含图片的邮件的原理,甚至代码都几乎相同。也就是使用 JAF 框架中的 FileDataSource 类和 DataHandler 类来获得给定路径的资源文件,JAF 框架中的这两个类共同协作可以获知文件所属的 MIME 类型,它们会正确地添加到邮件组织结构中的对应消息头中。

不同的是:

在 HTML 格式的正文中内含图片是使用 MimeBody.setContentID() 方法设置对应的资源文件的唯一标识符,即 MIME 协议对于邮件的结构组织格式中的 Content-ID 头字段;

而在 MIME 邮件中添加附件是使用 MimeBodyPart.setFileName() 方法来关联 FileSourceData 对象指向的资源文件。

程序代码:

这个不同点在下面代码中会用橙色背景强调指出,代码如下: 

 
  
  1. import java.io.FileOutputStream;  
  2. import java.util.Properties;  
  3.  
  4. import javax.activation.DataHandler;  
  5. import javax.activation.FileDataSource;  
  6. import javax.mail.Message;  
  7. import javax.mail.Session;  
  8. import javax.mail.internet.InternetAddress;  
  9. import javax.mail.internet.MimeBodyPart;  
  10. import javax.mail.internet.MimeMessage;  
  11. import javax.mail.internet.MimeMultipart;  
  12.  
  13. /**  
  14.  * 创建内含附件、图文并茂的邮件  
  15.  * @author haolloyin  
  16.  */ 
  17. public class WithAttachmentMessage {  
  18.  
  19.     /**  
  20.      * 根据传入的文件路径创建附件并返回  
  21.      */ 
  22.     public MimeBodyPart createAttachment(String fileName) throws Exception {  
  23.         MimeBodyPart p_w_uploadPart = new MimeBodyPart();  
  24.         FileDataSource fds = new FileDataSource(fileName);  
  25.         p_w_uploadPart.setDataHandler(new DataHandler(fds));  
  26.         p_w_uploadPart.setFileName(fds.getName());  
  27.         return p_w_uploadPart;  
  28.     }  
  29.  
  30.     /**  
  31.      * 根据传入的邮件正文body和文件路径创建图文并茂的正文部分  
  32.      */ 
  33.     public MimeBodyPart createContent(String body, String fileName)  
  34.             throws Exception {  
  35.         // 用于保存最终正文部分  
  36.         MimeBodyPart contentBody = new MimeBodyPart();  
  37.         // 用于组合文本和图片,"related"型的MimeMultipart对象  
  38.         MimeMultipart contentMulti = new MimeMultipart("related");  
  39.  
  40.         // 正文的文本部分  
  41.         MimeBodyPart textBody = new MimeBodyPart();  
  42.         textBody.setContent(body, "text/html;charset=gbk");  
  43.         contentMulti.addBodyPart(textBody);  
  44.  
  45.         // 正文的图片部分  
  46.         MimeBodyPart jpgBody = new MimeBodyPart();  
  47.         FileDataSource fds = new FileDataSource(fileName);  
  48.         jpgBody.setDataHandler(new DataHandler(fds));  
  49.         jpgBody.setContentID("logo_jpg");  
  50.         contentMulti.addBodyPart(jpgBody);  
  51.  
  52.         // 将上面"related"型的 MimeMultipart 对象作为邮件的正文  
  53.         contentBody.setContent(contentMulti);  
  54.         return contentBody;  
  55.     }  
  56.  
  57.     /**  
  58.      * 根据传入的 Seesion 对象创建混合型的 MIME消息  
  59.      */ 
  60.     public MimeMessage createMessage(Session session) throws Exception {  
  61.         String from = test_hao@163.com;  
  62.         String to = "test_hao@sina.cn";  
  63.         String subject = "创建内含附件、图文并茂的邮件!";  
  64.         String body = "<h4>内含附件、图文并茂的邮件测试!!!</h4> </br>" 
  65.                 + "<a href = http://haolloyin.blog.51cto.com/> 蚂蚁</a></br>" 
  66.                 + "<img src = \"cid:logo_jpg\"></a>";  
  67.  
  68.         MimeMessage msg = new MimeMessage(session);  
  69.         msg.setFrom(new InternetAddress(from));  
  70.         msg.setRecipient(Message.RecipientType.TO, new InternetAddress(to));  
  71.         msg.setSubject(subject);  
  72.  
  73.         // 创建邮件的各个 MimeBodyPart 部分  
  74.         MimeBodyPart p_w_upload01 = createAttachment("F:\\java\\Snake.java");  
  75.         MimeBodyPart p_w_upload02 = createAttachment("F:\\java\\meng.mp3");  
  76.         MimeBodyPart content = createContent(body, "F:\\java\\logo.jpg");  
  77.  
  78.         // 将邮件中各个部分组合到一个"mixed"型的 MimeMultipart 对象  
  79.         MimeMultipart allPart = new MimeMultipart("mixed");  
  80.         allPart.addBodyPart(p_w_upload01);  
  81.         allPart.addBodyPart(p_w_upload02);  
  82.         allPart.addBodyPart(content);  
  83.  
  84.         // 将上面混合型的 MimeMultipart 对象作为邮件内容并保存  
  85.         msg.setContent(allPart);  
  86.         msg.saveChanges();  
  87.         return msg;  
  88.     }  
  89.  
  90.     // 测试生成邮件  
  91.     public static void main(String[] args) throws Exception {  
  92.         WithAttachmentMessage mail = new WithAttachmentMessage();  
  93.         Session session = Session.getDefaultInstance(new Properties());  
  94.         MimeMessage message = mail.createMessage(session);  
  95.         message.writeTo(new FileOutputStream("withAttachmentMail.eml"));  
  96.     }  

编译、运行生成 withAttachmentMail.eml 文件,双击打开,如下图:

withAttachmentMail01

 

看看上面用 Outlook 打开生成的文件,在附件栏里面就有一个 .java 源文件和一首 MP3 文件了。

打开邮件的原始内容:

查看生成的邮件的原始内容,点击“文件”、“属性”、“邮件来源”或者使用 EditPlus 、UltraEdit 等文本编辑器直接打开也行,下面是原始内容:

 
  
  1. From: test_hao@163.com  
  2. To: test_hao@sina.cn  
  3. Message-ID: <56667.2.1279677956578.JavaMail.Administrator@WWW-1477FF1578B> 
  4. Subject: =?GBK?B?tLS9qMTauqy4vbz+oaLNvM7EsqLDr7XE08q8/qOh?=  
  5. MIME-Version: 1.0  
  6. Content-Type: multipart/mixed;   
  7.     boundary="----=_Part_1_13249998.1279677956546" 
  8.  
  9. ------=_Part_1_13249998.1279677956546  
  10. Content-Type: application/octet-stream; name=Snake.java  
  11. Content-Transfer-Encoding: base64  
  12. Content-Disposition: p_w_upload; filename=Snake.java  
  13.  
  14. // 省略被 BASE64 转码后的 Snake.java 附件内容  
  15.  
  16. ------=_Part_1_13249998.1279677956546  
  17. Content-Type: application/octet-stream; name=meng.mp3  
  18. Content-Transfer-Encoding: base64  
  19. Content-Disposition: p_w_upload; filename=meng.mp3  
  20.  
  21. // 省略被 BASE64 转码后的 meng.java 附件内容  
  22.  
  23. ------=_Part_1_13249998.1279677956546  
  24. Content-Type: multipart/related;   
  25.     boundary="----=_Part_0_3373112.1279677956546" 
  26.  
  27. ------=_Part_0_3373112.1279677956546  
  28. Content-Type: text/html;charset=gbk 
  29. Content-Transfer-Encoding: quoted-printable  
  30.  
  31. <h4>=C4=DA=BA=AC=B8=BD=BC=FE=A1=A2=CD=BC=CE=C4=B2=A2=C3=AF=B5=C4=D3=CA=BC=  
  32. =FE=B2=E2=CA=D4=A3=A1=A3=A1=A3=A1</h4> </br><a href =3D http://haolloyin.bl=  
  33. og.51cto.com/> =C2=EC=D2=CF</a></br><img src =3D "cid:logo_jpg"></a> 
  34. ------=_Part_0_3373112.1279677956546  
  35. Content-Type: p_w_picpath/jpeg  
  36. Content-Transfer-Encoding: base64  
  37. Content-ID: logo_jpg  
  38.  
  39. // 省略被 BASE64 转码后的邮件正文部分内嵌的 .jpg 图片的内容  
  40.  
  41. ------=_Part_0_3373112.1279677956546--  
  42.  
  43. ------=_Part_1_13249998.1279677956546-- 

重要部分已经用背景颜色指出来了,有兴趣的可以深入了解一下 MIME 协议对邮件结构组织的规范格式。

我的相关文章: 

JavaMaill:使用MIME协议创建内含图片的复杂邮件

JavaMail入门:创建纯文本、HTML格式的邮件