JavaMail(JAVA郵件服務） API詳解 （2）

F．Transport
在發送資訊時，Transport類將被用到。這個類實現了發送資訊的協議（通稱為SMTP），此類是一個抽象類別，我們可以使用這個類的靜態方法send()來發送訊息：
Transport.send(message);
當然，方法是多樣的。我們也可由Session獲得相應協議對應的Transport執行個體。並通過傳遞使用者名稱、密碼、郵件伺服器主機名稱等參數建立與郵件伺服器的串連，並使用sendMessage()方法將資訊發送，最後關閉串連：
message.saveChanges(); // implicit with send()Transport transport = session.getTransport("smtp");transport.connect(host, username, password);transport.sendMessage(message, message.getAllRecipients());transport.close();
評
論：上面的方法是一個很好的方法，尤其是在我們在同一個郵件伺服器上發送多個郵件時。因為這時我們將在串連郵件伺服器後連續發送郵件，然後再關閉掉串連。
send()這個基本的方法是在每次調用時進行與郵件伺服器的串連的，對於在同一個郵件伺服器上發送多個郵件來講可謂低效的方式。
注意：如果需要在發送郵件過程中監控mail命令的話，可以在發送前設定debug標誌：
session.setDebug(true)。

G．Store和Folder
接
收郵件和發送郵件很類似都要用到Session。但是在獲得Session後，我們需要從Session中擷取特定類型的Store，然後串連到
Store，這裡的Store代表了儲存郵件的郵件伺服器。在串連Store的過程中，極有可能需要用到使用者名稱、密碼或者Authenticator。
// Store store = session.getStore("imap");Store store = session.getStore("pop3");store.connect(host, username, password);
在串連到Store後，一個Folder對象即目錄對象將通過Store的getFolder()方法被返回，我們可從這個Folder中讀取郵件資訊：
Folder folder = store.getFolder("INBOX");folder.open(Folder.READ_ONLY);Message message[] = folder.getMessages();
上
面的例子首先從Store中獲得INBOX這個Folder（對於POP3協議只有一個名為INBOX的Folder有效），然後以唯讀
（Folder.READ_ONLY）的方式開啟Folder，最後調用Folder的getMessages()方法得到目錄中所有Message的數
組。

注意：對於POP3協議只有一個名為INBOX的Folder有效，而對於IMAP協議，我們可以訪問多個Folder（想想前面講
的IMAP協議）。而且SUN在設計Folder的getMessages()方法時採取了很智能的方式：首先接收新郵件列表，然後再需要的時候（比如讀
取郵件內容）才從郵件伺服器讀取郵件內容。
在讀取郵件時，我們可以用Message類的getContent()方法內送郵件或是writeTo()方法將郵件儲存，getContent()方法只內送郵件內容（不包含郵件標頭），而writeTo()方法將包括郵件標頭。
System.out.println(((MimeMessage)message).getContent());
在讀取郵件內容後，別忘記了關閉Folder和Store。
folder.close(aBoolean);store.close();
傳遞給Folder.close()方法的boolean 型別參數表示是否在刪除操作郵件後更新Folder。 

H．繼續向前進！
在講解了以上的七個Java Mail核心類定義和理解了簡單的代碼片斷後，下文將詳細講解怎樣使用這些類實現JavaMail API所要完成的進階功能。

五、使用JavaMail API
在明確了JavaMail API的核心部分如何工作後，本人將帶領大家學習一些使用Java Mail API任務案例。
1．發送郵件
在獲得了Session後，建立並填入郵件資訊，然後發送它到郵件伺服器。這便是使用Java Mail API發送郵件的過程，在發送郵件之前，我們需要設定SMTP伺服器：通過設定Properties的mail.smtp.host屬性。
String host = ...;String from = ...;String to = ...;// Get system propertiesProperties props = System.getProperties();// Setup mail serverprops.put("mail.smtp.host", host);// Get sessionSession session = Session.getDefaultInstance(props, null);// Define messageMimeMessage message = new MimeMessage(session);message.setFrom(new InternetAddress(from));message.addRecipient(Message.RecipientType.TO,   new InternetAddress(to));message.setSubject("Hello JavaMail");message.setText("Welcome to JavaMail");// Send messageTransport.send(message);
由於建立郵件資訊和發送郵件的過程中可能會拋出異常，所以我們需要將上面的代碼放入到try-catch結構塊中。

2．內送郵件
為了在讀取郵件，我們獲得了session，並且串連到了郵箱的相應store，開啟相應的Folder，然後得到我們想要的郵件，當然別忘記了在結束時關閉串連。
String host = ...;String username = ...;String password = ...;// Create empty propertiesProperties props = new Properties();// Get sessionSession session = Session.getDefaultInstance(props, null);// Get the storeStore store = session.getStore("pop3");store.connect(host, username, password);// Get folderFolder folder = store.getFolder("INBOX");folder.open(Folder.READ_ONLY);// Get directoryMessage message[] = folder.getMessages();for (int i=0, n=message.length; i
上面的代碼所作的是從郵箱中讀取每個郵件，並且顯示郵件的發信人地址和主題。從技術角度講，這裡存在著一個異常的可能：當發信人地址為空白時，getFrom()[0]將拋出異常。

下
面的代碼片斷有效說明了如何讀取郵件內容，在顯示每個郵件發信人和主題後，將出現使用者提示從而得到使用者是否讀取該郵件的確認，如果輸入YES的話，我們
可用Message.writeTo(java.io.OutputStream os)方法將郵件內容輸出到控制台上，關於
Message.writeTo()的具體用法請看JavaMail API。
BufferedReader reader = new BufferedReader (  new InputStreamReader(System.in));// Get directoryMessage message[] = folder.getMessages();for (int i=0, n=message.length; i
3．刪除郵件和標誌
設定與message相關的Flags是刪除郵件的常用方法。這些Flags表示了一些系統定義和使用者定義的不同狀態。在Flags類的內部類Flag中預定義了一些標誌：
Flags.Flag.ANSWERED
Flags.Flag.DELETED
Flags.Flag.DRAFT
Flags.Flag.FLAGGED
Flags.Flag.RECENT
Flags.Flag.SEEN
Flags.Flag.USER
但
需要在使用時注意的：標誌存在並非意味著這個標誌被所有的郵件伺服器所支援。例如，對於刪除郵件的操作，POP協議不支援上面的任何一個。所以要確定哪些
標誌是被支援的??通過訪問一個已經開啟的Folder對象的getPermanetFlags()方法，它將返回當前被支援的Flags類對象。
刪除郵件時，我們可以設定郵件的DELETED標誌： 
message.setFlag(Flags.Flag.DELETED, true);
但是首先要採用READ_WRITE的方式開啟Folder：
folder.open(Folder.READ_WRITE);
在對郵件進行刪除操作後關閉Folder時，需要傳遞一個true作為對刪除郵件的擦除確認。
folder.close(true);
Folder類中另一種用於刪除郵件的方法expunge()也同樣可刪除郵件，但是它並不為sun提供的POP3實現支援，而其它第三方提供的POP3實現支援或者並不支援這種方法。
另外，介紹一種檢查某個標誌是否被設定的方法：Message.isSet(Flags.Flag flag)方法，其中參數為被檢查的標誌。

4．郵件認證
我
們在前面已經學會了如何使用Authenticator類來代替直接使用使用者名稱和密碼這兩字串作為
Session.getDefaultInstance()或者Session.getInstance()方法的參數。在前面的小試牛刀後，現在我們將
瞭解到全面認識一下郵件認證。
我們在此取代了直接使用郵件伺服器主機名稱、使用者名稱、密碼這三個字串作為串連到POP3 Store的方式，使用儲存了郵件伺服器主機名稱資訊的屬性檔案，並在獲得Session時傳入自訂的Authenticator執行個體：
// Setup propertiesProperties props = System.getProperties();props.put("mail.pop3.host", host);// Setup authentication, get sessionAuthenticator auth = new PopupAuthenticator();Session session = Session.getDefaultInstance(props, auth);// Get the storeStore store = session.getStore("pop3");store.connect();

PopupAuthenticator
類繼承了抽象類別Authenticator，並且通過重載Authenticator類的getPasswordAuthentication()方法返
回PasswordAuthentication類對象。而getPasswordAuthentication()方法的參數param是以逗號分割的
使用者名稱、密碼組成的字串。
import javax.mail.*;import java.util.*;public class PopupAuthenticator extends Authenticator {  public PasswordAuthentication getPasswordAuthentication(String param) {    String username, password;    StringTokenizer st = new StringTokenizer(param, ",");    username = st.nextToken();    password = st.nextToken();    return new PasswordAuthentication(username, password);  }}