Commons Email-优快云博客

本文链接：https://blog.youkuaiyun.com/u012671407/article/details/84283966

（1）下载Commons Email

Commons Email位于Apache的Commons下。

地址是：http://commons.apache.org/email/

下载地址是：http://commons.apache.org/downloads/download_email.cgi

（2）官方简介：

Commons Email aims to provide a API for sending email. It is built on top of the Java Mail API, which it aims to simplify. Some of the mail classes that are provided are as follows:
● SimpleEmail - This class is used to send basic text based emails .
● MultiPartEmail - This class is used to send multipart messages . This allows a text message with attachments either inline or attached.
● HtmlEmail - This class is used to send HTML formatted emails . It has all of the capabilities as MultiPartEmail allowing attachments to be easily added. It also supports embedded images .
● EmailAttachment - This is a simple container class to allow for easy handling of attachments . It is for use with instances of MultiPartEmail and HtmlEmail.

（3）

Commons-Email 简单教程

Commons Emails ，目的是为了简化JavaMail。

知道有它几个class吗？你一定想不到，只有8个！

一：Quick Start
通过SimpleEmail发送邮件

java.lang.Object
2

org.apache.commons.mail.Email
3

org.apache.commons.mail.SimpleEmail

SimpleEmail email = new SimpleEmail();
2

email.setHostName( " mail.4ya.cn " );
3

email.setAuthentication( " <username> " , " <password> " )
4

email.addTo( " martin.xus@gmail.com " , " martin " );
5

email.setFrom( " martin@4ya.cn " , " martin " );
6

email.setSubject( " 测试主题 " );
7

email.setMsg( " 这里是邮件内容 " );
8

email.send();

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

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

1：）发送本地附件：

EmailAttachment attachment = new EmailAttachment();
2

attachment.setPath( " test/test.rar " );
3

attachment.setDisposition(EmailAttachment.ATTACHMENT);
4

attachment.setDescription( " python resource " );
5

attachment.setName( " resource " );

2：）发送不存在本地的附件

EmailAttachment attachment = new EmailAttachment();
2

attachment.setURL( new URL( " http://www.smilinglibrary.org/sldoc/pics/index03.jpg " ));
3

attachment.setDisposition(EmailAttachment.ATTACHMENT);
4

attachment.setDescription( " 微笑图书馆 " );
5

attachment.setName( " 微笑图书馆 " );

next,添加附件到我们的邮件中

MultiPartEmail email = new MultiPartEmail();
2

email.setHostName( " mail.4ya.cn " );
3 email.setAuthentication(" <username> " , " <password> " )
4

email.addTo( " martin.xus@gmail.com " , " martin " );
5

email.setFrom( " martin@4ya.cn " , " martin " );
6

email.setSubject( " 邮件主题 " );
7

email.setMsg( " 邮件内容 " );

// 添加附件
9

email.attach(attachment);
10

// 发送邮件
12

email.send();

如果需要发送多个附件，只需创建多个EmailAttachement,即可

email.attach(attachment1)
2

email.attach(attachment2)

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

java.lang.Object
2

org.apache.commons.mail.Email
3

org.apache.commons.mail.MultiPartEmail
4

org.apache.commons.mail.HtmlEmail
5

如下：

// HtmlEmail!
2

HtmlEmail email = new HtmlEmail();
3

email.setHostName( " mail.4ya.cn " );
3 email.setAuthentication(" <username> " , " <password> " )
5

email.addTo("martin@4ya.cn " martin " );
6

email.setFrom("martin.xus@gmail.com " martin " );
7

email.setSubject( "主题：该邮件包括html格式内容 " );

// embed the image and get the content id
9

// 注意这里：embed 将帮助我们创建标签如：cid:xxx url
10

URL url = new URL( " http://www.apache.org/images/asf_logo_wide.gif " );
11

String cid = email.embed(url, " Apache logo " );
12

/**
14

set the html message
15

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

* */
17

email.setHtmlMsg( " <html>The apache logo - <img src=\ " cid: " +cid+ " \ " ></html> " );
18

// set the alternative message
20

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

[iocblog.net 来源]
22

// set mail
23

email.send();
24

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

这一点jakarta也做了，给我们提供了一个defaultAuthenticator

java.lang.Object
2

javax.mail.Authenticator
3

org.apache.commons.mail.DefaultAuthenticator

覆盖掉该方法，实现你自己的东东 o_o

protected javax.mail.PasswordAuthentication getPasswordAuthentication()