Jakarta发布了Commons Emails 1.0 released 版本,目的是为了简化javaMail。

知道有它几个class吗?你一定想不到,只有8个!

好了,开始我们的jakarta commons emails 之旅:)

一:Quick Start
通过SimpleEmail发送邮件
1java.lang.Object
2
org.apache.commons.mail.Email
3 org.apache.commons.mail.SimpleEmail

1SimpleEmail email = new SimpleEmail();
2email.setHostName("mail.4ya.cn"
);
3email.setAuthentication("",""
)
4email.addTo("[email protected]Gmail.com", "martin"
);
5email.setFrom("[email protected]", "martin"
);
6email.setSubject("测试主题"
);
7email.setMsg("这里是邮件内容"
);
8email.send();

就如代码里字面上的意思一样简单:
1:创建以SimpleEmail对象
2:设定发送信件的smtp服务器,如果没有设定,会寻找系统变量中mail.host值。
3:设定smtp的用户和密码
4:收件人
5:发件人
6:主题
7:内容
8:发送

二:发送带附件的邮件
我们可以发送本机的附件,当然我们也可以发送非本机的附件,如果发送的是一个存在网络上的附件的url,则邮件发送的时候会自动下载,添加到附件中。

1:)发送本地附件:
1EmailAttachment attachment = new EmailAttachment();
2attachment.setPath("test/test.rar"
);
3
attachment.setDisposition(EmailAttachment.ATTACHMENT);
4attachment.setDescription("python resource"
);
5attachment.setName("resource");

2:)发送不存在本地的附件
1EmailAttachment attachment = new EmailAttachment();
2attachment.setURL(new URL("http://www.smilinglibrary.org/sldoc/pics/index03.jpg"
));
3
attachment.setDisposition(EmailAttachment.ATTACHMENT);
4attachment.setDescription("微笑图书馆"
);
5attachment.setName("微笑图书馆");


next,添加附件到我们的邮件中
1MultiPartEmail email = new MultiPartEmail();
2email.setHostName("mail.4ya.cn"
);
3 email.setAuthentication("","")
4email.addTo("[email protected]", "martin"
);
5email.setFrom("[email protected]", "martin"
);
6email.setSubject("邮件主题"
);
7email.setMsg("邮件内容"
);

8//添加附件

9email.attach(attachment);
10

11//发送邮件

12email.send();

如果需要发送多个附件,只需创建多个EmailAttachement,即可
1email.attach(attachment1)
2email.attach(attachment2)

三:发送html格式的邮件
通过HtmlEmail我们可以发送Html格式的邮件:

1java.lang.Object
2
org.apache.commons.mail.Email
3
org.apache.commons.mail.MultiPartEmail
4
org.apache.commons.mail.HtmlEmail
5

如下:
1//HtmlEmail!
2HtmlEmail email = new HtmlEmail();
3email.setHostName("mail.4ya.cn"
);
3 email.setAuthentication("","")
5email.addTo("[email protected]"martin"
);
6email.setFrom("[email protected]"martin"
);
7email.setSubject("主题:该邮件包括html格式内容"
);

8//
embed the image and get the content id
9// 注意这里:embed 将帮助我们创建标签如:cid:xxx url

10URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
11String cid = email.embed(url, "Apache logo"
);
12

13
/**
14set the html message
15
我们看到HtmlEmail extends Email的,它依然有setMsg(),但是这里发送的邮件包括了插入在邮件内容中的图片,所以不能在使用了setMsg(),而要以setHtmlMsg 或setTextMsg代码
16**/

17email.setHtmlMsg("The apache logo - "cid:"+cid+"UploadFiles/20061202/200612219353660277806>">");
18

19// set the alternative message

20email.setTextMsg("Your email client does not support HTML messages");
21

22//set mail

23email.send();
24

四:最后一步
如果需要实现更复杂authenticator 你可以extends javax.mail.Authenticator ,实现你自己的东西,然后调用Email.setAuthenticator(javax.mail.Authenticator newAuthenticator)即可

这一点jakarta也做了,给我们提供了一个defaultAuthenticator
1java.lang.Object
2
javax.mail.Authenticator
3 org.apache.commons.mail.DefaultAuthenticator

覆盖掉该方法,实现你自己的东东 o_o
1PRotected javax.mail.PassWordAuthentication getPasswordAuthentication()


五:any more?
当然有了 o_o 以后再写.