1.介紹:

Java Mail API的開發(fā)是SUN為Java開發(fā)者提供公用API框架的持續(xù)努力的良好例證。提倡公用框架，反對(duì)受限于供應(yīng)商的解決方案，充分預(yù)示著一個(gè)日益開放的開發(fā)環(huán)境的建立。
　　Java Mail API的結(jié)構(gòu)本身證明了它的開發(fā)者的基本目標(biāo)之一--軟件開發(fā)的工作量應(yīng)該取決于應(yīng)用程序本身的復(fù)雜程度以及開發(fā)者所要求的控制程度。換句話說，Java Mail API盡可能地保持簡(jiǎn)單。乍看起來，JavaMail API所擁有的類總數(shù)以及類之間的關(guān)系可能讓人誤解為要花費(fèi)漫長(zhǎng)的學(xué)習(xí)時(shí)間。實(shí)際上，一旦正式開始使用，你就會(huì)發(fā)現(xiàn)該API不失為在應(yīng)用程序中加入健壯的郵件/通訊支持的簡(jiǎn)單工具。

2.安裝:

安裝前要確保你的機(jī)子上安裝得有標(biāo)準(zhǔn)版的JDK和Web服務(wù)器,并且已配置好,有關(guān)它們的安裝方法,請(qǐng)參考其它文章(網(wǎng)上到處都有).

(1).安裝JavaMail API。現(xiàn)在最常用的 JavaMail API 版本是1.3.
　　要使用 JavaMail 1.3 API，請(qǐng)下載 JavaMail 1.3 實(shí)現(xiàn)，解開Javamail-1_3.zip 文件，并將 mail.jar 文件添加到 CLASSPATH 中。除了核心類，隨版本 1.3 實(shí)現(xiàn)一起提供的還有 SMTP、IMAP4 和 POP3 供應(yīng)商。
　　
(2).JavaBeans Activation Framework(1.0.2版) 的安裝
JavaMail API 的所有版本都需要 JavaBeans Activation Framework 來支持任意數(shù)據(jù)塊的輸入及相應(yīng)處理。功能似乎不多，但目前許多瀏覽器和郵件工具中都能找到這種基本的 MIME 型支持。下載完框架后，解開 jaf1_0_2.zip 文件，并將 activation.jar 文件添加到 CLASSPATH 中。
　　

注: 如果您使用的JDK是J2EE，就沒有什么特定的事非要用基本 JavaMail API來做不可；J2EE 的類就能處理了,因?yàn)樗旧砭桶蠮avaMail API和JAF,您只需要確將 j2ee.jar 文件添加到您的CLASSPATH 中并已全部設(shè)置好。

 

3.JavaMail的常用類介紹

事先說明:

沒用過JavaMail的人可能看不懂這些介紹,不過不要緊,后面的文章有具體的實(shí)例,到時(shí)也可倒回來查看這些類的用法.


(1) javax.mail.Properties類
　　JavaMail需要Properties來創(chuàng)建一個(gè)session對(duì)象。它將尋找字符串"mail.smtp.host"，屬性值就是發(fā)送郵件的主機(jī).

用法:
　Properties props = new Properties ();
　　　props.put("mail.smtp.host", "smtp.163.com");//可以換上你的smtp主機(jī)名。


(2) javax.mail.Session類
　　這個(gè)Session類代表JavaMail 中的一個(gè)郵件session. 每一個(gè)基于 JavaMail的應(yīng)用程序至少有一個(gè)session但是可以有任意多的session。 在這個(gè)例子中, Session對(duì)象需要知道用來處理郵件的SMTP 服務(wù)器。

用法:
　　 Session sendMailSession;
　　 sendMailSession = Session.getInstance(props, null);


(3) javax.mail.Transport類
　　郵件是既可以被發(fā)送也可以被受到。JavaMail使用了兩個(gè)不同的類來完成這兩個(gè)功能：Transport 和Store. Transport 是用來發(fā)送信息的，而Store用來收信。對(duì)于這的教程我們只需要用到Transport對(duì)象。

用法：
Transport transport;
　 transport = sendMailSession.getTransport("smtp");

