JAVA MAIL JavaMail详解
在Java EE应用程序中，经常需要发送E-mail。Java EE框架为应用提供了JavaMail接口，通过JavaMail相关的接口可以读取邮件服务器的邮件，并且可以完成邮件的发送过程。
本章的主要内容包括：
E-mail体系结构
JavaMail API
如何使用JavaMail API发送邮件
如何使用JavaMail API接收邮件
29.1 E-mail体系结构
29.1.1 什么是E-mail
E-mail是用户间或应用程序间交换信息的Internet标准。每个用户都有自己的网上邮箱，发送方把信息发送到自己的网上信箱，并声明信息的接收方；该信箱所在的“邮局”会把信息发送到接收方的“邮局”，接收方从接收方的“邮局”中自己的信箱获取信息。这样就完成了信息从发送方到接收方的传递。所以，要发送或者接收邮件首先应该有自己的邮箱。
E-mail消息可以包含普通文本，也可以包含更为复杂的多媒体数据类型和图像声音等。这样，用户就可以交换各种各样的信息。
每个E-mail消息的头信息中都包含消息的发出者、发送的目的地和其他相关信息。
29.1.2 E-mail体系结构
要完成消息的交互，需要几方面的支持：邮件发送客户端程序、邮件接收客户端程序、邮件发送服务器和邮件接收服务器，此外，还需要相关的通信协议。
邮件发送客户端程序和邮件接收客户端程序可以是相同的，例如经常使用的微软的Outlook既可以发送邮件，也可以接收邮件。
邮件发送服务器和邮件接收服务器也可以是相同的服务器。在与邮件服务器交互的过程中，主要完成两个动作，把邮件发送到邮件服务器，以及从邮件服务器读取邮件。所以，主要使用两类协议，分别进行邮件的发送和接收。
邮件从发送方到接收方的传递过程（参见图29.1）如下：
（1）邮件发送方通过邮件发送客户端把邮件发送到发送方的邮件服务器，在发送的过程中需要用到SMTP协议。
（2）发送方的邮件服务器把邮件发送到接收方的邮件服务器，使用的协议也是SMTP。
（3）邮件接收方从接收方邮件服务器接收邮件，使用POP3协议或者IMAP协议。
邮件
发送方
发送方邮件
服务器
接收方邮件
服务器
邮件
接收方
SMTP
SMTP
IMAP
POP3
图29.1 邮件从发送方到接收方的传递过程
29.1.3 E-mail相关的协议
简单邮件传输协议（SMTP）
在邮件发送方把邮件发送到发送方邮件服务器的时候，需要用到简单邮件传输协议（Simple Mail Transport Protocol，简称SMTP），发送方邮件服务器把邮件发送到接收方邮件服务器的时候，也要用到SMTP。SMTP是应用程序与邮件服务器通信并发送邮件的Internet标准，SMTP通信基于TCP协议端口25之上。
邮箱协议（POP3）
邮件接收方从接收方邮件服务器接收邮件的时候，需要使用检索协议，可以使用POP3或者IMAP。POP3是Post Office Protocol的简称，是用于接收方从邮件服务器上检索E-mail消息的协议，工作在TCP协议端口110之上。
Internet消息访问协议（IMAP）
IMAP是Internet Message Access Protocol的简称，与POP3基本相同。完成的主要功能是从邮件服务器接收邮件，使用的端口是293。
29.1.4 什么是Java Mail
在Java EE应用中，经常需要通过E-mail与用户进行交互，主要是与邮件服务器的交互，例如向邮件服务器发送邮件，或者从邮件服务器接收邮件。如果是用户之间直接进行交互可以使用邮件客户端程序，例如微软的Outlook。如果想在应用程序中发送邮件，就不能直接使用通用的客户端了，需要编写自己专门的邮件发送和接收代码，并且需要与邮件服务器进行交互。可以通过Socket编程，使用相关的协议完成，但是这个过程非常复杂。而Java Mail提供了比较便利的解决方案。
JavaMail是Java EE中的标准API，是对邮件服务器访问过程的封装。使用JavaMail API则不需要编写与邮件服务器交互的详细过程，只需要调用相关接口即可。在接口中封装了与邮件服务器交互的详细过程。
本章的主要内容是介绍如何通过JavaMail API完成邮件的发送和接收。
29.2 JavaMail API
JavaMail API主要包括四个部分：Session，Message，Transport和InternetAddress。下面分别进行介绍。
29.2.1 Session
Session定义了全局的和每个用户的与邮件相关的属性，这些属性详细说明了客户机和服务器如何交流信息。Session中定义的属性如下：
mail.store.protocol：确定检索邮件所使用的协议。可以是IMAP（接收），也可以是POP3。
mail.transport.protocol：确定发送邮件所使用的协议，可以是SMTP（发送）。
mail.host：确定邮件服务器的主机名。
mail.user：确定检索邮件或者发送邮件的用户名。
mail.protocol.host：确定具体的发送邮件服务器或者接收邮件服务器。有时候发送邮件服务器和接收邮件服务器使用的主机不同，这时候需要详细指定各个协议使用的主机，如果不指定，则使用mail.host所确定的主机。
mail.protocol.user：为登录特定邮件服务器所使用的用户名，如果没有指定，使用mail.user所指定的用户。
mail.from：为邮件指定默认的回复地址，如果没有指定，使用mail.user所指定的用户。
29.2.2 Message
Message表示单个邮件消息，其属性包括消息类型、地址信息和所定义的目录结构。但是Message类是一个抽象类，必须实现它的一个子类。通常使用MimeMessage，它是Message类的一个派生类。
Message类的主要方法有两部分，第一部分主要在发送邮件的时候使用，用于设置邮件的相关信息，包括邮件的发送者、接收者、主题和发送时间等。这些方法如下：
setFrom()，用于设置邮件的发送者，值从“mail.user”属性中获取，如果这个值是默认的，则使用系统属性“user.name”。
setFrom（Address address），与上一个方法的作用相同，值是通过参数确定的，是Address的对象，通常使用其实现者InternetAddress的对象作为参数。
addFrom（Address[] addresses），在已有的邮件发送者中添加其他的邮件发送者，参数是要添加的邮件发送者的地址。
setSubject（String subject），用于设置邮件的标题。
setContent（String contentType），用于设置邮件的内容类型。
setSentDate（java.util.Date date），用于设置邮件发送的时间。
setRecipient（Message.RecipientType type, Address address），用于设置邮件的接收者。有两个参数，第一个参数是接收者的类型，第二个参数是接收者。接收者类型可以是Message.RecipientType.TO，Message.RecipientType.CC和Message.RecipientType.BCC，TO表示主要接收人，CC表示抄送人，BCC表示秘密抄送人。接收者与发送者一样，通常使用InternetAddress的对象。
addRecipient（Message.RecipientType type, Address address），用于添加邮件的接收者，其参数与setRecipient方法的基本相同。
setRecipients（Message.RecipientType type, Address[] addresses），作用和setRecipient基本相同，区别在于该方法可以同时设置多个邮件的接收者。
addRecipients（Message.RecipientType type, Address[] addresses），用于添加邮件接收者，可以同时添加多个接收者。
setReplyTo（Address[] addresses），设置邮件的回复地址，参数用于确定要回复的地址。
setText（String text），用于设置邮件的文本，同时还将邮件的内容类型设置为text/plain。如果邮件的内容类型不是文本的，则需要通过setContent方法来设置内容类型。
第二部分用于获取邮件的相关信息，在接收邮件的时候使用：
Flags getFlags()，用于获取与邮件相关的标记属性。
Folder getFolder()，用于获取该邮件所在的文件夹。
Address getFrom()，用于获取邮件的发送者。
int getMessageNumber()，用于获取邮件的编号，该编号是邮件系统设置的。
Address[] getAllRecipients()，获取邮件的所有接收者。
java.util.Date getReceivedDate()，用于获取邮件的接收时间。
Address[] getRecipients(Message.RecipientType type)，用于获取指定接收类型的接收者，参数用于确定接收者的类型。
Address[] getReplyTo()，用于获取邮件的回复者，也就是邮件要给哪些人回复。
java.util.Date getSentDate()，用于获取邮件的发送时间。
java.lang.String getSubject()，用于获取邮件的主题。
29.2.3 Transport
Transport是一个抽象类，用于邮件的发送，主要的方法有：
public static void send(Message msg) throws MessagingException，用于发送邮件，参数就是要发送的邮件本身，该方法是一个静态方法，不需要实例化对象，可以直接使用。
public static void send(Message msg, Address[] addresses) throws MessagingException，也是用于发送邮件，有两个参数，第一个参数是要发送的邮件本身，第二个参数是邮件发送的目的地。该方法会忽略在邮件中设置的接收者。
29.2.4 InternetAddress
InternetAddress把用户的E-mail地址映射为Internet地址。得到的邮件发送者和接收者通常都是字符串，但是在Message中确定邮件的接收者和发送者，以及在发送邮件时候使用的都是Address的对象。InternetAddress是Address的派生类，可以把字符串转换成InternetAddress类的对象。
构造函数如下：
InternetAddress( )，无参数的默认构造函数。
InternetAddress(java.lang.String address)，把一个字符串构造成一个InternetAddress，用得比较多。
InternetAddress(java.lang.String address, java.lang.String personal)，使用字符串和个人姓名构造一个InternetAddress。
InternetAddress(java.lang.String address, java.lang.String personal, java.lang.String charset)，使用字符串和个人姓名构造一个InternetAddress对象，名字的编码方式是第三个参数确定的。
要设置该对象所表示的Internet地址，可以通过下面的方法：
void setAddress(java.lang.String address)，参数确定了地址。
如果想把Internet地址转换成字符串，则使用下面的方法：
java.lang.String toString()
29.3 WebLogic中邮件会话的配置
在介绍邮件发送和邮件接收程序之前，需要在WebLogic中配置邮件会话的相关信息。需要配置所使用的发送邮件服务器和接收邮件服务器。在WebLogic中的配置过程如下：
（1）进入到WebLogic Server的控制台；
（2）在控制台的左下方选择【Domain Structure】→【Service】→【Mail Sessions】；
（3）在控制台的左上方点击【Lock & Edit】；
（3）在界面的右边点击【New】；
（4）在接下来的过程中需要分别输入下面的信息：
会话的名字（Name）：MailSession。
会话的JNDI名字（JNDIName）：MailSession；会话的JNDI名字可以和会话的名字相同。
会话相关的属性：
mail.pop3.host = 218.25.154.4 （应该写你所使用的邮件服务器的IP地址）
mail.transport.protocol = smtp （发送）
mail.user = lixucheng
mail.smtp.host = 218.25.154.6
mail.store.protocol = pop3（接收）
其中mail.pop3.host是所使用的接收邮件服务器，mail.transport.protocol是发送邮件所使用的协议，mail.user是发送邮件和接收邮件时候的用户名，mail.smtp.host是所使用的发送邮件服务器，mail.store.protocol是检索邮件所使用的协议。
输入完这些信息之后，点击【Save】，创建该邮件会话。
（5）把邮件会话部署到相应的服务器上：选择【Targets】页面，从服务器列表中选择相应的服务器，然后点击【Save】，就完成邮件会话的配置了。要让之前的配置起作用，需要点击左上角的【Activate Changes】（参见图29.2和图29.3）。
29.4 邮件发送示例程序
发送邮件的基本过程如下：
（1）得到会话对象
（2）构造邮件对象
（3）发送邮件
图29.2 邮件会话的配置
图29.3 把会话部署到相应的服务器上
29.4.1 得到会话对象
这里使用前面在WebLogic中配置好的邮件会话，所以首先要获取这个会话。下面的代码完成获取邮件会话的功能：
//获取上下文环境
Context ctx = new InitialContext();
//从JNDI中查找会话MailSession
Session mailSession = (Session) ctx.lookup("MailSession");
其中，MailSession是我们在前面配置的邮件会话中的JNDI名字。
如果不使用配置好的邮件会话，可以通过创建Properties对象设置相关会话属性，然后，通过Session.getInstance(propoties, null)创建会话对象。
29.4.2 构造邮件对象
发送一封邮件通常需要确定邮件发送者、邮件接收者、邮件的主题和邮件的内容，有时候还需要发送附件。这里先不考虑附件。其他的条件通过JSP界面接收，下面是构造邮件的代码：
//获取相关参数
String to = request.getParameter("to");
String subject = request.getParameter("subject");
String from = request.getParameter("from");
String message = request.getParameter("message");
to = new String(to.getBytes("8859_1"));
subject = new String(subject.getBytes("8859_1"));
from = new String(from.getBytes("8859_1"));
//创建消息对象
Message msg = new MimeMessage(mailSession);
//把邮件地址映射到Internet地址上
InternetAddress dest = new InternetAddress(to);
//设置消息内容
msg.setFrom(new InternetAddress(from));
msg.setSubject(subject);
msg.setRecipient(Message.RecipientType.TO, dest);
msg.setContent(message, "text/plain");
首先，通过request对象的getParameter方法获取邮件接收者、邮件发送者、邮件主题和邮件内容。然后，创建Message的对象。最后，通过Message的setXXX方法设置邮件的相关信息。
29.4.3 发送邮件
通过Transport的send(Message msg)方法发送构建好的消息。
Transport.send(msg);
29.4.4 完整的代码
该实例的代码分为两部分，第一部分是发送邮件的界面，第二部分是发送邮件的处理代码。完整的代码如下：
<%@ page import = "java.util.*,
javax.mail.*,
javax.mail.internet.*,
javax.naming.*"
%>
<%@ page contentType = "text/html;charset = gb2312"%>
<%
if (request.getMethod().equals("POST")) {
try {
//获取相关参数
String to = request.getParameter("to");
String subject = request.getParameter("subject");
String from = request.getParameter("from");
String message = request.getParameter("message");
to = new String(to.getBytes("8859_1"));
subject = new String(subject.getBytes("8859_1"));
from = new String(from.getBytes("8859_1"));
message = new String(message.getBytes("8859_1"));
//获取上下文环境
Context ctx = new InitialContext();
//从JNDI中查找会话MailSession
Session mailSession = (Session) ctx.lookup("MailSession");
//创建消息对象
Message msg = new MimeMessage(mailSession);
//把邮件地址映射到Internet地址上
InternetAddress dest = new InternetAddress(to);
//设置消息内容
msg.setFrom(new InternetAddress(from));
msg.setSubject(subject);
msg.setRecipient(Message.RecipientType.TO, dest);
msg.setContent(message, "text/plain");
//通过Transport类发送消息
Transport.send(msg);
out.println("
到 " + to + "的邮件发送成功!");
}
catch (Exception e) {
out.println(e);
}
} else {
%>