JavaMail 深入淺出

    我幹軟件開發也有一點的年頭了,回頭想想,也經歷了不少的酸甜苦辣,爲解決了複雜的問題快樂過.也爲不分晝夜的加班趕工程鬱悶過.不過這些都沒能減少我對計算機的熱情,我對程序的喜好.以前對JavaMail也有一些學習性的認識,不過一直沒在實際的項目中應用過.直到最近的一個項目,需要JavaMail所以我打算認真的學習一下這種技術,因爲我目前擅長的是Struts,而Struts又不具備郵件發送的功能,所以我要深刻的學習一下JavaMailAPI.所以在我學會了JavaMail的基本操作的同時也將這篇文章獻給大家,雖然技術含量不高,但是希望能對一些剛剛接觸JavaMail的同道中人有所幫助.好了閒話少說進入正題,首先介紹幾個郵件傳輸協議,雖然說不了解這些協議也可以實用JavaMailAPI,但是我始終認爲,如果不透徹的瞭解一種技術的本質,即使會用了也是照葫蘆畫瓢,換一種模式也許就玩不轉了.

    SMTP:簡單郵件傳輸協議(Simple Mail Transfer Protocol,SMTP)由RFC821定義,它定義了發送郵件的機制,在JavaMail環境中,基於JavaMail的程序將和因特網服務供應商ISP(internet Service Provider s)SMTP服務器通信.SMTP服務器會中轉消息給接收方SMTP服務器以便最終讓用戶經由POP或者IMAP獲得.

    POP:代表郵局協議(Post Office Protocol).目前的版本是3.所以一般都稱之爲POP3.這個協議是由RFC1939定義的.POP是一種機制,因特網上多大數用戶用它得到郵件.它規定每個用戶一個郵箱的支持.使用POP協議的時候,用戶的許多性能並不是由POP協議支持的,如查看幾封新郵件消息這個功能,這些功能內建在如Eudora或MicrosoftOutlook之類的程序中,它們記住一些事.所以在用JavaMail的時候,如果你想要這些信息,你就必須自己算了.

    IMAP:是更高級的用戶接收消息的協議,被定義在RFC2060中,IMAP代表因特網消息訪問協議(Internet Message Access Protocol),目前用的版本是4,所以也叫做IMAP4.在用到IMAP的時候,郵件服務器必須支持這個協議,不能僅僅把使用POP的程序用於IMAP,並指望它支持IMAP所有性能.

    MIME:是因特網郵件擴展標準(Multipurpose Internet Mail Extensions).它不是郵件傳輸協議,但是對於傳輸的內容的消息,附件以及其他的內容定義了格式.可以理解成一個定義合適的標準.

    NNTP:因爲JavaMail將供應商和所有其它的東西分開了,您就能輕鬆添加額外的協議支持.NNTP 就是網絡新聞傳輸協議.

    JavaMailAPI可以到 http://java.sun.com/products/javamail/index.html 進行下載,並將mail.jar添加到classpath即可.

    JAF框架可以到 http://java.sun.com/products/javabeans/glasgow/jaf.html 進行下載,並將activation.jar添加到classpath即可.

    如果實用J2EE就沒由什麼特定非要用基本的JavaMailAPI了.J2EE的類就能處理了.只要確保j2ee.jar文件在classpath中就Ok了.

下面我用一個最簡單的例子還演示第一條消息的發送.

1,獲取系統Properties.

Properties props = System.getProperties();

2,將您的SMTP服務器名添加到mail.smtp.host關鍵字的屬性中.

Props.pout( mail.smtp.host ,host);

3,獲取基於Properties Session對象.

Session session = Session.getDefaultInstance(props,null);

4,從Session創建一個MimeMessage.

MimeMessage message = new MimeMessage(session);

5,設置消息from域.

Message.setForm(new InternetAddress(from));

6,設置to域.

Message.addRecipient(Message.RecipientType.TO,new InternetAddress(to));

7,設置消息主題.

message.setSubject( HelloJavaMail );

8,設置消息內容.

Message.setText( Welcome to JavaMail );

9發送消息.

Transport.send(message);

