Jarkata Common Email

 

1.        基础

1.1.      简介

Jarkata Common Email 是一个用来发送email的组件，其目的是用来简化应用系统发送email的要求。他的功能：

u       发送简单文本的email

u       支持附件的email

u       支持html格式的email

1.2.      Email主要类

Email包提供了如下的几个类：

u       SimpleEmail ： 用来发送基本的文本email

u       MultipartEmail：该类用来发送Multipart 信息。他允许发送带附件的文本信息

u       HtmlEmil：用来发送HTML格式的email，除了有MultipartEmail的所有能力，还可以发送内嵌的图象；

u       EmailAttachment：方便发送email的时候，进行附件处理。主要提供给MultipartEmail和HtmlEmail来使用。

1.3.      主要代码例子

1.3.1.      发送简单的文本邮件

发送简单的文本邮件使用SimpleEmail类即可。下面的例子是通过Gmail Server来发送邮件。

1. package org.apache.commons.mail.study;
2. 
   
3. import org.apache.commons.mail.EmailException;
4. import org.apache.commons.mail.SimpleEmail;
5. 
   
6. public class SimpleEmailStudy {
7. 
   
8.     public static void main(String[] args) throws EmailException {
9.         SimpleEmail email = new SimpleEmail();
10.         
11.         //通过Gmail Server 发送邮件
12.         email.setHostName("smtp.gmail.com"); //设定smtp服务器
13.         email.setSSL(Boolean.TRUE);          //设定是否使用SSL 
14.         email.setSslSmtpPort("465");         //设定SSL端口
15.         email.setAuthentication("username", "password"); //设定smtp服务器的认证资料信息
16.         
17.         email.addTo("[e-mail]","reciever"); //设定收件人
18.         email.setCharset("UTF-8");//设定内容的语言集
19.         email.setFrom("[e-mail]");//设定发件人
20.         email.setSubject("Hello");//设定主题
21.         email.setMsg("中国/n ");//设定邮件内容
22.         
23.         email.send();//发送邮件
24.     }
25. }

1.3.2.      发送带附件的Email

发送带附件的Email可以使用MultipartEmail，他可以同时发送多个附件。

1. package org.apache.commons.mail.study;
2. 
   
3. import org.apache.commons.mail.EmailAttachment;
4. import org.apache.commons.mail.EmailException;
5. import org.apache.commons.mail.MultiPartEmail;
6. 
   
7. public class MultiPartEmailStudy {
8. 
   
9.     public static void main(String[] args) throws EmailException {
10.         MultiPartEmail email = new MultiPartEmail();
11. 
    
12.         // 通过Gmail Server 发送邮件
13.         email.setHostName("smtp.gmail.com"); // 设定smtp服务器
14.         email.setSSL(Boolean.TRUE); // 设定是否使用SSL
15.         email.setSslSmtpPort("465"); // 设定SSL端口
16.         email.setAuthentication("username", "password"); // 设定smtp服务器的认证资料信息
17. 
    
18.         EmailAttachment attachment = new EmailAttachment();
19.         attachment.setPath("logo.png");
20.         //设定合法的URL指向文件
21.         //attachment.setURL(new URL(http://www.apache.org/images/asf_logo_wide.gif));
22.             
23.         attachment.setDisposition(EmailAttachment.ATTACHMENT);//设定附件的方式（内嵌，附件）
24.         attachment.setDescription("Picture");
25.         attachment.setName("logo.png");  //附件的文件名
26. 
    
27.         email.addTo("[e-mail]", "reciever"); // 设定收件人
28.         email.setCharset("UTF-8"); // 设定内容的语言集
29.         email.setFrom("[e-mail]"); // 设定发件人
30.         email.setSubject("common email"); // 设定主题
31.         email.setMsg("这是我所设计的Logo，请审核"); // 设定邮件内容
32.         
33.         email.attach(attachment);
34.         email.send();
35.     }
36. }

EmailAttachment的可以指向合法的URL资源，发送邮件的时候，该URL指向的文件会首先下载下来，然后发送出去。

1.3.3.      发送HTML格式的邮件

使用HTMLEmail来发送HTML格式的电子邮件

1. package org.apache.commons.mail.study;
3. import java.net.MalformedURLException;
4. import java.net.URL;
6. import org.apache.commons.mail.EmailException;
7. import org.apache.commons.mail.HtmlEmail;
9. public class HtmlEmailStudy {
11.     public static void main(String[] args) throws EmailException,MalformedURLException{
12.         HtmlEmail email = new HtmlEmail();
13.         
14.         email.setHostName("smtp.gmail.com"); // 设定smtp服务器
15.         email.setSSL(Boolean.TRUE); // 设定是否使用SSL
16.         email.setSslSmtpPort("465"); // 设定SSL端口
17.         email.setAuthentication("username", "password"); // 设定smtp服务器的认证资料信息
18.         
19.         email.addTo("[e-mail]", "reciever"); // 设定收件人
20.         email.setFrom("[e-mail]", "From");
21.         email.setSubject("Test email with inline image");
23.         // embed the image and get the content id
24.         URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
25.         String cid = email.embed(url, "Apache logo");
27.         // set the html message
28.         email.setHtmlMsg("<html>The apache logo - <img src=/"cid:" + cid + "/"></html>");
30.         // set the alternative message
31.         email.setTextMsg("Your email client does not support HTML messages");
32.         // send the email
33.         email.send();
34.     }
35. }