Java Mail简介

本文档分三个部分，第一部分简要介绍了一下JavaMail，第二部分是JavaMail几个关键类的介绍，最后是我写的一个发送邮件的小程序。关于几个核心类的介绍，基本上是翻译的IBM一个关于JavaMail的文档。希望对大家有帮助。

[@more@]开始了，使用JavaMail来发送接收电子邮件真的是一件非常愉快的事（因为很简单：）。

不 管你是发送，还是接收邮件，第一件事，一定是创建Session。如果，你是发送邮件那么 接下来你需要创建你要发送的邮件，也就是一个 message 对象。现在的message对象好像一张白纸，现在就需要我们来添加内容啦message.setContent()可以帮你搞定。然后我们需要写“信 封” message.setFrom(); message.addRecipient();...
哈哈，都搞定了，然后就可以寄出去了
Transport transport = session.getTransport("smtp");
transport.sendMessage(message, message.getAllRecipients());
transport.close();

好 了，邮件发送完成了：），嘻嘻当然，这里有些过于乐观了，在发送的过程中我们还有遇到其它一些问题，比如，认证，地址等。下面就JavaMail几个重要 的类进行一下介绍（主要是翻译的IBM developerWorks的一个关于JavaMail的文档，加入了一些个人看法 ）

====================================================================

Session
--------------------------------------------------------------------
 Session 定义了一个基本的邮件会话，任何工作都是基于这个Session的。Session 对象需要一个 java.util.Properties 对象来得到类似 邮件服务器，用户名，密码这样的信息。
 
 Session 的构造函数是私有的，你可以通过 getDefaultInstance() 方法来取得一个单一的可以被共享的默认session 如：

  Properties props = new Properties();
  // 填写一些信息
  Session session = Session.getDefaultInstance(props,null);

 或者，你可以使用 getInstance() 方法来创建一个唯一的 session如：

  Properties props = new Properties();
  // 填写一些信息
  Session session = Session.getInstance(props,null);
 
 在这两种方法中 其中的 null 参数是一个 Authenticator 对象，在这里没有被使用的，所以就是null
 
 在大多数案例中，使用一个共享session 已经做够了。

Message
----------------------------------------------------------------
 一 旦你创建了Session对象，那么下面要做的就是创建 message 来发送。Message 是一个抽象类，在大部分应用中你可以使用它的子 类 javax.mail.internet.MimeMessage 。MimeMessage 是一个理解在不同RFCs中定义的MIME类型以及 headers的e-mail message 。 Message headers 必须使用 US-ASCII 字符集。

 可以用如下的方法创建一个 Message 
  MimeMessage message = new MimeMessage(session);
 我们注意到，这里需要用session对象作为构造函数的参数。当然，还有其它的构造函数，比如从用RFC822格式化过的输入流来创建message。

 一旦你得到了 message ,你就可以来设置它的各个部分（parts）。设置内容（content）的基本的机制是使用setContent() 方法。

  message.setContent("Email Content. ","text/plain");

 如果，你能够明确你的使用MimeMessage来创建message 并且只是使用普通的文本（plain text） 那么你也可以使用 setText() 方法，setTest()方法只需要设置具体的内容，它默认的MIME类型是 text/plain
  
  message.setText("Email Content. ");
 
 对 于普通文本类型的邮件，有一种机制是首选（ message.setText("Email Content. ")）的设置内容的方法。如果要创建其它 类型的message ，比如　HTML类型的message  那么还是需要使用前者　（　 message.setContent("Email Content. ","text/html");　）

 设置主题（subject ），使用setSubject() 方法
  
  message.setSubject(" Subject ");

Address 
----------------------------------------------------------------
 
 当 你已经创建Session 以及 Message，并且已经为message 填充了内容，那么接下来要做的就是给你的邮件添加一个地址 （Address）。　就像Message一样，Address也是一个抽象类，我们可以使用它的一个子类 javax.mail.internet.InternetAddress　。

 创建一个地址非常简单

  Address address = new InternetAddress(" suixin@asiainfo.com ");

 如果，你希望在出现邮件地址的地方出现一个名称，那么你只需要再多传递一个参数。

  Address address = new InternetAddress(" suixin@asiainfo.com ","Steve");

 你需要为 message 的from以及 to 字段创建address对象。为了识别发送者，你需要使用setFrom() 和 setReplyTo() 方法。
  
  messge.setFrom(address);

 如果你的message 需要显示多个 from 地址，可以使用 addFrom() 方法

  Address address[] = {....};
  message.addFrom(address);

 为了辨识message 的收件人，你需要使用 setRecipient() 方法。这个方法除了address参数之外，还需要一个Message.RecipientType 。

 message.addRecipient(type,address);

 Message.RecipientType有几个预先定义好的类型
 
 Message.RecipientType.TO　　收件人
 Message.RecipientType.CC　　抄送
 Message.RecipientType.BCC　 暗送

 如果你的一封邮件，需要发送给你的老师，并还要给你的几个同学，那么你可以这样

 Address toAddress = new InternetAddress(" teacher@17288.com ");
 Address[] ccAddress = {new InternetAddress(" schoolmate1@17288.com "),new InternetAddress(" schoolmate2@17288.com ")};

 message.addRecipient(Message.RecipientType.To, toAddress);
 message.addRecipient(Message.RecipientType.CC, ccAddress);
 
 JavaMail 没有提供电子邮件地址有效性的检测。这些超越了JavaMail API的范围。

