2019-01-05

EnjoyingSoft之Mule ESB开发教程第四篇：Mule Expression Language - MEL表达式

本篇主要介绍Mule表达式语言，Mule Expression Language，简称MEL。MEL是一种轻量级，在Mule ESB使用的表达式语言，可用于访问和计算Mule Message的Payload，Property和Variable。几乎每一个Mule组件都可以使用MEL表达式。MEL表达式能够帮助开发者高效和优雅地过滤，路由，处理Mule message。关于Mule message基本概念，请参考第二篇和第三篇文章。

Mule ESB是一个使用Java语言，基于Spring框架编写的开源企业服务总线，其相关源代码托管在GitHub上。企业服务总线英文Enterprise Service Bus，简称ESB。

MuleESB在众多开源的ESB中处于领先者的地位，拥有来自世界各地数十万个开发人员，超过数百万的下载量。MuleSoft公司也作为开源软件中的独角兽，2017年在纽交所成功上市。我们作为MuleSoft的重要合作伙伴也参与其中，在六年多的时间里，使用Mule ESB企业版开发，或者Mule ESB社区版开发，构建了众多Mule ESB实施案例，帮助国内众多的企业成功上线企业集成项目。

我们使用Mule ESB开发的过程中，体会到它优秀的架构设计和高效的开发速度。同时也深感Mule ESB开发书籍，Mule ESB中文文档资料非常稀少，所以使用8篇文章来写基础Mule ESB基础开发教程课程系列，讲解如何使用Mule ESB开发。

EnjoyingSoft之Mule ESB开发教程第一篇：初识Mule ESB
EnjoyingSoft之Mule ESB开发教程第二篇：Mule ESB基本概念
EnjoyingSoft之Mule ESB开发教程第三篇：Mule message structure - Mule message结构
EnjoyingSoft之Mule ESB开发教程第四篇：Mule Expression Language - MEL表达式
EnjoyingSoft之Mule ESB开发教程第五篇：控制消息的流向-数据路由
EnjoyingSoft之Mule ESB开发教程第六篇：Data Transform-数据转换
EnjoyingSoft之Mule ESB开发教程第七篇：SOAP Web Service的消费和创建
EnjoyingSoft之Mule ESB开发教程第八篇：使用API构建Rest Service

1. MEL的优势

在Mule ESB上有很多方法可以操作Mule Message，比如Java语言或者其他脚本语言(比如JavaScript等)。但是MEL表达式是Mule推荐使用，在Mule应用中的一个统一和标准的方法。

MEL表达式为开发人员提供了一个一致的标准化语言，用来访问和计算Mule Message的Payload（负载），Property（属性）和Variable（变量）。
MEL基于Mule特定的对象，Studio中提供auto-complete（自动完成，语法提示）的功能，帮助开发者快速编码。
更重要的是，Mule的绝大多数组件都支持MEL，比如路由组件，过滤组件等。

MEL的示例，这个示例在在Mule的Logger组件中使用MEL表达式获取FlowVars。

从下图可以看到，我们在Logger组件中使用MEL表达式，能够提供语法提示，该提示带出了上一步设定的customerNo变量。

XML配置如下：

<flow name="mel-flow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/" doc:name="HTTP"/>
        <set-variable variableName="customerNo" value="#[1008]" doc:name="customerNo"/>
        <logger message="The customerNo is #[flowVars.customerNo]" level="INFO" doc:name="Logger"/>
</flow>

注意：MEL是一种表达式，和脚本语言类似，但并不相同。表达式通常用于动态获取值或者设定值，或对数据进行简单的操作。表达式语言和脚本语言之间在功能上存在重叠，但如果您编写的内容非常复杂，需要的不仅仅是几行代码，或者您需要包含条件逻辑，那么脚本语言通常会更有用。如果简单的获取或设定值，调用方法或执行函数，则使用表达式则更方便。

2. MEL的使用场景

MEL表达式常用的使用场景大概可以分成三种。

获取值
- #[payload]
  - 表示获取message的负载
- #[message.inboundProperties.'http.query.params'.customerNo]
  - 表示获取查询参数customerNo
- #[payload.callMethod(parameters)
  - 表示调用payload对象的callMethod方法，并获取方法返回值
- #[xpath('//root/element')]
  - 表示使用xpath语法解析并获取相应节点内容。
条件比较，返回的结果就是布尔变量
- #[payload.amount > 2000]
- #[message.inboundProperties.'http.method' == 'GET']
  - 表示判断HTTP请求是不是GET方法
设定值，通常用于Message Enricher组件。
- #[flowVars.dbResult]
  - 这里表示相应的值设定到dbResult变量中。

3. MEL的示例

使用表达式提取值，根据消息的内容，属性决定执行流程。在下面的示例中，payload是一个Java对象，我们根据购买类型，将订单分发路由到不同的JMS消息队列中。

