摘要
这篇文章介绍创建基于java的email应用程序入门知识。假如你想创建你自己的email客户端应用程序来代替MicrosoftOutlook,或者创建一个基于Web的email系统来跟Hotmail叫板,那么你可以从这里开始。从JavaMail的一个不同角度出发,该文给出了一个谈话email客户端应用程序。
在JavaMail中,你可以找到API以及其实现部分,从而用它开发功能全面的email客户端应用程序。“email客户端应用程序”引用了MicrosoftOutlook的思想;然而,你可以写你自己的Outlook来取而代之。但是,一个email客户端程序不一定要驻留在一个客户端机器上。事实上,它可以是一个在远程服务器上运行的一个servlet或者EJB,终端用户通过Web浏览器可以收发他们的email。在作者自己的宠物项目中,就使用了一个语音客户端来读取接收进来的消息。它是作者在“Talking Java!”中介绍的想法(在后面将有更多的介绍)的提炼。
现在开始安装和配置Javamail软件。
安装
假如你使用的是Java2企业版(J2EE)1.3,那么它已经自带有JavaMail,因此不需要进行额外的安装。但是假如你使用的是Java2标准版(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文件包含核心API类,而pop3.jar和smtp.jar文件包含各自的email协议实现部分。(在这篇文章中我们不使用imap.jar文件)。可以认为实现部分跟JDBC(Java数据库连接)驱动程序相似,不过它是用于消息系统而不是用于数据库而已。至于mail.jar文件,它包含了上面的每一个jar文件,因此,你可以在你的classpath中只包含mail.jar和activation.jar文件。
Activation.jar文件答应你通过二进制数据流的形式处理MIME类型的访问。在后面“不仅仅可以发送普通文本”这一部分会讲到DataHandler类,你可以在那找到相关信息。
至于记录,本文的余下部分没有对API做全面的讲解;不过你可以学着去做一做。假如你想更多的了解API信息,你可以查看每个下载包中的PDF文件以及Javadoc。
一旦你已经安装了这个软件,那么你需要知道你的email帐户情况以便运行下面的这个例子。你需要知道你的ISP的SMTP服务器名和POP服务器名,你的email帐户登录名以及你的邮箱密码。图1表示的是作者在MicrosoftOutlook中使用的具体情况:
图1作者的Internet email设置
通过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所示的内容
图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未被包含在程序里面。可以到JavaMaildemo目录下去查找一下。
至于你一开始就感爱好的附件,你可以在DataHandler的构造器中建立一个javax.activation.FileDataSource实例来实现。当然,你不可能单独发送一个文件;它可以作为一个文本消息的附件发送。可能你需要理解多部分消息的概念,现在,我在接收email的环境下为你介绍这个概念。