　　用JavaMail Session對(duì)象的getTransport 方法來初始化Transport。傳過去的字符串申明了對(duì)象所要使用的協(xié)議，如"smtp"。這將為我們省了很多時(shí)間。因?yàn)镴avaMail以境內(nèi)置了很多協(xié)議的實(shí)現(xiàn)方法。

　注意: JavaMail并不是絕對(duì)支持每一個(gè)協(xié)議，目前支持IMAP、 SMTP和 POP3.


(4) javax.mail.MimeMessage類
　　Message對(duì)象將存儲(chǔ)我們實(shí)際發(fā)送的電子郵件信息，Message對(duì)象被作為一個(gè)MimeMessage對(duì)象來創(chuàng)建并且需要知道應(yīng)當(dāng)選擇哪一個(gè)JavaMail session。

　　用法：
Message newMessage = new MimeMessage(sendMailSession);


(5) javax.mail.InternetAddress類
一旦您創(chuàng)建了 Session 和 Message，并將內(nèi)容填入消息后，就可以用Address確定信件地址了。和 Message 一樣，Address 也是個(gè)抽象類。您用的是Javax.mail.internet.InternetAddress 類.

用法:
InternetAddress from=new InternetAddress("xxf@cafe.com");


(6) javax.mail.Store類
Store類實(shí)現(xiàn)特定郵件協(xié)議上的讀、寫、監(jiān)視、查找等操作。通過Javax.mail.Store類可以訪問Javax.mail.Folder類。

用法:
Store store=s.getSorte("pop3");//s為一個(gè)郵件會(huì)話
store.connect(popserver,username,password);//通過你提供的pop地址,用戶名和密碼登錄你的郵箱


(7) javax.mail.Folder類
Folder類用于分級(jí)組織郵件，并提供照J(rèn)avax.mail.Message格式訪問email的能力。

用法:
Folder folder=store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);


(8) javax.mail.Internet.MimeMultpart
一般保存電子郵件內(nèi)容的容器是Multipart抽象類,它定義了增加和刪除及獲得電子郵件不同部分內(nèi)容的方法.由于Multipart是抽象類,我們必須為它使用一個(gè)具體的子類,JavaMail API提供javax.mail.Internet.MimeMultpart類來使用MimeMessage對(duì)象.

用法:
MimeMultipart multipart=new MimeMultipart();

注:我們使用MimeMultipart對(duì)象的一個(gè)方法是addBodyPart(),它在我們的電子郵件內(nèi)容里添加BodyPart(BodyPart類在下面緊接著要介紹)對(duì)象.消息可以有很多部分,一個(gè)BodyPart可以代表一個(gè)部分.


(9) javax.mail.Internet.MimeBodyPart類

MimeBodyPart是BodyPart具體用于mimeMessage的一個(gè)子類.
MimeBodyPart對(duì)象代表一個(gè)MimeMessage對(duì)象內(nèi)容的一部分.每個(gè)MimeBodyPart被認(rèn)為有兩部分:
⊙一個(gè)MIME類型
⊙匹配這個(gè)類型的內(nèi)容

用法:
MimeBodyPart mdp=new MimeBodyPart();
String text="Hello JavaMail!";
mdp.setContent(text,"text/plain");//定義MIME類型為text/plain,并設(shè)置MimeBodyPart的內(nèi)容.


(10) javax.activation.DataHandler類(包含在JAF中)
JavaMail API不限制信息只為文本,任何形式的信息都可能作繭自縛MimeMessage的一部分.除了文本信息,作為文件附件包含在電子郵件信息的一部分是很普遍的.JavaMail API通過使用DataHandler對(duì)象,提供一個(gè)允許我們包含非文本BodyPart對(duì)象的簡(jiǎn)便方法.

用法:
DataHandler dh=new DataHandler(text,type);
mdp.setDatahandler(dh);//mdp是一個(gè)MimeBodyPart對(duì)象


(11) javax.activation.FileDataSource類(包含在JAF中)
一個(gè)FileDataSource對(duì)象可以表示本地文件和服務(wù)器可以直接訪問的資源.一個(gè)本地文件可以通過創(chuàng)建一個(gè)新的MimeBodyPart對(duì)象附在一個(gè)mimeMessage對(duì)象上.

