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

第 5 章 配置 资源

本章介绍了如何为使用 JavaMail API 的应用程序配置资源。它包含以下小节:

关于 JavaMail

JavaMail API 是一组用于建立邮件系统模型的抽象 API。API 提供了一个与平台无关以及与协议无关的框架来建立邮件应用程序和消息传送应用程序。JavaMail API 提供了多个工具用于读取和发送电子邮件。服务提供商可实现特定协议。

JavaMail API 可作为 Java 平台可选软件包实现,还可作为 J2EE 平台的一部分使用。

Application Server 包含 JavaMail API 以及 JavaMail 服务提供商,使应用程序组件可以通过 Internet 发送电子邮件通知,以及从 IMAP 和 POP3 邮件服务器读取电子邮件。

有关 JavaMail API 的更多信息,请转至 JavaMail Web 站点 (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 或 FINER,将生成调试输出,并且此输出将包含在系统日志文件中。有关设置日志级别的信息,请参见配置日志级别

  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