mule in action翻译17 : 3.5 使用EMAIL传输

mule in action翻译17 : 3.5  使用EMAIL传输

    email常被看成是主要用来进行个人之间通讯的，但它不仅仅是一个会话机制。email可用来转发监控警告，发送订单收据，协调调度。想一下当你在网站注册时、在亚马逊买书时，是不是经常会收到自动发送的邮件？这就是email传输的例子。本节中探讨如何使用email传输处理并生成这些消息。先看使用IMAP接收这些消息，然后看如何使用SMTP发送消息。

3.5.1  使用IMAP接收email

    IMAP连接器允许你使用IMAP协议从邮件服务器接收邮件。IMAP --Internet Message Access Protocol

获取邮件的流行的方式，多数邮件服务器和客户端都支持IMAP。 IMAP是和不提供常规集成机制的应用进行集成的方便方式。例如一个遗留系统周期性的生成状态邮件，但不提供任何类型的可编程API。有时email是应用集成的更好的方式。比如当你需要以编程方式回应电子邮件确认时。这种情况下使用IMAP endpoint非常合适。

表3.4  列出IMAP一般的配置属性。

Prancing Donkey最近购买了一个由Frozen North Freezing公司制造的制冷系统。

该制冷系统有这么个功能：当某个环境指标超过阈值时会向某个地址发送邮件。Prancing Donkey想使用

这个功能驱动一些附属功能。例如，希望当这些事件发生时维护人员会受到短信通知。

他们也想发送数据到一个复杂事件处理系统， 以用来推断什么时候会可能发生灾难性事件。

他们联合使用IMAP传输、JMS topic、文件传输来实现这些功能。如下面列表及3.14图所示。

Listing 3.18 Dispatch cooling emails to a JMS topic

<jms:activemq-connector name="jmsConnector" specification="1.1" brokerURL="${jms.url}" />
<!-- 注释1 配置IMAP连接器 -->
<imap:connector name="imapConnector" deleteReadMessages="true" checkFrequency="60000" />
<flow name="dispatchCoolingAlerts"><!-- 配置IMAP inbound endpoint，指定邮件服务器详细信息 --><imap:inbound-endpoint host="${imap.host}" port="${imap.port}"user="cooling" password="password"></imap:inbound-endpoint><!-- 这个all 路由器会分发到多个endpoint --><all><file:outbound-endpoint path="./data/cooling/reports"><!-- 表达式转换器用来从mule消息中提取邮件附件  --><expression-transformer expression="#[message.inboundAttachments.report]" /></file:outbound-endpoint><jms:outbound-endpoint topic="cooling.alerts"><!--注释2 转换email为String形式 --><email:email-to-string-transformer /></jms:outbound-endpoint></all>
</flow>

    all 路由器可以把同个消息发送到多个endpoint，第5章深入讨论。现在用它保存邮件的附件

（本例是制冷报告的PDF）到一个归档目录，然后把email消息发送到JMS topic。某些协议是

支持附件的比如SOAP 和 HTTP 。本例中你可以使用附件计算器来提取附件，如列表3.18中一样。

注释1处，是显示定义IMAP连接器。设置checkFrequency为10分钟（单位毫秒）。

         设置deleteReadMessages为true，消息被读取后将会在服务器上删除。

注释2处，注意email的命名空间。email命名空间包含消息处理器，这里用的email-to-email

         String转换器，这些处理器简化了邮件消息处理。  

最佳实践  使用backupFolder和backupEnabled属性时要注意。mule将为它处理的每个

消息创建一个文件夹。在邮件压力大的环境下可能导致文件系统问题比如文件系统地方inode被耗尽。

3.5.2 使用SMTP发送邮件

    SMTP传输让你可以使用一个outbound endpoint发送邮件消息。这在多种情况下是有用的。你已经看到了Prancing Donkey公司的制冷系统使用SMTP发送警告数据。你现在对机动接受购物确认邮件、论坛订阅邮件没有疑问了。在完成一个长耗时处理后发送通知送邮件的方式的是比较有用的，比如备份完成时进行通知。

来看如何配置SMTP连接器和endpoint。

列表3.5 列出了配置SMTP的常用属性。一般可以通过这些属性指定生产的邮件头信息。

    来回顾一下本章开头时提到的 Arnor Accounting 的例子。列表3.14 中当收到 Arnor Accounting 应用的回调时分发一个JMS消息。列表3.15 中添加了一个对JMS topic的订阅者，以记录事件。现在添加另外一个订阅者，当支出报表别处理后发送email给Prancing Donkey 会计人员。

Listing 3.19 Using an SMTP endpoint to send an email

<flow name="sendExpenseReportEmails"><!--注释1 订阅expenses.status topic--><jms:inbound-endpoint topic="expenses.status" exchange-pattern="one-way"/><!--配置 SMTP outbound endpoint--><smtp:outbound-endpoint from="mule@prancingdonkey.com" host="${smtp.host}" port="${smtp.port}" subject="Expense Report Processed" to="accounting@prancingdonkey.com"><!--把消息payload转为email-->	 <email:string-to-email-transformer/></smtp:outbound-endpoint>
</flow>

注释1处 配置JMS endpoint，当消息发送到 expenses.status topic时，这里的JMS endpoint会受到通知。

这些消息的payload将转换为email，并通过SMTP outbound endpoint发送到accounting@prancingdonkey.com 。