Apache Commons Email 简单使用

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.

说明：这个是Apache的一个开源项目，是基于另一个开源项目Java Mail上而进行封装的，使用起来更加简单方便。官网：

http://commons.apache.org/email/index.html

首先下载jar包：commons-email-1.2.jar

http://repo1.maven.org/maven2/org/apache/commons/commons-email/1.2/commons-email-1.2.jar

 

1、先来一个简单文本邮件发送的例子：

package com.mail.test;
import org.apache.commons.mail.DefaultAuthenticator;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;

public class BaseEmailSend
{
    public BaseEmailSend()
    {

    }


    public static void send()
    {
        SimpleEmail email = new SimpleEmail();
        //email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验
        email.setDebug(true);
        email.setSSL(true);
        email.setHostName("smtp.163.com");
        email.setAuthenticator(new DefaultAuthenticator("[email protected]", "yuaio"));
        try
        {
         email.setFrom("[email protected]"); //发送方,这里可以写多个
         email.addTo(www@gmail.com); // 接收方
         email.addCc("402******@qq.com"); // 抄送方
         email.addBcc("[email protected]"); // 秘密抄送方
         email.setCharset("GB2312");
         email.setSubject("标题哦"); // 标题
         email.setMsg("测试测试内容，请查阅！！！);// 内容
         email.send();
         System.out.println("发送成功");
        } catch (EmailException e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args)
    {
        send();
    }
}

package com.mail.test; import org.apache.commons.mail.DefaultAuthenticator; import org.apache.commons.mail.EmailException; import org.apache.commons.mail.SimpleEmail; public class BaseEmailSend { public BaseEmailSend() { } public static void send() { SimpleEmail email = new SimpleEmail(); //email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验 email.setDebug(true); //email.setSSL(true); email.setHostName("smtp.163.com"); email.setAuthenticator(new DefaultAuthenticator("[email protected]", "yuaio")); try { email.setFrom("[email protected]"); //发送方,这里可以写多个 email.addTo([email protected]); // 接收方 email.addCc("402******@qq.com"); // 抄送方 email.addBcc("[email protected]"); // 秘密抄送方 email.setCharset("GB2312"); email.setSubject("标题哦"); // 标题 email.setMsg("测试测试内容，请查阅！！！);// 内容 email.send(); System.out.println("发送成功"); } catch (EmailException e) { e.printStackTrace(); } } public static void main(String[] args) { send(); } }

注意：email.setHostName("smtp.163.com");
         email.setAuthenticator(new DefaultAuthenticator("[email protected]", "yuaio"));

还有email.setTLS(true); email.setSSL(false); 这些都应该是对应的，使用不同的服务商邮箱，这里的HostName需要改一下，同时安全校验也是不同的，据我测试：只有google gmail邮箱这两个校验都需要（google邮箱是我的最爱，好用，快速，最最重要的是安全，给你足够的隐私权。）设email.setTLS(true); email.setSSL(true);

163：两个都不需要校验就能通过；

sina：两个都不需要校验就能通过；

qq邮箱：需要需要校验tls；

email.setDebug(true); 开启debug模式，可以打印一些信息。

 

 

2、带附件的邮箱发送：

package com.mail.test;
import org.apache.commons.mail.DefaultAuthenticator;
import org.apache.commons.mail.EmailAttachment;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.MultiPartEmail;

public class EmailWithAffixSend
{
    public EmailWithAffixSend()
    {

    }


    public static void send()
    {
     MultiPartEmail  email = new MultiPartEmail();
        //email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验
        email.setDebug(true);
        email.setSSL(true);
        email.setHostName("smtp.sina.com");
        email.setAuthenticator(new DefaultAuthenticator("[email protected]", "******"));
        try
        {
   // Create the attachment
   EmailAttachment attachment = new EmailAttachment();
   //绝对路径
   attachment.setPath("F://dgjl.jpg");
   attachment.setDisposition(EmailAttachment.ATTACHMENT);
   attachment.setDescription("Picture of John");
   attachment.setName("John");
   email.setFrom("[email protected]"); //发送方
   email.addTo("[email protected]"); // 接收方
   //email.addCc("[email protected]"); // 抄送方
   //email.addBcc("[email protected]"); // 秘密抄送方
   email.setCharset("GB2312");//编码
   email.setSubject("有附件!!!"); // 标题
   email.setMsg("邮件发送测试"); // 内容
   email.attach(attachment);
   email.send();
   System.out.println("发送成功");
        } catch (EmailException e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args)
    {
        send();
    }
}

package com.mail.test; import org.apache.commons.mail.DefaultAuthenticator; import org.apache.commons.mail.EmailAttachment; import org.apache.commons.mail.EmailException; import org.apache.commons.mail.MultiPartEmail; public class EmailWithAffixSend { public EmailWithAffixSend() { } public static void send() { MultiPartEmail email = new MultiPartEmail(); //email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验 email.setDebug(true); //email.setSSL(true); email.setHostName("smtp.sina.com"); email.setAuthenticator(new DefaultAuthenticator("[email protected]", "******")); try { // Create the attachment EmailAttachment attachment = new EmailAttachment(); //绝对路径 attachment.setPath("F://dgjl.jpg"); attachment.setDisposition(EmailAttachment.ATTACHMENT); attachment.setDescription("Picture of John"); attachment.setName("John"); email.setFrom("[email protected]"); //发送方 email.addTo("[email protected]"); // 接收方 //email.addCc("[email protected]"); // 抄送方 //email.addBcc("[email protected]"); // 秘密抄送方 email.setCharset("GB2312");//编码 email.setSubject("有附件!!!"); // 标题 email.setMsg("邮件发送测试"); // 内容 email.attach(attachment); email.send(); System.out.println("发送成功"); } catch (EmailException e) { e.printStackTrace(); } } public static void main(String[] args) { send(); } }

3、附件图片是url链接的：

package com.mail.test;
import java.net.MalformedURLException;
import java.net.URL;
import org.apache.commons.mail.DefaultAuthenticator;
import org.apache.commons.mail.EmailAttachment;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.MultiPartEmail;
import org.apache.commons.mail.SimpleEmail;

public class EmailWithUrlAffixSend
{
    public EmailWithUrlAffixSend()
    {

    }


    public static void send()
    {
     MultiPartEmail  email = new MultiPartEmail();
        email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验
        email.setDebug(false);
        email.setSSL(true);
        email.setHostName("smtp.sina.com");
        email.setAuthenticator(new DefaultAuthenticator("[email protected]", "******"));
        try
        {
   // Create the attachment
   EmailAttachment attachment = new EmailAttachment();
   attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif"));
   attachment.setDisposition(EmailAttachment.ATTACHMENT);
   attachment.setDescription("Apache logo");
   attachment.setName("我的份");

   email.setFrom("[email protected]"); //发送方
   email.addTo("[email protected]"); // 接收方
   //email.addCc("[email protected]"); // 抄送方
   //email.addBcc("[email protected]"); // 秘密抄送方
   email.setCharset("GB2312");
   email.setSubject("有附件!!!"); // 标题
   email.setMsg("邮件发送测试。"); // 内容
   email.attach(attachment);
   email.send();
   System.out.println("发送成功");
        } catch (EmailException e) {
            e.printStackTrace();
        }catch (MalformedURLException e) {
   e.printStackTrace();
  }
    }

    public static void main(String[] args)
    {
        send();
    }
}

package com.mail.test; import java.net.MalformedURLException; import java.net.URL; import org.apache.commons.mail.DefaultAuthenticator; import org.apache.commons.mail.EmailAttachment; import org.apache.commons.mail.EmailException; import org.apache.commons.mail.MultiPartEmail; import org.apache.commons.mail.SimpleEmail; public class EmailWithUrlAffixSend { public EmailWithUrlAffixSend() { } public static void send() { MultiPartEmail email = new MultiPartEmail(); email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验 email.setDebug(false); //email.setSSL(true); email.setHostName("smtp.sina.com"); email.setAuthenticator(new DefaultAuthenticator("[email protected]", "******")); try { // Create the attachment EmailAttachment attachment = new EmailAttachment(); attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif")); attachment.setDisposition(EmailAttachment.ATTACHMENT); attachment.setDescription("Apache logo"); attachment.setName("我的份"); email.setFrom("[email protected]"); //发送方 email.addTo("[email protected]"); // 接收方 //email.addCc("[email protected]"); // 抄送方 //email.addBcc("[email protected]"); // 秘密抄送方 email.setCharset("GB2312"); email.setSubject("有附件!!!"); // 标题 email.setMsg("邮件发送测试。"); // 内容 email.attach(attachment); email.send(); System.out.println("发送成功"); } catch (EmailException e) { e.printStackTrace(); }catch (MalformedURLException e) { e.printStackTrace(); } } public static void main(String[] args) { send(); } }
4、html格式邮件发送：

package com.mail.test;
import java.net.MalformedURLException;
import java.net.URL;
import org.apache.commons.mail.DefaultAuthenticator;
import org.apache.commons.mail.EmailAttachment;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.HtmlEmail;
import org.apache.commons.mail.MultiPartEmail;
import org.apache.commons.mail.SimpleEmail;

public class HtmlEmailSend
{
    public HtmlEmailSend()
    {

    }

    public static void send()
    {
  // Create the email message
  HtmlEmail email = new HtmlEmail();
  email.setHostName("smtp.163.com");
  email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验
  email.setAuthenticator(new DefaultAuthenticator("[email protected]", "******"));
  try {
   email.setCharset("GB2312");
   email.addTo("[email protected]", "java");
   email.setFrom("[email protected]", "java");
   email.setSubject("内嵌图片背景测试");
   // embed the image and get the content id
   URL url = new URL("http://www.jianlimuban.com/resume/images/20081112155017201.jpg");
   String cid = email.embed(url, "Apache logo");
   // set the html message
   email.setHtmlMsg("The apache logo - /" mce_src="/""cid:" + cid + "/">");
   // 假如图片失效时显示的文字
   email.setTextMsg("Your email client does not support HTML messages");
   // send the email
   email.send();
   System.out.println("发送成功");
        } catch (EmailException e) {
            e.printStackTrace();
        }catch (MalformedURLException e) {
   e.printStackTrace();
  }
    }

    public static void main(String[] args)
    {
        send();
    }
}

package com.mail.test; import java.net.MalformedURLException; import java.net.URL; import org.apache.commons.mail.DefaultAuthenticator; import org.apache.commons.mail.EmailAttachment; import org.apache.commons.mail.EmailException; import org.apache.commons.mail.HtmlEmail; import org.apache.commons.mail.MultiPartEmail; import org.apache.commons.mail.SimpleEmail; public class HtmlEmailSend { public HtmlEmailSend() { } public static void send() { // Create the email message HtmlEmail email = new HtmlEmail(); email.setHostName("smtp.163.com"); email.setTLS(true); //是否TLS校验，，某些邮箱需要TLS安全校验，同理有SSL校验 email.setAuthenticator(new DefaultAuthenticator("[email protected]", "******")); try { email.setCharset("GB2312"); email.addTo("[email protected]", "java"); email.setFrom("[email protected]", "java"); email.setSubject("内嵌图片背景测试"); // embed the image and get the content id URL url = new URL("http://www.jianlimuban.com/resume/images/20081112155017201.jpg"); String cid = email.embed(url, "Apache logo"); // set the html message email.setHtmlMsg("The apache logo - "); // 假如图片失效时显示的文字 email.setTextMsg("Your email client does not support HTML messages"); // send the email email.send(); System.out.println("发送成功"); } catch (EmailException e) { e.printStackTrace(); }catch (MalformedURLException e) { e.printStackTrace(); } } public static void main(String[] args) { send(); } }

 

异常：开始放在测试项目中还是发送成功的，但是移到另一个项目中，抛异常了：

Exception in thread "main" java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream

Exception in thread "main" java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream

查找资料有朋友也遇到过，是因为MyEclipse中系统自带的email.jar与导入的mail.jar包冲突不一致引起的，删除系统中的jar包即可：

这里引用这位朋友的方法吧：

用rar打开X:/Program Files/MyEclipse 6.0/myeclipse/eclipse/plugins/com.genuitec.eclipse.j2eedt.core_6.0.1.zmyeclipse601200710/data/libraryset/EE_5/javaee.jar
,然后删除mail,一切就OK了。