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

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

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

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

1 None.gif SimpleEmail email  =   new  SimpleEmail();
2 None.gifemail.setHostName( " mail.4ya.cn " );
3 None.gifemail.setAuthentication( " <username> " , " <password> " )
4 None.gifemail.addTo( " martin.xus@gmail.com " " martin " );
5 None.gifemail.setFrom( " martin@4ya.cn " " martin " );
6 None.gifemail.setSubject( " 测试主题 " );
7 None.gifemail.setMsg( " 这里是邮件内容 " );
8 None.gifemail.send();

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

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

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

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


next,添加附件到我们的邮件中
 1 None.gif MultiPartEmail email  =   new  MultiPartEmail();
 2 None.gifemail.setHostName( " mail.4ya.cn " );
 3    email.setAuthentication("<username>","<password>")
 4 None.gifemail.addTo( " martin.xus@gmail.com " " martin " );
 5 None.gifemail.setFrom( " martin@4ya.cn " " martin " );
 6 None.gifemail.setSubject( " 邮件主题 " );
 7 None.gifemail.setMsg( " 邮件内容 " );
None.gif
 8 None.gif // 添加附件
 9 None.gif email.attach(attachment);
10 None.gif
11 None.gif // 发送邮件
12 None.gif email.send();

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

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

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

如下:
 1 None.gif // HtmlEmail!
 2 None.gif HtmlEmail email  =   new  HtmlEmail();
 3 None.gifemail.setHostName( " mail.4ya.cn " );
 3   email.setAuthentication("<username>","<password>")
 5 None.gifemail.addTo("martin@4ya.cn " martin " );
 6 None.gifemail.setFrom("martin.xus@gmail.com " martin " );
 7 None.gifemail.setSubject( "主题:该邮件包括html格式内容 " );
  None.gif
 8 None.gif //  embed the image and get the content id
 9 None.gif //  注意这里:embed 将帮助我们创建标签如:cid:xxx url
10 None.gif URL url  =   new  URL( " http://www.apache.org/images/asf_logo_wide.gif " );
11 None.gifString cid  =  email.embed(url,  " Apache logo " );
12 None.gif
13 ExpandedBlockStart.gifContractedBlock.gif /** */ /**
14InBlock.gifset the html message
15InBlock.gif我们看到HtmlEmail extends Email的,它依然有setMsg(),但是这里发送的邮件包括了插入在邮件内容中的图片,所以不能在使用了setMsg(),而要以setHtmlMsg 或setTextMsg代码
16ExpandedBlockEnd.gif**/

17 None.gifemail.setHtmlMsg( " <html>The apache logo - <img src= " cid: " +cid+ " "></html>");
18None.gif
19None.gif// set the alternative message
20None.gifemail.setTextMsg("Your email client does not support HTML messages");
21None.gif
22None.gif//set mail
23None.gifemail.send();
24None.gif

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

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

覆盖掉该方法,实现你自己的东东 o_o
1 None.gif protected  javax.mail.PasswordAuthentication getPasswordAuthentication()


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