写之前的内容时,Mule刚刚3.0.1版本,很多官方文档还没有更新(尤其示例代码),维持在V2的状态。经过了一年多的时间,Mule社区版发展至了3.2版本,并且推出了Mule Studio可视化开发工具(当前beta状态,支持Mule 3.1.2)。
将以前自己验证的示例代码在3.1.2版本上又跑了一遍(有些变化),在此做一下记录。
一. 服务调用
1. Mule实现并提供Web Service
在Mule上开发并发布一个Web Service供客户端调用。
- 示例配置
<flow name="local-ws">
<core:inbound-endpoint address="http://localhost:65082/services/Echo1"
exchange-pattern="request-response" doc:name="Generic" doc:description="Generic endpoint specified by address URI" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" doc:name="SOAP"
doc:description="Make a web service available via CXF" />
<component doc:name="Component" doc:description="Invoke a Java component">
<singleton-object class="demo.mule.component.Echo" />
</component>
</ flow >- 测试方法
- 在浏览器地址栏中输入“http://localhost:65082/services/Echo1/echo/text/hello”,回车后浏览器中将显示返回结果信息。地址中的“echo”是服务的方法,“text”是方法的参数,“hello”是参数的值。
2. Web Service Proxy
Web Service Proxy用来将客户端的WS请求直接转发至相应的远程WS服务端处理,并返回处理结果。Mule本身不做任何处理。
2.1 配置方式1
- 示例配置
<flow name="local2remote-ws">
<http:inbound-endpoint keep-alive="false" address="http://localhost:65000"
encoding="UTF-8" disableTransportTransformer="false" exchange-pattern="request-response" doc:name="HTTP"
doc:description="" />
<http:outbound-endpoint method="GET" keep-alive="false"
address="http://localhost:5050#[header:INBOUND:http.request]" responseTimeout="10000" encoding="UTF-8"
disableTransportTransformer="false" followRedirects="false" exchange-pattern="request-response"
doc:name="HTTP" doc:description="" />
</ flow >- 说明
- 注意outbound-endpoint中address参数中的表达式。
- 测试方法
- 浏览器中通过“http://localhost:65000/webservice/EchoService?wsdl”(将内容复制,保存为*.wsdl),然后使用SoapUI测试。
2.2 配置方式2
- 示例配置
<pattern:web-service-proxy name="ws-proxy" inboundAddress="http://localhost:65082/services/Echo2"
outboundAddress="http://localhost:65082/services/Echo1?method=echo">
</pattern:web-service-proxy>
- 说明
- Mule为这种常见的场景提供了现成的模式,以简化配置。
- 测试方法
- 通过“http://localhost:65082/services/Echo2?wsdl”获取wsdl文件,然后使用SoapUI测试。
3. Web Service to Web Service
Web Service To Web Service用于在Mule中提供Web Service供客户端调用,Mule接收请求后调用远端的Web Service进行处理,并返回结果。
- 示例配置
<flow name="local-ws2remote-ws">
<core:inbound-endpoint address="http://localhost:65082/services/Echo8"
disableTransportTransformer="false" exchange-pattern="request-response" doc:name="Generic"
doc:description="Generic endpoint specified by address URI" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" doc:name="SOAP"
doc:description="Make a web service available via CXF" />
<core:outbound-endpoint
address="wsdl-cxf:http://server1:5050/mule-business/webservice/EchoService?wsdl&method=Echo" />
</ flow >- 说明
- 注意outbound-endpoint中address参数的配置方式,使用了wsdl-cxf前缀表示此web service是由cxf提供的。
- 测试方法
- 在浏览器中输入“http://localhost:65082/services/Echo8/echo/text/hello”进行测试。
4. Socket to Socket
Socket To Socket用于将客户端的Socket请求转发至远程的Socket服务端处理,并返回处理结果。
- 示例配置
<flow name="tcp2tcp">
<tcp:inbound-endpoint host="localhost" port="7100" responseTimeout="10000"
encoding="UTF-8" disableTransportTransformer="false" exchange-pattern="request-response" doc:name="TCP"
doc:description="The TCP transport enables events to be sent and received over TCP sockets." />
<tcp:outbound-endpoint host="localhost" port="7000" responseTimeout="10000"
encoding="UTF-8" disableTransportTransformer="false" exchange-pattern="request-response" doc:name="TCP"
doc:description="The TCP transport enables events to be sent and received over TCP sockets." />
</ flow >- 说明
- 主要配置host、port参数,表明服务地址。
- 测试方法
- 通过 SimpleServer和SimpleClient测试类,首先启动SimpleServer,然后启动SimpleClient,发送请求并接收处理结果。
5. JMS Topic
客户端发送Web Service请求,Mule将请求消息发送至远程JMS的Topic中。
- 示例配置
<flow name="local-ws2jms-topic">
<core:inbound-endpoint address="http://localhost:65082/services/Echo3"
responseTimeout="10000" encoding="UTF-8" disableTransportTransformer="false" mimeType="text/plain"
exchange-pattern="one-way" doc:name="Generic" doc:description="Generic endpoint specified by address URI" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" doc:name="SOAP"
doc:description="Make a web service available via CXF" />
<jms:outbound-endpoint topic="topic1" responseTimeout="10000" encoding="UTF-8"
disableTransportTransformer="false" disableTemporaryReplyToDestinations="false" exchange-pattern="one-way"
connector-ref="activemqConnector" doc:name="JMS" doc:description="Send or receive messages from a JMS queue" />
</flow>
<flow name="jms-topic2echo">
<jms:inbound-endpoint topic="topic1" responseTimeout="10000" encoding="UTF-8"
disableTransportTransformer="false" disableTemporaryReplyToDestinations="false" exchange-pattern="one-way"
connector-ref="activemqConnector" doc:name="JMS" doc:description="Send or receive messages from a JMS queue" />
<echo-component doc:name="Echo" doc:description="Echoes message payload." />
</ flow >- 说明
- JMS endpoint是单向的,不需要返回值。通过topic属性指定JMS Server的Topic名称,connector-ref指明了使用的JMS连接。
- 测试方法
- 在浏览器地址栏中输入“http://localhost:65082/services/Echo3/echo/text/hello”发送请求,Mule控制台上输出订阅者的处理结果(上述示例中通过Mule配置了一个JMS的订阅者)。也可以通过ActiveMQ的控制台,查看到Topic中增加了一条发布的消息。
二. 基于消息内容的路由
Mule提供基于消息内容的路由机制,根据消息中的指定信息,将消息发送至不同的服务端进行处理。
1. Socket to Socket 路由
- 示例配置
<flow name="tcp2tcp-router">
<tcp:inbound-endpoint host="localhost" port="7101" responseTimeout="10000"
encoding="UTF-8" disableTransportTransformer="false" exchange-pattern="request-response" doc:name="TCP"
doc:description="The TCP transport enables events to be sent and received over TCP sockets." />
<choice>
<when evaluator="jxpath" expression="(req/area)='bj'">
<tcp:outbound-endpoint host="server1" port="7101"
responseTimeout="10000" encoding="UTF-8" disableTransportTransformer="false" exchange-pattern="request-response"
doc:name="TCP" doc:description="The TCP transport enables events to be sent and received over TCP sockets." />
</when>
<when evaluator="jxpath" expression="(req/area)='sh'">
<tcp:outbound-endpoint host="server1" port="7102"
responseTimeout="10000" encoding="UTF-8" disableTransportTransformer="false" exchange-pattern="request-response"
doc:name="TCP" doc:description="The TCP transport enables events to be sent and received over TCP sockets." />
</when>
</choice>
</ flow >- 说明
- 路由使用了<choice>、<when>元素,表示路由分支。When元素使用evaluator指明表达式的解析方式,使用expression描述消息内容的判断条件。
- 测试方法
- 同Socket To Socket测试,消息内容分别为<req><area>bj</area></req>、<req><area>sh</area></req>,查看发送至不同服务器的输出。
2. Web Service to JMS Topic 路由
- 示例配置
<flow name="local-ws2jms-topic-router">
<core:inbound-endpoint address="http://localhost:65082/services/Echo7"
disableTransportTransformer="false" exchange-pattern="request-response" doc:name="Generic"
doc:description="Generic endpoint specified by address URI" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" doc:name="SOAP"
doc:description="Make a web service available via CXF" />
<choice>
<when evaluator="jxpath" expression="(req/area)='bj'">
<jms:outbound-endpoint topic="topic1" responseTimeout="10000" encoding="UTF-8"
disableTransportTransformer="false" disableTemporaryReplyToDestinations="false"
exchange-pattern="one-way" connector-ref="activemqConnector" doc:name="JMS"
doc:description="Send or receive messages from a JMS queue" />
</when>
<when evaluator="jxpath" expression="(req/area)='sh'">
<jms:outbound-endpoint topic="topic2" responseTimeout="10000" encoding="UTF-8"
disableTransportTransformer="false" disableTemporaryReplyToDestinations="false"
exchange-pattern="one-way" connector-ref="activemqConnector" doc:name="JMS"
doc:description="Send or receive messages from a JMS queue" />
</when>
</choice>
</ flow >- 测试方法
- 通过“http://localhost:65082/services/Echo7?wsdl”获取wsdl文件,然后通过SoapUI发送请求,查看返回结果。修改消息内容,查看结果的变化。
3. Web Service to Web Service 路由
- 示例配置
<flow name="local-ws2jms-topic-router">
<core:inbound-endpoint address="http://localhost:65082/services/Echo9"
disableTransportTransformer="false" exchange-pattern="request-response" doc:name="Generic"
doc:description="Generic endpoint specified by address URI" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" doc:name="SOAP"
doc:description="Make a web service available via CXF" />
<choice>
<when evaluator="jxpath" expression="(req/area)='bj'">
<core:outbound-endpoint
address="wsdl-cxf:http://server1:5050/mule-business/webservice/CalcService?wsdl&method=processXml" />
</when>
<when evaluator="jxpath" expression="(req/area)='sh'">
<core:outbound-endpoint
address="wsdl-cxf:http://server2:5050/mule-business/webservice/CalcService?wsdl&method=processXml" />
</when>
</choice>
</ flow >- 测试方法
- 使用“
三. 数据转换
1. 压缩解压
Mule原生提供了gzip压缩方式的Transformer。
- 示例配置
<flow name="gzip">
<stdio:inbound-endpoint ref="stdioInEndpoint" />
<core:string-to-byte-array-transformer encoding="UTF-8" />
<component class="demo.mule.component.Passthrough" />
<core:gzip-compress-transformer encoding="UTF-8" />
<component class="demo.mule.component.Passthrough" />
<core:gzip-uncompress-transformer encoding="UTF-8" />
<component class="demo.mule.component.Passthrough" />
<core:byte-array-to-string-transformer encoding="UTF-8" />
<stdio:outbound-endpoint ref="stdioOutEndpoint" />
</ flow >- 说明
- gzip-compress-transformer针对byte[]进行压缩处理,因此对于字符串类型的消息,首先需要通过string-to-byte-array-transformer进行转换。
- 测试方法
- 在控制台的提示信息后输入测试字符串,完成后控制台输出同样的信息。
2. 加密解密
加密、解密是一种特定的数据转换方式,因此通过自定义Transformer的形式支持。
- 示例配置
<flow name="encrypt">
<core:inbound-endpoint address="http://localhost:65082/services/Echo11"
responseTimeout="10000" encoding="UTF-8" disableTransportTransformer="false" mimeType="text/plain"
exchange-pattern="one-way" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" />
<component>
<singleton-object class="demo.mule.component.Echo" />
</component>
<core:custom-transformer class="demo.mule.transformer.DesEncryptTransformer" encoding="UTF-8" />
<component class="demo.mule.component.Passthrough" />
<core:custom-transformer class="demo.mule.transformer.DesDecryptTransformer" encoding="UTF-8" />
<stdio:outbound-endpoint ref="stdioOutEndpoint" />
</ flow >- 说明
- DesEncryptTransformer是自定义的压缩转换器,DesDecryptTransformer是对应的解压转换器。
- 测试方法
- 在浏览器地址栏中输入“http://localhost:65082/services/Echo11/echo/text/测试字符串”,在控制台中可见加密后的字符串和最终解密后与原串相同的字符串。
3. 自定义Transformer
- 示例代码
import demo.mule.dto.Envelope;
publicclassString2EnvelopeTransformerextendsAbstractTransformer{
privatestaticLoglog=LogFactory.getLog(String2EnvelopeTransformer.class);
@Override
protectedObjectdoTransform(Objectsrc,Stringenc)throws TransformerException {
Envelopeenv=newEnvelope();
if(srcinstanceofString){
StringTokenizerst=newStringTokenizer((String)src,",");
Stringarea=st.nextToken();
Stringdata=st.nextToken();
env.create(area,data);
}
log.debug(env);
returnenv;
}
}- 说明
- 自定义Transformer需要继承AbstractTransformer类,实现其doTransform方法。该方法接收两个参数,一个是消息对象,一个是消息的Encoding,方法抛出TransformerException,返回转换后的消息对象。
- 实例配置
<flow name="local-ws">
<core:inbound-endpoint address="http://localhost:65082/services/Echo1"
exchange-pattern="request-response" doc:name="Generic" doc:description="Generic endpoint specified by address URI" />
<cxf:jaxws-service serviceClass="demo.mule.component.Echo" doc:name="SOAP"
doc:description="Make a web service available via CXF" />
<component doc:name="Component" doc:description="Invoke a Java component">
<singleton-object class="demo.mule.component.Echo" />
</component>
<core:custom-transformer class="demo.mule.transformer.String2EnvelopeTransformer"></core:custom-transformer>
<core:outbound-endpoint address="stdio://System.out" exchange-pattern="one-way" />
</ flow >- 测试方法
- 在浏览器中输入“http://localhost:65082/services/Echo1/echo/text/bj,hello”进行测试,观察控制台输出结果。