<choice>
   <when expression="#[payload.getOrderType() == 'book']">
        <jms:outbound-endpoint queue="bookQueue" />
    </when>
   <when expression="#[payload.getOrderType() == 'music']">
        <jms:outbound-endpoint queue="musicQueue" />
    </when>
</choice>

使用表达式提取值，并将值传递给Connector，如下示例就是使用MEL计算的值设定SMTP Connector的邮件标题，邮件接收人等。
1
<smtp:outbound-endpoint from="#[flowVars.mailFrom]" to="#[flowVars.mailTo]" subject="#[payload.mailSubject]" doc:name="SMTP"/>
如果payload是Java对象，可以调用payload方法，获取方法的返回值。示例就说调用calAmount方法，并打印计算出来的金额。
1
<logger message="#[payload.calAmount()]" />

4. MEL的上下文对象

我们在上述的MEL表达式示例中可以看到MEL有多个部分组成，第一部分就是上下文对象。MEL常见的上下文对象如下:

上下文对象	说明
#[server]	当前服务器，可以获取服务器的时间，JDK版本等，如#[server.dateTime]，#[server.javaVersion]
#[mule]	当前Mule实例，可以获取Mule的版本，目录等。如#[mule.version]
#[app]	当前Mule应用的实例，可以获取应用的名称等。如#[app.name]
#[message]	这个是我们最经常使用的对象，就说Mule message。如#[message.payload]，#[message.inboundProperties.’http.query.params’.customerNo]等

server上下文对象的常用属性:

Field	Field描述
dateTime	系统当前时间
host	主机名
ip	主机IP
osName	操作系统名称
userName	当前用户
userDir	当前用户工作目录

mule上下文对象的常用属性:

Field	Field描述
home	Mule Runtime的安装目录
version	Mule Runtime的版本
nodeId	集群下的本机ID
clusterId	集群ID

app上下文对象的常用属性:

Field	Field描述
name	Mule App应用名称
workdir	Mule App工作目录

message上下文对象的常用属性:

Field	Field描述
id	message的唯一ID
rootId	message的根ID
payload	message的负载
inboundProperties	message的inbound头信息
inboundAttachments	message的inbound附件信息
outboundProperties	message的outbound头信息
outboundAttachments	message的outbound附件信息

5. MEL的Variable

不同于第4点提到的上下文对象，MEL中还可以使用变量，使用变量并不要求在表达式中使用上下文对象。变量是顶层的标识符。MEL中常见的变量如下：

flowVars - flowVars的有效范围是在一个Flow中，定义flowVars之后，后续的Message Processor都可以使用。
sessionVars - 在跨Flow通信时，可以使用sessionVars来传递变量。需要注意的是，sessionVars并不总是有效的，其实取决于Inboud Endpoint的类型。后续再出专题介绍flowVars和sessionVars等之间的区别。

1	#[flowVars.foo = sessionVars.bar]

上述的表达式的意思是，将session变量赋值给flow变量。

6. MEL访问属性

点语法。适用对象通常是Java Pojo。MEL中可以使用点语法来访问相关的对象属性，同样对象属性的属性也是可以用点号来访问的。
1
#[message.payload.item.name]
Null安全性访问。Java编程中经常遇到NullPointerException错误，也就是说对空对象进行访问操作会报错。而在MEL表达式，可以通过点语法.?来避免出错。如下示例，即使item为null，该表达式仍然不会报错，它会返回null值。
1
#[message.payload.?item.name]
属性名称的转义。如果属性名称有特殊字符，那么使用点语法会遇到问题，这个时候可以单引号进行转义。如下示例，http.query.params是一个整体。我们访问这个属性名，必须使用单引号进行转义。
1
#[message.inboundProperties.'http.query.params'.customerNo]
中括号语法。如果对象是数组，或者Map，那么可以使用中括号进行访问
1
#[payload[5]]
1
#[payload['userName']]

7. MEL操作符

常用的操作符如下，和普通的开发语言类似。还有更多的操作符可以查阅官方手册。

算术运算符 + - / * %

#[2 + 4] #['fu' + 'bar']
比较运算符 == != > < >= <=

#['A' == 'A'] #[7 > 5]
逻辑运算符 && ||

#[(a == b) && (c != d)]
三元操作符

#[lastname = (name == 'Smith') ? 'Smith' : 'Unknown']

本文同步发文于EnjoyingSoft之Mule ESB开发教程第四篇：Mule Expression Language - MEL表达式

访问EnjoyingSoft 网站，获取更多Mule ESB 开发，Mule ESB 实施，Mule ESB 社区版实施，Mule ESB实施，Mule ESB社区版实施帮助。

欢迎转载，但必须保留原文和此段声明，且在文章页面明显位置给出原文链接，否则保留追究法律责任的权利。