用 apache commons-email 輕鬆傳送無亂碼郵件

工程師WWW發表於2015-10-29
ApacheAI
原來專案中都是自己拿到 mail.jar 和 activation.jar 兩個包編寫傳送Email的程式碼，雖然不難，但也有些麻煩。

現在好了，在 apache 站點有一個 jarkata/commons/email 子專案，也為我們實現了傳送 Email 的功能，在 http://jakarta.apache.org/commons/email/ 把包 commons-email-1.0.jar 下來，自己要寫的程式碼就十分少了，並且非常明瞭。

這個包的大小隻有23K，也就是9個類而已，卻能讓您省不少事。
還需要mail.jar&activation.jar(google去找o(∩_∩)o...)
commons-email是apache提供的一個開源的API，是對javamail的封裝，因此在使用時要將javamail.jar加 到 class path中，主要包括SimpleEmail，MultiPartEmail，HtmlEmail，EmailAttachment四個類。
 
SimpleEmail:傳送簡單的email,不能新增附件
MultiPartEmail:文字郵件，可以新增多個附件
HtmlEmail:HTML格式郵件，同時具有MultiPartEmail類所有“功能”
EmailAttchment:附件類，可以新增本地資源，也可以指定網路上資源，在傳送時自動將網路上資源下載傳送。
 
傳送基本文字格式郵件：
==============
SimpleEmail email = new SimpleEmail();
//smtp host 
email.setHostName("mail.test.com");
//登陸郵件伺服器的使用者名稱和密碼
email.setAuthentication("test","testpassword");
//接收人
email.addTo("jdoe@somewhere.org", "John Doe");
//傳送人
email.setFrom("me@apache.org", "Me");
//標題
email.setSubject("Test message");
//郵件內容
email.setMsg("This is a simple test of commons-email");
//傳送
email.send();

傳送文字格式，帶附件郵件：
==================
//附件，可以定義多個附件物件
EmailAttachment attachment = new EmailAttachment();
attachment.setPath("e:\\1.pdf");
attachment.setDisposition(EmailAttachment.ATTACHMENT);
attachment.setDescription("Picture of John");
//
MultiPartEmail email = new MultiPartEmail();
//smtp host 
email.setHostName("mail.test.com");
//登陸郵件伺服器的使用者名稱和密碼
email.setAuthentication("test","testpassword");
//接收人
email.addTo("jdoe@somewhere.org", "John Doe");
//傳送人
email.setFrom("me@apache.org", "Me");
//標題
email.setSubject("Test message");
//郵件內容
email.setMsg("This is a simple test of commons-email");
//新增附件
email.attach(attachment);
//傳送
email.send();
 
傳送HTML格式帶附件郵件：
=================
//附件，可以定義多個附件物件
EmailAttachment attachment = new EmailAttachment();
attachment.setPath("e:\\1.pdf");
attachment.setDisposition(EmailAttachment.ATTACHMENT);
attachment.setDescription("Picture of John");
//
HtmlEmail email = new HtmlEmail ();
//smtp host 
email.setHostName("mail.test.com");
//登陸郵件伺服器的使用者名稱和密碼
email.setAuthentication("test","testpassword");
//接收人
email.addTo("jdoe@somewhere.org", "John Doe");
//傳送人
email.setFrom("me@apache.org", "Me");
//標題
email.setSubject("Test message");
//郵件內容
email.setHtmlMsg("This is a simple test of commons-email");
//新增附件
email.attach(attachment);
//傳送

 下面提供一個完整的程式示例：

package zieckey

import org.apache.commons.mail.*;

public class SendEMail
{
    public static void main ( String[] arg ) throws Exception
    {
        SimpleEmail email = new SimpleEmail ();

        // smtp host
        email.setHostName ( "smtp.163.com" );
        // 登陸郵件伺服器的使用者名稱和密碼
        email.setAuthentication ( "zieckey", "123456" );
        // 接收人
        email.addTo ( "zieckey@yahoo.com.cn", "Zieckey" );
        // 傳送人
        email.setFrom ( "zieckey@163.com", "Me" );
        // 標題
        email.setSubject ( "Test message" );
        // 郵件內容
        email.setMsg ( "This is a simple test of commons-email");
        // 傳送
        email.send ( );
        
        System.out.println ( "Send email successful!" );
    }
}

commons-email 提供了 SimpleEmail、MultiPartEmail、HtmlEmail、EmailAttachment 等類，只需要您按正常思維簡單的寫幾行程式碼就能發各種型別的 Email，一般我們用 JavaMail 傳送 Email 會碰到中文亂碼問題，主要是出現在把程式碼放在英文系統中執行時，處理方法是主題和內容使用 GBK 或 UTF-8 字符集。

在 http://jakarta.apache.org/commons/email/userguide.html 有 commons-email 的使用示例，如果直接用第一個例子放在英文環境中傳送帶中文主題或內容的郵件也會出現亂碼，

這裡對第一個例子稍做改造，可以讓發出的 Email 中文不出現亂碼，如下：
  1. package com.unmi;   
  2.   
  3. import org.apache.commons.mail.SimpleEmail;   
  4.   
  5. public class MailTo   
  6. {   
  7.     /**  
  8.      * @Author Unmi   
  9.      * @param args   
  10.      * @throws Exception    
  11.      */  
  12.     public static void main(String[] args) throws Exception   
  13.     {   
  14.         //傳送簡單郵件   
  15.         SimpleEmail email = new SimpleEmail();   
  16.            
  17.         email.setHostName("mail.2911.net");   
  18.            
  19.         //需要郵件傳送伺服器驗證,使用者名稱/密碼   
  20.         email.setAuthentication("broodwar", "xxxxxx");   
  21.         email.addTo("fantasia@sina.com", "fantasia");   
  22.         email.setFrom("broodwar@2911.net", "Broodwar");   
  23.            
  24.         //設定主題的字符集為UTF-8   
  25.         email.setCharset("UTF-8");    
  26.         email.setSubject("測試郵件主題");   
  27.            
  28.         email.buildMimeMessage();   
  29.            
  30.         //設定內容的字符集為UTF-8,先buildMimeMessage才能設定內容文字   
  31.         email.getMimeMessage().setText("測試郵件內容","UTF-8");   
  32.         email.sendMimeMessage();   
  33.     }   
  34. }  

在以後在java中發郵件就用這個 commons-email 元件就好了，如果要傳送 HTML 郵件或者帶附件的郵件就學著http://jakarta.apache.org/commons/email/userguide.html 中的例子做即可，出現中文亂碼，跟到原始碼中想想辦法自己動動腦。

相關文章