JBOSS---ESB 序列之二 helloworld详细介绍

本文是 quickstarts 中最简单的一个sample,后续将从一一介绍各个sample，从简单到复杂。

[b]【esb 服务端】[/b]

[b]1. esb的配置文件[/b]

<?xml version = "1.0" encoding = "UTF-8"?>
<jbossesb xmlns="http://anonsvn.labs.jboss.com/labs/jbossesb/trunk/product/etc/schemas/xml/jbossesb-1.0.1.xsd" parameterReloadSecs="5">

[color=red] <providers>
<jms-provider name="JBossMQ" connection-factory="ConnectionFactory">
<jms-bus busid="quickstartGwChannel">
<jms-message-filter dest-type="QUEUE" dest-name="queue/quickstart_helloworld_Request_gw" />
</jms-bus>
<jms-bus busid="quickstartEsbChannel">
<jms-message-filter dest-type="QUEUE" dest-name="queue/quickstart_helloworld_Request_esb" />
</jms-bus>
</jms-provider>
</providers>[/color]

<services>
<service category="FirstServiceESB" name="SimpleListener" description="Hello World">
[color=blue] <listeners>
<jms-listener name="JMS-Gateway" busidref="quickstartGwChannel" is-gateway="true"/>
<jms-listener name="helloWorld" busidref="quickstartEsbChannel"/>
</listeners>[/color]
<actions mep="OneWay">
[color=green] <action name="action1" class="org.jboss.soa.esb.samples.quickstart.helloworld.MyJMSListenerAction" process="displayMessage" />
<action name="action2" class="org.jboss.soa.esb.actions.SystemPrintln">
<property name="printfull" value="false"/>
</action>
<!-- The next action is for Continuous Integration testing -->
<action name="testStore" class="org.jboss.soa.esb.actions.TestMessageStore"/>[/color]
</actions>
</service>
</services>

</jbossesb>


[b]2. provider提供了两个JMS-BUS，根据名称容易知道一个是给 JMS-GateWay使用的，一个是给 FirstServiceESB:SimpleListener 服务使用的。[/b]

[b]3. listeners中提供了两个jms-listener，一个是用于JMS-Gateway，用以接收任何的UnAware的JMS消息。此时的JMS客户端只是一个普通的JMS客户端，它只知道往JMS队列发送JMS消息。另外一个是 ESB Listener，用来接收Aware消息。[/b]

[color=red]请注意：其实 jms-provider 中定义的 两个jms-bus只是定义了两个普通的jms 队列，此时任何Jms客户端都可以向他们发送jms消息。问题在于两个队列的消息接收者对消息的处理不同，GateWay listener 能处理任何的jms消息，因此不存在任何问题，但是 EBS 的listener只能处理 ESB中规定的Message类型，因此普通的jms客户端如果向esb的队列发送消息后，必然会导致ebs listener 出现问题。 [/color]

[b]4. Esb Listener接收到 消息后，会调用一序列的Action来处理 service 的业务逻辑[/b]


[b]【Client测试】[/b]

[b]1. 普通的jms客户端发送调用 Service 的请求[/b]
普通的jms客户端调用 Service其实非常简单，只需要向 Esb Service 中定义的 GateWay 监听的 消息队列发送一个 Esb Service 规定的 消息即可。

[color=red]需要注意的有两点：<br>
a. GateWay Listener指定的消息队列<br>
b. Esb Service 规定的消息交换的格式(根据业务自定义的格式),这类例子没有涉及到格式，非常简单，所以不能引起大家的注意
<br>[/color]

[b]2. 通过ServiceInvoker发送Aware消息[/b]
ServiceInvoker直接发送 Aware Message 到 Esb Listener指定的消息队列中去，直接省去了GateWay这个环节（如果不清楚这个步骤，请参阅JBOSS---ESB 序列之一 Getting Started）