JavaMail快速入门1

原文：http://www.javazy.com/contentex/2005622172018.shtml
这篇文章介绍创建基于Java的email应用程序入门知识。假如你想创建你自己的email客户端应用程序来代替 Microsoft　Outlook，或者创建一个基于Web的email系统来跟Hotmail叫板，那么你可以从这里开始。从JavaMail的一个 不同角度出发，该文给出了一个谈话email客户端应用程序。

　　在JavaMail中，你可以找到API以及其实现部分，从而用它开发 功能全面的email客户端应用程序。“email客户端应用程序”引用了Microsoft　Outlook的思想；然而，你可以写你自己的 Outlook来取而代之。但是，一个email客户端程序不一定要驻留在一个客户端机器上。事实上，它可以是一个在远程服务器上运行的一个 servlet或者EJB，终端用户通过Web浏览器可以收发他们的email。在作者自己的宠物项目中，就使用了一个语音客户端来读取接收进来的消息。 它是作者在“Talking Java!”中介绍的想法（在后面将有更多的介绍）的提炼。

　　现在开始安装和配置Javamail软件。

　　安装

　 　如果你使用的是Java２企业版（J2EE）１.3，那么它已经自带有JavaMail，因此不需要进行额外的安装。但是如果你使用的是Java２标准 版（J2SE）1.1.7及以后的版本，那么如果想要你的应用程序具备收发email的能力，下载并安装以下两个应用程序：

　　l、JavaMail

　　2、JavaBeans Activation Framework

　　安装很简单，只需解压下载的文件，并把所包含的jar文件添加到你机器的classpath下，以下是作者机器上的classpath：

;C:/Apps/Java/javamail-1.2/mail.jar;C:/Apps/Java

/javamail-1.2/mailapi.jar;C:/Apps/Java/javamail-1.2

/pop3.jar;C:/Apps/Java/javamail-1.2/smtp.jar;C:/Apps

/Java/jaf-1.0.1/activation.jar
　 　mailapi.jar文件包含核心ＡＰＩ类，而pop3.jar和smtp.jar文件包含各自的email协议实现部分。（在这篇文章中我们不使用 imap.jar文件）。可以认为实现部分跟JDBC（Java数据库连接）驱动程序相似，不过它是用于消息系统而不是用于数据库而已。至于 mail.jar文件，它包含了上面的每一个jar文件，因此，你可以在你的classpath中只包含mail.jar和activation.jar 文件。

　　Activation.jar文件允许你通过二进制数据流的形式处理MIME类型的访问。在后面“不仅仅可以发送普通文本”这一部分会讲到DataHandler类，你可以在那找到相关信息。

　　至于记录，本文的余下部分没有对API做全面的讲解；不过你可以学着去做一做。如果你想更多的了解API信息，你可以查看每个下载包中的ＰＤＦ文件以及Javadoc。

　 　一旦你已经安装了这个软件，那么你需要知道你的email帐户情况以便运行下面的这个例子。你需要知道你的ISP的SMTP服务器名和POP服务器名， 你的email帐户登录名以及你的邮箱密码。图１表示的是作者在Microsoft　Outlook中使用的详细情况：
　　通过SMTP发送email

　　第一个例子告诉你怎样通过SMTP发送一个基本的email消息。在下面，你将找到SimpleSender类，它从命令行读取你的消息，然后调用一个单独的方法send(…)来发送它们：

package com.lotontech.mail;

import javax.mail.*;

import javax.mail.internet.*;

import java.util.*;

/**

* A simple email sender class.

*/

public class SimpleSender

