一、JavaMail API简介
JavaMail API是 读取、撰写、发送电子信息 的可选包。

可用它来建立如Eudora、Foxmail、MS Outlook Express一般的邮件用户代理程序(Mail User Agent,简称MUA,而非邮件传输代理MTA)。


从另外一个角度来看,我们这些电子邮件用户日常用MUA程序来读写邮件,而MUA依赖着MTA处理邮件的递送。


二、相关协议一览
不依赖于协议的方式发送接收电子信息,只依赖特定协议SMTP、POP、IMAP、MIME、NNTP协议。



1.SMTP(递送邮件机制 )


简单邮件传输协议


SMTP服务器将邮件转发到接收者的SMTP服务器,直至最后被接收者通过POP或者IMAP协议获取。

2.POP(获取邮件机制)
邮局协议,目前为第3个版本POP3

3.IMAP(多目录共享)
接收信息的高级协议,目前版本为第4版IMAP4


接收新信息,将这些信息递送给用户,维护每个用户的多个目录。

4.MIME
邮件扩展内容格式:信息格式、附件格式等等

5.NNTP


第三方新闻组协议

三、安装
1.安装JavaMail
http://java.sun.com/products/javamail/downloads/index.html下载JavaMail


mail.jar文件添加到CLASSPATH中

2.安装JavaBeans Activation Framework
http://java.sun.com/products/javabeans/glasgow/jaf.html下载JavaBeans Activation Framework


activation.jar文件添加到CLASSPATH中



四、初次认识JavaMail API
1.了解我们的JavaMail环境
A.纵览JavaMail核心类结构
JavaMail.jar文件的一些核心类: Session、Message、Address、Authenticator、Transport、Store、Folder


以及javax.mail.internet包中还有一些常用的子类。



B.Session(邮件会话)
进行收发邮件的工作都是基于这个会话的。


Session对象利用了java.util.Properties对象获得了邮件服务器、用户名、密码信息和整个应用程序都要使用到的共享信息


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

或者


Properties props = new Properties();
Session session = Session.getInstance(props, null);

从上面的两个例子中不难发现,第二个参数都是null,这是因为在上面的例子中并没有使用到

邮件授权(参考E)



C.Message


建立了Session对象后,便可以被发送的构造信息体Message抽象类

使用javax.mail.internet.MimeMessage这个子类,该类是使用MIME类型、MIME信息头的邮箱信息。


信息头只能使用US-ASCII字符


Message message = new MimeMessage(session);
message.setContent("Hello", "text/plain");//非文本信息内容
message.setText("Hello");//纯文本信息内容
message.setSubject("First");//设置邮件主题
message.setSentDate(Date);//设置邮件发送日期

D.Address
建立了Session和Message对象后,使用邮件地址Address抽象类


使用javax.mail.internet.InternetAddress这个子类。通过传入邮件地址的字符串


Address address = new InternetAddress("kuangye89757@163.com"); //邮件地址
Address address = new InternetAddress("president@whitehouse.gov", "George Bush"); //带名字的邮件

地址 
 
message.setFrom(address);//设置发信人 
message.setReplyTo(address);//同上
 
message.addFrom(Address[] address);//添加多个发信人
 

 
message.addRecipient(type, address)//设置收信人 
 
Message.RecipientType.TO//收信人
Message.RecipientType.CC//抄送人
 Message.RecipientType.BCC//暗送人 
 

E.Authenticator授权者类 
 
使用Authenticator抽象类必须实现getPasswordAuthentication()方法(用于存储认证时要用到的用户名、密码)。 
并且要在Session中进行注册,使Session能够了解在认证时该使用哪个类。
 
Properties props = new Properties();
 
Authenticator auth = new MyAuthenticator();
 
Session session = Session.getDefaultInstance(props, auth);
 
/**
 
 
 * 自定义邮件授权类
 
 
 * @return
 
 
 * @throws IOException
 
 
 */
 
