第 5 章 配置 JavaMail 资源

Application Server 包含 JavaMail API。JavaMail API 是一组用于建立邮件系统模型的抽象 API。API 提供了一个与平台无关以及与协议无关的框架来建立邮件应用程序和消息传送应用程序。JavaMail API 提供了用于读取、撰写和发送电子邮件的工具。服务提供商可实现特定协议。使用 JavaMail API，您可以向应用程序中添加电子邮件功能。通过 JavaMail，可以从 Java 应用程序访问网络或 Internet 上支持 Internet 消息访问协议 (Internet Message Access Protocol, IMAP) 和简单邮件传输协议 (Simple Mail Transfer Protocol, SMTP) 的邮件服务器。它不提供邮件服务器功能；您必须有权访问邮件服务器，才能使用 JavaMail。

要了解有关 JavaMail API 的更多信息，请查阅位于以下位置的 JavaMail Web 站点：http://java.sun.com/products/javamail/index.html。

本章包括以下部分：

• 创建 JavaMail 会话

创建 JavaMail 会话

要配置 JavaMail 以便用于 Application Server 中，请在 Application Server 管理控制台中创建邮件会话。这样，服务器端组件和应用程序就可以使用您为它们指定的会话属性通过 JNDI 访问 JavaMail 服务。创建邮件会话时，您可以在管理控制台中指定邮件主机、传输和存储协议以及默认邮件用户，这样，使用 JavaMail 的组件就不必设置这些属性。具有大量电子邮件用户的应用程序会从中受益，因为 Application Server 将创建一个会话对象，并使任何需要该对象的组件均可通过 JNDI 使用该对象。

要使用管理控制台创建 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 或 FINER，将生成调试输出，并且此输出将包含在系统日志文件中。有关设置日志级别的信息，请参见设置自定义日志级别。

• 其他属性：创建应用程序所需的属性，例如特定于协议的主机或用户名属性。JavaMail API 文档列出了可用属性。