Authenticator
 
 通过Authenticator设置用户名、密码，来访问受保护的资源，这里的资源一般指的是邮件服务器。
 
 Authenticator 也是一个抽象类，你需要自己编写子类已备应用。你需要实现getPasswordAuthentication()方法，并返回一个 PasswordAuthentication实例。你必须在 session被创建时， 注册你的 Authenticator。这样，当需要进行认证 是，你的Authenticator就可以被得到。

  Properties props = new Properties();
  //设置属性
  Authenticator auth = new YourAuthenticator();
  Session session = Session.getDefaultInstance(props, auth);
 
Transport
----------------------------------------------------------------

 发送消息最后的一步就是使用Transport类，你可以通过两种方法来进行发送。
 Transport 是一个抽象类，你可以调用它静态的send() 方法来发送

  Transport.send(message);

 或者，你可以为你使用的协议从session中取得一个指定的实例，

  Transport transport = session.getTransport("smtp");
  transport.sendMessage(message, message.getAllRecipients());
  transport.close();

Store and Folder
 
 这两个类重要用于取得信息。在创建了Session之后，需要连接到一个 Store ，你需要告诉Store  你使用的是什么协议。

  // Store store = session.getStore("imap");
  Store store = session.getStore("pop3");
  store.connect(host, username, password);

 在连接到一个 Store 后，你可以得到一个 Folder，当然，这个Floder必须是打开的。

  Folder folder = store.getFolder("INBOX");
  folder.open(Folder.READ_ONLY);
  Message message[] = folder.getMessages();

 如果使用POP3那么，INDEX是唯一可用的文件夹。如果使用的是IMAP，你就可以使用其它的文件夹。 

====================================================================

下面是一个发送邮件的例子

SendMailAuthenticator 
---------------------------------------
package com.steve.email;

import javax.mail.Authenticator;
import javax.mail.PasswordAuthentication;

public class SendMailAuthenticator extends Authenticator{
  private String username = "";
  private String password = "";

  public void check(String username, String password){
    this.username = username;
    this.password = password;
  }

  public PasswordAuthentication getPasswordAuthentication(){
    return new PasswordAuthentication(username,password);
  }
}

SendMailTools
--------------------------------------------------------
package com.steve.email;

import java.util.Properties;
import java.util.Date;
import javax.mail.*;
import javax.mail.internet.*;

public class SendMailTools {
 
  public static void main(String[] args) {
    
    Properties props = new Properties();
    
    SendMailAuthenticator au = new SendMailAuthenticator();
    au.check("******", "******"); // 认证 (用户名和密码)
    props.put("mail.smtp.host", "smtp.17288.com"); // 设置smtp服务器
    props.put("mail.smtp.auth", "true"); // 这样认证才会起作用：）
    Session session = Session.getInstance(props, au);// 创建session
    
    MimeMessage message = new MimeMessage(session); //创建message对象
    //先来写“信封”吧
    try{
      Address address = new InternetAddress(" sender@17288.com ", "Steve"); //发件人地址
      Address toAddress = new InternetAddress(" getter@asiainfo.com ");//收件人地址
      message.setFrom(address);//设置发件人
      message.setRecipient(MimeMessage.RecipientType.TO,toAddress);//设置收件人
      
      //下面写邮件内容
      message.setSubject("测试邮件","GB2312"); //设置主题
      message.setSentDate(new Date());//设置日期
      message.setText("测试邮件","GB2312");//设置邮件内容
      
      //发送啦
      Transport transport = session.getTransport("smtp");
      transport.send(message);

    }catch(Exception ex){ //嘻嘻，这里简单起见就这样写了，这种做法是不值得提倡的：）
    }
  }
}