??? 我干軟件開發也有一點的年頭了,回頭想想,也經歷了不少的酸甜苦辣,為解決了復雜的問題快樂過.也為不分晝夜的加班趕工程郁悶過.不過這些都沒能減少我對計算機的熱情,我對程序的喜好.以前對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();
??????? }
??? }
}