IDC资讯中心
摘要
这篇文章介绍创建基于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:appsjavajavamail-1.2mail.jar;c:appsjava
javamail-1.2mailapi.jar;c:appsjavajavamail-1.2
pop3.jar;c:appsjavajavamail-1.2smtp.jar;c:apps
javajaf-1.0.1activation.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 bill@lotontech.com
ben@lotontech.com “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的环境下为你介绍这个概念。
通过pop3接受email
在前面，我介绍了由javax.mail.message实现的javax.mail.part接口。我现在将解释它的消息部分，它在这个例子中很重要。我们先看图３。
图3 mail.part接口的uml图
图３表示在前面例子中建立的一个message，它既可以是一个消息，也可以是一个消息部分，因为它实现了part接口。对于任何部分，你都能得到它的内容（任何java对象），并且在发送的是一个简单文本消息的情况下，内容对象可能是一个string。对于多部分消息，内容可能是类型multipart，由此我们可以得到单独的正文部分，它本身就实现了part接口
实际上，当你看过simplereceiver类的代码之后，你会发现一切都变得很明朗。我们用三部分内容来介绍simplereceiver类：第一部分，类的定义以及从命令行获取连接细节信息的main()方法；第二部分，捕获和查看进来消息的receive()方法；第三部分，打印头信息和每个消息内容的printmessage()方法。
下面是第一部分：
package com.lotontech.mail;
import javax.mail.*;
import javax.mail.internet.*;
import java.util.*;
import java.io.*;
/**
* a simple email receiver class.
*/
public class simplereceiver
{
/**
* main method to receive messages from the mail server specified
* as command line arguments.
*/
public static void main(string args[])
{
try
{
string popserver=args[0];
string popuser=args[1];
string poppassword=args[2];
receive(popserver, popuser, poppassword);
}
catch (exception ex)
{
system.out.println(“usage: java com.lotontech.mail.simplereceiver”
+” popserver popuser poppassword”);
}
system.exit(0);
}
现在我们使用命令行来运行它（记住用你的email设置替换命令行参数）：
java com.lotontech.mail.simplereceiver pop.myisp.net myusername mypassword
receive()方法从main()方法中调用，它依次打开你的pop3信箱检查消息，每次都调用printmessage()。代码如下：
/**
* “receive” method to fetch messages and process them.
*/
public static void receive(string popserver, string popuser
, string poppassword)
{
store store=null;
folder folder=null;
try
{
// — get hold of the default session —
properties props = system.getproperties();
session session = session.getdefaultinstance(props, null);
// — get hold of a pop3 message store, and connect to it —
store = session.getstore(“pop3”);
store.connect(popserver, popuser, poppassword);
// — try to get hold of the default folder —
folder = store.getdefaultfolder();
if (folder == null) throw new exception(“no default folder”);
// — …and its inbox —
folder = folder.getfolder(“inbox”);
if (folder == null) throw new exception(“no pop3 inbox”);
// — open the folder for read only —
folder.open(folder.read_only);
// — get the message wrappers and process them —
message[] msgs = folder.getmessages();
for (int msgnum = 0; msgnum < msgs.length; msgnum++)
{
printmessage(msgs[msgnum]);
}
}
catch (exception ex)
{
ex.printstacktrace();
}
finally
{
// — close down nicely —
try
{
if (folder!=null) folder.close(false);
if (store!=null) store.close();
}
catch (exception ex2) {ex2.printstacktrace();}
}
}
请注意：你从session中得到一个pop3消息存储封装器，然后使用最初在命令行上键入的mail设置跟它连接。
一旦连接成功，你就得到了一个默认文件夹的句柄，在这里使用的是inbox文件夹，它保存了进来的消息。你可以打开这个只读的inbox信箱，然后一个一个的读取消息。
另外，你可能想知道是否你能够以写的方式打开这个inbox信箱。如果你想为这些消息做标记或者从服务器上删除，你可以做得到。不过在我们的这个例子中，你只能查看消息。
最后，在上面的代码中，你做到了当查看完毕后关闭文件夹以及消息存储，然后留下printmessage()方法来完成这个类的剩余部分。
打印消息
在这一部分，很有必要讨论前面提到的javax.mail.part接口。
下面的代码让你明白怎样隐含地把消息转换为它的part接口并且把它赋给messagepart变量。对于只有一部分的消息，你现在需要打印一些信息。
假如调用messagepart.getcontent()来生成一个multipart实例，你知道你正在处理一个多部分消息；在这种情况下，你正在通过getbodypart(0)来得到第一个多部分消息并且打印它。
当然你还要知道是否你已经得到了这个消息本身，还是仅仅是消息正文的第一部份。只有当内容是普通文本或者html时，你才可以打印该消息，这是通过一个inputstream来完成的。
/**
* “printmessage()” method to print a message.
*/
public static void printmessage(message message)
{
try
{
// get the header information
string from=((internetaddress)message.getfrom()[0]).getpersonal();
if (from==null) from=((internetaddress)message.getfrom()[0])
.getaddress();
system.out.println(“from: “+from);
string subject=message.getsubject();
system.out.println(“subject: “+subject);
// — get the message part (i.e. the message itself) —
part messagepart=message;
object content=messagepart.getcontent();
// — or its first body part if it is a multipart message —
if (content instanceof multipart)
{
messagepart=((multipart)content).getbodypart(0);
system.out.println(“[ multipart message ]”);
}
// — get the content type —
string contenttype=messagepart.getcontenttype();
// — if the content is plain text, we can print it —
system.out.println(“content:”+contenttype);
if (contenttype.startswith(“text/plain”)|| contenttype.startswith(“text/html”))
{
inputstream is = messagepart.getinputstream();
bufferedreader reader=new bufferedreader(new inputstreamreader(is));
string thisline=reader.readline();
while (thisline!=null)
{
system.out.println(thisline);
thisline=reader.readline();
}
}
system.out.println(“—————————–“);
}
catch (exception ex)
{
ex.printstacktrace();
}
}
}
为了简单起见，我假设消息本身或者消息正文的第一部份是可以打印的。对于真正的应用软件，可能你想要依次检查消息正文的每一部分，并且对每一部分采取相应的行动－打印或者是保存到磁盘，这取决于内容的类型。
当你从消息存储中得到每个消息时，你实际上已经得到了一个轻量级的封装器。数据内容的获取是每申请一次就读取一次－这对于你只想下载消息头时很有用。
simplereceiver测试
让我们对simplereceiver做一次测试。为了让它有东西可以接收，我发送图４所示的消息（注意：消息由文本和一个附件组成）
图4 用于simplereceiver的测试消息
一旦接收到消息，就把该消息认为是一个多部分消息。打印的文本如下：
from: tony loton
subject: number 1
[ multipart message ]
content:text/plain;
charset=”iso-8859-1″
attachment 1
from tony loton.
—————————–
把你的消息送出去
为了有趣一点，并且说明javamail apis的一个新颖的用法，我现在简要介绍一下我的谈话email项目。在做这个试验之前你需要得到lotontalk.jar文件，并把它加到你的classpath中去，添加方法如下：
set classpath=%classpath%;lotontalk.jar
你也需要在simplereceiver类中两个地方做代码修改。首先在receive()方法里面，把以下代码：
// — get the message wrappers and process them —
message[] msgs = folder.getmessages();
for (int msgnum = 0; msgnum < msgs.length; msgnum++)
{
printmessage(msgs[msgnum]);
}
替换为：
// — get the message wrappers and process them —
message[] msgs = folder.getmessages();
for (int msgnum = 0; msgnum < msgs.length; msgnum++)
{
printmessage(msgs[msgnum]);
speakmessage(msgs[msgnum]);
}
现在增加以下的新方法speakmessage()，它与最初的printmessage()方法相似。
/**
* “speakmessage”, a talking version of printmessage().
*/
public static void speakmessage(message message)
{
string speech=””;
try
{
com.lotontech.talk.lotontalk speaker=new com.lotontech.talk.lotontalk();
string from=((internetaddress)message.getfrom()[0]).getpersonal();
if (from==null) from=((internetaddress)message.getfrom()[0]).getaddress();
speech=speech+”from “+from+”, “;
string subject=message.getsubject();
speech=speech+”subject “+subject+”, “;
// — get the message part (i.e., the message itself) —
part messagepart=message;
object content=messagepart.getcontent();
// — …or its first body part if it is a multipart message —
if (content instanceof multipart)
messagepart=((multipart)content).getbodypart(0);
string contenttype=messagepart.getcontenttype();
if (contenttype.startswith(“text/plain”)|| contenttype.startswith(“text/html”))
{
inputstream is = messagepart.getinputstream();
bufferedreader reader=new bufferedreader(new inputstreamreader(is));
string thisline=reader.readline();
while (thisline!=null)
{
speech=speech+thisline+”. “;
thisline=reader.readline();
}
// — speak —
speaker.speak(speech,true);
}
}
catch (exception ex)
{
ex.printstacktrace();
}
}
因为在说话之前，你正在把整个消息积累到一个字符串中，所以这个方案可能只适合小的消息。作为一种选择，你可以读一行然后再讲一行。
当然，我不可能把结果显示给你看，因此你必须亲自来做实验。
你还可以做一些小的试验，当然不是在这个试验中，来发现语音合成的一些有趣的特征：怎样处理数字，以及怎样把全部大些的单词假想成只取首字母的缩写词，然后一个一个字母地把它们拼出来。
结论
我们已经通过对发送和接收email消息的应用程序的各个基本构造块分别讲解，涉及到了收发email的方方面面。如果你是第一次接触javamail，是不是发现在应用程序中收发email不是一件困难的事情。
