JavaMail(JAVA邮件服务)API详解

JavaMail(JAVA邮件服务） API详解

一、JavaMail API简介
 
     JavaMail API是读取、撰写、发送电子信息的可选包。我们可用它来建立如Eudora、Foxmail、MS Outlook Express一般的邮件用户代理程序（Mail User Agent,简称MUA）。而不是像sendmail或者其它的邮件传输代理（Mail Transfer Agent，简称MTA）程序那样可以传送、递送、转发邮件。从另外一个角度来看，我们这些电子邮件用户日常用MUA程序来读写邮件，而MUA依赖着MTA处理邮件的递送。 在清楚了到MUA与MTA之间的关系后，让我们看看JavaMailAPI是如何提供信息访问功能的吧！JavaMail API被设计用于以不依赖协议的方式去发送和接收电子信息，这个API被分为两大部分： 基本功能：如何以不依赖于协议的方式发送接收电子信息，这也是本文所要描述的，不过在下文中，大家将看到这只是一厢情愿而已。第二个部分则是依赖特定协议的，比如SMTP、POP、IMAP、NNTP协议。在这部分的JavaMailAPI是为了和服务器通讯，并不在本文的内容中。

 二、相关协议一览

     在我们步入JavaMail API之前，先看一下API所涉及的协议。以下便是大家日常所知、所乐于使用的4大信息传输协议：
     SMTP
     POP
     IMAP
     MIME

     当然，上面的4个协议，并不是全部，还有NNTP和其它一些协议可用于传输信息，但是由于不常用到，所以本文便不提及了。理解这4个基本的协议有助于我们更好的使用JavaMail API。然而JavaMail API是被设计为与协议无关的，目前我们并不能克服这些协议的束缚。确切的说，如果我们使用的功能并不被我们选择的协议支持，那么JavaMail API并不可能如魔术师一样神奇的赋予我们这种能力。
  
     1．SMTP

     简单邮件传输协议定义了递送邮件的机制。在下文中，我们将使用基于Java-Mail的程序与公司或者ISP的SMTP服务器进行通讯。这个SMTP服务器将邮件转发到接收者的SMTP服务器，直至最后被接收者通过POP或者IMAP协议获取。这并不需要SMTP服务器使用支持授权的邮件转发，但是却的确要注意SMTP服务器的正确设置（SMTP服务器的设置与JavaMail API无关）。
  
     2．POP

     POP是一种邮局协议，目前为第3个版本，即众所周知的POP3。POP定义了一种用户如何获得邮件的机制。它规定了每个用户使用一个单独的邮箱。大多数人在使用POP时所熟悉的功能并非都被支持，例如查看邮箱
中的新邮件数量。而这个功能是微软的Outlook内建的，那么就说明微软Outlook之类的邮件客户端软件是通过查询最近收到的邮件来计算新邮件的数量来实现前面所说的功能。因此在我们使用JavaMail API时需要注意，当需要获得如前面所讲的新邮件数量之类的信息时，我们不得不自己进行计算。

    3．IMAP

    IMAP使用在接收信息的高级协议，目前版本为第4版，所以也被称为IMAP4。需要注意的是在使用IMAP时，邮件服务器必须支持该协议。从这个方面讲，我们并不能完全使用IMAP来替代POP，不能期待IMAP在任何地方都被支持。假如邮件服务器支持IMAP，那么我们的邮件程序将能够具有以下被IMAP所支持的特性：每个用户在服务器上可具有多个目录，这些目录能在多个用户之间共享。其与POP相比高级之处显而易见，但是在尝试采取IMAP时，我们认识到它并不是十分完美的：由于IMAP需要从其它服务器上接收新信息，将这些信息递送给用户，维护每个用户的多个目录，这都为邮件服务器带来了高负载。并且IMAP与POP的一个不同之处是POP用户在接收邮件时将从邮件服务器上下载邮件，而IMAP允许用户直接访问邮件目录，所以在邮件服务器进行备份作业时，由于每个长期使用此邮件系统的用户所用的邮件目录会占有很大的空间，这将直接导致邮件服务器上磁盘空间暴涨。

    4．MIME

    MIME并不是用于传送邮件的协议，它作为多用途邮件的扩展定义了邮件内容的格式：信息格式、附件格式等等。一些RFC标准都涉及了MIME：RFC 822,RFC 2045, RFC 2046, RFC 2047，有兴趣的Matrixer可以阅读一下。而作为JavaMail API的开发者，我们并不需关心这些格式定义，但是这些格式被用在了程序中。

    5．NNTP和其它的第三方协议 正因为JavaMail API在设计时考虑到与第三方协议实现提供商之间的分离，故我们可以很容易的添加一些第三方协议。SUN维护着一个第三方协议实现提供商的列表：http://java.sun.com/products/javamail/Third_Party.html，通过此列表我们可以找到所需要的而又不被SUN提供支持的第三方协议：比如NNTP这个新闻组协议和S/MIME这个安全的MIME协议。

  三、安装

    1．安装JavaMail 为了使用JavaMail API，需要从http://java.sun.com/products/javamail/downloads/index.html下载文件名格式为javamail-[version].zip的文件（这个文件中包括了JavaMail实现），并将其中的mail.jar文件添加到CLASSPATH中。这个实现提供了对SMTP、IMAP4、POP3的支持。
注意：在安装JavaMail实现之后，我们将在demo目录中发现许多有趣的简单实例程序。在安装了JavaMail之后,我们还需要安装JavaBeans Activation Framework，因为这个框架是JavaMailAPI所需要的。如果我们使用J2EE的话，那么我们并无需单独下载JavaMail，因为它存在于J2EE.jar中，只需将J2EE.jar加入到CLASSPATH即可。
 
    2．安装JavaBeans Activation Framework 从http://java.sun.com/products/javabeans/glasgow/jaf.html下载JavaBeans Activation Framework，并将其添加到CLASSPATH中。此框架增加了对任何数据块的分类、以及对它们的处理的特性。这些特性是JavaMail API需要的。虽然听起来这些特性非常模糊，但是它对于我们的JavaMailAPI来说只是提供了基本的MIME类型支持。 到此为止，我们应当把mail.jar和activation.jar都添加到了CLASSPATH中。 当然如果从方便的角度讲，直接把这两个Jar文件复制到JRE目录的lib/ext目录中也可以。

  四、初次认识

     JavaMail API
  
     1．了解我们的JavaMail环境
    
    A．纵览JavaMail核心类结构

     打开JavaMail.jar文件，我们将发现在javax.mail的包下面存在着一些核心类：Session、Message、Address、Authenticator、Transport、Store、Folder。而且在javax.mail.internet包中还有一些常用的子类。

    B．Session

     Session类定义了基本的邮件会话。就像HTTP会话那样，我们进行收发邮件的工作都是基于这个会话的。Session对象利用了java.util.Properties对象获得了邮件服务器、用户名和密码信息和整个应用程序都要使用到的共享信息。 Session类的构造方法是私有的，所以我们可以使用Session类提供的getDefaultInstance()这个静态工厂方法获得一个默认的Session对象：
     Properties props= new Properties();// fill props with any information
     informationSessionsession = Session.getDefaultInstance(propnull);
     或者使用getIntance()这个静态的工厂方法获得自定义的Session:
     Properties props= new Properties();// fill props with any information
     Session session= Session.getInstance(props, null);
     从上面的两个例子中不难发现，getDefaultInstance()和getInstance()方法的第二个参数都是null，这是因为在上面的例子中并没有使用到邮件授权，下文中将对授权进行详细介绍。从很多的实例看，在对mail server进行访问的过程中使用共享的Session是足够的，即使是工作在多个用户邮箱的模式下也不例外。

     C．Message
 
     当我们建立了Session对象后，便可以创建被发送消息的构造体了。在这里SUN提供了Message类型来帮助开发者完成这项工作。由于Message是一个抽象类，大多数情况下，我们使用javax.mail.internet.MimeMessage这个子类，该类是使用MIME类型、MIME信息头的邮件信息。信息头只能使用US-ASCII字符，而非ASCII字符将通过编码转换为ASCII的方式使用。
     为了建立一个MimeMessage对象，我们必须将Session对象作为MimeMessage构造方法的参数传入：
     MimeMessagemessage = new MimeMessage(session);
     注意：对于MimeMessage类来讲存在着多种构造方法，比如使用输入流作为参数的构造方法。
     在建立MimeMessage对象后，我们需要设置它的各个Part，对于MimeMessage类来说，这些part就是MimePart接口。最基本的设置信息内容的方法就是通过表示信息内容和米么类型的参数调用setContent()方法：
     message.setContent("Hello","text/plain");
     然而，如果我们所使用的MimeMessage中信息内容是文本的话，我们可以直接使用setText()方法来方便的设置文本内容。
     message.setText("Hello");
     前面所讲的两种方法，对于文本信息，后者更为合适。而对于其它的一些信息类型，比如HTML信息，则要使用前者。 别忘记了，使用setSubject()方法对邮件设置邮件主题:
     message.setSubject("First");
 
    D．Address
   
     到这里，我们已经建立了Session和Message，下面介绍如何使用邮件地址类：Address。像Message一样，Address类也是一个抽象类，所以我们将使用javax.mail.internet.InternetAddress这个子类。 通过传入代表邮件地址的字符串，我们可以建立一个邮件地址类：
     Address address= new InternetAddress("president@whitehouse.gov");
     如果要在邮件地址后面增加名字的话，可以通过传递两个参数代表邮件地址和名字的字符串来建立一个具有邮件地址和名字的邮件地址类：
     Address address= new InternetAddress("president@whitehouse.gov","GeorgeBush");
     本文在这里所讲的邮件地址类是为了设置邮件信息的发信人和收信人而准备的，在建立了邮件地址类后，我们通过message的setFrom()和setReplyTo()两种方法设置邮件的发信人：
     message.setFrom(address);
     message.setReplyTo(address);
     若在邮件中存在多个发信人地址，我们可用addForm()方法增加发信人:
     Addressaddress[] = ...;message.addFrom(address);
     为了设置收信人，我们使用addRecipient()方法增加收信人，此方法需要使用Message.RecipientType的常量来区分收信人的类型：
     message.addRecipient(type, address)
     下面是Message.RecipientType的三个常量：
     Message.RecipientType.TO
     Message.RecipientType.CC
     Message.RecipientType.BCC
     因此，如果我们要发送邮件给总统，并发一个副本给第一夫人，下面的方法将被用到：
     Address toAddress = newInternetAddress("vice.president@whitehouse.gov");
     AddressccAddress= new InternetAddress("first.lady@whitehouse.gov");
     message.addRecipient(Message.RecipientType.TO,toAddress);
     message.addRecipient(Message.RecipientType.CC,ccAddress);
     JavaMail API并没有提供检查邮件地址有效性的机制。当然我们可以自己完成这个功能：验证邮件地址的字符是否按照RFC822规定的格式书写或者通过DNS服务器上的MX记录验证等。

    E．Authenticator
   
     像java.net类那样，JavaMail API通过使用授权者类(Authenticator)以用户名、密码的方式访问那些受到保护的资源，在这里“资源”就是指邮件服务器。在javax.mail包中可以找到这个JavaMail的授权者类（Authenticator）。

    在使用Authenticator这个抽象类时，我们必须采用继承该抽象类的方式，并且该继承类必须具有返回PasswordAuthentication对象（用于存储认证时要用到的用户名、密码）getPasswordAuthentication()方法。并且要在Session中进行注册，使Session能够了解在认证时该使用哪个类。

    下面代码片断中的MyAuthenticator就是一个Authenticator的子类:
    Properties props= new Properties();// fill props with any information
    Authenticator auth = newMyAuthenticator();
    Sessiosession = Session.getDefaultInstance(props,auth);

    F．Transport
    
     在发送信息时，Transport类将被用到。这个类实现了发送消息的协议（通称为SMTP），此类是一个抽象类，我们可以使用这个类的静态方法send()来发送消息：
     Transport.send(message);
     当然，方法是多样的。我们也可由Session获得相应协议对应的Transport实例。并通过传递用户名、密码、邮件服务器主机名等参数建立与邮件服务器的连接，并使用sendMessage()方法将信息发送，最后关闭连接：
      message.saveChanges();//implicit with send() Transport

      transport =session.getTrpassword);
      transport.sendMessage(message,message.getAllRecipients());
      transport.clos();
      评论：上面的方法是一个很好的方法，尤其是在我们在同一个邮件服务器上发送多个邮件时。因为这时我们将在连接邮件服务器后连续发送邮件，然后再关闭掉连接。send()这个基本的方法是在每次调用时进行与邮件服务器的连接的，对于在同一个邮件服务器上发送多个邮件来讲可谓低效的方式。
      注意：如果需要在置debug标志：
      session.setDebug(ture);

    G．Store和Folder
    
     接收邮件和发送邮件很类似都要用到Session。但是在获得Session后，我们需要从Session中获取特定类型的Store，然后连接到Store，这里的Store代表了存储邮件的邮件服务器。在连接Store的过程中，极有可能需要用到用户名、密码或者Authenticator。

     // Store store =session.getStore("imap");
     Storestore=session.getStore("pop3");
     store.connect(host,username, password);
     在连接到Store后，一个Folder对象即目录对象将通过Store的getFolder()方法被返回，我们可从这个Folder中读取邮件信息：
     Folder folder =store.getFolder("INBOX");
     folder.open(Folder.READ_ONLY);
     Messagemessage[] = folder.getMessages();
     上面的例子首先从Store中获得INBOX这个Folder(对于POP3协议只有一个名为INBOX的Folder有效），然后以只读（Folder.READ_ONLY）的方式打开Folder，最后调用Folder的getMessages()方法得到目录中所有Message的数组。
     注意：对于POP3协议只有一个名为INBOX的Folder有效，而对于IMAP协议，我们可以访问多个Folder（想想前面讲的IMAP协议）。而且SUN在设计Folder的getMessages()方法时采取了很智能的方式：首先接收新邮件列表，然后再需要的时候（比如读取邮件内容）才从邮件服务器读取邮件内容。
     在读取邮件时，我们可以用Message类的getContent()方法接收邮件或是writeTo()方法将邮件保存，getContent()方法只接收邮件内容（不包含邮件头），而writeTo()方法将包括邮件头。 
     System.out.println(((MimeMessage)message).getContent());
     在读取邮件内容后，别忘记了关闭Folder和Store。
     folder.close(aBoolean);store.close();
     传递给Folder.close()方法的boolean 类型参数表示是否在删除操作邮件后更新Folder。


    H．继续向前进！

     在讲解了以上的七个Java Mail核心类定义和理解了简单的代码片段后，下文将详细讲解怎样使用这些类实现JavaMail API所要完成的高级功能。
  
    五、使用JavaMail API

     在明确了JavaMail API的核心部分如何工作后，本人将带领大家学习一些使用Java Mail API任务案例。

    1．发送邮件

     在获得了Session后，建立并填入邮件信息，然后发送它到邮件服务器。这便是使用Java Mail API发送邮件的过程，在发送邮件之前，我们需要设置SMTP服务器：通过设置Properties的mail.smtp.host属性。
     String host =...;
     String from =...;
     String to = ...;
     // Getsystemproperties
     Properties props = System.getProperties();
     // Setup mail server
     props.put("mail.smtp.host",host);
     // Get session
     Session session= Session.getDefaultInstance(props,null);
     // Definemessage
     MimeMessagemessage = new MimeMessage(session);
     message.setFrom(newInternetAddress(from));
     message.addRecipient(Message.RecipientType.TO,new InternetAddress(to));
     message.setSubject("HelloJavaMail");
     message.setText("Welcometo JavaMail");
     // Send
     messageTransport.send(message);
     由于建立邮件信息和发送邮件的过程中可能会抛出异常，所以我们需要将上面的代码放入到try-catch结构块中。
    
     2．接收邮件

     为了在读取邮件，我们获得了session，并且连接到了邮箱的相应store，打开相应的Folder，然后得到我们想要的邮件，当然别忘记了在结束时关闭连接。
     String host = ...;
     String username = ...;
     String password=...;
     //Create emptyproperties
     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);
     // GetfolderFolder
     folder =store.getFolder("INBOX");
     folder.open(Folder.READ_ONLY);
     //GET directory
     Messagemessage[] = folder.getMessages();
     for (int i=0,n=message.length; i++)....
     ....
     message.setContent(htmlText,"text/html");
     
     请注意：这里的图片并不是在邮件中内嵌的，而是在URL中定义的。邮件接收者只有在线时才能看到。
     在接收邮件时，如果我们使用JavaMailAPI接收邮件的话是无法实现以HTML方式显示邮件内容的。因为JavaMailAPI邮件内容视为二进制流。所以要显示HTML内容的邮件，我们必须使用JEditorPane或者第三方HTML展现组件。
      以下代码显示了如何使用JEditorPane显示邮件内容:
      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= newJScrollPane(text);
         frame.getContentPane().add(pane);
         frame.setSize(300,300);
         frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
         frame.show();
      }

     3．在邮件中包含图片
      
      如果我们在邮件中使用HTML作为内容，那么最好将HTML中使用的图片作为邮件的一部分，这样无论是否在线都会正确的显示HTML中的图片。处理方法就是将HTML中用到的图片作为邮件附件并使用特殊的cid URL作为图片的引用，这个cid就是对图片附件的Content-ID头的引用。处理内嵌图片就像向邮件中添加附件一样，不同之处在于我们必须通过设置图片附件所在的邮件体部分的header中Content-ID为一个随机字
