ServiceMix+Tomcat+Axis2+Eclipse开发Web服务

最近一直在研究Servicemix,官方资料、网上有关的资料看了一大堆，发现要想真正运用ServiceMix，Tomcat，Axis2，Eclipse开发并部署好一个Web服务确实挺费劲的。个人觉得这些资料在一些关键的细节上描述的不够清楚，起码对于初学者来讲（对此，深有体会，一个参数设置搞了一个星期才搞定，晕！）。为此，我将学习过程中遇到的一些棘手的问题、解决的办法，以及具体的制做过程记录下来，希望能够对后来学习的朋友起到一点借鉴之用！

1. 开发环境搭建：

Servicemix 3.3（尽量用新的版本吧，3.2的在最后提示一个xml文件的命名空间找不到，到网上也没找到具

                           体原因，如果哪位知道，还望不吝赐教！）

                          安装过程比较简单，只需要将下载的文件包解压到指定的盘符下即可；如果做的再到位些

                          就在环境变量里添加SERVICEMIX_HOME并在path中追加Servicemix的bin路径；

Tomcat 5.0         安装较为简单，网上资料也很详细具体，这里不再重复；

Axis2 1.5            安装过程也比较省事就是将下载的“axis2-1.5-war.zip”解压后得到的“axis2.war”文件包

                          拷贝到Tomcat所在目录的Webapps子目录下即可；

Eclipse 3.2

Maven 2.0.9

JDK 1.5

WTP插件，apache eclipse wsdl 插件（Service Archive Wizard - Eclipse Plug-in，Code Generator Wizard - Eclipse Plug-in）大家可以到网上下载并进行Eclipse插件扩展安装，其过程较为简单，这里不再重复；

2. 开发过程

以下内容主体来自本网站redria的博文“使用Servicemix(ESB)发布一个外部的WebService ”，这是目前网上写的较为具体、全面的例子，对本人学习Servicemix帮助很大，这里深表谢意！

但是，在做的过程中，发觉并不像想像中的那么顺利，为了避免后来的同仁们少走些弯路，充分体验到学习的快乐，这里我在一些自认为的关键细节之处加以扩充、标注！

打开Eclipse并新建->项目->动态Web工程(Eclipse需要WTP插件)

 

 

点击下一步，进入如下界面

 

        输入Project名字HelloWorld，然后点击finish

注：这里要提醒大家一下，新建项目前，一定要把Tomcat配置成Eclipse默认的Server（配置过程：选择“窗口-首选项”在弹出的窗口左边的树形控件中点开“server”，然后选择“Installed Runtimes”，再到右边窗口点击“add”按钮，在弹出的窗口中最上面选择apache的Tomcat 5.0，点击“完成”，最后在弹出的对话框中设置Tomcat和jdk的安装路径即可，具体的界面如下：）

 

8，在新建的工程中添加class

        在新建的project的src中添加一个package

        package名字为sample

 

 

        在该包中添加一个class

 

        Class的名字为Hello，点击Finish

 

 

        修改java文件的内容如下。

 

注：大家注意到这个界面右下那个提示窗口中，Tomcat的信息显示了吗？

 

9，生成wsdl文件

        这里可以用Code Generator Wizard - Eclipse Plug-in插件生成，也可以用其他插件生成，差别不大

 

 

 

        以上两种方法都可以，第二种只要按照提示来就可以了，分别是选择class,选择生成路径

        下面说第一种方法

 

 

 

        注：这里如果想测试的话，就把上面那个窗口左上条子拉到顶，点击finish；另外，大家一定要注意这里右边那个配置中“Server”一定要自动显示你所配置的服务器（对应的Tomcat），如果没有显示，可以试着手动先把Tomcat启动，然后再来进行这一步的工作；

 

 

        测试：点击Operations中刚刚发布Say

 

 

        输入World，看到返回值正常

 

注：这里一定要看到“Hello World”的返回字符串，说明转换成功！

