邵波的空間 的 Javamail操作指南
怎樣才算比較完整的Javamail操作指南？我想應(yīng)該包括絕大多數(shù)基本的email操作，能夠應(yīng)付一般的應(yīng)用。在本指南中打算囊括以下內(nèi)容：
● 發(fā)送email：包括文本郵件、HTML郵件、帶附件的郵件、SMTP驗(yàn)證
● 接收email：pop3遠(yuǎn)程連接、收取不同MIME的郵件、處理附件
我想有了上述功能的介紹，應(yīng)該可以應(yīng)付很多email的相關(guān)應(yīng)用了。所以請(qǐng)?jiān)试S我給本文擬了一個(gè)比較狂妄的名字，這樣才能保證收視率，。還是那句話，寫這個(gè)post的原因就是沒(méi)有在網(wǎng)上看到更全面的，你看過(guò)的話記得要告訴我。
下面的所有例子都經(jīng)過(guò)實(shí)際測(cè)試，你可以說(shuō)它寫得不夠OO，不夠plugable，但是它的確是可以參考的。自從有了javamail，發(fā)垃圾郵件就方便多了。本文代碼多說(shuō)明少，這倒不是我偷懶，而是很多東西都涉及pop3等協(xié)議的規(guī)范，如果不了解這些規(guī)范的話，由的東西我實(shí)在不知道怎么跟你解釋；如果了解的話，那我基本上就不用再解釋。所以本著實(shí)用的原則就省略了，由興趣的話自己去翻翻協(xié)議規(guī)范。
廢話少說(shuō)，首先需要配置環(huán)境。需要的包是mail.jar和activation.jar。高版本的J2SDK EE自帶。地址嘛，再java.sun.com上搜索一下，很容易找到。放到classpath中就KO。
一、 郵件的發(fā)送
下面了弄個(gè)發(fā)郵件的Hello World，熱熱身：
/*************
Name:TextMailSender.java
Author:Bromon
Version:1.0
Date:2004-4-26
Note:發(fā)送email到bromon@163.com,需要安裝SMTP服務(wù)器
*************/
package org.bromon.mail;
import javax.mail.*;
import javax.mail.internet.*;
import java.util.*;
public class TextMailSender
{
public static void main(String args[])
{
try
{
Properties prop=new Properties();
//指定要使用的SMTP服務(wù)器為bromon2k
prop.put("mail.smtp.host","bromon2k");
Session mailSession=Session.getDefaultInstance(prop);
//發(fā)件人地址
InternetAddress from=new InternetAddress("bromon@bromon2k");
//收件人地址
InternetAddress to=new InternetAddress("bromon@163.com");
MimeMessage msg=new MimeMessage(mailSession);
msg.setFrom(from);
msg.addRecipient(javax.mail.Message.RecipientType.TO,to);
//發(fā)信日期
msg.setSentDate(new java.util.Date());
//title
msg.setSubject("你好");
//郵件正文
msg.setText("hello,bromon");
Transport.send(msg);
}catch(Exception e)
{
System.out.println(e);
}
}
}
程序很簡(jiǎn)單，但是它是不能運(yùn)行的（倒）。除非你的機(jī)器上安裝了一個(gè)SMTP服務(wù)器，而且你的機(jī)器還叫做bromon2k。寫這么一段不能執(zhí)行的程序不是為了找打，而是讓各位對(duì)javamail有個(gè)基本印象，我就懶得改了。下面演示的是如何通過(guò)163、sohu等email服務(wù)商提供的免費(fèi)郵箱來(lái)發(fā)郵件，基本操作和上面的一樣，只是多一個(gè)SMTP驗(yàn)證而已：
/*
* Created on 2004-4-26
*/
package org.bromon.mail;
import javax.mail.*;
import java.util.*;
import javax.mail.internet.*;
/**
* @author Bromon
*/
public class SenderWithSMTPVer
{
String host="";
String user="";
String password="";
public void setHost(String host)
{
this.host=host;
}
public void setAccount(String user,String password)
{
this.user=user;
this.password=password;
}
public void send(String from,String to,String subject,String content)
{
Properties props = new Properties();
props.put("mail.smtp.host", host);//指定SMTP服務(wù)器
props.put("mail.smtp.auth", "true");//指定是否需要SMTP驗(yàn)證
try
{
Session mailSession = Session.getDefaultInstance(props);
mailSession.setDebug(true);//是否在控制臺(tái)顯示debug信息
Message message=new MimeMessage(mailSession);
message.setFrom(new InternetAddress(from));//發(fā)件人
message.addRecipient(Message.RecipientType.TO,new InternetAddress(to));//收件人
message.setSubject(subject);//郵件主題
message.setText(content);//郵件內(nèi)容
message.saveChanges();
Transport transport = mailSession.getTransport("smtp");
transport.connect(host, user, password);
transport.sendMessage(message, message.getAllRecipients());
transport.close();
}catch(Exception e)
{
System.out.println(e);
}
}
public static void main(String args[])
{
SenderWithSMTPVer sm=new SenderWithSMTPVer();
sm.setHost("smtp.163.com");//指定要使用的郵件服務(wù)器
sm.setAccount("abc","123");//指定帳號(hào)和密碼
/*
* @param String 發(fā)件人的地址
* @param String 收件人地址
* @param String 郵件標(biāo)題
* @param String 郵件正文
*/
sm.send("abc@163.com","bromon@163.com","標(biāo)題","內(nèi)容");
}
}
這段程序好像也不需要解釋了吧，把SMTP地址、帳號(hào)、密碼等配置信息寫到Properties里面，Java里面很多API都需要這么干，比如再程序中加入對(duì)代理服務(wù)器的支持等。
上面的程序修改一下服務(wù)器地址、帳號(hào)、密碼就可以使用，非常簡(jiǎn)單。
如何發(fā)送一個(gè)HTML格式的Email呢？也很簡(jiǎn)單，再郵件正文中寫入HTML代碼，然后指定郵件的ContentType就OK，下面只給出關(guān)鍵代碼：
………..
MimeMessage msg=new MimeMessage(mailSession);
msg.setContent(content,"text/html");
msg.setText(“<html><body><h1>下面的，你們好嗎?</body></html>”);
………..
下面是發(fā)送帶有附件的email，稍微復(fù)雜一點(diǎn)，而且和前面的程序有一些不同，請(qǐng)仔細(xì)一點(diǎn)，同時(shí)需要一點(diǎn)IO的知識(shí)。相同的代碼就不在列出，只寫關(guān)鍵部分，誰(shuí)都想偷懶不是？
import javax.mail.*;
import javax.mail.internet.*;
import javax.activation.*;
import java.util.*;
……….
MimeMessage msg=new MimeMessage(mailSession);
msg.setSentDate(new Date());
msg.setSubject("hello");
MimeBodyPart textBodyPart=new MimeBodyPart();
textBodyPart.setText(“郵件正文”);
MimeBodyPart fileBodyPart=new MimeBodyPart();
FileDataSource fds=new FileDataSource("GIS.rar");//要發(fā)送的附件
fileBodyPart.setDataHandler(new DataHandler(fds));
fileBodyPart.setFileName(fds.getName());
Multipart container=new MimeMultipart();
container.addBodyPart(textBodyPart);
container.addBodyPart(fileBodyPart);
msg.setContent(container);
Transport.send(msg);
…………
這里的msg由兩個(gè)MimeBodyPart構(gòu)成，這個(gè)東西解釋起來(lái)基本上比較難，如果不了解相關(guān)的規(guī)范就不太好解釋，如果了解的話，我就不用解釋了，這個(gè)這個(gè)………唉。
二、 郵件的收取
通常情況下我們都使用pop3協(xié)議來(lái)收郵件，IMAP嘛現(xiàn)在就不涉及了。收郵件的功能雖然我用了很多時(shí)間才基本搞清楚，不過(guò)講起來(lái)就so easy了，一個(gè)程序就可以基本包括。
郵件大致可以分三種：純文本郵件、含有其他數(shù)據(jù)的文本郵件、含有附件的郵件。
CODE
/*
* Created on 2004-4-26
*/
package org.bromon.mail;
import javax.mail.*;
import java.util.*;
import java.io.*;
/**
* @author Bromon
*/
public class Receiver
{
Folder inbox;
Store store;
//連接郵件服務(wù)器，獲得所有郵件的列表
public Message[] getMail(String host,String name,String password) throws Exception
{
Properties prop=new Properties();
prop.put("mail.pop3.host",host);
Session session=Session.getDefaultInstance(prop);
store=session.getStore("pop3");
store.connect(host,name,password);
inbox=store.getDefaultFolder().getFolder("INBOX");
inbox.open(Folder.READ_ONLY);
Message[] msg=inbox.getMessages();
FetchProfile profile=new FetchProfile();
profile.add(FetchProfile.Item.ENVELOPE);
inbox.fetch(msg,profile);
return(msg);
}
//處理任何一種郵件都需要的方法
private void handle(Message msg) throws Exception
{
System.out.println("郵件主題:"+msg.getSubject());
System.out.println("郵件作者:"+msg.getFrom()[0].toString());
System.out.println("發(fā)送日期:"+msg.getSentDate());
}
//處理文本郵件
public void handleText(Message msg) throws Exception
{
this.handle(msg);
System.out.println("郵件內(nèi)容:"+msg.getContent());
}
//處理Multipart郵件，包括了保存附件的功能
public void handleMultipart(Message msg) throws Exception
{
String disposition;
BodyPart part;
Multipart mp=(Multipart)msg.getContent();
int mpCount=mp.getCount();//Miltipart的數(shù)量,用于除了多個(gè)part,比如多個(gè)附件
for(int m=0;m<mpCount;m++)
{
this.handle(msg);
part=mp.getBodyPart(m);
disposition=part.getDisposition();
if(disposition!=null && disposition.equals(Part.ATTACHMENT))//判斷是否有附件
{
//this.saveAttach(part);//這個(gè)方法負(fù)責(zé)保存附件，注釋掉是因?yàn)楦郊赡苡胁《荆?qǐng)清理信箱之后再取掉注釋
}else{
System.out.println(part.getContent());
}
}
}
private void saveAttach(BodyPart part) throws Exception
{
String temp=part.getFileName();//得到未經(jīng)處理的附件名字
String s=temp.substring(11,temp.indexOf("?=")-1);//去到header和footer
//文件名一般都經(jīng)過(guò)了base64編碼,下面是解碼
String fileName=this.base64Decoder(s);
System.out.println("有附件:"+fileName);
InputStream in=part.getInputStream();
FileOutputStream writer=new FileOutputStream(new File(fileName));
byte[] content=new byte[255];
int read=0;
while((read=in.read(content))!=-1)
{
writer.write(content);
}
writer.close();
in.close();
}
//base64解碼
private String base64Decoder(String s) throws Exception
{
sun.misc.BASE64Decoder decoder = new sun.misc.BASE64Decoder();
byte[] b=decoder.decodeBuffer(s);
return(new String(b));
}
//關(guān)閉連接
public void close() throws Exception
{
if(inbox!=null)
{
inbox.close(false);
}
if(store!=null)
{
store.close();
}
}
public static void main(String args[])
{
String host="pop.163.com";
String name="bromon";
String password="My password";
Receiver receiver=new Receiver();
try
{
Message[] msg=receiver.getMail(host,name,password);
for(int i=0;i<msg.length;i++)
{
if(msg[i].isMimeType("text/*"))//判斷郵件類型
{
receiver.handleText(msg[i]);
}else{
receiver.handleMultipart(msg[i]);
}
System.out.println("****************************");
}
receiver.close();
}catch(Exception e)
{
System.out.println(e);
}
}
}
沒(méi)有習(xí)慣讀java代碼的兄弟可能會(huì)覺(jué)得麻煩了一點(diǎn)，其中有個(gè)小問(wèn)題，下載的附件會(huì)再文件名后面加上一個(gè)”#”符號(hào)，不知道這是javamail的特別處理還是pop3的規(guī)范。通過(guò)程序更改文件名很簡(jiǎn)單，就不說(shuō)了。對(duì)于email還有很多其他的操作，可以自己取查看一下javadoc，我就不影響大家探索的樂(lè)趣了。在Properties里配置代理服務(wù)器，可以讓程序通過(guò)代理收發(fā)郵件，一般的HTTP、socks 4、socks 5都支持。