一:Quick Start
通过SimpleEmail发送邮件
就如代码里字面上的意思一样简单:
1:创建以SimpleEmail对象
2:设定发送信件的smtp服务器,如果没有设定,会寻找系统变量中mail.host值。
3:设定smtp的用户和密码
4:收件人
5:发件人
6:主题
7:内容
8:发送
二:发送带附件的邮件
我们可以发送本机的附件,当然我们也可以发送非本机的附件,如果发送的是一个存在网络上的附件的url,则邮件发送的时候会自动下载,添加到附件中。
1:)发送本地附件:
2:)发送不存在本地的附件
next,添加附件到我们的邮件中
如果需要发送多个附件,只需创建多个EmailAttachement,即可
三:发送html格式的邮件
通过HtmlEmail我们可以发送Html格式的邮件:
如下:
通过SimpleEmail发送邮件
1
java.lang.Object
2
org.apache.commons.mail.Email
3
org.apache.commons.mail.SimpleEmail

2

3

1
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();

2

3

4

5

6

7

8

就如代码里字面上的意思一样简单:
1:创建以SimpleEmail对象
2:设定发送信件的smtp服务器,如果没有设定,会寻找系统变量中mail.host值。
3:设定smtp的用户和密码
4:收件人
5:发件人
6:主题
7:内容
8:发送
二:发送带附件的邮件
我们可以发送本机的附件,当然我们也可以发送非本机的附件,如果发送的是一个存在网络上的附件的url,则邮件发送的时候会自动下载,添加到附件中。
1:)发送本地附件:
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

3

4

5

2:)发送不存在本地的附件
1
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(
"
微笑图书馆
"
);

2

3

4

5

next,添加附件到我们的邮件中
1
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(
"
邮件内容
"
);

8
//
添加附件
9
email.attach(attachment);
10
11
//
发送邮件
12
email.send();

2

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

5

6

7


8

9

10

11

12

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

2

三:发送html格式的邮件
通过HtmlEmail我们可以发送Html格式的邮件:
1
java.lang.Object
2
org.apache.commons.mail.Email
3
org.apache.commons.mail.MultiPartEmail
4
org.apache.commons.mail.HtmlEmail
5

2

3

4

5

如下:
1
//
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格式内容
"
);

8
//
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
13
/** */
/**
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
19
//
set the alternative message
20
email.setTextMsg(
"
Your email client does not support HTML messages
"
);
21
22
//
set mail
23
email.send();

2

3

3 email.setAuthentication("<username>","<password>")
5

6

7


8

9

10

11

12

13


14

15

16

17

18

19

20

21

22

23

朋友讨论的关于一些jakarta commons email出现乱码的问题:
一:通过SimpleEmail发送中文内容出现乱码的问题
SimpleEmail的代码如下
只是采用默认的,
并没有指定编码。
如果通过SimpleEmail发送,需要指定编码: Water Ye@ITO 的说明
二:关于附件中文名称乱码的问题:
需使用MimeUtility
原因是在MIME的相应规范中(RFC2047等)说明了附件标题必须是US-ASCII字符, 所以在发送中文标题的附件时需要编码成US-ASCII字符, 有两种编码方式: B (BASE64), Q (Quoted-Printable), 这些方法在MimeUtility里
都已经做了封装, 所以在发送附件时使用如下:
一:通过SimpleEmail发送中文内容出现乱码的问题
SimpleEmail的代码如下
1
public class SimpleEmail extends Email
{
2
/** *//**
3
* Set the content of the mail
4
*
5
* @param msg A String.
6
* @return An Email.
7
* @throws EmailException see javax.mail.internet.MimeBodyPart
8
* for definitions
9
* @since 1.0
10
*/
11
public Email setMsg(String msg) throws EmailException
{
12
if (EmailUtils.isEmpty(msg))
{
13
throw new EmailException("Invalid message supplied");
14
}
15
setContent(msg, Email.TEXT_PLAIN);
16
return this;
17
}
18
}



2


3

4

5

6

7

8

9

10

11



12



13

14

15

16

17

18

只是采用默认的,
1
public static final String TEXT_PLAIN = "text/plain";

并没有指定编码。
如果通过SimpleEmail发送,需要指定编码: Water Ye@ITO 的说明
1
email.setContent("测试邮件", "text/plain;charset=GBK");

二:关于附件中文名称乱码的问题:
需使用MimeUtility
原因是在MIME的相应规范中(RFC2047等)说明了附件标题必须是US-ASCII字符, 所以在发送中文标题的附件时需要编码成US-ASCII字符, 有两种编码方式: B (BASE64), Q (Quoted-Printable), 这些方法在MimeUtility里
都已经做了封装, 所以在发送附件时使用如下:
1
MimeUtility.encodeText(filename));

1
EmailAttachment attachment = new
EmailAttachment();
2
attachment.setPath("c:\\测试.txt"
);
3
attachment.setDisposition(EmailAttachment.ATTACHMENT);
4
attachment.setDescription("测试文件"
);
5
6 //
7
attachment.setName(MimeUtility.encodeText("测试文件.txt"));
8
9
MultiPartEmail email = new
MultiPartEmail();
10
email.setHostName("192.168.0.3"
);
11
email.setAuthentication("martin.xus", "1234"
);
12
email.addTo("martin.xus@192.168.0.3", "martin"
);
13
email.setFrom("martin.xus@192.168.0.3", "martin"
);
14
15
email.setSubject("测试带附件"
);
16
email.setMsg("该邮件含附件"
);
17
//添加附件
18
email.attach(attachment);
19
//发送邮件
20
email.send();

2

3

4

5

6 //

7

8

9

10

11

12

13

14

15

16

17

18

19

20