10，发布webservice

        发布WebService有很多种方式，可以把它直接发布Tomcat中，也可以利用Axis来发布

        我们使用Axis2来发布

        注意，我们要发布到Axis2中，所以我们service的address就变了，这里需要根据实际发布地址进 行修改

 

        例如本示例修改如上

        使用插件Service Archive Wizard - Eclipse Plug-in

 

 注：这一窗口是在“新建-其他”里面，不是在项目子菜单中；

        点击Next，然后选择Class文件的路径

 注：这里请大家注意类路径只选到classes就行了，不能选到包那一层，否则提示找不到类（这里当初很费了些周折，起初总是以为插件问题了，环境参数设置不妥，最后才发现是这么回事）

        点击Next，选择我们刚刚发布的wsdl，也就是前面我们转换生成的wsdl文件

 

 

 

        点击Next，然后来选择必要的jar包。

 

本例这里可以不填任何东西，点击“Next”

 

        点击Next,勾选自动生成Service.xml

 

 

        点击Next，填选Class

 

 

        点击Next，填写发布路径

 

 

        点击Finish，则在目标路径生成aar文件

 

        将生成的aar文件复制到%Tomcat%/webapps/axis2/WEB-INF/services下，或者在axis2的admin页面添 加该aar文件

 

 

        默认的用户名是admin，密码是axis2

 

 

        点击Upload Service

 

 

        将刚刚生成的wsdl发布

 

 

 

        发布成功后，就可以在Service中找到刚刚发布HelloService

 

 

        点击HelloService，我们就可以看到这个服务的具体内容，就是我们刚刚发布wsdl。

        至此，我们成功地发布了一个webservice

 

*以上示例使用的是POJOs形式发布。

 

11，运行Servicemix（此部分内容大家可以参考servicemix官方文档tutorial）

 

        运行cmd，然后启动servicemix服务

 

 

        等待服务完全开启。

 

 

        当启动成功之后。我们就可以在JDK的控制台看到关于ServiceMix的服务信息

        运行  %JDK%/bin/jconsole.exe

 

注：这里的jms：URL我当初也是弄了许久才搞定的，也是找了好多资料后在一个偶然的资料中发现的；那个密码也是“smx”

 

        则我们可以找到servicemix的服务已经开启

 

 

 

        点击连接，则我们可以看到servicemix中的所有信息，包括所有的操作及消息队列等等，在此不多述。

 

12，新建一个Servicemix的组件

        我们的目的是WebService，所以我们建一个Cxf-bc的组件

        在任意路径下建一个项目工程的目录，示例建立的是D:/CXFHello

        运行cmd,进入该目录

        键入

mvn archetype:create -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix- project-root -DgroupId=org.apache.servicemix.tutorial -DartifactId=tutorial-wsdl-cxf-service
        用来创建一个标准的pom.xml

        在这个pom.xml中，对于一些基本的工程配置作了设定

 

 

 

        在我们成功建立了之后，会发现CXFHello文件夹下面多出了一个路径

        则我们在这个新建的路径下面运行

mvn install

 

        至此，我们已经将这个新建的工程发布到我们的本地 Maven repository 中

 

        下面我们建立一个CXF-BC Service Unit

        在我们刚才建立的工程文件夹下面，运行

mvn archetype:create -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix- cxf-bc-service-unit -DgroupId=org.apache.servicemix.examples -DartifactId=my-cxf-bc-su
        用来创建一个标准的CXF-BC-SU组件

 

 

        至此，我们建议了一个标准的CXF-BC-SU组件的框子

       

        现在进入新建的组件的文件夹。

        我们看到一个pom.xml文件，这个是对这个组件进行配置的一个文件。

        打开，我们可以看到详细内容

        现在我们修改这个组件的名字

        将A Cxf BC Service Unit

        改成Cxf-Hello-SU

 

