一、JavaMail概述：
JavaMail是由Sun定义的一套收发电子邮件的API，不同的厂商可以提供自己的实现类。但它并没有包含在JDK中，而是作为JavaEE的一部分。
厂商所提供的JavaMail服务程序可以有选择地实现某些邮件协议，常见的邮件协议包括：
lSMTP：简单邮件传输协议，用于发送电子邮件的传输协议；
lPOP3：用于接收电子邮件的标准协议；
lIMAP：互联网消息协议，是POP3的替代协议。
这三种协议都有对应SSL加密传输的协议，分别是SMTPS，POP3S和IMAPS。
除JavaMail服务提供程序之外，JavaMail还需要JAF(JavaBeans Activation Framework)来处理不是纯文本的邮件内容，这包括MIME（多用途互联网邮件扩展）、URL页面和文件附件等内容。下图描述了JavaMail的体系结构。
mail.jar：此JAR文件包含JavaMail API和Sun提供的SMTP、IMAP和POP3服务提供程序；
activation.jar：此JAR文件包含JAF API和Sun的实现。
二、对相关协议的回顾：
1、介绍
在研究JavaMail API的细则之前，让我们回顾用于API的协议。基本上，您会逐渐熟悉并喜爱的协议有四个：
* SMTP
* POP
* IMAP
* MIME
您还将碰到NNTP和其它协议。理解所有协议的基本知识将有助于您理解如何使用JavaMail API。虽然不了解这些协议您照样可以用这个API，却不能够克服那些基础协议的局限性。如果我们精选的协议不能支持某种性能，JavaMail API决不能魔术般的将这种性能添加上去。（您很快就会看到，在处理POP时这将成为一个难题。）
2、SMTP
简单邮件传输协议（Simple Mail Transfer Protocol，SMTP）由RFC 821定义。它定义了发送电子邮件的机制。在JavaMail API环境中，您基于JavaMail的程序将和您的公司或因特网服务供应商的（Internet Service Provider's，ISP's）SMTP服务器通信。SMTP服务器会中转消息给接收方SMTP服务器以便最终让用户经由POP或IMAP获得。这不是要求SMTP服务器成为开放的中继，尽管SMTP服务器支持身份验证，不过还是得确保它的配置正确。像配置服务器来中继消息或添加删除邮件账号这类任务的实现，JavaMail API中并不支持。
3、POP
POP代表邮局协议（Post Office Protocol）。目前用的是版本3，也称POP3，RFC 1939定义了这个协议。POP是一种机制，因特网上大多数人用它得到邮件。它规定每个用户一个邮箱的支持。这就是它所能做的，而这也造成了许多混淆。使用POP时，用户熟悉的许多性能并不是由POP协议支持的，如查看有几封新邮件消息这一性能。这些性能内建于如Eudora或Microsoft Outlook之类的程序中，它们能记住一些事，诸如最近一次收到的邮件，还能计算出有多少是新的。所以当使用JavaMail API时，如果您想要这类信息，您就必须自己算。
4、IMAP
IMAP是更高级的用于接收消息的协议。在RFC 2060中被定义，IMAP代表因特网消息访问协议（Internet Message Access Protocol），目前用的是版本4，也称IMAP4。在用到IMAP时，邮件服务器必需支持这个协议。不能仅仅把使用POP的程序用于IMAP，并指望它支持IMAP所有性能。假设邮件服务器支持IMAP，基于JavaMail的程序可以利用这种情况—用户在服务器上有多个文件夹（folder），并且这些文件夹可以被多个用户共享。
因为有这一更高级的性能，您也许会认为所有用户都会使用IMAP。事实并不是这样。要求服务器接收新消息，在用户请求时发送到用户手中，还要在每个用户的多个文件夹中维护消息。这样虽然能将消息集中备份，但随着用户长期的邮件夹越来越大，到磁盘空间耗尽时，每个用户都会受到损失。使用POP，就能卸载邮件服务器上保存的消息了。
5、MIME
MIME代表多用途因特网邮件扩展标准（Multipurpose Internet Mail Extensions）。它不是邮件传输协议。但对传输内容的消息、附件及其它的内容定义了格式。这里有很多不同的有效文档：RFC 822、RFC 2045、RFC 2046和RFC 2047。作为一个JavaMail API的用户，您通常不必对这些格式操心。无论如何，一定存在这些格式而且程序会用到它。
6、NNTP及其他
因为JavaMail API将供应商和所有其它的东西分开了，您就能轻松添加额外的协议支持。Sun保留了一张第三方供应商列表，他们利用了Sun不提供超出（out-of-the-box）支持范围的协议。您会找到NNTP（网络新闻传输协议）[新闻组]、S/MIME（安全多用途因特网邮件扩展）及其它支持。
三、JavaMail的关键对象：
JavaMail对收发邮件进行了高级的抽象，形成了一些关键的的接口和类，它们构成了程序的基础，下面我们分别来了解一下这些最常见的对象。
Properties：属性对象
由于JavaMail需要和邮件服务器进行通信，这就要求程序提供许多诸如服务器地址、端口、用户名、密码等信息，JavaMail通过Properties对象封装这些属性西信息。如下面的代码封装了两个属性信息：
Properties props =newProperties();
props.put("mail.smtp.host","smtp.sina.com.cn");
props.put("mail.smtp.auth","true");
针对不同的的邮件协议，JavaMail规定了服务提供者必须支持一系列属性，下表是针对SMTP协议的一些常见属性（属性值都以String类型进行设置，属性类型栏仅表示属性是如何被解析的）：
| 属性名 | 属性类型 | 说明 |
| mail.stmp.host | String | SMTP服务器地址，如smtp.sina.com.cn |
| mail.stmp.port | int | SMTP服务器端口号，默认为25 |
| mail.stmp.auth | boolean | SMTP服务器是否需要用户认证，默认为false |
| mail.stmp.user | String | SMTP默认的登陆用户名 |
| mail.stmp.from | String | 默认的邮件发送源地址 |
| mail.stmp.socketFactory.class | String | socket工厂类类名，通过设置该属性可以覆盖提供者默认的实现，必须实现javax.net.SocketFactory接口 |
| mail.stmp.socketFactory.port | int | 指定socket工厂类所用的端口号，如果没有规定，则使用默认的端口号 |
| mail.smtp.socketFactory.fallback | boolean | 设置为true时，当使用指定的socket类创建socket失败后，将使用java.net.Socket创建socket，默认为true |
| mail.stmp.timeout | int | I/O连接超时时间，单位为毫秒，默认为永不超时 |
其他几个协议也有类似的一系列属性，如POP3的mail.pop3.host、mail.pop3.port以及IMAP的mail.imap.host、mail.imap.port等。更详细的信息请查看com.sun.mail.smtp、com.sun.mail.pop3和com.sun.mail.imap这三个包的Javadoc：http://java.sun.com/products/javamail/javadocs/index.html。
Session：会话对象
Session是一个很容易被误解的类，这归咎于混淆视听的类名。千万不要以为这里的Session像HttpSession一样代表真实的交互会话，但创建Session对象时，并没有对应的物理连接，它只不过是一对配置信息的集合。Session的主要作用包括两个方面：
1）接收各种配置属性信息：通过Properties对象设置的属性信息；
2）初始化JavaMail环境：根据JavaMail的配置文件，初始化JavaMail环境，以便通过Session对象创建其他重要类的实例。
所以，如果把Session更名为Configure也许更容易理解一些。JavaMail提供者在Jar包的META-INF目录下，通过以下文件提供了基本配置信息，以便session能够根据这个配置文件加载提供者的实现类：
ljavamail.providers和javamail.default.providers；
ljavamail.address.map和javamail.default.address.map。
下面是Sun提供者java.mail.default.providers文件的配置信息（位于mail.jar中）：
# JavaMail IMAP provider Sun Microsystems, Inc
protocol=imap; type=store; class=com.sun.mail.imap.IMAPStore; vendor=Sun Microsystems, Inc;
protocol=imaps; type=store; class=com.sun.mail.imap.IMAPSSLStore; vendor=Sun Microsystems, Inc;
# JavaMail SMTP provider Sun Microsystems, Inc
protocol=smtp; type=transport; class=com.sun.mail.smtp.SMTPTransport; vendor=Sun Microsystems, Inc;
protocol=smtps; type=transport;class=com.sun.mail.smtp.SMTPSSLTransport; vendor=Sun Microsystems, Inc;
# JavaMail POP3 provider Sun Microsystems, Inc
protocol=pop3; type=store; class=com.sun.mail.pop3.POP3Store; vendor=Sun Microsystems, Inc;
protocol=pop3s; type=store; class=com.sun.mail.pop3.POP3SSLStore; vendor=Sun Microsystems, Inc;
这个配置文件提供了以下四个方面的信息：
protocol：协议名称；
type：协议类型；
class：对应该操作类型的实现类；
vendor：厂商名称。
Session在加载配置文件时会按照以下优先级顺序进行：
1）首先使用<JAVA_HOME>/lib中的javamail.providers；
2）如果1）不存在相应的配置文件，使用类路径下mail.jar中META-INF目录下的javamail.providers；
3）如果2）不存在相应的配置文件，使用类路径下的mail.jar中META-INF目录下的javamail.default.providers；
所以开发者可以在<JAVA_HOME>/lib目录下提供配置文件覆盖mail.jar/META-INF目录中厂商的配置。但是，一般情况下，我们无须这样做。
Session通过JavaMail配置文件以及程序中设置的Properties对象构建一个邮件处理环境，后续的处理将在Session基础上进行。Session拥有多个静态工厂方法用于创建Session实例。
lstatic Session getDefaultInstance(Properties props, Authenticator authenticator)：当JVM中已经存在默认的Session实例中，直接返回这个实例，否则创建一个新的Session实例，并将其作为JVM中默认Session实例。这个API很诡异，我们将对它进行详细的讲解。由于这个默认Session实例可以被同一个JVM所有的代码访问到，而Session中本身又可能包括密码、用户名等敏感信息在内的所有属性信息，所以后续调用也必须传入和第一次相同的Authenticator实例，否则将抛出java.lang.SecurityException异常。如果第一次调用时Authenticator入参为null，则后续调用通过null的Authenticator入参或直接使用getDefaultInstance(Properties props)即可返回这个默认的Session实例。值得一提的是，虽然后续调用也会传入Properties，但新属性并不会起作用，如果希望采用新的属性值，则可以通过getDefaultInstance(Properties props)创建一个新的Session实例达到目的。Authenticator在这里承当了两个功能：首先，对JVM中默认Session实例进行认证保护，后续调用执行getDefaultInstance(Properties props, Authenticator authenticator)方法时必须和第一次一样；其次，在具体和邮件服务器交互时，又作为认证的信息；
lstatic Session getDefaultInstance(Properties props)：返回JVM中默认的Session实例，如果第一次创建Session未指定Authenticator入参，后续调用可以使用该访问获取Session;
lstatic Session getInstance(Properties props, Authenticator authenticator)：创建一个新的Session实例，它不会在JVM中被作为默认实例共享；
lstatic Session getInstance(Properties props)：根据相关属性创建一个新的Session实例，未使用安全认证信息；
Session是JavaMail提供者配置文件以及设置属性信息的“容器”，Session本身不会和邮件服务器进行任何的通信。所以在一般情况下，我们仅需要通过getDefaultInstance()获取一个共享的Session实例就可以了，下面的代码创建了一个Session实例：
Properties props = System.getProperties();
props.setProperty("mail.transport.protocol", "smtp");…
Session session = Session.getDefaultInstance(props);
Transport和Store：传输和存储
邮件操作只有发送或接收两种处理方式，JavaMail将这两种不同操作描述为传输（javax.mail.Transport）和存储（javax.mail.Store），传输对应邮件的发送，而存储对应邮件的接收。
Session提供了几个用于创建Transport和Store实例的方法，在具体讲解这些方法之前，我们事先了解一下Session创建Transport和Store的内部机制。我们知道提供者在javamail.providers配置文件中为每一种支持的邮件协议定义了实现类，Session根据协议类型（stmp、pop3等）和邮件操作方式（传输和存储）这两个信息就可以定位到一个实例类上。比如，指定stmp协议和transport类型后，Session就会使用com.sun.mail.smtp.SMTPTransport实现类创建一个Transport实例，而指定pop3协议和store类型时，则会使用com.sun.mail.pop3.POP3Store实例类创建一个Store实例。Session提供了多个重载的getTransport()和getStore()方法，这些方法将根据Session中Properties属性设置情况进行工作，影响这两套方法工作的属性包括：
| 属性名 | 说明 |
| mail.transport.protocol | 默认的邮件传输协议，例如，smtp |
| mail.store.protocol | 默认的存储邮件协议，例如：pop3 |
| mail.host | 默认的邮件服务地址，例如：192.168.67.1 |
| mail.user | 默认的登陆用户名，例如：zapldy |
下面，我们再回头来了解Session的getTransport()和getStore()的重载方法。
lTransport getTransport()：当Session实例设置了mail.transport.protocol属性时，该方法返回对应的Transport实例，否则抛出javax.mail.NoSuchProviderException。
lTransport getTransport(String protocol)：如果Session没有设置mail.transport.protocol属性，可以通过该方法返回指定类型的Transport，如transport = session.getTransport(“smtp”)。
如果Session中未包含Authenticator，以上两方法创建的Transport实例和邮件服务器交互时必须显示提供用户名/密码的认证信息。如果Authenticator非空，则可以在和邮件服务器交互时被作为认证信息使用。除了以上两种提供认证信息的方式外，Session还可以使用以下的方法为Transport提供认证信息。
Transport getTransport(URLName url)：用户可以通过URLName入参指定邮件协议、邮件服务器、端口、用户名和密码信息，请看下面的代码：
URLName urln = new URLName(“smtp”, “smtp.sina.com.cn”, 25, null, “masterspring2”, “spring”);
Transport transport = session.getTransport(urln);
这里，指定了邮件协议为smtp，邮件服务器是smtp.sina.com.cn，端口为25，用户名/密码为masterspring2/spring。
消息发送的最后一部分是使用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)设置调试标志。
用Session获取消息与发送消息开始很相似。但是，在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();看上去是个很慢的操作，它从服务器上读取每一条消息，但仅在你实际需要消息的一部分时，消息的内容才会被检索。
一旦有了要读的Message，您可以用getContent()来获取其内容，或者用writeTo()将内容写入流。getContent()方法只能得到消息内容，而writeTo()的输出却包含消息头。
System.out.println(((MimeMessage)message).getContent());
一旦读完邮件，要关闭与folder和store的连接。
folder.close(aBoolean);
store.close();
传递给folder的close()方法的boolean表示是否清除已删除的消息从而更新folder。
Message：消息对象
一旦获得Session对象，就可以继续创建要发送的消息。这由Message类来完成。因为Message是个抽象类，您必需用一个子类，多数情况下为javax.mail.internet.MimeMessage。MimeMessage是个能理解MIME类型和头的电子邮件消息，正如不同RFC中所定义的。虽然在某些头部域非ASCII字符也能被译码，但Message头只能被限制为用US-ASCII字符。
要创建一个Message，请将Session对象传递给MimeMessage构造器：
MimeMessage message = new MimeMessage(session);
注意：还存在其它构造器，如用按RFC822格式的输入流来创建消息。
一旦获得消息，您就可以设置各个部分，因为Message实现Part接口（且MimeMessage实现MimePart）。设置内容的基本机制是setContent()方法，同时使用参数，分别代表内容和mime类型：
message.setContent("Hello", "text/plain");
但如果，您知道您在使用MimeMessage，而且消息是纯文本格式，您就可以用setText()方法，它只需要代表实际内容的参数，（MIME类型缺省为text/plain）：
message.setText("Hello");
后一种格式是设置纯文本消息内容的首选机制。至于发送其它类型的消息，如HTML文件格式的消息，我们首选前者。
用setSubject()方法设置subject（主题）：
message.setSubject("First");
下面的代码演示了创建一个简单邮件信息的过程：
Messagemsg =newMimeMessage(session);
msg.setSubject("Test Title");
msg.setText("How are you!");
msg.setSentDate(newDate());
Address：地址
一旦您创建了Session和Message，并将内容填入消息后，就可以用Address确定信件地址了。和Message一样，Address也是个抽象类。您用的是javax.mail.internet.InternetAddress类。
若创建的地址只包含电子邮件地址，只要传递电子邮件地址到构造器就行了。
Address address = new InternetAddress("president@whitehouse.gov");
若希望名字紧挨着电子邮件显示，也可以把它传递给构造器：
Address address = new InternetAddress("president@whitehouse.gov", "George Bush");
需要为消息的from域和to域创建地址对象。除非邮件服务器阻止，没什么能阻止你发送一段看上去是来自任何人的消息。
一旦创建了address（地址），将它们与消息连接的方法有两种。如果要识别发件人，您可以用setFrom()和setReplyTo()方法。
message.setFrom(address)
需要消息显示多个from地址，可以使用addFrom()方法：
Address address[] = ...;
message.addFrom(address);
若要识别消息recipient（收件人），您可以使用addRecipient()方法。除address（地址）外，这一方法还请求一个Message.RecipientType。
message.addRecipient(type, address)
三种预定义的地址类型是：
Message.RecipientType.TO
Message.RecipientType.CC
Message.RecipientType.BCC
如果消息是发给副总统的，同时发送一个副本(carbon copy)给总统夫人，以下做法比较恰当：
Address toAddress = new InternetAddress("vice.president@whitehouse.gov");
Address ccAddress = new InternetAddress("first.lady@whitehouse.gov");
message.addRecipient(Message.RecipientType.TO, toAddress);
message.addRecipient(Message.RecipientType.CC, ccAddress);
JavaMail API没有提供电子邮件地址有效性核查机制。虽然通过编程，自己能够扫描有效字符（如RFC 822中定义的）或验证邮件交换（mail exchange，MX）记录，但这些功能不属于JavaMail API。
Authenticator：认证者
与java.net类一样，JavaMail API也可以利用Authenticator通过用户名和密码访问受保护的资源。对于JavaMail API来说，这些资源就是邮件服务器。JavaMail Authenticator在javax.mail包中，而且它和java.net中同名的类Authenticator不同。两者并不共享同一个Authenticator，因为JavaMail API用于Java 1.1，它没有java.net类别。
要使用Authenticator，先创建一个抽象类的子类，并从getPasswordAuthentication()方法中返回PasswordAuthentication实例。创建完成后，您必需向session注册Authenticator。然后，在需要认证的时候，就会通知Authenticator。您可以弹出窗口，也可以从配置文件中（虽然没有加密是不安全的）读取用户名和密码，将它们作为PasswordAuthentication对象返回给调用程序。
Properties props = new Properties();
// fill props with any information
Authenticator auth = new MyAuthenticator();
Session session = Session.getDefaultInstance(props, auth);
发送消息：
发送电子邮件消息这一过程包括获取一个会话，创建并填充一则消息，然后发送。得到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程序块中，这样创建和发送消息时就能够抛出异常。
消息的提取：
为读邮件，您获取一个会话，获取并连接一个用于邮箱的适宜的存储（store），打开适宜的文件夹，然后获取您的消息。同样，切记完成后关闭连接。
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();
对每条消息做些什么由您决定。上面的代码块只是显示这些消息的发件人和主题。技术上讲，from地址列表可能为空，而getFrom()[0]调用会抛出一个异常。
要显示全部信息，您可以在用户看完from和subject域之后给出提示，如用户有需要，就调用消息的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;
}
}
消息和标识的删除：
消息的删除涉及使用与消息相关的Flags（标志）。不同flag对应不同的状态，有些由系统定义而有些则由用户定义。下面列出在内部类Flags.Flag中预定义的标志：
* Flags.Flag.ANSWERED
* Flags.Flag.DELETED
* Flags.Flag.DRAFT
* Flags.Flag.FLAGGED
* Flags.Flag.RECENT
* Flags.Flag.SEEN
* Flags.Flag.USER
仅仅因为存在一个标志，并不意味着所有邮件服务器或供应商都支持这个标志。例如，除了删除消息标志外，POP协议不再支持其它任何标志。检查是否存在新邮件，这不是个POP任务，而是内建于邮件客户机的任务。为找出哪些标志能被支持，可以用getPermanentFlags()向folder提出要求。
要删除消息，您可以设置消息的DELETED flag：
message.setFlag(Flags.Flag.DELETED, true);
首先，请以READ_WRITE模式打开folder：
folder.open(Folder.READ_WRITE);
然后，当所有消息的处理完成后，关闭folder，并传递一个true值，从而擦除（expunge）有delete标志的消息。
folder.close(true);
一个Folder的expunge()方法可以用来删除消息。但Sun的POP3供应商不支持。其它供应商有的或许能够实现这一功能，而有的则不能。IMAP供应商极有可能实现此功能。因为POP只支持单个对邮箱的访问，对Sun的供应商来说，您必需关闭folder以删除消息。
要取消标志，只要传递false给setFlag()方法就行了。想知道是否设置过标志，可以用isSet()检查。
亲自认证：
您已经知道—如果需要可以用一个Authenticator提示用户输入用户名和密码，而不是将用户名和密码作为字符串传递。在这里您会明确了解怎样更充分的使用认证。
不用主机、用户名和密码与Store相连接，而是设置Properties来拥有主机，然后告诉Session自定义的Authenticator实例，如下所示：
// Setup properties
Properties props = System.getProperties();
props.put("mail.pop3.host", host);
// Setup authentication, get session
Authenticator auth = new PopupAuthenticator();
Session session = Session.getDefaultInstance(props, auth);
// Get the store
Store store = session.getStore("pop3");
store.connect();
然后，您创建一个Authenticator子类并从getPasswordAuthentication()方法中返回PasswordAuthentication对象。下面就是这样一种实现，其中用户名和密码仅占用一个域。（这不是一个Swing工程教程；只要将两部分输入同一个域，用逗号分隔就行。）
import javax.mail.*;
import javax.swing.*;
import java.util.*;
public class PopupAuthenticator extends Authenticator {
public PasswordAuthentication getPasswordAuthentication() {
String username, password;
String result = JOptionPane.showInputDialog(
"Enter 'username,password'");
StringTokenizer st = new StringTokenizer(result, ",");
username = st.nextToken();
password = st.nextToken();
return new PasswordAuthentication(username, password);
}
}
因为PopupAuthenticator涉及到Swing，它会启动AWT的事件处理线程。这一点基本上要求您在代码中添加一个对System.exit()的调用来终止程序。
消息的回复：
Message类引入一个reply()方法来配置一个新Message，包括正确的recipient（收件人）和添加“Re”（如果没有就添加）的正确的subject。这样做并没有为消息添加新内容，仅仅将from或reply-to（被回复人）头复制给新的收件人。这种方法用一个boolean参数指定消息只回复给发件人（false）或回复给全体（true）。
MimeMessage reply = (MimeMessage)message.reply(false);
reply.setFrom(new InternetAddress("president@whitehouse.gov"));
reply.setText("Thanks");
Transport.send(reply);
在发送消息时要配置reply to（被回复人）地址，可以用setReplyTo()方法。
消息的转发：
转发消息有一点棘手。没有单独的方法可以调用，您通过对组成消息各部分的处理来组织要转发的消息。
一条邮件消息可以由多个部分组成。在处理MIME消息时，消息中每部分都是BodyPart，再特殊些，是MimeBodyPart。不同的body part（信体部件或正文部件）结合成一个容器，名为Multipart，再特殊些，就是MimeMultipart。要转发一条消息，您为自己的消息正文创建一个部件，要转发的消息作为另一部件。并且将两个部件结合成一个multipart（多部件）。然后您将这个multipart添加到一则已写好恰当地址的消息中，并发送。
本质上就是如此。要将一条消息内容复制到另一条，只要复制DataHandler（JavaBeans Activation Framework中的类）就行了。
// Create the message to forward
Message forward = new MimeMessage(session);
// Fill in header
forward.setSubject("Fwd: " + message.getSubject());
forward.setFrom(new InternetAddress(from));
forward.addRecipient(Message.RecipientType.TO,
new InternetAddress(to));
// Create your new message part
BodyPart messageBodyPart = new MimeBodyPart();
messageBodyPart.setText(
"Here you go with the original message:/n/n");
// Create a multi-part to combine the parts
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(messageBodyPart);
// Create and fill part for the forwarded content
messageBodyPart = new MimeBodyPart();
messageBodyPart.setDataHandler(message.getDataHandler());
// Add part to multi part
multipart.addBodyPart(messageBodyPart);
// Associate multi-part with message
forward.setContent(multipart);
// Send message
Transport.send(forward);
附件的处理：
附件是邮件消息的相关资源，如通常不包含在消息正文里文本文件、电子表格或图像等。常见的邮件程序，如Eudora和pine之类，可以用JavaMail API将资源attach（附加）到您的消息上，就可以在收到消息时得到。
附件的发送：
发送附件非常像转发消息。您建立各部分以组成完整消息。完成第一部件，即消息正文后，您添加其它部件，其中每个DataHandler都代表附件，而不是转发消息情况下的共享处理程序。如果从文件中读附件，附件的数据源是FileDataSource。而如果从URL中读时，附件的数据源是URLDataSource。一旦存在DataSource，只要先把它传递给DataHandler构造器，最后再用setDataHandler()把它附加到BodyPart。假定您要保留附件的原始文件名，最终要做的是用BodyPart的setFileName()方法设置与附件相关的文件名。如下所示：
// Define message
Message 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
BodyPart messageBodyPart = new MimeBodyPart();
// Fill the message
messageBodyPart.setText("Pardon Ideas");
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(messageBodyPart);
// Part two is attachment
messageBodyPart = new MimeBodyPart();
DataSource source = new FileDataSource(filename);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(filename);
multipart.addBodyPart(messageBodyPart);
// Put parts in message
message.setContent(multipart);
// Send the message
Transport.send(message);
就消息引入附件时，若程序是个servlet（小服务程序），除告知消息发送到何处外，还必需上载附件。可以将multipart/form-data表单编码类型（form encoding type）用于每个上载文件的处理。
<FORM ENCTYPE="multipart/form-data"
method=post action="/myservlet">
<INPUT TYPE="file" NAME="thefile">
<INPUT TYPE="submit" VALUE="Upload">
</FORM>
注意：消息大小由SMTP服务器而不是JavaMail API来限制。如果您碰到问题，可以考虑用设置ms和mx参数的方法增大Java堆大小。
附件的获取：
从消息中获取附件比发送它们棘手些，因为MIME没有简单的关于附件的概念。当消息包含附件时，消息的内容是个Multipart对象。接着，您需要处理每个Part，获取主要内容和附件。标有从part.getDisposition()获得的Part.ATTACHMENT配置（disposition）的部件（Part）无疑就是附件。但是，没有配置（以及一个非文本MIME类型）和带Part.INLINE配置的部件也可能是附件。当配置要么是Part.ATTACHMENT，要么是Part.INLINE时，这个消息部件的内容就能被保存。只要用getFileName()和getInputStream()就能分别得到原始文件名和输入流。
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());
}
}
saveFile()方法仅依据文件名创建了一个File，它从输入流中将字节读出，然后写入到文件中。万一文件已经存在，就在文件名后添加一个数字作为新文件名，如果这个文件名仍存在，则继续添，直到找不到这样的文件名为止。
// from saveFile()
File file = new File(filename);
for (int i=0; file.exists(); i++) {
file = new File(filename+i);
}
上面的代码涵盖了最简单的情况—消息中各部件恰当的标记了。要涵盖所有情况，还要在配置为空时进行处理，并且获取部件的MIME类型来进行相应处理。
if (disposition == null) {
// Check if plain
MimeBodyPart mbp = (MimeBodyPart)part;
if (mbp.isMimeType("text/plain")) {
// Handle plain
} else {
// Special non-attachment cases here of image/gif, text/html, ...
}
...
}
对HTML消息的处理
发送基于HTML文件格式消息的工作量比发送纯文本消息多，虽然不一定非要这些多余的工作量。如何选择完全取决于给定的请求。
HTML消息的发送：
若您所要做的全部事情是发送一份HTML文件的等价物作为消息，但让邮件阅读者为不能提取任何内嵌图像或相关片段而担心的话，可以使用Message的setContent()方法，把内容当作一个String传入，并将内容类型设置成text/html。
String htmlText = "<H1>Hello</H1>" +
"<img src=/"http://www.jguru.com/images/logo.gif/">";
message.setContent(htmlText, "text/html"));
在接收端，如果您用JavaMail API提取消息，API中没有内建的显示HTML消息的东西。JavaMail API只把它看成一串字节流。要显示HTML文件格式的消息，您必需使用Swing JEditorPane或其它第三方HTML格式查看器组件。
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();
}
在消息中引入图像：
另一方面，如果您想让HTML文件格式内容的消息完整（内嵌的图像作为消息的一部分），您必需把图像作为附件，并且用一个给定的cid URL引用图像，其中cid是图像附件Content-ID头的引用。
嵌入图像的过程与附加文件到消息的过程非常相似，唯一的区别在于您必需通过设置MimeMultipart构造器中的子类型（或者说用setSubType()）告知MimeMultipart各个相关部件，并且将这个图像的Content-ID头设置成随机字符串，作为图像的src在img标记中使用。完整的演示如下。
String file = ...;
// Create the message
Message message = new MimeMessage(session);
// Fill its headers
message.setSubject("Embedded Image");
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO,
new InternetAddress(to));
// Create your new message part
BodyPart messageBodyPart = new MimeBodyPart();
String htmlText = "<H1>Hello</H1>" +
"<img src=/"cid:memememe/">";
messageBodyPart.setContent(htmlText, "text/html");
// Create a related multi-part to combine the parts
MimeMultipart multipart = new MimeMultipart("related");
multipart.addBodyPart(messageBodyPart);
// Create part for the image
messageBodyPart = new MimeBodyPart();
// Fetch the image and associate to part
DataSource fds = new FileDataSource(file);
messageBodyPart.setDataHandler(new DataHandler(fds));
messageBodyPart.setHeader("Content-ID","memememe");
// Add part to multi-part
multipart.addBodyPart(messageBodyPart);
// Associate multi-part with message
message.setContent(multipart);
784
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