10,在編譯用運的時候傳遞MSTP服務器,from地址,to地址.

    通過簡單的接觸了JavaMail相信大家多郵件發送也有了簡單的瞭解和認識,下面我主要研究一下它的具體功能,也就是說具體的接口或類的含義.

    Session類定義了一個基本的郵件會話,所有的其他類都是由這個session才得意生效的,Session對象用java.util.Properties對象獲取信息,如郵件服務器,用戶名,密碼及整個應用程序中共享的其他信息.類的構造器是此有的,private.它能用getDefaultInstance()方法來共享.獲取Session對象的方方法如下:

Properties props = new Properties();

Session session = Session.getDefaultInstance(props,null);

Null參數都是Authenticator對象,在這裏沒有使用.

對於大多數情況,共享的session已經足夠用了.

    Message消息類,在獲得了Session對象後,就可以繼續創建要發送的消息.因爲Message是個抽象類,您必須用一個子類,多數情況下爲java.mail.internet.MimeMessage.這個能理解成MIME類型和頭的電子郵件消息.正如不同的RFC中定義的,雖然在某些頭部域非ASCII字符也能被編譯,但是Message頭只能被限制用US-ASCII字符.要創建一個Message請將Session對象傳遞給MimeMessage的構造器.

MimeMessage message = newMimeMessage(session);

一旦獲得消息,就可以設置各個部分了.最基本的就是setContent()方法,例如/

message.setContent( Hello , text/plain );

如果知道在實用MimeMessage,而且消息是純文本格式,就可以用setText()方法,它只需要代表實際內容的參數.(Mime類型缺省爲text/plain)

setSubject()方法設置subject(主題);

message.setSubject( 主題 );

    Address地址類,和Message一樣也是一個抽象類,一旦創建了Session和Message並將內容填入消息後,就可以用Address確定信件的地址了,用javax.mail.internet.

InternetAddress類.若創建的地址只包含電子郵件地址,只要傳遞電子郵件地址給構造器就可以了.例如:Address address = new InternetAddress( [email protected] );

若希望名字挨着電子郵件現實,就可以把它傳遞給構造器,如下:

Address address = new InternetAddress( [email protected] , 我心依舊 );

需要爲消息的from域和to域創建地址對象,除非郵件服務器阻止,沒有什麼能阻止你發送一段看上去是任何人的消息了呵呵.一旦創建address將他們域消息連接方法有兩種,如要要識別發件人的就可以用setFrom()和setReplyTo方法.然後message.setFrom(address);

需要實用多個from地址的就用addFrom()方法.例子如下:

Address[] address = ,.,. ;    message.addFrom(address);

若要識別消息recipient收件人,就要實用addRecipient()方法了.例如:

message.addRecipient(type,address)

    Authenticator與java.net類一樣,JavaMailAPI也可以利用Authentcator通過用戶名密碼訪問受保護的資源.對於JavaMail來說,這些資源就是郵件服務器,Authentcator類在javax.mail包中.要使用Authenticator,首先創建一個抽象的子類,並從

GetPasswordAuthentication方法中返回passwordAuthentication實例,創建完成後,您必須向session註冊Authenticator,然後在需要認證的時候會通知它,其實說白了就是把配置的用戶名和密碼返回給調用它的程序.例如:

Properties props = new properties();

Authenticator auth = new MailAuthenticator()//接口聲明,創建自己新類的實例.

Session session = Session.getDefauItInstance(props,auth);

    Transport消息發送傳輸類,這個類用協議指定的語言發送消息,通常是SMTP,它是抽象類,它的工作方式與Session有些類似,盡調用靜態方法send()方法,就OK了.例如:

Transport.send(message);

或者也可以從針對協議的會話中獲取一個特定的實例,傳遞用戶名和密碼.發送消息,然後關閉連接,例如:

message.saveChanges();

transport transport = session.getTreansport( smtp );//指定的協議

transport.connect(host,username,password);

transport.sendMessage(message,message.getAllRecipients());

transport.close();

如果要觀察傳到郵件服務器上的郵件命令,請用session.setDubug(true)設置調試標誌.

    Store和folder用session獲取消息,與發送消息開始很相似,但是在session得到後,很可能實用用戶名和密碼或實用Authenticator連接到一個Store.類似於Transport,也是一樣要告訴store用什麼協議.例如

Store store = session.getStore( pop3 );

Store.connect(host,username,password);