用法:
MimeMultipart mm=new MimeMultipart();
MimeBodyPart mdp=new MimeBodyPart();
FileDataSource fds=new FileDataSource("c:/exam.txt");
mdp.setDataHandler(new DataHandler(fds)); //設(shè)置數(shù)據(jù)源
mm.addBodyPart(mdp); //為當(dāng)前消息MimeMultipart對(duì)象增加MimeBodyPart


(12) javax.activation.URLDataSource類(包含在JAF中)
遠(yuǎn)程資源,URL不會(huì)指向它們,由一個(gè)URLDataSource對(duì)象表示.一個(gè)遠(yuǎn)程資源可以通過創(chuàng)建一個(gè)新mimeBodyPart對(duì)象附在一個(gè)mimeMessage對(duì)象上(同F(xiàn)ileDataSource差不多).

用法:
與FileDataSource唯一不同的是數(shù)據(jù)源的設(shè)置:
URLDataSource uds=new URLDataSource( http://www.cnjsp.com/logo.gif );

 

4.試著編寫第一個(gè)發(fā)送程序

在前面我們已對(duì)JavaMail作了一些介紹,下面我們可試著寫自己的程序了.

首先,我們先寫一個(gè)撰寫郵件的html程序index.htm,如下:
-------------------------------------------------------------------------------------------
< html >
< head >
< meta http-equiv="Content-Type" content="text/html; charset=gb2312" >
< title > 撰寫郵件 < /title >
< /head >

< body >
< form name="form1" method="post" action="testmail.jsp" >
< table width="75" border="0" align="center" cellspacing="1" bgcolor="#006600" class="black" >
< tr bgcolor="#FFFFFF" >
< td width="24%" > 收信人地址: < /td >
< td width="76%" >
< input name="to" type="text" id="to" >< /td >
< /tr >
< tr bgcolor="#FFFFFF" >
< td > 主題: < /td >
< td >
< input name="title" type="text" id="title" >< /td >
< /tr >
< tr >
< td height="107" colspan="2" bgcolor="#FFFFFF" >
< textarea name="content" cols="50" rows="5" id="content" >< /textarea >< /td >
< /tr >
< tr align="center" >
< td colspan="2" bgcolor="#FFFFFF" >
< input type="submit" name="Submit" value="發(fā)送" >
< input type="reset" name="Submit2" value="重置" >
< /td >
< /tr >
< /table >
< /form >
< /body >
< /html >


接著,我們?cè)賹懸粋€(gè)處理程序testmail.jsp,如下:
-----------------------------------------------------------------------------------------
< %@ page contentType="text/html;charset=GB2312" % >
< %request.setCharacterEncoding("gb2312");% >< !--中文處理代碼-- >

< !--引入要用到的類庫-- >
< %@ page import="java.util.*,javax.mail.*"% >
< %@ page import="javax.mail.internet.*"% >

< html >
< head >
< meta http-equiv="Content-Type" content="text/html; charset=gb2312" >
< title > 發(fā)送成功 < /title >
< /head >

< body >
< %
try{

//從html表單中獲取郵件信息
String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String tcontent=request.getParameter("content");

Properties props=new Properties();//也可用Properties props = System.getProperties();
props.put("mail.smtp.host","smtp.163.net");//存儲(chǔ)發(fā)送郵件服務(wù)器的信息
props.put("mail.smtp.auth","true");//同時(shí)通過驗(yàn)證
Session s=Session.getInstance(props);//根據(jù)屬性新建一個(gè)郵件會(huì)話
s.setDebug(true);

MimeMessage message=new MimeMessage(s);//由郵件會(huì)話新建一個(gè)消息對(duì)象

//設(shè)置郵件
InternetAddress from=new InternetAddress("boy@163.net");
message.setFrom(from);//設(shè)置發(fā)件人
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);//設(shè)置收件人,并設(shè)置其接收類型為TO
message.setSubject(ttitle);//設(shè)置主題
message.setText(tcontent);//設(shè)置信件內(nèi)容
message.setSentDate(new Date());//設(shè)置發(fā)信時(shí)間

