用 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("[e-mail]", "John Doe");
//发送人
email.setFrom("[e-mail]", "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("[e-mail]", "John Doe");
//发送人
email.setFrom("[e-mail]", "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("[e-mail]", "John Doe");
//发送人
email.setFrom("[e-mail]", "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 ( "[e-mail]", "Zieckey" );
        // 发送人
        email.setFrom ( "[e-mail]", "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("[e-mail]", "fantasia");   
22.         email.setFrom("[e-mail]", "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 中的例子做即可，出现中文乱码，跟到源代码中想想办法自己动动脑。