Commons-Email 简单教程

最新推荐文章于 2021-02-25 14:29:28 发布

木生火18624

最新推荐文章于 2021-02-25 14:29:28 发布

阅读量1k

点赞数

一：Quick Start
通过SimpleEmail发送邮件

     Java代码 
       
     
   
 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,则邮件发送的时候会自动下载，添加到附件中。

     Java代码 
       
     
   
  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格式的邮件

     Java代码 
       
     
   
 通过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的代码如下

     Java代码 
       
     
   
 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里
都已经做了封装, 所以在发送附件时使用如下:

     Java代码 
       
     
   
 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  
 ---------------------------------------------------------------------------------  
 