連接到Store之後,接下來,獲得一個folder,必須打開它就可以讀取裏邊的消息了.

Folder folder = store.getFolder("INBOX");

folder.open(Folder.READ_ONLY);

Message[] message = folder.getMessages();

POP3唯一可用的文件夾就是INBOX,如果實用IMAP,還可以用其他的文件夾.

當讀到了具體的message以後,就可以用getContent來獲取內容,或者用writeTo()將內容寫入流,getContent()方法只能得到消息內容,而writeTo()的輸出卻包含消息頭.

System.out.println(((MimeMessage)message).getConntent());

一旦讀取完畢郵件,要關閉store和folder的連接.

folder.colse(boolean);

store.colse();

傳遞給folder的close()方法的boolean參數表示是否清楚已刪除的消息從而更新folder.

    上面就是JavaMail郵件操作的基本的常用類,我覺得理解了這幾個類的機制,基本就可以處理一般的郵件操作了.下面是一個我寫的JavaMail實現郵件發送的代碼.

首先是一個Authenticator類的實現:記錄用戶名和密碼:

import javax.mail.*;

 

 

public class MailAuthenticator extends Authenticator

{

    //******************************

    //由於發送郵件的地方比較多,

    //下面統一定義用戶名,口令.

    //******************************

    public static String HUAWEI_MAIL_USER = "[email protected]";

    public static String HUAWEI_MAIL_PASSWORD = "密碼";

 

 

    public MailAuthenticator()

    {

    }

 

    protected PasswordAuthentication getPasswordAuthentication()

    {

        return new PasswordAuthentication(HUAWEI_MAIL_USER, HUAWEI_MAIL_PASSWORD);

    }

 

}

 

這個類是發送郵件的類.

 

 

package com.deepdo.common.mail;

 

/**

 * 此處插入類型說明。

 * 創建日期:(2006-4-21 14:57:16)

 * @author:張宏亮

 */

 

import java.util.*;

import java.io.*;

import javax.mail.*;

import javax.mail.internet.*;

import javax.activation.*;

 

 

public class SendMail {

 

    //要發送Mail地址

    private String mailTo = null;

    //Mail發送的起始地址

    private String mailFrom = null;

    //SMTP主機地址

    private String smtpHost = null;

    //是否採用調試方式

    private boolean debug = false;

 

    private String messageBasePath = null;

    //Mail主題

    private String subject;

    //Mail內容

    private String msgContent;

 

    private Vector attachedFileList;

    private String mailAccount = null;

    private String mailPass = null;

    private String messageContentMimeType ="text/html; charset=gb2312";

 

    private String mailbccTo = null;

    private String mailccTo = null;

    /**

     * SendMailService 構造子註解。

     */

    public SendMail() {

        super();

   

    }

 

    private void fillMail(Session session,MimeMessage msg) throws IOException, MessagingException{

   

        String fileName = null;

        Multipart mPart = new MimeMultipart();

        if (mailFrom != null) {

            msg.setFrom(new InternetAddress(mailFrom));

            System.out.println("發送人Mail地址:"+mailFrom);

        } else {

            System.out.println("沒有指定發送人郵件地址!");

            return;

        }

        if (mailTo != null) {

            InternetAddress[] address = InternetAddress.parse(mailTo);

            msg.setRecipients(Message.RecipientType.TO, address);

            System.out.println("收件人Mail地址:"+mailTo);

        } else {

            System.out.println("沒有指定收件人郵件地址!");

            return;

        }

   

        if (mailccTo != null) {

            InternetAddress[] ccaddress = InternetAddress.parse(mailccTo);

            System.out.println("CCMail地址:"+mailccTo);

            msg.setRecipients(Message.RecipientType.CC, ccaddress);

        }

        if (mailbccTo != null) {

            InternetAddress[] bccaddress = InternetAddress.parse(mailbccTo);

            System.out.println("BCCMail地址:"+mailbccTo);

            msg.setRecipients(Message.RecipientType.BCC, bccaddress);

        }

        msg.setSubject(subject);

        InternetAddress[] replyAddress = { new InternetAddress(mailFrom)};

        msg.setReplyTo(replyAddress);

        // create and fill the first message part

        MimeBodyPart mBodyContent = new MimeBodyPart();

        if (msgContent != null)

            mBodyContent.setContent(msgContent, messageContentMimeType);

        else

            mBodyContent.setContent("", messageContentMimeType);

        mPart.addBodyPart(mBodyContent);

        // attach the file to the message

        if (attachedFileList != null) {

            for (Enumeration fileList = attachedFileList.elements(); fileList.hasMoreElements();) {

                fileName = (String) fileList.nextElement();

                MimeBodyPart mBodyPart = new MimeBodyPart();

   

                // attach the file to the message

                FileDataSource fds = new FileDataSource(messageBasePath + fileName);

                System.out.println("Mail發送的附件爲:"+messageBasePath + fileName);

                mBodyPart.setDataHandler(new DataHandler(fds));

                mBodyPart.setFileName(fileName);

                mPart.addBodyPart(mBodyPart);

            }

        }

        msg.setContent(mPart);

        msg.setSentDate(new Date());

    }

