一: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 org.apache.commons.mail.Email
3 org.apache.commons.mail.SimpleEmail
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 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:)发送本地附件:
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 attachment.setPath( " test/test.rar " );
3 attachment.setDisposition(EmailAttachment.ATTACHMENT);
4 attachment.setDescription( " python resource " );
5 attachment.setName( " resource " );
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 attachment.setURL( new URL( " http://www.smilinglibrary.org/sldoc/pics/index03.jpg " ));
3 attachment.setDisposition(EmailAttachment.ATTACHMENT);
4 attachment.setDescription( " 微笑图书馆 " );
5 attachment.setName( " 微笑图书馆 " );
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 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();
如果需要发送多个附件,只需创建多个EmailAttachement,即可
1
email.attach(attachment1)
2 email.attach(attachment2)
2 email.attach(attachment2)
三:发送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 org.apache.commons.mail.Email
3 org.apache.commons.mail.MultiPartEmail
4 org.apache.commons.mail.HtmlEmail
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 /** */ /**
14set 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 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 /** */ /**
14set 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();
朋友讨论的关于一些jakarta commons email出现乱码的问题:
一:通过SimpleEmail发送中文内容出现乱码的问题
SimpleEmail的代码如下
只是采用默认的,
并没有指定编码。
如果通过SimpleEmail发送,需要指定编码: Water Ye@ITO 的说明
二:关于附件中文名称乱码的问题:
需使用MimeUtility
原因是在MIME的相应规范中(RFC2047等)说明了附件标题必须是US-ASCII字符, 所以在发送中文标题的附件时需要编码成US-ASCII字符, 有两种编码方式: B (BASE64), Q (Quoted-Printable), 这些方法在MimeUtility里
都已经做了封装, 所以在发送附件时使用如下:
一:通过SimpleEmail发送中文内容出现乱码的问题
SimpleEmail的代码如下
1public 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 * 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}
只是采用默认的,
1public static final String TEXT_PLAIN = "text/plain";
并没有指定编码。
如果通过SimpleEmail发送,需要指定编码: Water Ye@ITO 的说明
1email.setContent("测试邮件", "text/plain;charset=GBK");
二:关于附件中文名称乱码的问题:
需使用MimeUtility
原因是在MIME的相应规范中(RFC2047等)说明了附件标题必须是US-ASCII字符, 所以在发送中文标题的附件时需要编码成US-ASCII字符, 有两种编码方式: B (BASE64), Q (Quoted-Printable), 这些方法在MimeUtility里
都已经做了封装, 所以在发送附件时使用如下:
1MimeUtility.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 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();