{

　/**

　　* Main method to send a message given on the command line.

　*/

　public static void main(String args[])

　{

　　try

　　{

　　　String smtpServer=args[0];

　　　String to=args[1];

　　　String from=args[2];

　　　String subject=args[3];

　　　String body=args[4];

　　　send(smtpServer, to, from, subject, body);

　　}

　　catch (Exception ex)

　　{

　　　System.out.println("Usage: java com.lotontech.mail.SimpleSender"

　　　　　　　+" smtpServer toAddress fromAddress subjectText bodyText");

　　}

　　System.exit(0);

　}
　　下一步，如下所示运行SimpleSender，用你自己的SMTP替换你email设置中的smtp.myISP.net：

　　java com.lotontech.mail.SimpleSender smtp.myISP.net [e-mail] [e-mail] "Hello" "Just to say Hello."

　　如果它能正常工作起来的话，在接收端你将看到如图２所示的内容


　　　　　图2　从SimpleSender读取的消息
　　SimpleSender类主要由Send(…)方法完成。其代码如下：

/**

* "send" method to send the message.

*/

public static void send(String smtpServer, String to, String from

, String subject, String body)

　{

　　try

　　{

　　　Properties props = System.getProperties();

　　　// -- Attaching to default Session, or we could start a new one --

　　　props.put("mail.smtp.host", smtpServer);

　　　Session session = Session.getDefaultInstance(props, null);

　　　// -- Create a new message --

　　　Message msg = new MimeMessage(session);

　　　// -- Set the FROM and TO fields --

　　　msg.setFrom(new InternetAddress(from));

　　　msg.setRecipients(Message.RecipientType.TO,

　　　InternetAddress.parse(to, false));

　　　// -- We could include CC recipients too --

　　　// if (cc != null)

　　　// msg.setRecipients(Message.RecipientType.CC

　　　// ,InternetAddress.parse(cc, false));

　　　// -- Set the subject and body text --

　　　msg.setSubject(subject);

　　　msg.setText(body);

　　　// -- Set some other header information --

　　　msg.setHeader("X-Mailer", "LOTONtechEmail");

　　　msg.setSentDate(new Date());

　　　// -- Send the message --

　　　Transport.send(msg);

　　　System.out.println("Message sent OK.");

　　}

　　catch (Exception ex)

　　{

　　　ex.printStackTrace();

　　}

　}

　}
　
　 　首先，请注意，你得到一个emailsession（java.mail.Session），没有它你什么都做不了。在这个案例中，你调用了 Sesion.getDefultInstance(…)来得到一个共享session，其它的桌面应用程序也可以使用它；你也可以通过 Session.getInstance(…)方法建立一个新的session，它对于你的应用程序来说是唯一的。然后我们能够证明email客户端应用 程序对每个用户来说，其使用方法都是一样的，比如它可以是一个用servlet实现的基于Web的email系统。

　　建立一个session需要设置一些属性；如果你通过SMTP发送消息，那么至少需要设置mail.smtp.host属性。在API文档中你可以找到其它的属性。

　　现在你有了一个session，创建了一个消息。在这个例子中，你就可以设置email地址信息、主题、正文了，所有这些都取自于命令行。你也可以设置一些头信息，包括日期等，并且你还可以指定复制（CC）的收件人。

　　最后，你通过javax.mail.Transport类发送消息。如果你想知道我们的emailsession，请看后面的消息构造器。
　　不仅仅可以发送普通文本

　　javax.mail.Message（继承javax.mail.Part接口）类中的setText(…)方法把消息内容赋给所提供的字符串，把MIME设置为text/plain。

　　但是，你不仅仅可以发送普通文本，你还可以通过setDateHandler(…)方法发送其它类型的内容。在大多数情况下，你能通过采用“其它类型内容”来指定文件附件，比如Word文档，但是有趣的是，你检查这里的代码发现它发送一个Java序列化的对象：

ByteArrayOutputStream byteStream=new ByteArrayOutputStream();

ObjectOutputStream objectStream=new ObjectOutputStream(byteStream);

objectStream.writeObject(theObject);

msg.setDataHandler(new DataHandler( new ByteArrayDataSource( byteStream.toByteArray(), "lotontech/javaobject" )));
　 　在javax.mail.*包结构中你可能找不到DataHandler类，因为它属于JavaBeans Activation Framework (JAF)的javax.activation包。JAF提供处理数据内容类型的机制，这种机制主要是针对Internet内容而言，也即MIME类型。

　 　假如你已经试验过了以上的代码，通过email来发送一个Java对象，你可能碰到定位ByteArrayDataSource类的问题，因为要么是 mail.jar要么是activation.jar未被包含在程序里面。可以到JavaMail　demo目录下去查找一下。

　　至于 你一开始就感兴趣的附件，你可以在DataHandler的构造器中建立一个javax.activation.FileDataSource实例来实 现。当然，你不可能单独发送一个文件；它可以作为一个文本消息的附件发送。可能你需要理解多部分消息的概念，现在，我在接收email的环境下为你介绍这 个概念。