public class  
 MyAuthenticator   
 extends Authenticator {
 
  public PasswordAuthentication getPasswordAuthentication(String param) {
 
String username;
 
String password;
 
StringTokenizer st = new StringTokenizer(param, ",");
 
username = st.nextToken();
 
password = st.nextToken();
 
return new PasswordAuthentication(username, password);
 
}
 
}
 
 
 

F.Transport 
 
发送信息时使用Transport抽象类(实现了SMTP) 
Transport.send( 
 MimeMessage  
 message);
 
 
 
 
或者一般用法
 当然,方法是多样的。我们也可由Session获得相应协议对应的Transport实例。并通过传递用户名、密码、邮件服务器主机名等参数建立与邮件服务器的连接,并使用sendMessage()方法将信息发送,最后关闭连接: 
session.setDebug(true);//监控邮件发送过程
 
message.saveChanges(); //保存文件
 
Transport transport = session.getTransport("smtp");//获取实现了SMTP协议的Transport类
 
transport.connect(host, username, password);//连接服务器
 
transport.sendMessage(message, message.getAllRecipients());//发送邮件给所有收件人
 
transport.close();//关闭连接
 

 
G.Store(存储邮件的服务器 
 )和Folder(目录对象 
 )
 
Store store = session.getStore("pop3");
 
store.connect(host, username, password);
 

 
Folder folder = store.getFolder("INBOX");// 
 POP3协议只有一个名为INBOX的Folder有效
 
folder.open(Folder.READ_ONLY);//只读方式打开
 
Message message[] = folder.getMessages();//获得邮件
 
System.out.println(((MimeMessage)message).getContent());// 
 邮件内容(不包含邮件头)
 
System.out.println((( 
 MimeMessage 
 )message).writeTo());// 
 邮件内容(含邮件头)
 
folder.close(true);//若删除邮件则及时更新Folder,关闭
 
store.close();//关闭 
 
 
 

五、使用JavaMail API 
 
1.发送邮件 
 
在获得了Session后,建立并填入邮件信息,在发送邮件之前,我们需要设置SMTP服务器:通过设置Properties的mail.smtp.host属性 

 
mail配置文件.properties
 
String server=xx.xx.xx.xx(服务器)
 
authUser=XXX
 
authPasswd=xxxxxx
 
/**
 
 * 获得配置文件信息
 
 * @return
 
 * @throws IOException
 
 */
 
 private static Properties getProp() throws IOException{
 
 
 
 
 mail配置文件.properties 
 ");
 
 
 
 
 }
 

 
private String from = ...;//发件人
 
private  
 String to = ...;//收件人
 
//获取邮件发送服务器及验证用户名和密码
 
 
Properties  
  props 
  =getProp();
 
 
props.put("mail.smtp.host", host);
 
 
//获取Session会话
 
 
Session session = Session.getDefaultInstance(props, null);
 
 
//创建MIMEMessage
 
 
Message message = new MimeMessage(session);
 
 
message.setFrom(new InternetAddress(from));
 
 
message.addRecipient(Message.RecipientType.TO,  
  new InternetAddress( 
  to 
  ));
 
 
message.setSubject("Hello JavaMail");
 
 
message.setText("Welcome to JavaMail");
 
 
//发送邮件
 
 
message.saveChanges();
 
  
Transport transport = session.getTransport("smtp");
 
  
transport.connect( 
   props.getProperty(“ 
   server 
   ”), props.getProperty(“ 
   authUser 
   ”), props.getProperty(“ 
   authPasswd 
   ”));
 
  
transport.sendMessage(message, message.getAllRecipients());
 
  
transport.close();
 
 
2.接收邮件 
Session session = Session.getDefaultInstance(props, null);
 
Store store = session.getStore("pop3");
 
store.connect( 
 props.getProperty(“ 
 server 
 ”) 
 ,  
 props.getProperty(“ 
 authUser 
 ”),  
 props.getProperty(“ 
 authPasswd 
 ”) 
 );
 
Folder folder = store.getFolder("INBOX");
 
folder.open(Folder.READ_ONLY);
 
Message message[] = folder.getMessages();
 
