struts2集成javamail發郵件（帶附件）實踐記錄

一、代碼預覽

這兩天在做struts2上的郵件發送。以前的項目有用到spring，用spring提供的郵件支持類很方便可以完成這個功能，但是現在只用struts2的話，就碰到了一系列的問題。

代碼是從網上copy的，然後自己改進了一些，同時增加了附件發送功能，我們先來看看主要代碼(請先將自己下載的 mail.jar，及activation.jar加入到classpath)

package com.nerve.cloudoffice.common.util;

import java.util.List;
import java.util.Properties;

import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Address;
import javax.mail.BodyPart;
import javax.mail.Message;
import javax.mail.Multipart;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;

public class EMailSender {
	 /**
     * 向用戶發送郵件
     */
    private static final long serialVersionUID = 1L;

    private MimeMessage mimeMsg; // MIME郵件對象

    private Session session; // 郵件會話對象

    private Properties props; // 系統屬性

    private boolean needAuth = false; // smtp是否需要認證

    private String username = ""; // smtp認證用戶名和密碼

    private String password = "";

    private Multipart mp; // Multipart對象,郵件內容,標題,附件等內容均添加到其中後再生成
    
    private String log;
    
    public EMailSender() {

    }

    public EMailSender(String smtp) {
        setSmtpHost(smtp);
        createMimeMessage();
    }

    public void setSmtpHost(String hostName) {
        System.out.println("設置系統屬性：mail.smtp.host = " + hostName);
        if (props == null)
            props = System.getProperties(); // 獲得系統屬性對象
        props.put("mail.smtp.host", hostName); // 設置SMTP主機
        props.put("mail.smtp.localhost", "localHostAdress");
    }

    public boolean createMimeMessage() {
        try {
            System.out.println("準備獲取郵件會話對象！");
            session = Session.getDefaultInstance(props, null); // 獲得郵件會話對象
        } catch (Exception e) {
        	log = "獲取郵件會話對象時發生錯誤！" + e.toString();
            System.err.println(log);
            return false;
        }
        try {
            mimeMsg = new MimeMessage(session); // 創建MIME郵件對象
            mp = new MimeMultipart(); // mp 一個multipart對象
            // Multipart is a container that holds multiple body parts.
            return true;
        } catch (Exception e) {
        	log = "創建MIME郵件對象失敗！" + e;
            System.err.println(log);
            return false;
        }
    }

    public void setNeedAuth(boolean need) {
        System.out.println("設置smtp身份認證：mail.smtp.auth = " + need);
        if (props == null)
            props = System.getProperties();
        if (need) {
            props.put("mail.smtp.auth", "true");
        } else {
            props.put("mail.smtp.auth", "false");
        }
    }

    public void setNamePass(String name, String pass) {
        System.out.println("程序得到用戶名與密碼");
        username = name;
        password = pass;
    }

    public boolean setSubject(String mailSubject) {
        System.out.println("設置郵件主題！");
        try {
            mimeMsg.setSubject(MimeUtility.encodeText(mailSubject,"utf-8","B"));
            return true;
        } catch (Exception e) {
        	log = "設置郵件主題發生錯誤！"+e;
            System.err.println(log);
            return false;
        }
    }

    public boolean setBody(String mailBody) {
        try {
            System.out.println("設置郵件體格式");
            BodyPart bp = new MimeBodyPart();
            // 轉換成中文格式
            bp.setContent(
                    "<meta http-equiv=Content-Type content=text/html; charset=utf-8>"
                            + mailBody, "text/html;charset=utf-8");
            mp.addBodyPart(bp);
            return true;
        } catch (Exception e) {
        	log = "設置郵件正文時發生錯誤！" + e;
            System.err.println(log);
            return false;
        }
    }
    
    public boolean setFiles(List<String> files){
    	try{
    		for(String s:files){
        		MimeBodyPart mbp=new MimeBodyPart();  
                FileDataSource fds=new FileDataSource(s); //得到數據源  
                mbp.setDataHandler(new DataHandler(fds)); //得到附件本身並至入BodyPart  
                mbp.setFileName(fds.getName());  //得到文件名同樣至入BodyPart  
                mp.addBodyPart(mbp);
        	}
    		return true;
    	}catch(Exception e){
    		log = "增加附件時出錯："+e;
    		e.printStackTrace();
    		return false;
    	}
    }
    
