Rising Sun

最近在項目中用到發(fā)送郵件的功能，由于以前沒有接觸過，找了很多資料才終于把它弄出來，今天寫下這些，算是做個總結(jié)吧。
1、首先定義一個郵件的數(shù)據(jù)結(jié)構(gòu)類
public class EmailData() {
     String from   = null;  //發(fā)件人
     String[] recipients = null;  //收件人,可以多個
     String subject   = null;  //郵件主題
     String content   = null;  //郵件內(nèi)容
     String contentType  = null;  //郵件內(nèi)容格式(文本或html)
     String fileName  = null;  //附件文件名(目前只提供一個附件)
 
     //下面是相應(yīng)的setter/getter方法，省略..
}
2、發(fā)送不帶附件的郵件(包括文本格式和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();
     //設(shè)置郵件服務(wù)器地址，連接超時時限等信息
     props.put("mail.smtp.host", "10.30.1.233"); //10.30.1.233郵件服務(wù)器
     props.put("mail.smtp.connectiontimeout", "10000"); //
  props.put("mail.smtp.timeout", "10000");   //
    
     //創(chuàng)建缺省的session對象
     Session session = Session.getDefaultInstance(props, null);
 
     //創(chuàng)建message對象
     Message msg = new MimeMessage(session);
 
     //設(shè)置發(fā)件人和收件人
     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);
  
  //設(shè)置郵件標(biāo)題，中文編碼
     subject = MimeUtility.encodeText(new String(subject.getBytes(), "GB2312"), "GB2312", "B");
     msg.setSubject(subject);
    
     //設(shè)置郵件內(nèi)容,區(qū)分文本格式和HTML格式
     if (contentType == null || contentType.equals("text")) {
      msg.setText(content);
  } else if (contentType.equals("html")) {
   //給消息對象設(shè)置內(nèi)容
   BodyPart bodyPart1 = new MimeBodyPart(); //新建一個存放信件內(nèi)容的BodyPart對象
   mdp.setContent(content, "text/html;charset=gb2312");//給BodyPart對象設(shè)置內(nèi)容和格式/編碼方式
   Multipart mmp = new MimeMultipart();//新建一個MimeMultipart對象用來存放BodyPart對象(事實上可以存放多個)
   //設(shè)置郵件附件
   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作為消息對象的內(nèi)容
  }
     
     //設(shè)置郵件發(fā)送時間
        msg.setSentDate(new java.util.Date());
        //調(diào)用抽象類的靜態(tài)方法send()發(fā)送郵件
     Transport.send(msg);
    }
}

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

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

4、以下是轉(zhuǎn)載的關(guān)于java mail的介紹
Session
--------------------------------------------------------------------
 Session 定義了一個基本的郵件會話，任何工作都是基于這個Session的。Session 對象需要一個 java.util.Properties 對象來得到類似 郵件服務(wù)器，用戶名，密碼這樣的信息。
 
 Session 的構(gòu)造函數(shù)是私有的，你可以通過 getDefaultInstance() 方法來取得一個單一的可以被共享的默認(rèn)session 如：

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

 或者，你可以使用 getInstance() 方法來創(chuàng)建一個唯一的 session如：

  Properties props = new Properties();
  // 填寫一些信息
  Session session = Session.getInstance(props,null);
 
 在這兩種方法中 其中的 null 參數(shù)是一個 Authenticator 對象，在這里沒有被使用的，所以就是null
 
 在大多數(shù)案例中，使用一個共享session 已經(jīng)做夠了。

