第 5 章 配置 JavaMail 資源

Application Server 包含 JavaMail API。JavaMail API 是一組用於建立郵件系統模型的抽象 API。API 提供了一個獨立於平台和協定的架構來建置郵件和訊息傳送應用程式。JavaMail API 提供讀取、撰寫與傳送電子郵件的功能。服務提供者可實作特定協定。您可以使用 JavaMail API 為您的應用程式增加電子郵件功能。JavaMail 可讓 Java 應用程式存取您的網路或網際網路上，能使用網際網路郵件存取通訊協定 (IMAP) 與簡易郵件傳輸協定 (SMTP) 之郵件伺服器。它不提供郵件伺服器功能；因此您必須能夠存取郵件伺服器才能使用 JavaMail。

如需瞭解有關 JavaMail API 的更多資訊，請參閱 JavaMail 網站，網址為 http://java.sun.com/products/javamail/index.html

本章包括下列小節：

• 建立 JavaMail 階段作業

建立 JavaMail 階段作業

若要配置 JavaMail 以在 Application Server 中使用，請在 Application Server 的 Admin Console 中建立郵件階段作業。這樣可讓伺服器端元件與應用程式使用 JNDI (利用您為它們指定的階段作業特性) 存取 JavaMail 服務。建立郵件階段作業時，您可以在 Admin Console 中指定郵件主機、傳輸與儲存協定，以及預設郵件使用者，這樣使用 JavaMail 的元件就不需要設定這些特性。經常使用電子郵件功能的應用程式可從中獲益，因為 Application Server 會建立單一階段作業物件，並透過 JNDI 提供給任何需要它的元件。

若要使用 Admin Console 建立 JavaMail 階段作業，請選取 [資源] > [JavaMail 階段作業]。指定 JavaMail 設定，如下所示：

• JNDI 名稱：郵件階段作業的唯一名稱。對於 JavaMail 資源，請使用子環境前綴 mail/ 來命名。例如︰mail/MySession。

• 郵件主機：預設郵件伺服器的主機名稱。如果未提供協定特定的主機特性，Store 和 Transport 物件的連線方法將使用該值。名稱必須可以解析為實際的主機名稱。

• 預設使用者：連線至郵件伺服器時要提供的使用者名稱。如果未提供協定特定的使用者名稱特性，Store 和 Transport 物件的連線方法使用該值。

• 預設傳回位址：預設使用者的電子郵件地址，格式如下：username@host.domain。

• 說明：提供元件的描述性敘述。

• 階段作業：如果您不希望此時啟用郵件階段作業，請取消選取 [啟用] 核取方塊。

此外，只有重新配置郵件提供者以使用非預設儲存或傳輸協定時，才需要定義以下進階設定：

• 儲存協定：定義要使用的儲存物件通訊方法。依預設，儲存協定是 imap。

• 儲存協定類別：提供可實作想要之儲存協定的儲存通訊方法類別。依預設，儲存協定類別是 com.sun.mail.imap.IMAPStore。

• 傳輸協定：指定傳輸通訊方法。依預設，傳輸協定是 smtp。

• 傳輸協定類別：定義傳輸類別的通訊方法。依預設，傳輸協定類別是 com.sun.mail.smtp.SMTPTransport。

• 除錯：選取此核取方塊可為此郵件階段作業啟用額外的除錯輸出功能，包括協定追蹤。如果將 JavaMail 記錄層級設為 FINE 或更精細，則系統會產生除錯輸出，並且該輸出會包含在系統記錄檔中。請參閱設定自訂記錄層級，以取得有關設定記錄層級的資訊。

• 其他特性：建立應用程式所需的特性，例如協定特定的主機或使用者名稱特性。JavaMail API 文件列出了可用的特性。