`
jessen163
  • 浏览: 457270 次
  • 性别: Icon_minigender_1
  • 来自: 潘多拉
社区版块
存档分类
最新评论

Commons-Email 简单教程

    博客分类:
  • Util
阅读更多
一:Quick Start
通过SimpleEmail发送邮件
java.lang.Object
org.apache.commons.mail.Email
org.apache.commons.mail.SimpleEmail

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

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


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

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

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


next,添加附件到我们的邮件中
MultiPartEmail email = new MultiPartEmail();
email.setHostName("mail.4ya.cn");
email.setAuthentication("<username>","<password>")
email.addTo("martin.xus@gmail.com", "martin");
email.setFrom("martin@4ya.cn", "martin");
email.setSubject("邮件主题");
email.setMsg("邮件内容");

//添加附件
email.attach(attachment);

//发送邮件
email.send();

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

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

java.lang.Object
org.apache.commons.mail.Email
org.apache.commons.mail.MultiPartEmail
org.apache.commons.mail.HtmlEmail


如下:
1//HtmlEmail!
HtmlEmail email = new HtmlEmail();
email.setHostName("mail.4ya.cn");
email.setAuthentication("<username>","<password>")
email.addTo("martin@4ya.cn"martin");
email.setFrom("martin.xus@gmail.com"martin");
email.setSubject("主题:该邮件包括html格式内容");
 
// embed the image and get the content id
// 注意这里:embed 将帮助我们创建标签如:cid:xxx url
URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
String cid = email.embed(url, "Apache logo");

/**
set the html message
我们看到HtmlEmail extends Email的,它依然有setMsg(),但是这里发送的邮件包括了插入在邮件内容中的图片,所以不能在使用了setMsg(),而要以setHtmlMsg 或setTextMsg代码
**/
email.setHtmlMsg("<html>The apache logo - <img src=\"cid:"+cid+"\"></html>");

// set the alternative message
email.setTextMsg("Your email client does not support HTML messages");

//set mail
email.send();


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

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

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

顺便再整理一下,朋友讨论的关于一些jakarta commons email出现乱码的问题:

一:通过SimpleEmail发送中文内容出现乱码的问题
SimpleEmail的代码如下
public class SimpleEmail extends Email {
    /**
     * Set the content of the mail
     *
     * @param msg A String.
     * @return An Email.
     * @throws EmailException see javax.mail.internet.MimeBodyPart
     *                        for definitions
     * @since 1.0
     */
    public Email setMsg(String msg) throws EmailException {
        if (EmailUtils.isEmpty(msg)) {
            throw new EmailException("Invalid message supplied");
        }
        setContent(msg, Email.TEXT_PLAIN);
        return this;
    }
}

只是采用默认的,

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


        EmailAttachment attachment = new EmailAttachment();
        attachment.setPath("c:\\测试.txt");
        attachment.setDisposition(EmailAttachment.ATTACHMENT);
        attachment.setDescription("测试文件");
         
           //
        attachment.setName(MimeUtility.encodeText("测试文件.txt"));

         MultiPartEmail email = new MultiPartEmail();
        email.setHostName("192.168.0.3");
        email.setAuthentication("martin.xus", "1234");
        email.addTo("martin.xus@192.168.0.3", "martin");
        email.setFrom("martin.xus@192.168.0.3", "martin");

        email.setSubject("测试带附件");
        email.setMsg("该邮件含附件");
        //添加附件
        email.attach(attachment);
        //发送邮件
        email.send();


end
---------------------------------------------------------------------------------
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics