本文详细解析了JBoss ESB HelloWorld实例的配置文件，包括jboss-esb.xml、jbm-queue-service.xml及deployment.xml等，并介绍了ESB目录结构及运行步骤。
前言
发现JBossESB网上流传甚广的就是JBoss学习笔记系列了，这个系列资料还可以，但如果你一上来就看这个的话，感觉还是有点蒙，因为根本不明白这样做到底是为什么。所以看了之后，也会发现自己只能照着葫芦画一个葫芦，连一个瓢也画不了。
helloworld这句话从我们一进行编程的世界就经常听到，那么第一个例子，我们就来helloworld。
ESB目录结构
ESB发布之后，会是一个.esb格式的zip压缩包，里面的结构如下：
其中：
jboss-esb.xml：包含service、listener、action、provider的配置，具体都是什么，后面会说到的。
deployment.xml：是可选的，有两种情况下会用这个。一种是一个.esb依赖令一个.esb，用来指定加载顺序，另一种就是确定.esb的部署范围。不明白没关系，有的是例子使你明白这个的用处的。
java classes：是你自己的包含包层次的action
jars：这个我想不用说吧，就是添加你的应用依赖的包
queue-service.xml：如果你的jboss-esb.xml中的provider使用的queue或者topic，你可以在通过这个来进行部署。使用其它方式督署也可以，不过ESB的官方文档中明确说明的建议采取此种方式。
运行helloworld
在JBossESB的doc里面的Getting Started的最后面列出了一个学习JBossESB的学习建议。网上的JBossESB学习笔记大概就是按照这个顺序来进行的，有一些不同，但不碍事。
在最初，我其实不太建议自己去敲，因为你还很不熟悉，直接运行它自己带的例子就好。
运行需要安装Ant，Ant的安装很简单。提到Ant，不得不说一下。JBossESB是用的Ant构建的，所以最近和Ant打的交道特别多，最初感觉Ant没啥，现在感觉里面需要学习的东西很多，最近没事学习一下这个小东西。前面的博客对这个对这个进行过说明，这里不再重复。
首先启动服务器，这里在JBossESB_Home/bin下的run.bat，不过建议新建一个start.bat，然后在里面写上run -b 0.0.0.0，这样写，就可以监听所有的IP了，不然，你的服务只能用localhost或者127.0.0.1访问（JBoss应用服务器首页也是这样的）。
命令行下进入JBossESB_HOME/sample/quickstart/helloworld，然后运行ant deploy，成功后，再执行ant runtest；还可以执行ant sendesb执行，两个执行的结果是一样的，但原理却差好多。
helloworld配置解析
action的代码很简单，所以就不做什么解析了，列一下代码得了，需要说的就是配置以及执行流程。
public class MyJMSListenerAction extends AbstractActionLifecycle
{
protected ConfigTree _config;
public MyJMSListenerAction(ConfigTree config) { _config = config; }
public Message displayMessage(Message message) throws Exception{
System.out.println("&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&");
System.out.println("Body: " + message.getBody().get()) ;
System.out.println("&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&");
return message;
}
}jboss-esb.xml
在这个里面有provider、service、listener、action。
provider是对外提供的一个入口，不论是ESB（aware）还是非ESB（aware）都可以通过这个进入。
listener是对provider进行监听的一个东西。通过它能够获取到发到provider上的东西。
service是对外发布的服务，我感觉是对action的一个整理。
action是一个又一个的动作。可大可小（粒度），就看你是怎样设计的。
看完这些基本的概念，那么现在来看一下官方提供的权威例子吧。
<?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> 大家发现了么，在一个jms-provider里面使用了两个jms-bus，而且除了名字其它都一样。但监听它们的listoner配置是不一样的，那就是is-gateway="true"，这个区别了，is-gateway的默认值为false。被设置这个属性为true的才能监听来自非ESB（Unaware）发过来的消息，否则只能监听ESB消息（Aware，采用ServiceInvoker调用）。
下面，咱们来看一下官方文档中给的一个helloworld中给出的执行流程的一个图：
有了这一张原理图，是不是好些了呢？那么我们继续来看后几个吧。
jbm-queue-service.xml
<?xml version="1.0" encoding="UTF-8"?>
<server>
<mbean code="org.jboss.jms.server.destination.QueueService"
name="jboss.esb.quickstart.destination:service=Queue,name=quickstart_helloworld_Request_esb"
xmbean-dd="xmdesc/Queue-xmbean.xml">
<depends optional-attribute-name="ServerPeer">jboss.messaging:service=ServerPeer</depends>
<depends>jboss.messaging:service=PostOffice</depends>
</mbean>
<mbean code="org.jboss.jms.server.destination.QueueService"
name="jboss.esb.quickstart.destination:service=Queue,name=quickstart_helloworld_Request_gw"
xmbean-dd="xmdesc/Queue-xmbean.xml">
<depends optional-attribute-name="ServerPeer">jboss.messaging:service=ServerPeer</depends>
<depends>jboss.messaging:service=PostOffice</depends>
</mbean>
</server如果你看sample/quickstart/helloworld下面，还有一个jbmq-queue-service.xml，但部署文件里只有jbm-queue-service.xml。
下面是jbmq-queue-service.xml的配置信息：
<?xml version="1.0" encoding="UTF-8"?>
<server>
<mbean code="org.jboss.mq.server.jmx.Queue"
name="jboss.esb.quickstart.destination:service=Queue,name=quickstart_helloworld_Request_esb">
<depends optional-attribute-name="DestinationManager">
jboss.mq:service=DestinationManager
</depends>
</mbean>
<mbean code="org.jboss.mq.server.jmx.Queue"
name="jboss.esb.quickstart.destination:service=Queue,name=quickstart_helloworld_Request_gw">
<depends optional-attribute-name="DestinationManager">
jboss.mq:service=DestinationManager
</depends>
</mbean>
</server>
jbm-queue-service.xml是JBoss messaging这种消息使用方式采用的配置文件，jbmq-queue-service.xml是JBossMQ的配置文件，但官方建议我们使用JBoss messaging，具体原因还待日后研究，只能说时间和精力有限啊。。。
那么剩下的就是对QUEUE的定义了，privide中用到的QUEUE和Topic都需要在这里面进行一下定义。使用方法就照葫芦画一个瓢吧。
deployment.xml
<jbossesb-deployment>
<depends>jboss.esb.quickstart.destination:service=Queue,name=quickstart_helloworld_Request_esb</depends>
<depends>jboss.esb.quickstart.destination:service=Queue,name=quickstart_helloworld_Request_gw</depends>
</jbossesb-deployment>
上面说过两种情况你会用到这个东西，esb部署上来需要使用到QUEUE或Topic，也就是说QUEUE这些东西是需要在程序部署上来之前就创建好。我感觉这个只是说明一下顺序，而创建工作是jbm-queue-service.xml这个配置文件中做的事情。
结语
至此，helloworld中用到的配置文件就说完了。我是看完官方给的所有PDF后才开始看这些源码的，再加上JBossESB学习笔记系列的一些简单说明，现在感觉看例子什么的比之前好多了，但是还是有一些数据库之类的配置真心让人感觉很不爽，而且还有一些概念目前没有时间和精力来细研究，这块的学习继续进行～～后面陆续会有一些相对综合的文章。
下篇想就Notifier、Router、Wiretap说一下自己的看法～
扫一扫
3781
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