//發(fā)送郵件
message.saveChanges();//存儲(chǔ)郵件信息
Transport transport=s.getTransport("smtp");
transport.connect("smtp.163.net","boy","iloveyou");//以smtp方式登錄郵箱
transport.sendMessage(message,message.getAllRecipients());//發(fā)送郵件,其中第二個(gè)參數(shù)是所有
//已設(shè)好的收件人地址
transport.close();

% >
< div align="center" >
< p >< font color="#FF6600" > 發(fā)送成功! < /font >< /p >
< p >< a href="recmail.jsp" > 去看看我的信箱 < /a >< br >
< br >
< a href="index.htm" > 再發(fā)一封 < /a > < /p >
< /div >
< %
}catch(MessagingException e){
out.println(e.toString());
}
% >
< /body >
< /html >

**********************************注意***************************************

有好多書上和網(wǎng)上的文章在關(guān)鍵部分都是這樣寫testmail.jsp的,如下:

String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String tcontent=request.getParameter("content");
Properties props=new Properties();
props.put("mail.smtp.host","smtp.163.net");
Session s=Session.getInstance(props);
MimeMessage message=new MimeMessage(s);

InternetAddress from=new InternetAddress("boy@163.net");
message.setFrom(from);
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);

message.setSubject(ttitle);
message.setText(tcontent);
message.setSentDate(new Date());

Store store=s.getStore("pop3");
store.connect("pop.163.net","boy","iloveyou");//以pop3的方式登錄郵箱
Transport transport=s.getTransport("smtp");
transport.send(message);
store.close();

事實(shí)上,這種方式并不可靠,因?yàn)楹芏嚯娮余]局的smtp服務(wù)器要求我們通過驗(yàn)證,所以用這種方式發(fā)郵件時(shí),只能發(fā)給同類郵箱(即相同smtp的郵箱),甚至有時(shí)同類郵箱也發(fā)不出去.以上兩種方式我試過很多次,結(jié)果證明第一種方式是最可靠的.


好了,我相信你應(yīng)該會(huì)寫最簡(jiǎn)單的Email發(fā)送程序了.OK,下一次我們將說說怎樣寫發(fā)送HTML格式的郵件.

 

5.發(fā)送HTML格式的郵件

所謂HTML格式,就是超文本格式.你的郵件可以用HTML代碼編寫,發(fā)給對(duì)方后,對(duì)方收到的將是信息將是超文本,超文本比純文本好看多了.下以面是在以前例子的基礎(chǔ)上修改的程序:

< %@ page contentType="text/html;charset=GB2312" % >
< %request.setCharacterEncoding("gb2312");% >
< %@ page import="java.util.*,javax.mail.*"% >
< %@ page import="javax.mail.internet.*"% >
< html >
< head >
< meta http-equiv="Content-Type" content="text/html; charset=gb2312" >
< title > 發(fā)送成功 < /title >
< /head >

< body >
< %
try{
String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String tcontent=request.getParameter("content");
Properties props=new Properties();
props.put("mail.smtp.host","127.0.0.1");
props.put("mail.smtp.auth","true");
Session s=Session.getInstance(props);
s.setDebug(true);

MimeMessage message=new MimeMessage(s);

//給消息對(duì)象設(shè)置發(fā)件人/收件人/主題/發(fā)信時(shí)間
InternetAddress from=new InternetAddress("xxf@cafe.com");
message.setFrom(from);
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);
message.setSubject(ttitle);
message.setSentDate(new Date());


//給消息對(duì)象設(shè)置內(nèi)容
BodyPart mdp=new MimeBodyPart();//新建一個(gè)存放信件內(nèi)容的BodyPart對(duì)象
mdp.setContent(tcontent,"text/html;charset=gb2312");//給BodyPart對(duì)象設(shè)置內(nèi)容和格式/編碼方式
Multipart mm=new MimeMultipart();//新建一個(gè)MimeMultipart對(duì)象用來存放BodyPart對(duì)
//象(事實(shí)上可以存放多個(gè))
mm.addBodyPart(mdp);//將BodyPart加入到MimeMultipart對(duì)象中(可以加入多個(gè)BodyPart)
message.setContent(mm);//把mm作為消息對(duì)象的內(nèi)容