for (int i=0, n=message.length; i<n; i++) {
 
   System.out.println(i + ": " + message[i].getFrom()[0] + " " + message[i].getSubject());
 
}
 
folder.close(false);
 
store.close();
 
 
 
 
3.删除邮件和标志 
 
Flags类的内部类Flag中预定义了一些标志:(POP协议不支持) 
如:Flags.Flag.DELETED   
 通过访问一个已经打开的Folder对象的getPermanetFlags()方法,它将返回当前被支持的Flags类对象。
 删除邮件时,我们可以设置邮件的DELETED标志: 
if(Message.isSet(Flags.Flag. 
 DELETED 
 )){
 
folder.open(Folder.READ_WRITE);
 
message.setFlag(Flags.Flag.DELETED, true);//删除邮件
 
folder.close(true);
 
}
 

 
4.回复邮件
 
MimeMessage reply = (MimeMessage)message.reply(false);//不发送给发件人
 
reply.setFrom(new InternetAddress("president@whitehouse.gov"));
 
reply.setText("Thanks");
 
Transport.send(reply);//回复邮件 
 
 
 

6.转发邮件 
 
转发邮件的过程不如前面的回复邮件那样简单,它将建立一个转发邮件,这并非一个方法就能做到。
 每个邮件是由多个部分(邮件体MimeBodyPart类对象)组成 
这些邮件体包含MimeMultiPart类对象
 
复制一个邮件内容到另一个邮件的方法是复制它的DataHandler(数据处理者)
 
 
 
 
Message forward = new MimeMessage(session);
 
forward.setSubject("Fwd: " + message.getSubject());
 
forward.setFrom(new InternetAddress(from));
 
forward.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
 
forward.setContent(multipart);//这里的多媒体对象通过下列方式获得
 
Transport.send(forward);//转发邮件
 

 
//创建邮件体对象
 
BodyPart messageBodyPart = new MimeBodyPart();
 
messageBodyPart 
 .setContent(“内容”,"text/plain;charset=GB2312");
 
messageBodyPart.setDataHandler(message.getDataHandler());//从邮件中获取DataHandler
 

 
//创建多媒体对象
 
Multipart multipart = new MimeMultipart();
 
multipart.addBodyPart(messageBodyPart);

7.使用附件


A.发送带有附件的邮件

建立一个完整邮件的各个邮件体部分:


第一个部分:邮件内容文字


DataHandler的附件


1.若 文件作为附件发送 建立FileDataSource类型的 附件数据源 对象


2.若 URL作为附件发送 建立 URLDataSource 类型的 附件数据源 对象


Message message = new MimeMessage(session);


message.setFrom(new InternetAddress(from));


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


message.setSubject("Hello JavaMail Attachment");



//第一部分(内容)
 
BodyPart messageBodyPart1 = new MimeBodyPart();
 
messageBodyPart1.setText("Pardon Ideas");
 
 
 
 

 
//第二部分(文件附件)
 
BodyPart  m 
 essageBodyPart2 = new MimeBodyPart();
 
DataSource source = new FileDataSource(filename);
 
messageBodyPart2.setDataHandler(new DataHandler(source));
 
messageBodyPart2.setFileName(filename);
 
 
 
 
 
 Multipart  
 multipart = new  
 MimeMultipart 
 ();
 
multipart.addBodyPart(messageBodyPart1); 
 //装填第一部分
 
multipart.addBodyPart(messageBodyPart2);//装填第二部分
 
message.setContent(multipart);
 
Transport.send(message);//发送带有附件的文件
 
 
 
使用servlet实现发送带有附件的邮件注意提交页面form中对编码类型的设置应为multipart/form-data 
<form enctype="multipart/form-data"  method=post action="/myservlet"> 
 
 <input type="file" NAME="thefile">
 
input type="submit" VALUE="Upload">
 
</form> 
 
 
 

B.读取邮件中的附件 
 
读取邮件中带有附件的邮件是多部分组成的,我们必须处理每一个部分获得邮件的内容和附件 
 
