javax.mail


 

最近在項目中用到發送郵件的功能,由於以前沒有接觸過,找了很多資料才終於把它弄出來,今天寫下這些,算是做個總結吧。 
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,你就可以使用其它的文件夾。  

 

 

 

 最后講述下最容易出現的錯誤:

    網上很多人都說J2EE5兼容性不好,例如典型的javamail1.4中包與J2EE5中包接口包引起沖突,導致單元測試經常報如下錯誤:

    java.lang.NoClassDefFoundError: com/sun/mail/util/BEncoderStream

    當然這個錯誤是沒有將javamail的實現者引進工程(沒有導包),但導包后,就會出現另外一個錯誤:

    java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream

    此時甚至web容器都無法啟動,經常會有網友們為這兩個異常搞得焦頭爛額,如此更換J2EE1.4,會對工程造成影響。但是一定要把概念弄清楚,問題就好解決。J2EE5中mail.jar包定義的只是接口,沒有實現,是不能真正發送郵件的,但開發編譯肯定是可以過去的,因為我們是針對J2EE規范編的程序。而運行期用Sun公司的JavaMail1.4的實現才可以開始發送郵件,但老大為什么把這兩個弄沖突了?

    筆者的解決辦法是:

    開發期不要導包,運行期將javamail1.4壓縮文件中的mail.jar包放入到tomcat\lib目錄下,這樣完全可以通過開發和運行。若要做單元測試則新開一個Java Project,注意,不是web工程,此時可以將javamail1.4壓縮包中的mail.jar放入到工程的classpath下。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM