JavaMailAPI简介

JavaMailAPI简介

Java Mail API简介
JavaMail API是一种可选的、能用于读取、编写和发送电子消息的包（标准扩展）。您可使用这种包创建邮件用户代理（Mail User Agent ，MUA） 类型的 程序，它类似于Eudora、Pine及Microsoft Outlook这些邮件 程序。其主要目的不是像发送邮件或其他邮件传输代理（Mail Transfer Agent，MTA）类型的 程序那样用于传输、发送和转发消息。换句话说，用户可以与MUA类型的 程序交互，以阅读和撰写电子邮件。MUA依靠MTA处理实际的发送任务。
JavaMail API的设计是，为收发信息提供与协议无关的访问。方式是把该API划分成两个部分：
· 该API的第一个部分是本课程的重点。基本上是如何发送和接收独立于提供 程序/协议的消息。
· 第二个部分则使用特定的协议语言，如：SMTP、POP、IMAP和NNTP。如果要让 JavaMail API与服务器通信，就需要为之提供协议。由于Sun公司对特定协议提供 程序有充分的介绍，用户可以免费获取，所以本课程没有介绍创建特定协议提供 程序的内容。
复习相关协议
在学习 JavaMail API的深层知识之前，让我们回过头来看一看在该API中使用的协议,本质上有4种人们常用的协议：
· SMTP
· POP
· IMAP
· MIME
您还需要了解NNTP及其他一些协议。理解这些协议的基本原理有助于您理解如何使用 JavaMail API。而该API的设计要与协议无关，所以不能克服这些基础协议的限制。如果选用的协议不支持某种功能，那么 JavaMail API也无法在其上添加这种功能。（正如您一会儿就会看到的，在操作POP协议时，常常会碰到这种问题）。
SMTP
简单邮件传输协议（SMTP）是用于传送电子邮件的机制。在 JavaMail API环境中，您的基于 JavaMail的 程序将与您公司或Internet服务提供商（ISP）的SMTP服务器通信。该SMTP服务器将会把消息转发给用作接收消息的SMTP服务器，最后用户可通过POP或IMAP协议获取该消息。由于支持身份验证，所以不需要SMTP服务器是一种开放的转发器，但需要确保SMTP服务器配置正确。 JavaMail API中没有集成用于处理诸如配置服务器以转发消息或添加/删除电子邮件帐户这一类任务的功能。
POP
POP的含义是邮局协议，当前的版本为3，也称作POP3，该协议是在RFC 1939中定义的。POP是Internet上的大多数人用来接收邮件的机制。它为每个用户的每个邮箱定义支持，这是它所做的全部工作，也是大多数问题的根源。在使用POP协议时，人们熟悉的很多功能，如查看收到了多少新邮件消息的功能，POP根本不支持。这些功能都内置到诸如Eudora或Microsoft Outlook之类的邮件 程序中，能为您记住接收的上一封邮件，以及计算有多少新邮件这类信息。因此，使用 JavaMail API时，如果想获取这类信息，将需要由自己进行计算。
IMAP
IMAP是用于接收消息的更加高级的协议，它是在RFC 2060中定义的。IMAP的含义是“Internet消息访问协议”，当前版本是第4版，也称作IMAP4。使用IMAP时，您的邮件服务器必须支持该协议。您不能只是简单地把 程序转变为支持IMAP，而不是支持POP，就指望能支持IMAP中的一切。假定您的邮件服务器支持IMAP，那么基于 JavaMail的 程序就可利用在服务器上拥有多个文件夹的用户，并且这些文件夹可以被多个用户共享的功能。
由于IMAP协议具有更高级的功能，您也许会想IMAP应该被每一个人使用，但事实不是这样。因为IMAP会加重邮件服务器的负荷，它需要服务器接收新消息，发送消息给请求的用户，并在多个文件夹中为每个用户维护这些消息。而这要集中备份，因而长期下去用户的文件夹会变得越来越大，当磁盘空间用光了时，每个人都会遭受损失。而使用POP协议时，已保存消息可以解除服务器的重负。
MIME
MIME的含义是“多用途的网际邮件扩充协议”。它不是一种邮件传输协议，相反，它定义传输的内容：消息的格式、附件等。许多文档都定义了MIME协议，包含：RFC 822、RFC 2045、RFC 2046和RFC 2047。作为 JavaMail API的用户，一般不需要担心这些格式。但是，这些格式确实存在，并为您的 程序所用。
NNP和其他协议
由于 JavaMail API分开了提供 程序和其他部分，所以您可以轻松地为附加协议添加支持。Sun公司提供第3方提供 程序清单，这些提供 程序要利用 Sun公司不支持的少见的协议。在这份清单中，您将会看到对NNTP（ 网络新闻传输协议）[新闻组]、S/MIME（安全多用途的网际邮件扩充协议）及其他协议的提供支持的第3方提供 程序。
安装
目前有两种版本的 JavaMail API最常用：1.2和1.1.3。本课程中的所有例子都适用于这两种版本。其中 JavaMail API 1.2是最新的，而 JavaMail API 1.1.3中包含了 Java 2企业版（J2EE）平台1.2.1版，所以它仍然很常用。使用 JavaMail API的版本会对您的下载和安装产生一些影响。这两种版本的 JavaMail API都能与JDK 1.1.6、 Java 2标准版（J2SE）平台1.2.x和1.3.x协同工作。
注意：在安装了Sun公司的 JavaMail工具后，会在演示目录下看到许多示例 程序。
安装 JavaMail 1.2
要使用 JavaMail 1.2 API，可以下载 JavaMail 1.2工具，然后解压缩 javamail-1_2.zip文件，并把mail.jar文件添加到典型安装路径下。 JavaMail 1.2工具带有SMTP、IMAP4和POP3提供 程序以及核心类。
安装完 JavaMail 1.2后，再安装 JavaBeans Activation Framework。
安装 JavaMail 1.1.3
要使用 JavaMail 1.1.3 API，可以下载 JavaMail 1.1.3工具，然后解压缩 javamail1_1_3.zip文件，并把mail.jar文件添加到典型安装路径下。 JavaMail 1.1.3工具带有SMTP和IMAP4提供 程序以及核心类。
如果您想用 JavaMail 1.1.3访问POP服务器，需要下载并安装POP3提供 程序。Sun公司拥有一个独立于 JavaMail 工具的提供 程序。在下载并解压缩pop31_1_1.zip文件后，也还需要把pop3.jar添加到典型安装路径下。
安装完 JavaMail 1.1.3后，再安装 JavaBeans Activation Framework。
安装 JavaBeans Activation Framework
JavaMail API的所有版本都需要 JavaBeans Activation Framework（ JavaBeans激活框架），这种框架提供了对输入任意数据块的支持，并能相应地对其进行处理。看上去效果好像不太好，但该框架是在当今的许多浏览器和邮件工具中可以找到的基本MIME类型支持。下载该框架后，解压缩jaf1_0_1.zip文件，并将activation.jar文件添加到典型安装路径下。
对于 JavaMail 1.2用户，现在应该把mail.jar和activation.jar文件添加到典型安装路径下。
对于 JavaMail 1.1.3用户，现在应该把mail.jar、pop3.jar和activation.jar添加到典型安装路径下。如果您不打算使用POP3，就不需要把pop3.jar文件添加到典型安装路径下。
如果您不想更改安装路径环境变量，可以把JAR文件复制到 Java运行时环境（JRE）目录下的lib/ext目录下。例如，对于J2SE 1.3版本， Windows平台上的默认目录应该是C:\jdk1.3\jre\lib\ext。
使用 Java 2企业版
如果您使用的是J2EE，则在使用基本 JavaMail API时，不需要做什么特殊的工作； JavaMail API带有J2EE类。只要确保j2ee.jar文件位于典型安装路径下，并完成了所有的设置工作。
对于J2EE 1.2.1，POP3提供 程序是单独提供的，因此需要下载该提供 程序，并按安装 JavaMail 1.1.3的步骤，在J2EE 1.2.1中包含POP3提供 程序。J2EE 1.3的用户会获得J2EE和POP3提供 程序，因而不需要对POP3提供 程序执行独立安装。使用这两种版本的J2EE用户，都不需要安装 JavaBeans Activation Framework。
练习
设置您的 JavaMail 环境。
复习核心类
在开始深入研究 JavaMail类之前，首先让用户浏览一下构成API的核心类：会话、消息、地址、验证 程序、传输，存储和文件夹。所有这些类都可以在 JavaMail API即 javax.mail的顶层包中找到，尽管您将频繁地发现您自己使用的子类是在 javax.mail.internet包中找到的。
Session类
Session类定义了一个基本的邮件会话。通过该会话可让别的工作顺利执行。Session对象利用 java.util.Properties对象获取诸如邮件服务器、用户名、密码等信息，以及其他可在整个应用 程序中共享的信息。
Session类的构造器是私有的。您可以获得一个可被getDefaultInstance()方法共享的单一的默认会话：
Properties props = new Properties();
// fill props with any information
Session session = Session.getDefaultInstance(props, null);
或者，您可以用getInstance()方法创建一个独特的会话：
Properties props = new Properties();
// fill props with any information
Session session = Session.getInstance(props, null);
这两种情形下的null参数都是一种Authenticator对象，它不是在此时使用的。详细信息请参阅其后的“Autherticator”一节。
在大多数情况下，使用共享会话就足够了，即使为多个用户邮箱处理邮件会话也是如此。您可以在通信过程的后面一步添加上用户名和密码的组合，并保持所有的一切是独立的。
Message类
一旦创建了自己的Session对象，就是该去创建要发送的消息的时候了。这时就要用到消息类型。作为一个抽象类，您必须操作一个子类，在大多数情况下，该子类是 javax.mail.internet.MimeMessage。一个MimeMessage是一种理解MIME类型和报头（在不同的RFC文档中均有定义）的消息。消息的报头被严格限制成只能使用US-ASCII字符，尽管非ASCII字符可以被编码到某些报头字段中。
可以通过将Session对象传递给MimeMessage构造器的方法来创建消息：
MimeMessage message = new MimeMessage(session);
注意：还有其他的构造器，像用于创建消息的源于RFC822格式化的输入流的构造器。
一旦创建了消息，就可以设置其各个部分，如Message(消息)实现Part（部分）接口（以MimeMessage实现MimePart）。设置内容的基本机制是setContent()方法，它带有表示内容和MIME类型的参数：
message.setContent("Hello", "text/plain");
但是，如果正在使用 MimeMessage，并且您的消息是纯文本，那么您就可以使用setText()方法。该方法只需要一个表示实际内容的参数，默认的MIME类型为纯文本：
message.setText("Hello");
对于纯文本消息，setText()方法更常常被用来设置内容。要发送其他类型的消息，如HTML消息，就要使用setContent方法()。现在用的更多的是HTML消息。
要设置主题，可以使用setSubject()方法：
message.setSubject("First");
Address类
一旦创建了会话和消息，并为消息填充了内容，就需要用Address类为您的信件标上地址了。同Message类一样，Address类也是一种抽象类。您可以使用 javax.mail.internet.InternetAddress类。
要创建只带有电子邮件地址的地址，可以把电子邮件地址传递给Address类的构造器：
Address address = new InternetAddress(" [email protected]");
如果想让一个名字出现在电子邮件地址后，也可以将其传递给构造器：
Address address = new InternetAddress(" [email protected]", "George Bush");
您要为消息的from（发送者）字段和to（接收者）字段创建地址对象。除非您的邮件服务器阻止这样做，否则要在发送的消息中注明该消息的发送者。
一旦创建好了地址，有两种方法可让您将地址与消息连接起来。为了鉴别发送者，您可以使用setFrom()和setReplyTo()方法。
message.setFrom(address)
如果您的消息需要显示多个地址来源，则可以使用addFrom()方法：
Address address[] = ...;
message.addFrom(address);
为了鉴别消息接收者，您可以使用addRecipient()方法。该方法除了需要一个地址参数外，还需要一个Message.RecipientType属性（消息的接收类型）。
message.addRecipient(type, address)
地址的3种预定义类型如下：
· Message.RecipientType.TO
· Message.RecipientType.CC
· Message.RecipientType.BCC
因此，如果一条消息将发送给副总统，同时还将发送该消息的副本给第一夫人，则采用下面的代码：
Address toAddress = new InternetAddress(" [email protected]");
Address ccAddress = new InternetAddress(" [email protected]");
message.addRecipient(Message.RecipientType.TO, toAddress);
message.addRecipient(Message.RecipientType.CC, ccAddress);
JavaMail API没有提供检查电子邮件地址有效性的机制。您可以自己编写支持扫描有效字符（在RFC 822文档中所定义的）的 程序或检验MX（邮件交换）记录，这些都超越了 JavaMail API的范围。
Authenticator类
与 java.net类一样， JavaMail API可以利用Authenticator（验证 程序）类通过用户名和密码来访问受保护的资源。对于 JavaMail API来说，这种受保护的资源是指邮件服务器。 JavaMail的Authenticator类可以在 javax.mail包中找到，并有别于同名的 java.net类。当 JavaMail API在 Java 1.1下工作时， JavaMail和 java.net不会共享同一个Authenticator类名称，这是因为 Java 1.1中不含有 java.net。
要使用Authenticator类，您可以使用该抽象类的子类，并通过getPasswordAuthentication()方法返回一个PasswordAuthentication实例。在创建时，您必须用会话记录Authentication类。其后，当需要进行身份验证时，会通知您的Authenticator。会弹出一个窗口，或从一个配置文件（尽管不加密就不安全）中读取用户名和密码，并把它们作为一个PasswordAuthentication对象返回给调用 程序。
Properties props = new Properties();
// fill props with any information
Authenticator auth = new MyAuthenticator();
Session session = Session.getDefaultInstance(props, auth);
Transport类
发送消息的最后一步操作是使用Transport类。该类使用特定于协议（通常是SMTP）的语言来发送消息。它是一个抽象类，其操作与Session类有些相似。您可以通过只调用静态的send()方法来使用该类的默认版本：
Transport.send(message);
或者，您可以从用于您的协议的会话中获取一个特定的实例，然后传递用户名和密码（不必要时可以为空）并发送消息，最后关闭连接：
message.saveChanges(); // implicit with send()
Transport transport = session.getTransport("smtp");
transport.connect(host, username, password);
transport.sendMessage(message, message.getAllRecipients());
transport.close();
当您需要发送多个消息时，建议采用后一种方法，因为它将保持消息间活动服务器的连接。而基本的send()机制会为每一个方法调用都建立一条独立的连接。
注意：要查看经过邮件服务器邮件命令，可以用session.setDebug(true)方法设置调试标志。
Store和Folder类
使用Session类来获取消息，开始时与发送消息很相似。但是，在获取会话后，很有可能使用用户名和密码或Authenticator类来连接Store类。与Transport类一样，您要告诉Store类将使用什么协议：
// Store store = session.getStore("imap");
Store store = session.getStore("pop3");
store.connect(host, username, password);
在连接Store类后，就可以获取一个Folder类，在读取其中的消息前必须先打开该类。
Folder folder = store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);
Message message[] = folder.getMessages();
对于POP3协议，惟一可用的文件夹是INBOX。如果使用的是IMAP协议，则可以使用其他的文件夹。
注意：Sun公司的提供 程序本来想提供方便。而Message message[]=folder.getMessages();这条语句却是一种从服务器逐条读取消息的缓慢操作，所以仅当您确实需要获取消息部分（该内容是所检索消息的内容）时可以使用这条语句。
一旦读取消息，就可以使用getContent()方法获取其内容，或使用writeTo()方法将其内容写到一个流中。getContent()方法只获取消息内容，而writeTo()方法则还会输出报头。
System.out.println(((MimeMessage)message).getContent());
一旦您阅读完邮件，就可以关闭对文件夹和存储的连接。
folder.close(aBoolean);
store.close();
传递给文件夹的close()方法的布尔变量指定了是否通过清除已删除的消息来更新文件夹。
继续前进
实际上，理解使用这7个类的方式，是使用 JavaMail API处理几乎所有事情所需要的全部内容。用这7个类以外的方式构建的 JavaMail API，其大多数功能都是以几乎完全相同或特定的方式来执行任务的，就好像内容是附件。特定的任务，如：搜索、隔离等将在后面进行介绍。
使用 JavaMail API
您已经看到了如何操作 JavaMail API的核心部分。在下面几节中，您将学习如何连接几个部分以执行特定的任务。
发送消息
发送电子邮件消息涉及到获取会话、创建和填充消息并发送消息这些操作。您可以在获取Session时，通过为要传递的Properties对象设置mail.smtp.host属性来指定您的SMTP服务器。
String host = ...;
String from = ...;
String to = ...;
// Get system properties
Properties props = System.getProperties();
// Setup mail server
props.put("mail.smtp.host", host);
// Get session
Session session = Session.getDefaultInstance(props, null);
// Define message
MimeMessage 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");
// Send message
Transport.send(message);
您应该在try-catch块中编写代码，以在创建消息并发送它时可以抛出一个异常。
练习
发送您的第一个消息
获取消息
对于阅读邮件来说，首先您要获取一个会话，然后获取并连接到一个相应的用于您的收件箱的存储上，接着打开相应的文件夹，再获取消息。同时，不要忘记了操作完成后关闭连接。
String host = ...;
String username = ...;
String password = ...;
// Create empty properties
Properties props = new Properties();
// Get session
Session session = Session.getDefaultInstance(props, null);
// Get the store
Store store = session.getStore("pop3");
store.connect(host, username, password);
// Get folder
Folder folder = store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);
// Get directory
Message message[] = folder.getMessages();
for (int i=0, n=message.length; i<n; i++) {
System.out.println(i + ": " + message[i].getFrom()[0]
+ "\t" + message[i].getSubject());
}
// Close connection
folder.close(false);
store.close();
每一条消息执行何种操作取决于自己决定。上面的代码块只是显示了消息的发送者和主题。从 技术上讲，发送者地址列表可以为空，此时getFrom()[0]调用会抛出一个异常。
为了显示整条消息，您可以提示用户在看完消息的发送者和主题字段后，如果想看到消息的内容，可以再调用消息的writeTo()方法。
BufferedReader reader = new BufferedReader (
new InputStreamReader(System.in));
// Get directory
Message message[] = folder.getMessages();
for (int i=0, n=message.length; i<n; i++) {
System.out.println(i + ": " + message[i].getFrom()[0]
+ "\t" + message[i].getSubject());
System.out.println("Do you want to read message? " +
"[YES to read/QUIT to end]");
String line = reader.readLine();
if ("YES".equals(line)) {
message[i].writeTo(System.out);
} else if ("QUIT".equals(line)) {
break;
}
}


发送附件
MimeMessage message =
         new MimeMessage(session);
      message.setFrom(
         new InternetAddress(from));
      message.addRecipient(
         Message.RecipientType.TO,
         new InternetAddress(to));
      message.setSubject(
         "Hello JavaMail Attachment");

      // create the message part
MimeBodyPart messageBodyPart =
         new MimeBodyPart();

      //fill message
      messageBodyPart.setText("Hi");

      Multipart multipart = new MimeMultipart();
      multipart.addBodyPart(messageBodyPart);

      // Part two is attachment
      messageBodyPart = new MimeBodyPart();
      DataSource source =
         new FileDataSource(fileAttachment);
      messageBodyPart.setDataHandler(
         new DataHandler(source));
      messageBodyPart.setFileName(fileAttachment);
      multipart.addBodyPart(messageBodyPart);

      // Put parts in message
      message.setContent(multipart);

      // Send the message
      Transport.send( message );