BodyPart类提供了getDisposition()方法获得邮件体的部署类型 
该部分是附件时返回Part.ATTACHMENT或Part.INLINE
 
 
 
 
//获取邮件中的多媒体
 
Multipart mp = (Multipart)message.getContent();
 
//循环遍历多媒体,并获取邮件体各部分
 
for (int i=0, n=multipart.getCount(); i<n; i++) {
 
Part part = multipart.getBodyPart(i));
 
//获得邮件体的部署类型
 
String disposition = part.getDisposition();
 
if ((disposition != null) && ((disposition.equals(Part.ATTACHMENT) || (disposition.equals(Part.INLINE))) {
 
saveFile(part.getFileName(), part.getInputStream());
 
}else if (disposition == null) {
 
MimeBodyPart mbp = (MimeBodyPart)part;
 
if (mbp.isMimeType("text/plain")) {
 
//解析过程
 
} else {
 
//其他解析过程
 
}
 
}
 
}
 

 
8.处理HTML邮件
 
A.发送HTML邮件
 
设置邮件内容为html代码,并设置内容类型为text/html即可:
 
String htmlText = "<H1>Hello</H1>" +  "<img src="http://www.jguru.com/images/logo.gif">";
 
message.setContent(htmlText, "text/html")); 
 
 
 
请注意:
 在接收邮件时,因为JavaMail API邮件内容视为二进制流。必须使用JEditorPane 
 
if (message.getContentType().equals("text/html")) { 
String content = (String)message.getContent();
 
JFrame frame = new JFrame();
 
JEditorPane text = new JEditorPane("text/html", content);
 
text.setEditable(false);
 
JScrollPane pane = new JScrollPane(text);
 
frame.getContentPane().add(pane);
 
frame.setSize(300, 300);
 
frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
 
frame.show();
 
} 
 
 
 
B.在邮件中包含图片 
 
将HTML中用到的图片作为邮件附件并使用特殊的cid URL作为图片的引用(Content-ID头的引用) 
通过设置图片附件邮件体部分的header中Content-ID为一个随机字符串,
 
并在HTML中img的src标记中设置为该字符串来完成了图片附件与HTML的关联。
 

 
String file = ...;
 
Message message = new MimeMessage(session);
 
message.setSubject("Embedded Image");
 
message.setFrom(new InternetAddress(from));
 
message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
 

 
// 创建邮件体HTML部分
 
BodyPart messageBodyPart1 = new MimeBodyPart();
 
String htmlText = "<H1>Hello</H1>" +  
   "<img src="cid:memememe">";
 
messageBodyPart1.setContent(htmlText, "text/html");
 

 
//创建邮件体img部分
 
BodyPart  messageBodyPart2 = new MimeBodyPart();
 
DataSource fds = new FileDataSource(file);
 
messageBodyPart2.setDataHandler(new DataHandler(fds));
 
messageBodyPart2.setHeader("Content-ID","<memememe>"); 
 
 
 
// 创建一个关联的多媒体
  
  
MimeMultipart multipart = new MimeMultipart("related");
  
  
multipart.addBodyPart(messageBodyPart1);
  
  
multipart.addBodyPart(messageBodyPart2);
  
  
message.setContent(multipart);
 
 9.在邮件中搜索短语 
 
 JavaMail API提供了过滤器机制,它被用来建立搜索短语。 
 
SearchTerm抽象类来定义,在定义后我们便可以使用Folder的 
 Search()方法查找邮件: 

 
下面有 
 22个不同的类(继承了SearchTerm类) 
 供我们使用:
 

  AND terms 、OR terms 、NOT terms 、SENT DATE terms、CONTENT terms 、HEADER terms  
 
实例:在Folder中搜索邮件主题含有“ADV”字符串或者发信人地址为friend@public.com的邮件。 
SearchTerm st =  
   new OrTerm( 
 new SubjectTerm("ADV:"),  
 new FromStringTerm("friend@public.com"));
 
Message[] msgs = folder.search(st);