    public boolean addFile(String path, String name){
    	try{
    		MimeBodyPart mbp=new MimeBodyPart();  
            FileDataSource fds=new FileDataSource(path); //得到數據源  
            mbp.setDataHandler(new DataHandler(fds)); //得到附件本身並至入BodyPart  
            mbp.setFileName(MimeUtility.encodeText(name,"utf-8","B"));
            mp.addBodyPart(mbp);
    		return true;
    	}catch(Exception e){
    		log = "增加附件時出錯："+e;
    		e.printStackTrace();
    		return false;
    	}
    }

    public boolean setFrom(String from) {
        System.out.println("設置發信人！");
        try {
            mimeMsg.setFrom(new InternetAddress(from)); // 設置發信人
            return true;
        } catch (Exception e) {
        	log = "設置發信人出錯:"+e;
            return false;
        }
    }

    public boolean setTo(String to) {
        System.out.println("設置收信人");
        if (to == null)
            return false;
        try {
            mimeMsg.setRecipients(Message.RecipientType.TO, InternetAddress
                    .parse(to));
            return true;
        } catch (Exception e) {
            return false;
        }
    }

    public boolean setCopyTo(String copyto) {
        if (copyto == null)
            return false;
        try {
            mimeMsg.setRecipients(Message.RecipientType.CC,
                    (Address[]) InternetAddress.parse(copyto));
            return true;
        } catch (Exception e) {
            return false;
        }
    }

    public boolean sendout() {
        try {
            mimeMsg.setContent(mp);
            mimeMsg.saveChanges();
            System.out.println("正在發送郵件....");
            Session mailSession = Session.getInstance(props, null);
            Transport transport = mailSession.getTransport("smtp");
            transport.connect((String) props.get("mail.smtp.host"), username,
                    password);
            transport.sendMessage(mimeMsg, mimeMsg
                    .getRecipients(Message.RecipientType.TO));
            // transport.send(mimeMsg);
            System.out.println("發送郵件成功！");
            transport.close();
            return true;
        } catch (Exception e) {
        	log = "郵件發送失敗！" + e;
            System.err.println(log);
            return false;
        }
    }
    
    public String getLog(){
    	return log;
    }
}

二、問題總結

2.1  本地執行時報錯

我用的是javaee 5，jdk1.6，在本地跑時，會出現ClassNotFound的Exception，但是這些類在mail.jar裏面又是有的。這個原因是因爲我們自己增加的jar包裏面的類跟javaee5裏面的衝突了，我推薦的解決方法是將javaee5裏面的 activation包跟mail包刪除。

做法如下：

找到eclipse引用的javaee5包，用rar軟件打開，找到activation跟mail包，刪除保存就可以了。（記得在ide中刷新一下引用包）

2.2 javax.mail.MessagingException: 501 Syntax: HELO hostname

在本地測試通過後，我部署到linux服務器中，但是去碰到了javax.mail.MessagingException: 501 Syntax: HELO hostname異常， google了發現是以下原因：

Javamail 在提取本地 hostname 的時候會 dig 改 hostname ，然後以改 ip 發送郵件。

由於 hostname 對應的 ip 地址， linux 無法解析（如果是 windows 則無這個問題， windows 利用 netbios 協議去獲得該主機的 ip 地址）到本機 hostname 的 ip ，導致 javamail 無法調用發送 ip 。 Postfix 收到此類郵件將拒絕投遞，而產生 501 錯誤。

網上說可以通過修改服務器的hosts文件解決，但是我發現還可以直接在代碼裏面解決（只需要加一行代碼，這大大方便啊），即在setSmtpHost()方法中，增加下面一行：

props.put("mail.smtp.localhost", "localHostAdress");

2.3 附件中文名亂碼

如果附件有中文名，直接setName（）會亂碼，通過下面的方法可以解決：

mbp.setFileName(MimeUtility.encodeText(name,"utf-8","B"));

基本上是這些了，等以後有新發現再分享哈