JavaMail类介绍

JavaMail的三个主要类：
1、Session类
Session 类表示了一个基本的邮件会话过程，它提供了一个邮件的生存过程。Session对象需要java.util.Properties对象对其配置邮件环境属性，它利用Properties对象来获取诸如邮件服务器、用户名、密码等信息，以及其他可在整个应用程序中共享的信息。


2、Message类
在创建了一个邮件会话Session后，再用Message类提供了一封邮件的所有信息。它是一个抽象类，必须由其子类来构造。
MimeMessage message=new MimeMessage(sendsession);
//MimeMessage是Message的子类，可以使用当前的Session对象创建一个新的MimeMessage对象，然后就可以对其进行各种操作。
message.setSubject("This is subject of the e-mail");
//设置邮件的标题
message.setText("Hello,I am a e-mail");
//设置纯文本邮件的内容
InternetAddress sender=new InternetAddress("[email protected]");
//InternetAddress类通过一个合法的e-mail构造出e-mail地址对象
message.setForm(sender);
//设置邮件的发送方地址
InternetAddress receiver=new InternetAddress("[email protected]");
message.addRecipient(receiver,RecipientType.TO);
//设置接收方地址
设置接收方地址使用addRecipient方法，地址类型有三种：
RecipientType.TO:e-mail的发送地址；
RecipientType.CC:抄送地址，可以为多个；
RecipientType.BCC:暗送地址，可以为多个。

3、Transport类
邮件发送类。
邮件发送方法：send(message);

e.g
Properties props=new Properties();
Session sendsession = Session.getInstance(props, null);
//使用getInstance方法获取到这个信息
props.put("mail.smtp.host", "smtp.163.com");
//向属性中写入SMTP服务器的地址，为Session设置一个SMTP邮件服务器
props.put("mail.smtp.auth","true");
//用Properties对象的put方法设置了SMTP邮件服务器需要进行权限的认证；
sendsession.setDebug(true);
//用Session对象的setDebug方法设置输出发送邮件时的调试信息；可在Tomcat服务器上看到同SMTP邮件服务器交互过程中的输出信息。
MimeMessage message=new MimeMessage(sendsession);
//MimeMessage是Message的子类，可以使用当前的Session对象创建一个新的MimeMessage对象，然后就可以对其进行各种操作。
message.setFrom(new InternetAddress(request.getParameter("from")));
//设置发信人地址
message.setRecipient(Message.RecipientType.TO,new InternetAddress(request.getParameter("to")));
//设置收信人地址
message.setSubject(new String(request.getParameter("subject").getBytes("ISO8859_1"),"GBK"));
//设置e-mail标题
message.setSentDate(new Date());
//设置e-mail发送时间
message.setText(new String(request.getParameter("text").getBytes("ISO8859_1"),"GBK"));
//设置e-mail内容
message.saveChanges();
//保存对于Email的修改,用message对象的saveChanges方法将邮件信息保存起来；
Transport transport=sendsession.getTransport("smtp");
//由当前的session对象使用方法getTransport创建并初始化Transport对象
transport.connect("smtp.163.com","username","password");
//连接到SMTP服务器
transport.sendMessage(message,message.getAllRecipients());
//发送e-mail
transport.close();
//关闭Transport连接

发送带有附件的邮件：
1、BodyPart类
BodyPart类表示多部分的MIME信息中某一个部分的信息内容，它是一个抽象类，需要用其子类MimeBodyPart创建。
BodyPart messageBodyPart=new MimeBodyPart();
通常邮件的正文是一个BodyPart对象，附件则是另一个BodyPart对象。

2、MultiPart类
MultiPart类表示多部分的MIME信息的内容，它是一个抽象类，需要用其子类MimeMultipart来创建。还可以通过其方法addBodyPart()来创建。
Multipart multipart=new MimeMultipart();
将代表邮件正文的BodyPart对象和代表邮件附件的BodyPart对象分别加入到MimeMultipart对象中。

