JavaMail

Multipurpose Internet Mail Extensions (MIME)规范
RFC2045--RFC2049
http://www.faqs.org/rfcs/rfc2045.html
http://www.faqs.org/rfcs/rfc2046.html
http://www.faqs.org/rfcs/rfc2047.html
http://www.faqs.org/rfcs/rfc2048.html
http://www.faqs.org/rfcs/rfc2049.html

package(1.2)：
mail.jar、activation.jar

编码：
javax.mail.internet.MimeUtility
sun.misc.BASE64Decoder#decodeBuffer #encode  (jdk1.4/jre/lib/rt.jar)

Java Mail API核心类
　　·Javax.mail.Session：Session 类定义了一个基本邮件会话(session)，是Java Mail API最高层入口类。所有其它类都是经由这个session 才得以生效。Session 对象用 Java.util.Properties 对象获取信息，如邮件服务器、用户名、密码及整个应用程序中共享的其它信息。
　　·Javax.mail.Message：一旦获得 Session 对象，就可以继续创建要发送的消息。这由 Message 类来完成。因为 Message 是个抽象类，必需用一个子类，多数情况下为 Javax.mail.internet.MimeMessage。MimeMessage 是个能理解 MIME 类型和头的电子邮件消息，正如不同 RFC 中所定义的。虽然在某些头部域非 ASCII 字符也能被译码，但 Message 头只能被限制为用 US-ASCII 字符。
　　·Javax.mail.Address：一旦您创建了 Session 和 Message，并将内容填入消息后，就可以用 Address 确定信件地址了。和 Message 一样，Address 也是个抽象类。您用的是 Javax.mail.internet.InternetAddress 类。
　　·Javax.mail. Authenticator：与 Java.net 类一样，JavaMail API 也可以利用 Authenticator 通过用户名和密码访问受保护的资源。对于JavaMail API 来说，这些资源就是邮件服务器。JavaMail Authenticator 在 Javax.mail 包中，而且它和 Java.net 中同名的类 Authenticator 不同。两者并不共享同一个 Authenticator，因为JavaMail API 用于 Java 1.1，它没有 Java.net 类别。
要使用 Authenticator，先创建一个抽象类的子类，并从 getPasswordAuthentication() 方法中返回 PasswordAuthentication 实例。创建完成后，您必需向 session 注册 Authenticator。然后，在需要认证的时候，就会通知 Authenticator。您可以弹出窗口，也可以从配置文件中（虽然没有加密是不安全的）读取用户名和密码，将它们作为 PasswordAuthentication 对象返回给调用程序。
　　·Javax.mail.Transport：消息发送的最后一部分是使用 Transport 类。这个类用协议指定的语言发送消息（通常是 SMTP）。它是抽象类，它的工作方式与 Session 有些类似。仅调用静态 send() 方法，就能使用类的 缺省 版本：Transport.send(message);或者，读者也可以从针对自己的协议的会话中获得一个特定的实例，传递用户名和密码（如果不必要就不传），发送消息，然后关闭连接。
　　·Javax.mail.Store：Store类实现特定邮件协议上的读、写、监视、查找等操作。通过Javax.mail.Store类可以访问Javax.mail.Folder类。
　　·Javax.mail.Folder：Folder类用于分级组织邮件，并提供照Javax.mail.Message格式访问email的能力。

--------------------------------------------------------------------------------

---

REF: http://www.chinabyte.com/20020424/1608502.shtml


从文件读取：new MimeMessage(null,new FileInputStream(fileName));


层次结构关系(由上到下)

邮件：MimeMessage

邮件内容：
 1)文本：MimeMessage#setText:String
 2)HTML：MimeMessage#setContent:MimeMultipart

MimeMultipart：
 MimeMultipart 1——————n MimeBodyPart
 MimeMultipart#getCount 为MimeBodyPart的个数，邮件类容(1)+附件个数(n-1)

