Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

第 5 章 配置 JavaMail 資源

本章介紹如何為使用 JavaMail API 的應用程式配置資源。它包含以下小節:

關於 JavaMail

JavaMail API 是一組用於建立郵件系統模型的抽象 API。API 提供了一個獨立於平台和協定的架構來建置郵件和訊息傳送應用程式。JavaMail API 提供了多個工具用於讀取和傳送電子郵件。服務提供者可實作特定協定。

JavaMail API 可做為 Java 平台選擇性套裝軟體實作,還可做為 J2EE 平台的一部分使用。

Application Server 包含 JavaMail API 以及 JavaMail 服務提供者,使應用程式元件可以透過網際網路傳送電子郵件通知,以及從 IMAP 和 POP3 郵件伺服器讀取電子郵件。

如需有關 JavaMail API 的更多資訊,請至 JavaMail 網站 (http://java.sun.com/products/javamail/)。

有關 JavaMail 的 管理主控台 作業

Procedure建立 JavaMail 階段作業

  1. 在樹形元件中,展開 [資源] 節點,然後選取 [JavaMail 階段作業] 節點。

  2. 在 [JavaMail 階段作業] 頁面中,按一下 [新建]。

    將顯示 [建立 JavaMail 階段作業] 頁面。

  3. 在 [JNDI 名稱] 欄位中,鍵入階段作業的名稱。

    建議的作業是使用 JavaMail 資源的命名子環境前綴 mail/。例如︰mail/MySession

  4. 在 [郵件主機] 欄位中,鍵入預設郵件伺服器的主機名稱。

    如果未提供協定特定的主機特性,Store 和 Transport 物件的連線方法將使用該值。名稱必須可以解析為實際的主機名稱。

  5. 在 [預設使用者] 欄位中,鍵入連線至郵件伺服器時要提供的使用者名稱。

    如果未提供協定特定的使用者名稱特性,Store 和 Transport 物件的連線方法使用該值。

  6. 在 [預設傳回位址] 欄位中,鍵入預設使用者的郵件位址,格式為 username@host.domain

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

  8. 在 [進階] 區域中,僅當已將 Application Server 的郵件提供者重新配置為使用非預設儲存或傳輸協定時,才需要變更這些欄位值。

    依預設,儲存協定為 imap;儲存協定類別為 com.sun.mail.imap.IMAPStore;傳輸協定為 smtp;傳輸協定類別為 com.sun.mail.smtp.SMTPTransport

  9. 選取 [除錯] 核取方塊以啟用郵件階段作業的附加除錯輸出 (包括通訊協定追蹤)。

    如果將 JavaMail 記錄層級設為 FINE 或更精細,則系統會產生除錯輸出,並且該輸出會包含在系統記錄檔中。請參閱配置記錄層級,以取得有關設定記錄層級的資訊。

  10. 在 [附加特性] 區域中,按一下 [增加特性] 以新增應用程式所需的特性 (如協定特定的主機或使用者名稱特性)。

    JavaMail API 文件列出了可用的特性 (http://java.sun.com/products/javamail/javadocs/index.html)。

  11. 在 [目標] 區域中,執行以下操作:

    1. 從 [可用] 欄中選取一個或多個目標,在這些目標上將部署使用了資源的應用程式。

      可用目標包括可用叢集和可用伺服器實例,以及預設的伺服器實例 server

    2. 按一下 [新增] 以將目標移至 [選取] 欄中。

  12. 按一下 [確定] 以儲存階段作業。

等效的 asadmin 指令

create-javamail-resource

Procedure編輯 JavaMail 階段作業

  1. 在樹形元件中,展開 [資源] 節點,然後選取 [JavaMail 階段作業] 節點。

  2. 在 [JavaMail 階段作業] 頁面中,選取要編輯的階段作業。

  3. 在 [編輯 JavaMail 階段作業] 頁面中,您可以執行以下作業:

    • 修改 [郵件主機]、[預設使用者]、[預設傳回位吞 和 [描述] 欄位中的值。

    • 選取或取消選取 [啟用] 核取方塊以啟用或停用資源。

    • 修改 [進階] 欄位中的值。

    • 新增、移除或修改特性。

  4. 按一下 [目標] 標籤以移至 [JavaMail 階段作業目標] 頁面。在此頁面中,執行以下操作:

    1. 按一下 [管理目標] 以開啟 [管理資源目標] 頁面。

      在此頁面中,在 [可用] 欄與 [選取] 欄之間移動目標。確定將目標放入 [選取] 欄中。使用了資源的應用程序將部署在這樣的目標上。可用目標包括可用叢集和可用伺服器實例,以及預設的伺服器實例 server。按一下 [確定] 以儲存變更。

    2. 選取目標的核取方塊,然後按一下 [啟用] 或 [停用],以啟用或停用目標的資源。

  5. 按一下 [儲存] 以儲存變更,或按一下 [載入預設值] 以復原郵件階段作業的預設值。

Procedure刪除 JavaMail 階段作業

  1. 在樹形元件中,展開 [資源] 節點,然後選取 [JavaMail 階段作業] 節點。

  2. 在 [JavaMail 階段作業] 頁面中,選取要刪除的階段作業的名稱旁邊的核取方塊。

  3. 按一下 [刪除]。

等效的 asadmin 指令

delete-javamail-resource