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>