JavaMail 整合 Hotmail 實戰：基於 WebDAV 的 JDAVMail 解決方案

Hotmail (Outlook.com) 不支援標準 POP3/SMTP/IMAP 協定，導致 JavaMail 無法直接存取。本文深度解析 Hotmail 的 WebDAV/HTTPMail 協定機制，引入開源專案 JDAVMail 實作 JavaMail Provider，完整示範郵件收發整合代碼。

核心挑戰：協定不匹配

• JavaMail 定義標準 SPI：`Store` (收信)、`Transport` (發信)、`Provider` (協定實作)
• Hotmail 使用 WebDAV over HTTPS (HTTPMail 端點: `https://services.msn.com/svcs/hotmail/httpmail.asp`)
• 標準 JavaMail 無內建 WebDAV Provider → 需自行實作或使用第三方庫

WebDAV 協定優勢

WebDAV (Web Distributed Authoring and Versioning) 擴充 HTTP 解決：

1. 寫入保護：鎖定機制防止並發衝突
2. 資源管理：集合 (Collection) 概念類似檔案系統目錄
3. 文件屬性：XML 基礎的可擴充中繼資料 (發件人、時間、標題等)

JDAVMail 專案架構

• 基於：Jakarta Commons HttpClient (HTTP 通訊) + JDOM (XML 解析) + Commons Logging
• 提供兩大 Provider：
  • `davmail` (Store) — 收信
  • `davmail_xmit` (Transport) — 發信
• 部署：將 `JDAVMail.jar` + 相依 JAR 放入 Classpath，無需修改代碼即可透過協定名稱自動載入

Provider 註冊機制揭秘

JAR 內 `META-INF/javamail.providers`：

protocol=davmail; type=store; class=com.posisoft.jdavmail.JDAVMailStore; vendor=Positive Software
protocol=davmail_xmit; type=transport; class=com.posisoft.jdavmail.JDAVMailTransport; vendor=Positive Software

JavaMail 依協定名稱查找此檔案，動態載入對應實作類別。

完整收發代碼實戰

1. 郵件接收

Properties props = new Properties();
Session session = Session.getInstance(props);

// 關鍵：使用 "davmail" 協定名稱
Store store = session.getStore("davmail");
// Hotmail 伺服器固定，無需指定 host
store.connect(null, "your_account@hotmail.com", "password");

if (store.isConnected()) {
    Folder inbox = store.getFolder("INBOX");
    if (inbox.exists()) {
        inbox.open(Folder.READ_ONLY);
        int count = inbox.getMessageCount();
        System.out.println("Inbox contains " + count + " messages");
        
        for (int i = 1; i <= count; i++) {
            Message msg = inbox.getMessage(i);
            System.out.println("Subject: " + msg.getSubject());
            System.out.println("From: " + msg.getFrom()[0]);
            System.out.println("Content-Type: " + msg.getContentType());
            System.out.println("Content: " + msg.getContent());
        }
    }
    inbox.close(false);
    store.close();
}

2. 郵件發送

Properties props = new Properties();
// 設定發件人 (Hotmail 強制要求)
props.setProperty("mail.davmail.from", "your_account@hotmail.com");
Session session = Session.getInstance(props);

Transport transport = session.getTransport("davmail_xmit");
transport.connect(null, "your_account@hotmail.com", "password");

MimeMessage message = new MimeMessage(session);
message.setSubject("Test from JavaMail");
message.setFrom(new InternetAddress("your_account@hotmail.com"));
message.addRecipient(Message.RecipientType.TO, 
    new InternetAddress("recipient@example.com", "Recipient"));
message.setText("Hello from JDAVMail!");
message.setSentDate(new Date());

transport.sendMessage(message, message.getAllRecipients());
transport.close();

實測注意事項

• 發信延遲：Hotmail 發信常需數分鐘才送達，屬伺服器端反垃圾郵件機制，非 JDAVMail 問題
• 帳號格式：完整 Email 地址 (含 @hotmail.com/@outlook.com/@live.com)
• 雙因子驗證：啟用 2FA 的帳號需使用「應用程式密碼」而非登入密碼
• 資料夾名稱：收件箱為 `INBOX`，其他資料夾需列舉 `store.getFolder("*")` 確認名稱

進階：現代替代方案

Microsoft 現已支援標準協定 (需啟用)；建議優先使用：

標準協定相容性更好、效能更穩定、無第三方相依。JDAVMail 適用於舊版 Hotmail 帳號無法啟用標準協定的歷史場景。

架構啟示：JavaMail SPI 擴充模式

1. 實作 `javax.mail.Store` / `Transport` 抽象類別
2. 實作 `javax.mail.Folder` / `Message` 等輔助類別
3. 打包 `META-INF/javamail.providers` 註冊協定
4. 部署至 Classpath，應用層零代碼修改即可切換協定

此設計完美體現 SPI (Service Provider Interface) 與 開放封閉原則。

總結

JDAVMail 透過 WebDAV 橋接 JavaMail 與 Hotmail，展示了標準 SPI 擴充的強大威力。雖現代 Outlook.com 已支援標準協定，但此案例對理解 JavaMail 架構、實作自訂郵件協定、處理非標準郵件系統整合具有極高參考價值。開發者應優先使用標準 IMAP/SMTP，無法時再考慮 JDAVMail 等第三方實作。