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

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

【esb 服务端】

1. esb的配置文件

<?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">

    <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>
     
      <services>
        <service  category="FirstServiceESB"  name="SimpleListener"  description="Hello World">
            <listeners>
                <jms-listener name="JMS-Gateway" busidref="quickstartGwChannel" is-gateway="true"/>
                <jms-listener name="helloWorld" busidref="quickstartEsbChannel"/>
            </listeners>
            <actions mep="OneWay">
                   <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"/>
            </actions>
        </service>
      </services>
    
</jbossesb>


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

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

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

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




【Client测试】

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

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

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