Javamail实用简易教程

JavaMail 简易教程

Alex Zhu 2011.3 Version 0.1 Beta

JavaMail API 简介..............................................................................................................................3

了解相关协议.............................................................................................................................3

JavaMail 的安装.................................................................................................................................5

安装 JavaBeans Activation Framework......................................................................................5

使用 Java EE 企业版..................................................................................................................5

发送邮件的例子.................................................................................................................................6

javax.mail.Transport 类.............................................................................................................17

javax.mail.Store 和 javax.mail.Folder 类..................................................................................18

使用 JavaMail API............................................................................................................................20

发送消息...................................................................................................................................20

获取消息...................................................................................................................................22

删除消息和标志.......................................................................................................................24

自我验证...................................................................................................................................25

回复消息...................................................................................................................................26

转发消息...................................................................................................................................27

操作附件...................................................................................................................................28

常见问答...........................................................................................................................................33

JavaMail 的常用类速查...................................................................................................................36

示例代码...........................................................................................................................................39

Gmail 收发信............................................................................................................................39

JavaMail 收取邮件属性配置（包括 Gmail、hotmail 等）...................................................42

JavaMail 收取邮件 IMAP........................................................................................................46

JavaMail 发送邮件 [代码] MailSender.java............................................................................56

JavaMail 收取邮件 POP3.........................................................................................................63

GmailFetch 收取 Gmail 邮件...................................................................................................69

Gmail Sender 发送 Gmail 邮件................................................................................................70

及 Microsoft Outlook 邮件程序。其主要目的不是像发送邮件或其他邮件传输代理（Mail

Transfer Agent，MTA）类型的程序那样用于传输、发送和转发消息。换句话说，用户可以

与 MUA 类型的程序交互，以阅读和撰写电子邮件。MUA

JavaMail API 的设计是，为收发信息提供与协议无关的访问。方式是把该 API 划分成

两个部分：

在学习 JavaMail API 的深层知识之前，让我们来看一看在该 API 中使用的协议，通常

有 4 种人们常用的协议：

还需要了解 NNTP 及其他一些协议。理解这些协议的基本原理有助于理解如何使用

JavaMail API。而该 API 的设计要与协议无关，所以不能克服这些基础协议的限制。如果选

服务器通信。SMTP 服务器将会把消息转发给用作接收消息的 SMTP 服务器，最后用户可

通过 POP 或 IMAP 协议获取该消息。由于支持身份验证，不需要 SMTP 服务器是一种开放

的转发器，但需要确保 SMTP 服务器配置正确。JavaMail API 中没有集成用于处理诸如配

置服务器以转发消息或添加/删除电子邮件帐户这一类任务的功能。参阅 RFC 821。

POP 的含义是邮局协议（Post Office Protocol），当前的版本为 3，也称作 POP3，该

协议是在 RFC 1939 中定义的。POP 是 Internet 上的经常用来接收邮件的机制。它为每个用

户的每个邮箱定义支持，这是它所做的全部工作，也是大多数问题的根源。在使用 POP 协

议时，人们熟悉的很多功能，如查看收到了多少新邮件消息的功能， POP 根本不支持。这

些功能都内置到诸如 Eudora 或 Microsoft Outlook 之类的邮件程序中，能记住接收的上一封

Message Access Protocol”，当前版本是第 4 版，也称作 IMAP4。使用 IMAP 时，邮件服务

器必须支持该协议。不能简单地把支持 POP 的程序用于 IMAP 协议，就指望能支持 IMAP

中的一切。如果邮件服务器支持 IMAP，那么基于 JavaMail 的程序就可访问在服务器上拥

有的多个文件夹，并且这些文件夹可以被多个用户共享。

既然 IMAP 协议具有更高级的功能，那么 IMAP 应该被所有人使用？！ 事实不是这样！

因为 IMAP 会加重邮件服务器的负荷，它需要服务器接收新消息，发送消息给请求的用户 ，

不是一种邮件传输协议，相反，它定义传输的内容：

义了 MIME 协议，包含：RFC 822、RFC 2045、RFC 2046 和 RFC 2047。作为 JavaMail API

的用户，一般不需要担心这些格式。但是，这些格式确实存在，并为您的程序所用。

由于 JavaMail API 分开了提供程序和其他部分，可以轻松地为附加协议添加支持。Sun

公司提供第 3 方提供程序清单，这些提供程序要利用 Sun 公司不支持的少见的协议。在这

份清单中，您将会看到对 NNTP（网络新闻传输协议）[新闻组]、S/MIME（安全多用途的

网际邮件扩充协议）及其他协议的提供支持的第 3 方提供程序。

下载地址：http://java.sun.com/products/javamail/downloads/index.html

解压 JavaMail 安装包： javamail1_4_4.zip

把其中的 mail.jar 文件添加到 CLASSPATH 路径下，或直接拷贝到 Tomcat 的 lib 目录下。

在 JavaMail 安装包的解压文件夹下，有 demo 演示目录可以看到许多示例程序[

]。

安装 JavaBeans Activation Framework

使用 Java EE 企业版

如果使用的是 Java EE，则在使用基本 JavaMail API 时，不需要做什么特殊的工作；Java

EE API 中包含有 JavaMail。只要确保 j2ee.jar 文件位于典型安装路径下，并完成了所有的设

置工作，也不需要安装 JavaBeans Activation Framework。[

GlassFish]

练习

设置 JavaMail 环境。