    /**

     * 此處插入方法說明。

     */

    public void init()

    {

   

    }

    /**

     * 發送e_mail,返回類型爲int

     * 當返回值爲0時,說明郵件發送成功

     * 當返回值爲3時,說明郵件發送失敗

     */

    public int sendMail() throws IOException, MessagingException {

   

        int loopCount;

        Properties props = System.getProperties();

        props.put("mail.smtp.host", smtpHost);

        props.put("mail.smtp.auth", "true");

   

        MailAuthenticator auth = new MailAuthenticator();

   

        Session session = Session.getInstance(props, auth);

        session.setDebug(debug);

        MimeMessage msg = new MimeMessage(session);

        Transport trans = null;

        try {

   

            fillMail(session,msg);

            // send the message

            trans = session.getTransport("smtp");

            try {

                trans.connect(smtpHost, MailAuthenticator.HUAWEI_MAIL_USER, MailAuthenticator.HUAWEI_MAIL_PASSWORD);//, HUAWEI_MAIL_PASSWORD);

            } catch (AuthenticationFailedException e) {

                e.printStackTrace();

                System.out.println("連接郵件服務器錯誤:");

                return 3;

            } catch (MessagingException e) {

                System.out.println("連接郵件服務器錯誤:");

                return 3;

            }

   

            trans.send(msg);

            trans.close();

   

        } catch (MessagingException mex) {

            System.out.println("發送郵件失敗:");

            mex.printStackTrace();

            Exception ex = null;

            if ((ex = mex.getNextException()) != null) {

                System.out.println(ex.toString());

                ex.printStackTrace();

            }

            return 3;

        } finally {

            try {

                if (trans != null && trans.isConnected())

                    trans.close();

            } catch (Exception e) {

                System.out.println(e.toString());

            }

        }

        System.out.println("發送郵件成功!");

        return 0;

    }

    public void setAttachedFileList(java.util.Vector filelist)

    {

        attachedFileList = filelist;

    }

    public void setDebug(boolean debugFlag)

    {

        debug=debugFlag;

    }

    public void setMailAccount(String strAccount) {

        mailAccount = strAccount;

    }

    public void setMailbccTo(String bccto) {

        mailbccTo = bccto;

    }

    public void setMailccTo(String ccto) {

        mailccTo = ccto;

    }

    public void setMailFrom(String from)

    {

        mailFrom=from;

    }

    public void setMailPass(String strMailPass) {

        mailPass = strMailPass;

    }

    public void setMailTo(String to)

    {

        mailTo=to;

    }

    public void setMessageBasePath(String basePath)

    {

        messageBasePath=basePath;

    }

    public void setMessageContentMimeType(String mimeType)

    {

        messageContentMimeType = mimeType;

    }

    public void setMsgContent(String content)

    {

        msgContent=content;

    }

    public void setSMTPHost(String host)

    {

        smtpHost=host;

    }

    public void setSubject(String sub)

    {

        subject=sub;

    }

   

    public static void main(String[] argv) throws Exception

    {

        for(int i = 0;i<10;i++) {

        SendMail sm = new SendMail();

        sm.setSMTPHost("SMTP地址");

        sm.setMailFrom("發送地址");

        sm.setMailTo("目標地址");

        sm.setMsgContent("內容");

        sm.setSubject("標題");

        sm.sendMail();

        }

    }

}

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章