MimeBodyPart、BodyPart：
 邮件内容：#setText Text/HTML
 附件：#setDataHandler(new DataHandler(DataSource));
  #setFileName
 
     MimeMultipart mm=(MimeMultipart)msg.getContent()
            for (int i = 0, n = mm.getCount(); i < n; i++) {
                BodyPart part = mm.getBodyPart(i);
                String disposition = part.getDisposition();
                if ( (disposition != null) &&
                    ( (disposition.equals(Part.ATTACHMENT) ||
                       (disposition.equals(Part.INLINE))))) {
         //附件
                    //saveFile(part.getFileName(), part.getInputStream());
                    System.out.println(part.getFileName());
                }else if(disposition==null){
   //邮件内容
   MimeBodyPart mbp = (MimeBodyPart)part;
   if (mbp.isMimeType("text/plain")) {
    //文本
   } else {
   　　//HTML：可能是mht等
   }
  }else{
   //自定义协议(非标准)
  }

            }

DataSource：
 DataHandlerDataSource、URLDataSource、FileDataSource

---

　　附录：Java Mail API的基本概念

　　什么是Java Mail API

　　JavaMail API 是一个用于阅读、编写和发送电子邮件的可选包（标准扩展）。与 Eudora、pine 及 Microsoft Outlook 相似，这个包用来创建邮件用户代理（Mail User Agent，MUA） 类型程序。API 的主要用途并不在于传输、发送和转发消息；这一功能范围属于某些应用程序，如 sendmail 及其它邮件传输代理（Mail Transfer Agent，MTA）类型程序。MUA 类型的程序能让用户阅读和书写邮件，而它却依赖 MTA 处理实际发送。

　　什么是SMTP

　　SMTP（Simple Mail Transfer Protocol），即简单邮件传输协议，它定义了发送电子邮件的机制。在 JavaMail API 环境中，基于 JavaMail 的程序将和您的公司或因特网服务供应商的（Internet Service Provider's，ISP's）SMTP 服务器通信。SMTP 服务器可将消息中转至接收方 SMTP 服务器，以便最终让用户经由 POP 或 IMAP 获得。这不是要求 SMTP 服务器成为开放的中继，尽管 SMTP 服务器支持身份验证，不过还是得确保它的配置正确。像配置服务器来中继消息或添加删除邮件账号这类任务的实现，JavaMail API 中并不支持。

　　什么是POP

　　POP（Post Office Protocol），即邮局协议。目前用的是版本3，所以人们通常将它称为 POP3，RFC 1939 定义了这个协议。POP 和SMTP一样，也是一种机制，Internet上大多数人通过它得到邮件。该协议规定每个用户只能有一个邮箱的支持。这就是它所能做的，而这也造成了许多混淆。使用 POP 时，用户熟悉的许多性能并不是由 POP 协议支持的，如查看有几封新邮件消息这一性能。这些性能内建于如 Eudora 或 Microsoft Outlook 之类的程序中，它们能记住一些事，诸如最近一次收到的邮件，还能计算出有多少是新的。所以当使用 JavaMail API 时，如果读者想要这类信息，就只能由自己来计算了。

　　什么是IMAP

　　IMAP（Internet Message Access Protocol），即Internet消息访问协议，是更高级的用于接收消息的协议，在 RFC 2060 中有它的定义。目前使用的IMAP版本为4，人们习惯将它称为 IMAP4。在用到 IMAP 时，邮件服务器必需支持这个协议。不能仅仅把使用 POP 的程序用于 IMAP，并指望它支持 IMAP 所有性能。假设邮件服务器支持 IMAP，基于 JavaMail 的程序可以利用这种情况--用户在服务器上可以有多个文件夹（folder），并且这些文件夹可以被多个用户共享。
　　因为有这一更高级的性能，您也许会认为所有用户都会使用 IMAP。事实并不是这样。要求服务器接收新消息，在用户请求时发送到用户手中，还要在每个用户的多个文件夹中维护消息。这样虽然能将消息集中备份，但随着用户长期的邮件夹越来越大，到磁盘空间耗尽时，每个用户都会受到损失。使用 POP，就能卸载邮件服务器上保存的消息了。

　　什么是MIME

　　MIME（Multipurpose Internet Mail Extensions），即多用途Internet邮件扩展标准。它不是邮件传输协议，而是对传输内容的消息、附件及其它的内容定义了格式。这里有很多不同的RFC（Requirement of Comment）文档：RFC 822、RFC 2045、RFC 2046 和 RFC 2047。作为一个 JavaMail API 的用户，您通常不必对这些格式操心。无论如何，一定存在这些格式而且程序会用到它。