符串，并在HTML中img的src标记中设置为该字符串。这样就完成了图片附件与HTML的关联。

      String file = ...;
      // Create themessage
      Message message= new MimeMessage(session);
      // Fill itsheaders
      message.setSubject("EmbeddeImage");
      message.setFrom(newInternetAddress(from));
      messageaddRecipient(Message.RecipientType.TO,new InternetAddress(to));
      // Create yournew message partBodyPart message
      BodyPartmessageBodyPart = new MimeBodyPart();
      String htmlText= "Hello" + "";
      messageBodyPart.setContent(htmlText,"text/html");
      //Create arelated multi-part to combine the parts
      MimeMultipartmultipart = new MimeMultipart("ret);
      // Create partfor the imagemessage
      BodyPart = newMimeBodyPart();
      // Fetch theimage and associate to part
      DataSource fds =new FileDataSource(file);
      messageBodyPart.setDataHandler(newDataHandler(fds));
      messageBodyPart.setHeader("Content-ID","");
      // Add part to
      multi-partmultipart.addBodyPart(messageBodyPart);
      //Associatemulti-part with messagemessage.setContent(multipart);

   4．在邮件中搜索短语
      JavaMail API提供了过滤器机制，它被用来建立搜索短语。这个短语由javax.mail.search包中的SearchTerm抽象类来定义，在定义后我们便可以使用Folder的Search()方法在Folder中查找邮件：
      SearchTerm st =...;
      Message[] msgs =folder.search(st);
      下面有22个不同的类（继承了SearchTerm类）供我们使用：
      AND terms (classAndTerm)
      OR terms (classOrTerm)
      NOT terms (classNotTerm)
      SENT DATE terms(class SentDateTerm)
      CONTENT terms(class BodyTerm)
      HEADER terms(FromTerm / FromStringTerm,RecipentTerm / RecipientStringTerm, SubjectTerm,etc.)
      使用这些类定义的断语集合，我们可以构造一个逻辑表达式，并在Folder中进行搜索。下面是一个实例：在Folder中搜索邮件主题含有“ADV”字符串或者发信人地址为friend@public.com的邮件。
      SearchTerm st = new OrTerm( newSubjectTerm("ADV:"), newFromStringTerm("friend@public.com"));
      Message[]msgs=folder.search(st);