初試javax.mail

最近在項目中用到發送郵件的功能，因爲之前沒有接觸過，找了不少資料才終於把它弄出來，今天寫下這些，算是作個總結吧。 

一、首先定義一個郵件的數據結構類 
public class EmailData() { 
     String from   = null;  //發件人 
     String[] recipients = null;  //收件人,能夠多個 
     String subject   = null;  //郵件主題 
     String content   = null;  //郵件內容 
     String contentType  = null;  //郵件內容格式(文本或html) 
     String fileName  = null;  //附件文件名(目前只提供一個附件) 
  
     //下面是相應的setter/getter方法，省略.. 
} 
二、發送不帶附件的郵件(包括文本格式和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); 
    } 
} 

三、發送帶附件的郵件稍微複雜一些，跟發送普通郵件的區別主要以下： 
   //設置郵件內容 
   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); 

四、如下是轉載的關於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，你就可使用其它的文件夾。