MULE ESB webservice jms服务

写之前的内容时，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>

测试方法

使用“<![CDATA[<req><seq>1</seq><area>bj</area><price>123.45</price><count>10</count></req>]]>”数据进行测试。

三. 数据转换

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”进行测试，观察控制台输出结果。

仅以上述示例代码作为这一段时间Mule文档阅读及试用的总结。

PS：程序代码插件有时有点问题，前几段代码字体是CN，后边就突然变成一种非等宽字体了。而且XML的格式不是很直观，因此直接粘贴了。。