服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

javamail快速入门(上)


  摘要
  这篇文章介绍创建基于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软件。
  安装
  如果你使用的是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表示的是作者在microsoft outlook中使用的详细情况:
   javamail快速入门(上)(图一)
  图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所示的内容
  javamail快速入门(上)(图二)
  图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的环境下为你介绍这个概念。

扫描关注微信公众号