WebObjects/Project WONDER/Frameworks/ERJavaMail

概述

ERJavaMail 提供了一个简单而强大的 API，用于从 WebObjects 应用程序发送基于组件的电子邮件。ERJavaMail 不依赖于 Project Wonder 的任何其他部分，是开始使用 Wonder 的好方法。

配置

er.javamail.centralize = true

Centralize 将所有电子邮件发送到 er.javamail.adminEmail 用户。

er.javamail.debugEnabled = true

确定是否显示电子邮件调试信息。这包含协议级别的调试信息。

er.javamail.adminEmail = [email protected]

用于发送集中式电子邮件的管理员用户的电子邮件地址。这是必需的属性。

er.javamail.smtpHost = smtp.domain.com

要使用的 SMTP 主机名。如果未设置，将检查 mail.smtp.host，最终将使用 WOHost。

er.javamail.senderQueue.size = 50

发送者队列可以容纳的消息数量。默认值为 50。

er.javamail.milliSecondsWaitIfSenderOverflowed = 6000

如果发送者队列已满，则等待的毫秒数。默认值为 6000。

er.javamail.smtpAuth = true

设置是否使用身份验证 SMTP 发送传出邮件。如果设置，er.javamail.smtpUser 也必须设置（最好设置 er.javamail.smtpPassword）。

er.javamail.smtpUser = smtpusername

用于登录身份验证 SMTP 服务器的用户名。

er.javamail.smtpPassword = smtppassword

用于登录身份验证 SMTP 服务器的密码。

er.javamail.XMailerHeader =

要添加到所有传出邮件消息的 X-Mailer 标头。默认值为无。

er.javamail.defaultEncoding = UTF-8

用于消息内容的默认字符编码。默认为 ???。

er.javamail.WhiteListEmailAddressPatterns =

一个以逗号分隔的白名单电子邮件地址模式列表。如果设置，则只有与其中一个白名单模式匹配的地址才会被传递。

er.javamail.BlackListEmailAddressPatterns =

一个以逗号分隔的黑名单电子邮件地址模式列表。如果设置，则任何与黑名单模式匹配的电子邮件地址都不会被传递。

示例用法

 // Create an instance of an ERMailDelivery subclass
 ERMailDeliveryHTML mail = new ERMailDeliveryHTML ();
 
 // Here ERMailDeliveryHTML needs a WOComponent to 
 // render the HTML text content.
 mail.setComponent(mailPage);
 
 // Here you create a new instance of the message
 // You can loop over this fragment of code, not 
 // forgetting to use newMail ()
 // before you set the attributes of the message.
 try {
   mail.newMail();
   mail.setFromAddress(emailFrom);
   mail.setReplyToAddress(emailReplyTo);
   mail.setSubject(emailSubject);
   mail.setToAddresses(new NSArray (toEmailAddresses));
   // Send the mail.  There is an optional sendMail(boolean) that 
   // optionally blocks during the send.
   mail.sendMail();
 } catch (Exception e) {
   // handle the exception ...
 }

带有附件的邮件发送示例

ERMailDelivery 的子类不仅会为您传递邮件，还会创建消息。因此，ERMailDelivery 在某种程度上更像是一条消息，而不是一种传递机制。对于要发送的每条消息，实例化 ERMailDelivery 的具体子类（例如 ERMailDeliveryPlainText）。然后，您可以向其中添加附件。下面是发送带有附件的邮件的简单代码段。附件的 MimeType 是从文件名扩展名中解析出来的。

默认情况下，发送邮件是异步的，您可以指定一个标志（true == 应该阻塞，false == 不应该阻塞）来影响行为。

 byte[] content; // assume this exist, same interface exists for NSData, too
 // Create an instance of an ERMailDelivery subclass
 ERMailDeliveryPlainText message = new ERMailDeliveryPlainText();
 // set the text and subject
 message.setTextContent("Some Mail text");
 message.setSubject("The mail subject");
 // add the attachment
 message.addAttachment(new ERMailDataAttachment("myattachment.zip", null, content));
 message.setToAddress("[email protected]");
 message.setFromAddress("[email protected]");
 // send the mail asynchronously
 message.sendMail();

注意事项

注意包含您正在发送的组件的 WOContext。如果您在正常的请求-响应循环中使用 ERMailDeliveryHTML，并且使用默认的 WOContext，那么很有可能发送给用户的下一个页面将是您发送的电子邮件组件，而不是您想要发送的页面。为此，有几种可能的解决方法。一种方法是从您的动作方法返回特定组件而不是 null。我使用以下代码获得了更好、更一致的成功

 WOContext context = (WOContext) context().clone();
 MyComponent component = (MyComponent) WOApplication.application().pageWithName(MyComponent.class.getName(), context);
 ERMailDeliveryHTML mail = new ERMailDeliveryHTML();
 mail.setComponent(component);
 ...

这似乎可以将电子邮件正确隔离到当前上下文的克隆中，而不是实际的活动上下文。您的里程可能会有所不同。