Rising Sun

最近在項目中用到發送郵件的功能，由于以前沒有接觸過，找了很多資料才終于把它弄出來，今天寫下這些，算是做個總結吧。
1、首先定義一個郵件的數據結構類
public class EmailData() {
     String from   = null;  //發件人
     String[] recipients = null;  //收件人,可以多個
     String subject   = null;  //郵件主題
     String content   = null;  //郵件內容
     String contentType  = null;  //郵件內容格式(文本或html)
     String fileName  = null;  //附件文件名(目前只提供一個附件)
 
     //下面是相應的setter/getter方法，省略..
}
2、發送不帶附件的郵件(包括文本格式和html兩種格式)
public void postMail(EmailData emailData)
 throws MessagingException,Exception {
  
 String from   = emailData.getFrom();
 String[] recipients = emailData.getRecipents();
 String subject   = emailData.getSubject();
 String content   = emailData.getContent();
 String contentType = emailData.getContentType();
 String fileName  = emailData.getFileName();
 
    if (recipients != null && recipients.length > 0) {

     Properties props = new Properties();
     //設置郵件服務器地址，連接超時時限等信息
     props.put("mail.smtp.host", "10.30.1.233"); //10.30.1.233郵件服務器
     props.put("mail.smtp.connectiontimeout", "10000"); //
  props.put("mail.smtp.timeout", "10000");   //
    
     //創建缺省的session對象
     Session session = Session.getDefaultInstance(props, null);
 
     //創建message對象
     Message msg = new MimeMessage(session);
 
     //設置發件人和收件人
     InternetAddress addressFrom = new InternetAddress(from);
     msg.setFrom(addressFrom);  
     InternetAddress[] addressTo = new InternetAddress[recipients.length];
     for (int i = 0; i < recipients.length; i++){
         addressTo[i] = new InternetAddress(recipients[i]);
     }
     msg.setRecipients(Message.RecipientType.TO, addressTo);
  
  //設置郵件標題，中文編碼
     subject = MimeUtility.encodeText(new String(subject.getBytes(), "GB2312"), "GB2312", "B");
     msg.setSubject(subject);
    
     //設置郵件內容,區分文本格式和HTML格式
     if (contentType == null || contentType.equals("text")) {
      msg.setText(content);
  } else if (contentType.equals("html")) {
   //給消息對象設置內容
   BodyPart bodyPart1 = new MimeBodyPart(); //新建一個存放信件內容的BodyPart對象
   mdp.setContent(content, "text/html;charset=gb2312");//給BodyPart對象設置內容和格式/編碼方式
   Multipart mmp = new MimeMultipart();//新建一個MimeMultipart對象用來存放BodyPart對象(事實上可以存放多個)
   //設置郵件附件
   BodyPart bodyPart2 = new MimeBodyPart(); 
   FileDataSource fileDataSource = new FileDataSource(fileName);
   bodyPart2.setDataHandler(new DataHandler(fileDataSource));       
   bodyPart2.setFileName("=?GB2312?B?"+enc.encode(fileName.getBytes())+"?=");
   
     
   Multipart multipart = new MimeMultipart();
   multipart.addBodyPart(bodyPart1);
   multipart.addBodyPart(bodyPart2);
   
   mmp.addBodyPart(mdp);//將BodyPart加入到MimeMultipart對象中(可以加入多個BodyPart)
   msg.setContent(mmp);//把mm作為消息對象的內容
  }
     
     //設置郵件發送時間
        msg.setSentDate(new java.util.Date());
        //調用抽象類的靜態方法send()發送郵件
     Transport.send(msg);
    }
}

3、發送帶附件的郵件稍微復雜一些，跟發送普通郵件的區別主要如下：
   //設置郵件內容
   BodyPart bodyPart1 = new MimeBodyPart();
   bodyPart1.setDataHandler(new DataHandler( new MailDataSource(content,"text/html")));
   
   //設置郵件附件
   BodyPart bodyPart2 = new MimeBodyPart(); 
   FileDataSource fileDataSource = new FileDataSource(fileName);
   bodyPart2.setDataHandler(new DataHandler(fileDataSource));       
   //需要對附件文件名稱進行轉碼，不然會出現亂碼
   bodyPart2.setFileName("=?GB2312?B?"+enc.encode(fileName.getBytes())+"?=");
        
   Multipart multipart = new MimeMultipart();
   multipart.addBodyPart(bodyPart1);
   multipart.addBodyPart(bodyPart2);

   //將Multipart加入到信件
   newMessage.setContent(multipart);

4、以下是轉載的關于java mail的介紹
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&nbsp;。 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，你就可以使用其它的文件夾。