然后我们需要将我们发布在Axis2上的Webservice的wsdl复制下来放入servicemix这个bc组建之中。

 

        关于wsdl文件

            打开wsdl文件，我们可以发现，wsdl其实定义了webservice的所有规范，例如它的名字，接 口，方法，参数等等

            而我们需要将wsdl复制到我们要发布的servicemix当中，是因为我们暴露出去的接口，方法， 参数等要能和实际服务的webservice一致。所以servicemix当中需要一个由同样接口定义的wsdl文件

 

        访问  http://localhost:8080/axis2/services/HelloService?wsdl       

        得到我们刚才发布的webservice的wsdl文件

 

 

 

        将这个wsdl文件复制到%/my-cxf-bc-su/src/main/resources  下

        其实这里原本就预订了一个wsdl文件的位置。

        注意，我的wsdl名字叫做Hello.wsdl，因此，当复制过来后，原来的service.wsdl就可以删除了

        当然，我们也可以把刚才ecilpse项目中生成的wsdl复制过来，这是一样的文件

       

        现在我们需要修改这个复制进来的wsdl文件

        将webservice服务定义作如下替换

  

     

        

     

  
        结果如下图

 

        现在我们已经完成了对wsdl的设定，现在我们需要在xbean.xml设定consumer和provider来帮定这些东西。

        打开xbean.xml，作如下修改

            首先，我们需要一个namespace，这个namespace要和我们引用的wsdl中的service和 endpoint的namespace一致，这样我们才能准确找到service和接口

            我们的wsdl定义的targetNamespace="http://sample/"

            所以我们bc组件中的consumer和provider定义的namespace也必须和上面一样

         现在来定义consumer和provider，基本的定义规则参照：http://servicemix.apache.org/servicemix-cxf-bc.html

 

        则最终修改好的文件如下

       xmlns:cxfbc="http://servicemix.apache.org/cxfbc/1.0"
       xmlns:xsi="http://http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://servicemix.apache.org/cxfbc/1.0 http://servicemix.apache.org/schema/servicemix-cxfbc-3.2.3.xsd
       http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd"
       xmlns:ws="http://sample">

                    service="ws:HelloServiceProxy"
                  endpoint="ws:HelloProxy"
                  targetService="ws:HelloService"                     
                  targetEndpoint="ws:Hello"
                      />
                service="ws:HelloService"
                endpoint="ws:Hello" />

       

        这样service unit就建好了，接下来我们建立service assembly

        在我们的工程路目下运行

mvn archetype:create -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix- service-assembly -DgroupId=org.apache.servicemix.examples -DartifactId=my-cxf-sa 

        现在可以看到工程目录中新建出来了SA的文件夹

        同样，我们修改一个名字

        Cxf-Hello-SA

 

        接下来，我们要在这个SA中注册我们刚才制作的SU

……  
 
   
      org.apache.servicemix.examples
      my-cxf-bc-su
      1.0-SNAPSHOT
   
 
……
        好了现在一切就绪，我们在工程目录下面运行

mvn install
        就可以建立好组件了

 

        在build successful之后，我们就可以在

        %/my-cxf-sa/target

        目录下面看到我们建立好的jar包

        将这个jar包复制到servicemix目录下面的/hotdeploy文件夹，来正式发布到servicemix当中

        如此一来，我们就成功的发布了一个服务到servicemix上

       

        下面让我们来检测一下成果

        建立一个客户端html如下

 

ServiceMix CXF example

Welcome to the CXF example for ServiceMix

Perform a POST into the HTTP binding. This requires JavaScr ipt.

 

Target: .

  

 
   
   
 
 
   
 

<?xml version="1.0" encoding="UTF-8"?> <br><env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" <br>              xmlns:tns="http://sample"> <br>  <env:Body> <br>    <tns:say> <br>      <tns:value>World</tns:value> <br>    </tns:say> <br>  </env:Body> <br></env:Envelope> </em></strong> </div> <strong><em> </em></strong> <div> <strong><em>	<br>

        在浏览器中打开这个html，点击send，就可以看到结果

       

        注：

        1，soap是用xml作为传输介质，所以传输一定要是xml

        2，这里左边xml内容中，有一个tns的namespace，这个namespace和目标的接口有关，一定要和目标 wsdl的message传输接口一致

 

 

 

         到此，我们成功地制作了一个WebService，并且把这个WebService发布到了Servicemix上面，本示例到此 结束。