JSP與JavaMail之2(常用類介紹)

js 3.JavaMail的常用類介紹 

事先說明: 

沒用過JavaMail的人可能看不懂這些介紹,不過不要緊,後面的文章有具體的執行個體,到時也可倒回來查看這些類的用法. 


(1) javax.mail.Properties類 
　　JavaMail需要Properties來建立一個session對象。它將尋找字串"mail.smtp.host"，屬性值就是發送郵件的主機. 

用法: 
　Properties props = new Properties (); 
　　　props.put("mail.smtp.host", "smtp.163.com");//可以換上你的smtp主機名稱。 


(2) javax.mail.Session類 
　　這個Session類代表JavaMail 中的一個郵件session. 每一個基於 JavaMail的應用程式至少有一個session但是可以有任意多的session。 在這個例子中, Session對象需要知道用來處理郵件的SMTP 伺服器。 

用法: 
　　 Session sendMailSession; 
　　 sendMailSession = Session.getInstance(props, null); 


(3) javax.mail.Transport類 
　　郵件是既可以被發送也可以被受到。JavaMail使用了兩個不同的類來完成這兩個功能：Transport 和Store. Transport 是用來發送資訊的，而Store用來收信。對於這的教程我們只需要用到Transport對象。 

用法： 
Transport transport; 
　 transport = sendMailSession.getTransport("smtp"); 

　　用JavaMail Session對象的getTransport 方法來初始化Transport。傳過去的字串申明了對象所要使用的協議，如"smtp"。這將為我們省了很多時間。因為JavaMail以境內建了很多協議的實現方法。 

　注意: JavaMail並不是絕對支援每一個協議，目前支援IMAP、 SMTP和 POP3. 


(4) javax.mail.MimeMessage類 
　　Message對象將儲存我們實際發送的電子郵件資訊，Message對象被作為一個MimeMessage對象來建立並且需要知道應當選擇哪一個JavaMail session。 

　　用法： 
Message newMessage = new MimeMessage(sendMailSession); 


(5) javax.mail.InternetAddress類 
一旦您建立了 Session 和 Message，並將內容填入訊息後，就可以用Address確定信件地址了。和 Message 一樣，Address 也是個抽象類別。您用的是Javax.mail.internet.InternetAddress 類. 

用法: 
InternetAddress from=new InternetAddress("xxf@cafe.com"); 


(6) javax.mail.Store類 
Store類實現特定郵件協議上的讀、寫、監視、尋找等操作。通過Javax.mail.Store類可以訪問Javax.mail.Folder類。 

用法: 
Store store=s.getSorte("pop3");//s為一個郵件會話 
store.connect(popserver,username,password);//通過你提供的pop地址,使用者名稱和密碼登入你的郵箱 


(7) javax.mail.Folder類 
Folder類用於分級組織郵件，並提供照Javax.mail.Message格式訪問email的能力。 

用法: 
Folder folder=store.getFolder("INBOX"); 
folder.open(Folder.READ_ONLY); 


(8) javax.mail.Internet.MimeMultpart 
一般儲存電子郵件內容的容器是Multipart抽象類別,它定義了增加和刪除及獲得電子郵件不同部分內容的方法.由於Multipart是抽象類別,我們必須為它使用一個具體的子類,JavaMail API提供javax.mail.Internet.MimeMultpart類來使用MimeMessage對象. 

用法: 
MimeMultipart multipart=new MimeMultipart(); 

注:我們使用MimeMultipart對象的一個方法是addBodyPart(),它在我們的電子郵件內容裡添加BodyPart(BodyPart類在下面緊接著要介紹)對象.訊息可以有很多部分,一個BodyPart可以代表一個部分. 


(9) javax.mail.Internet.MimeBodyPart類 

MimeBodyPart是BodyPart具體用於mimeMessage的一個子類. 
MimeBodyPart對象代表一個MimeMessage對象內容的一部分.每個MimeBodyPart被認為有兩部分: 
⊙一個MIME類型 
⊙匹配這個類型的內容 

用法: 
MimeBodyPart mdp=new MimeBodyPart(); 
String text="Hello JavaMail!"; 
mdp.setContent(text,"text/plain");//定義MIME類型為text/plain,並設定MimeBodyPart的內容. 


(10) javax.activation.DataHandler類(包含在JAF中) 
JavaMail API不限制資訊只為文本,任何形式的資訊都可能作繭自縛MimeMessage的一部分.除了文本資訊,作為檔案附件包含在電子郵件資訊的一部分是很普遍的.JavaMail API通過使用DataHandler對象,提供一個允許我們包含非文本BodyPart對象的簡便方法. 

用法: 
DataHandler dh=new DataHandler(text,type); 
mdp.setDatahandler(dh);//mdp是一個MimeBodyPart對象 


(11) javax.activation.FileDataSource類(包含在JAF中) 
一個FileDataSource對象可以表示本地檔案和伺服器可以直接存取的資源.一個本地檔案可以通過建立一個新的MimeBodyPart對象附在一個mimeMessage對象上. 

用法: 
MimeMultipart mm=new MimeMultipart(); 
MimeBodyPart mdp=new MimeBodyPart(); 
FileDataSource fds=new FileDataSource("c:/exam.txt"); 
mdp.setDataHandler(new DataHandler(fds)); //設定資料來源 
mm.addBodyPart(mdp); //為當前訊息MimeMultipart對象增加MimeBodyPart 


(12) javax.activation.URLDataSource類(包含在JAF中) 
遠端資源,URL不會指向它們,由一個URLDataSource對象表示.一個遠端資源可以通過建立一個新mimeBodyPart對象附在一個mimeMessage對象上(同FileDataSource差不多).