message.saveChanges();
Transport transport=s.getTransport("smtp");
transport.connect("127.0.0.1","xxf","coffee");
transport.sendMessage(message,message.getAllRecipients());
transport.close();
% >
< div align="center" >
< p >< font color="#FF6600" > 發(fā)送成功! < /font >< /p >
< p >< a href="recmail.jsp" > 去看看我的信箱 < /a >< br >
< br >
< a href="index.htm" > 再發(fā)一封 < /a > < /p >
< /div >
< %
}catch(MessagingException e){
out.println(e.toString());
}
% >
< /body >
< /html >

注:撰寫郵件的html文件仍然和前面(請(qǐng)參考jsp和Java Mail(三))那個(gè)一樣,不需要作任何修改.

怎么樣,這個(gè)程序是不是很簡(jiǎn)單呢?如果還有什么不懂的話,請(qǐng)?jiān)谙旅媪粞?下一次我們將要講一講怎樣發(fā)送附件.

 

七.編寫靈活的發(fā)送程序

本小節(jié)沒加什么新鮮的東西,但是綜合了以前的所有內(nèi)容,可以讓你靈活地發(fā)送你想要發(fā)的郵件.看了本小節(jié)之后對(duì)你會(huì)感覺到非常有用.

更改后的撰寫界面程序如下:
-------------------------------------------------------------------------------------------
< html >
< head >
< meta http-equiv="Content-Type" content="text/html; charset=gb2312" >
< title > 撰寫郵件 < /title >
< /head >
< body >
< form action="testall.jsp" method="post" name="form1" >
< table width="75" border="0" align="center" cellspacing="1" bgcolor="#006600" class="black" >
< tr bgcolor="#FFFFFF" >
< td width="24%" > 收信人地址: < /td >
< td width="76%" > < input name="to" type="text" id="to" >< /td >
< /tr >
< tr bgcolor="#FFFFFF" >
< td > 主題: < /td >
< td > < input name="title" type="text" id="title" >< /td >
< /tr >
< tr >
< td height="18" colspan="2" bgcolor="#FFFFFF" > 信件類型
< select name="emailtype" id="emailtype" >
< option value="text/plain" selected > Text < /option >
< option value="text/html" > Html < /option >
< /select >< /td >
< /tr >
< tr >
< td height="53" colspan="2" bgcolor="#FFFFFF" >< textarea name="content" cols="50" rows="5" id="content" >< /textarea >< /td >
< /tr >
< tr align="center" >
< td colspan="2" bgcolor="#FFFFFF" > 附件1(自定義):
< input name="fj1" type="text" id="fj1" >
(輸入文本信息) < /td >
< /tr >
< tr align="center" valign="bottom" >
< td colspan="2" bgcolor="#FFFFFF" > 附件2(本地):
< input name="fj2" type="file" id="fj2" size="10" >< /td >
< /tr >
< tr align="center" >
< td colspan="2" bgcolor="#FFFFFF" > 附件3(遠(yuǎn)程):
< input name="fj3" type="text" id="fj3" value="http://" >
(輸入U(xiǎn)RL) < /td >
< /tr >
< tr align="center" >
< td colspan="2" bgcolor="#FFFFFF" > < input type="submit" name="Submit" value="發(fā)送" >
< input type="reset" name="Submit2" value="重置" >< /td >
< /tr >
< /table >
< /form >
< /body >
< /html >


處理郵件的JSP程序如下:
----------------------------------------------------------------------------------------
< %@ page contentType="text/html;charset=GB2312" % >
< %request.setCharacterEncoding("gb2312");% >
< %@ page import="java.util.*,javax.mail.*"% >
< %@ page import="javax.mail.internet.*"% >
< %@ page import="javax.activation.*"% >< !--要發(fā)送附件必須引入該庫-- >
< %@ page import="java.net.*"% >< !--要用到URL類-- >
< html >
< head >
< meta http-equiv="Content-Type" content="text/html; charset=gb2312" >
< title > 發(fā)送成功 < /title >
< /head >
< body >
< %
try{
String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String emailtype=request.getParameter("emailtype");//獲取email類型
String tcontent=request.getParameter("content");
String tfj1=request.getParameter("fj1");
String tfj2=request.getParameter("fj2");
String tfj3=request.getParameter("fj3");

Properties props=new Properties();
props.put("mail.smtp.host","127.0.0.1");
props.put("mail.smtp.auth","true");
Session s=Session.getInstance(props);
s.setDebug(true);

MimeMessage message=new MimeMessage(s);

//給消息對(duì)象設(shè)置發(fā)件人/收件人/主題/發(fā)信時(shí)間
InternetAddress from=new InternetAddress("xxf@cafe.com");
message.setFrom(from);
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);
message.setSubject(ttitle);
message.setSentDate(new Date());

