【轉】用 apache commons-email 輕鬆發送無亂碼郵件

peigen  的  用 apache commons-email 輕鬆發送無亂碼郵件
原來項目中都是本身拿到 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  中的例子作便可，出現中文亂碼，跟到源代碼中想一想辦法本身動動腦。