??? 我干軟件開發也有一點的年頭了,回頭想想,也經歷了不少的酸甜苦辣,為解決了復雜的問題快樂過.也為不分晝夜的加班趕工程郁悶過.不過這些都沒能減少我對計算機的熱情,我對程序的喜好.以前對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( “ it5719@163.com ” );
若希望名字挨著電子郵件現實,就可以把它傳遞給構造器,如下:
Address address = new InternetAddress( “ it5719@163.com ” , ” 我心依舊 ” );
需要為消息的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 = "it5719@163.com";
??? 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();
??????? }
??? }
}