3、DataSource类
DataSource类表示本地文件和服务器可以直接访问的资源，它是一个抽象类，用其子类FileDataSource来创建。
FileDataSource fds=new FileDataSource("c:/test.doc");

4、DataHandler类
DataHandler为不同的数据源和数据格式提供提供了一个统一的接口。
messageBodyPart.setDataHandler(new DataHandler(fds));
附件被封装到一个DataHandler对象，BodyPart对象可以用方法setDataHandler将封装了附件的DataHandler对象加进来。

发送附件时的处理过程：
BodyPart messageBodyPart=new MimeBodyPart();
Multipart multipart=new MimeMultipart();
multipart.addBodyPart(messageBodyPart);
//在要发送附件时，先建立代表邮件正文的BodyPart对象，并把它加到Multipart对象中去
messageBodyPart=new MimeBodyPart();
//建立代表邮件附件部分的BodyPart对象
DataSource source=new FileDataSource(attachment);
messageBodyPart.setDataHandler(new DataHandler(source));
用setDataHandler方法将获取到的附件包含进来
messageBodyPart.setFileName(attachment);
//设置附件文件名
multipart.addBodyPart(messageBodyPart);
//将与附件相关的内容设置好之后，就可以把代表此附件部分的BodyPart对象加到Multipart对象中去了，最后将Multipart对象放到代表邮件信息的Message对象中，这样就可以发送带有附件的邮件了。


接收邮件：
1、URLName类
URLName类实际上是对于某台邮件服务器上某个用户的一次操作的唯一标识，它的格式为：
协议名称：//用户名：密码@邮件服务器/
URLName irln=new URLName("pop3://username:[email protected]/");

2、Store类
Store类是用于接收邮件的类，它对邮件进行读、写、监视、查找等操作。接收邮件时首先要连接到邮件服务器上的一个邮箱，这需要调用Session对象的getStore方法来创建一个Store对象。
Store store=session.getStore("pop3");
//这个方法要设置Store对象所使用的协议，通常为POP3；
store.connect("pop.163.com","username","password");
//在创建了Store对象之后，可以使用它的connect方法连接到远程邮件服务器中的邮箱。

3、Folder类
在连接到邮箱之后，就可以打开包含邮件的消息文件夹了，打开消息文件夹需要先使用Store对象的getFolder方法创建一个Folder对象作为消息文件夹。
Folder folder=store.getFolder("INBOX");
//参数用来设置消息文件夹的名字，通常设为INBOX，因为POP3协议只支持唯一的消息文件夹INBOX。
使用Folder类的open方法来打开消息文件夹：
folder.open(Folder.READ_ONLY);
它有两种可选模式：READ_ONLY和READ_WRITE
要从消息文件夹中取出邮件，可以使用Folder类的getMessage方法或getMessages方法。
Message message=inbox.getMessage(i);
//方法getMessage返回以其参数为索引的Message对象
Message message[]=folder.getMessages();
//方法getMessages返回一个Message对象数组
int count=folder.getMessageCount();
//使用Folder类的getMessageCount()得到消息文件夹中的邮件总数

4、Message类
与前面的Message类相同，在这里介绍它在显示邮件列表和删除邮件时所使用的一些方法。
(1)、方法getSubject得到一封邮件的标题；
(2)、方法isSet用来判断一封邮件是否被标记为删除(DELETED)、是否用户已经收取过(SEEN)、是否被回复过(ANSWERED)、是否是一个草稿(DRAFT)等等；
(3)、方法setFlag设置一封邮件为待删除。

在接收和检索邮件之后，还要关闭程序使用到的资源，
folder.close(true);
store.cloase();
这两个方法关闭收件箱和到邮件服务器的连接。