Multipart mm=new MimeMultipart();//新建一個(gè)MimeMultipart對(duì)象用來存放多個(gè)BodyPart對(duì)象

//設(shè)置信件文本內(nèi)容
BodyPart mdp=new MimeBodyPart();//新建一個(gè)存放信件內(nèi)容的BodyPart對(duì)象
mdp.setContent(tcontent,emailtype+";charset=gb2312");//給BodyPart對(duì)象設(shè)置內(nèi)容和格式/編碼方式
mm.addBodyPart(mdp);//將含有信件內(nèi)容的BodyPart加入到MimeMultipart對(duì)象中

//設(shè)置信件的附件1(自定義附件:直接將所設(shè)文本內(nèi)容加到自定義文件中作為附件發(fā)送)
mdp=new MimeBodyPart();//新建一個(gè)存放附件的BodyPart
DataHandler dh=new DataHandler(tfj1,"text/plain;charset=gb2312");
//新建一個(gè)DataHandler對(duì)象,并設(shè)置其內(nèi)容和格式/編碼方式
mdp.setFileName("text.txt");//加上這句將作為附件發(fā)送,否則將作為信件的文本內(nèi)容
mdp.setDataHandler(dh);//給BodyPart對(duì)象設(shè)置內(nèi)容為dh
mm.addBodyPart(mdp);//將含有附件的BodyPart加入到MimeMultipart對(duì)象中

//設(shè)置信件的附件2(用本地上的文件作為附件)
mdp=new MimeBodyPart();
FileDataSource fds=new FileDataSource(tfj2);
dh=new DataHandler(fds);
int ddd=tfj2.lastIndexOf("\\");
String fname=tfj2.substring(ddd);//提取文件名
String ffname=new String(fname.getBytes("gb2312"),"ISO8859-1");//處理文件名是中文的情況
mdp.setFileName(ffname);//可以和原文件名不一致,但最好一樣
mdp.setDataHandler(dh);
mm.addBodyPart(mdp);

//設(shè)置信件的附件3(用遠(yuǎn)程文件作為附件)
mdp=new MimeBodyPart();


URL urlfj=new URL(tfj3);
URLDataSource ur=new URLDataSource(urlfj);
//注:這里用的參數(shù)只能為URL對(duì)象,不能為URL字串,在前面類介紹時(shí)有誤(請(qǐng)諒解),這里糾正一下.
dh=new DataHandler(ur);
int ttt=tfj3.lastIndexOf("/");
String urlname=tfj3.substring(ttt);
//String urlfname=new String(urlname.getBytes("gb2312"),"ISO8859-1");//不知怎么回事,這里不能處理中文問題
mdp.setFileName(urlname);
mdp.setDataHandler(dh);
mm.addBodyPart(mdp);

message.setContent(mm);//把mm作為消息對(duì)象的內(nèi)容

message.saveChanges();
Transport transport=s.getTransport("smtp");
transport.connect("127.0.0.1","xxf","coffee");
transport.sendMessage(message,message.getAllRecipients());
transport.close();
% >
< div align="center" >
< p >< font color="#FF6600" > 發(fā)送成功! < /font >< /p >
< p >< a href="recmail.jsp" > 去看看我的信箱 < /a >< br >
< br >
< a href="index.htm" > 再發(fā)一封 < /a > < /p >
< /div >
< %
}catch(MessagingException e){
out.println(e.toString());
}
% >
< /body >
< /html >

到目前為止,我們基本上已學(xué)會(huì)了發(fā)各種類型的郵件了.