Message
----------------------------------------------------------------
 一旦你創(chuàng)建了Session對象，那么下面要做的就是創(chuàng)建 message 來發(fā)送。Message 是一個抽象類，在大部分應(yīng)用中你可以使用它的子類 javax.mail.internet.MimeMessage 。MimeMessage 是一個理解在不同RFCs中定義的MIME類型以及headers的e-mail message&nbsp;。 Message headers 必須使用 US-ASCII 字符集。

 可以用如下的方法創(chuàng)建一個 Message 
  MimeMessage message = new MimeMessage(session);
 我們注意到，這里需要用session對象作為構(gòu)造函數(shù)的參數(shù)。當(dāng)然，還有其它的構(gòu)造函數(shù)，比如從用RFC822格式化過的輸入流來創(chuàng)建message。

 一旦你得到了 message ,你就可以來設(shè)置它的各個部分（parts）。設(shè)置內(nèi)容（content）的基本的機制是使用setContent() 方法。

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

 如果，你能夠明確你的使用MimeMessage來創(chuàng)建message 并且只是使用普通的文本（plain text） 那么你也可以使用 setText() 方法，setTest()方法只需要設(shè)置具體的內(nèi)容，它默認(rèn)的MIME類型是 text/plain
  
  message.setText("Email Content. ");
 
 對于普通文本類型的郵件，有一種機制是首選（ message.setText("Email Content. ")）的設(shè)置內(nèi)容的方法。如果要創(chuàng)建其它類型的message ，比如　HTML類型的message  那么還是需要使用前者　（　message.setContent("Email Content. ","text/html");　）

 設(shè)置主題（subject ），使用setSubject() 方法
  
  message.setSubject(" Subject ");

Address 
----------------------------------------------------------------
 
 當(dāng)你已經(jīng)創(chuàng)建Session 以及 Message，并且已經(jīng)為message 填充了內(nèi)容，那么接下來要做的就是給你的郵件添加一個地址（Address）。　就像Message一樣，Address也是一個抽象類，我們可以使用它的一個子類javax.mail.internet.InternetAddress　。

 創(chuàng)建一個地址非常簡單

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

 如果，你希望在出現(xiàn)郵件地址的地方出現(xiàn)一個名稱，那么你只需要再多傳遞一個參數(shù)。

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

 你需要為 message 的from以及 to 字段創(chuàng)建address對象。為了識別發(fā)送者，你需要使用setFrom() 和 setReplyTo() 方法。
  
  messge.setFrom(address);

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

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

 為了辨識message 的收件人，你需要使用 setRecipient() 方法。這個方法除了address參數(shù)之外，還需要一個Message.RecipientType 。

 message.addRecipient(type,address);

 Message.RecipientType有幾個預(yù)先定義好的類型
 
 Message.RecipientType.TO　　收件人
 Message.RecipientType.CC　　抄送
 Message.RecipientType.BCC　 暗送

 如果你的一封郵件，需要發(fā)送給你的老師，并還要給你的幾個同學(xué)，那么你可以這樣

 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設(shè)置用戶名、密碼，來訪問受保護的資源，這里的資源一般指的是郵件服務(wù)器。
 
 Authenticator也是一個抽象類，你需要自己編寫子類已備應(yīng)用。你需要實現(xiàn)getPasswordAuthentication()方法，并返回一個PasswordAuthentication實例。你必須在 session被創(chuàng)建時， 注冊你的 Authenticator。這樣，當(dāng)需要進行認(rèn)證是，你的Authenticator就可以被得到。

  Properties props = new Properties();
  //設(shè)置屬性
  Authenticator auth = new YourAuthenticator();
  Session session = Session.getDefaultInstance(props, auth);
 
Transport
----------------------------------------------------------------

 發(fā)送消息最后的一步就是使用Transport類，你可以通過兩種方法來進行發(fā)送。
 Transport 是一個抽象類，你可以調(diào)用它靜態(tài)的send() 方法來發(fā)送

  Transport.send(message);

 或者，你可以為你使用的協(xié)議從session中取得一個指定的實例，

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

Store and Folder
 
 這兩個類重要用于取得信息。在創(chuàng)建了Session之后，需要連接到一個 Store ，你需要告訴Store  你使用的是什么協(xié)議。

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

 在連接到一個 Store 后，你可以得到一個 Folder，當(dāng)然，這個Floder必須是打開的。

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

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