显示邮件详细信息的Message类的方法：
1、Address[] getFrom()：得到发件人的地址，返回一个Address类的对象数组；
2、Address[] getRecipients(Message.RecipientType.TO):得到收件人的地址列表；
3、Address[] getSubject():得到邮件标题
4、Address[] getContent():得到普通文本邮件的详细内容；
5、Date getSentDate():得到邮件发送的时间；
6、Date getReceivedDate():得到接受邮件的时间；
7、Boolean isMimeType("text/plain"):判断邮件的MIME(多用途的Internet邮件扩展)类型；
Address类是邮件的地址，它是一个抽象类，可以由其子类InternetAddress来实现。

接收带附件的邮件：
先用Message对象的isMimeType方法判断该邮件是否是一个多部分内容的邮件：
if(message.isMimeType("multipart/*"))
如果是的话，就表明该邮件带有附件，这是可以用Message对象的getContent方法获得代表该邮件的多部分内容的Multipart对象：
Multipart multipart=(Multipart)message.getContent();
然后依次获取Multipart对象的每个部分，并用方法getDisposition获得该部分的属性：
Part p=multipart.getBodypart(i);
String disposition=p.getDisposition();
如果该部分的属性是Part.ATTACHMENT或Part.INLINE，就表明它是附件的内容；如果该部分的属性为null，就表明它是普通文本的内容，在对属性进行判断之后，就可以进行相应的处理了：
if((disposition!=null)&&(disposition.equals(Part.ATTACHMENT)||disposition.equals(Part.INLINE)))
{
........
}
else if(disposition==null)
{
if(p.isMimeType("text/plain"))
{
.....
}
}

下载附件的处理：
先设置附件的类型属性，并生成下载的头信息：
response.setContentType(p.getContentType());
response.setHeader("Content-Disposition","attachment;filename=\""+p.getFileName()+"\"");
然后设置下载过程中的输入流和输出流，为下载附件做好准备工作：
OutputStream os=response.getOutputStream();
InputStream is=p.getInputStream();
最后就可以执行下载的操作了：
int c=is.read();
while(c!=-1)
{
os.write(c);
c=is.read();
}


邮件过滤：
要对邮件进行过滤，需要先查找出所有符合过滤条件的邮件，然后对这些邮件设置待删除标记，最后在关闭消息文件夹时真正删除它们。JavaMail提供了一个包javax.mail.search专门用来查找符合条件的邮件，因此可以这样来实现对邮件的过滤：
建立一个SearchTerm对象，它是一个抽象类，需要用其子类来构造，常用的有以下这些子类，这些字类的构造方法中参数就是过滤的规则，满足这些规则的邮件将被过滤掉。
AndTerm:查找同时满足多个条件的邮件；
OrTerm:只要邮件满足多个条件中的某一个条件，就查找出来；
NotTerm:查找不满足条件的邮件；
SentDateTerm:查找某个特定时间发送出来的邮件；
BodyTerm:查找正文部分的内容符合条件的邮件；
SubjectTerm:查找标题部分内容符合条件的邮件；
FromTerm:如果邮件的发件人地址头满足条件，就查找出来；
FromStringTerm:如果邮件发件人的地址字符串满足条件，就查找出来；
RecipientTerm:如果邮件的收件人地址头满足条件，就查找出来；
RecipientStringTerm:如果邮件收件人的地址字符串满足条件，就查找出来
例如：要设立这样的一个过滤规则，凡是标题中含有“惊喜”的邮件或者是由[email protected]发送过来的邮件都将被过滤。
SearchTerm st=new OrTerm(new SubjectTerm("惊喜"),new FromStringTerm("[email protected]"));
//建立SearchTerm对象；
Message[] message=folder.search(st);
//设立了过滤规则之后，调用Folder对象的search方法在接收到的邮件中寻找符合过滤条件的邮件；并将它们作为Message的对象数组返回；
message.setflsg(Flags.Flag.DELETED,true);
//将过滤出的所有邮件设置删除标志