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就变了,这里需要根据实际发布地址进 行修改
 
        例如本示例修改如上
<wsdlsoap:address location="http://localhost:8080/axis2/services/HelloService"/>
        使用插件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文件,这个是对这个组件进行配置的一个文件。
        打开,我们可以看到详细内容
        现在我们修改这个组件的名字
        将<name>A Cxf BC Service Unit</name>
        改成<name>Cxf-Hello-SU</name>
 
然后我们需要将我们发布在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:service name="HelloServiceProxy">
      <wsdl:port binding="impl:HelloSoapBinding" name="HelloProxy">
         <wsdlsoap:address location=" http://localhost:8193/HelloWorld/"/>
      </wsdl:port>
   </wsdl:service>
        结果如下图
 
        现在我们已经完成了对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
 
        则最终修改好的文件如下
  <cxfbc:consumer wsdl="classpath:Hello.wsdl"
                  service="ws:HelloServiceProxy"
                  endpoint="ws:HelloProxy"
                  targetService="ws:HelloService"                     
                  targetEndpoint="ws:Hello"
                      />
<cxfbc:provider wsdl=" http://localhost:8080/axis2/services/HelloService?wsdl"
                service="ws:HelloService"
                endpoint="ws:Hello" />
</beans>       
        这样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的文件夹
        同样,我们修改一个名字
        <name>Cxf-Hello-SA</name>
 
        接下来,我们要在这个SA中注册我们刚才制作的SU
……  
 <dependencies>
    <dependency>
      <groupId>org.apache.servicemix.examples</groupId>
      <artifactId>my-cxf-bc-su</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
  </dependencies>
……
        好了现在一切就绪,我们在工程目录下面运行
mvn install
        就可以建立好组件了
 
        在build successful之后,我们就可以在
        %/my-cxf-sa/target
        目录下面看到我们建立好的jar包
        将这个jar包复制到servicemix目录下面的/hotdeploy文件夹,来正式发布到servicemix当中
        如此一来,我们就成功的发布了一个服务到servicemix上
       
        下面让我们来检测一下成果
        建立一个客户端html如下
 
<html>
<head>
<title>ServiceMix WSDL -First Example</title>
<script type="text/javascript">
var urlToOpen = " http://localhost:8193/HelloWorld/"; //default URL to open
function getHTTPObject() {
  var xmlhttp = false;
  /* Compilation conditionnelle d'IE */
  /*@cc_on
  @if (@_jscript_version >= 5)
     try {
        xmlhttp = new ActiveXObject ("Msxml2.XMLHTTP");
     } catch (e) {
        try {
           xmlhttp = new ActiveXObject ("Microsoft.XMLHTTP");
        } catch (E) {
           xmlhttp = false;
        }
     }
  @else
     xmlhttp = false;
  @end @*/
  /* on essaie de créer l'objet si ce n'est pas déjà&nb sp;fait */
  if (!xmlhttp && typeof XMLHttpRequest != 'undefined')  {
     try {
        xmlhttp = new XMLHttpRequest ();
     } catch (e) {
        xmlhttp = false;
     }
  }
  if (xmlhttp) {
     /* on définit ce qui doit se passer quand&nbs p;la page répondra */
     xmlhttp.onreadystatechange=function() {
        if (xmlhttp.readyState == 4)  { /* 4 : état "complete" */
           var response = document.getElementById ("response");
           var responseStatus = "";
           try {
             responseStatus = xmlhttp.status + "";
           } catch (e) {
             responseStatus = "ERROR WHILE RETRIEVING STATUS; MAYBE UNABLE TO CONNECT.";
           }
           response.value = "STATUS: " + responseStatus + "/n" + xmlhttp.responseText;
        }
     }
  }
  return xmlhttp;
}
function send() {
  if ((document.getElementById("urlToOpen").value != urlToOpen) &&  (document.getElementById("urlToOpen").value != "")) {
    //use user entry only if it at least can be oka y
    urlToOpen = document.getElementById("urlToOpen").value;
  }  
  var xmlhttp = getHTTPObject();
  if (!xmlhttp) {
    alert('cound not create XMLHttpRequest object');
    return;
  }
  var request = document.getElementById("request");
  var response = document.getElementById("response");
  try {
    netscape.security.PrivilegeManager.enablePrivilege ("UniversalBrowserRead UniversalBrowserWrite");
  } catch (e) {
  }
  try {
    xmlhttp.open("POST", urlToOpen, true);
  } catch (e) {
    alert('error opening');
  }
  xmlhttp.send(request.value);
}
</script>
</head>
<body>
<h1>ServiceMix CXF example</h1>
<p>Welcome to the CXF example for ServiceMix</p>
<p>Perform a POST into the HTTP binding. This requires JavaScr ipt.</p> 
<p>Target: <input type="text" size="50" id="urlToOpen" value=""><script type="text/javascript">document.getElementById("urlToOpen").value = urlToOpen;</script>.</p>
  
<table>
  <tr>
    <td>
  <textarea id="request" style="width:600px;height:400px" onKeyUp="send();"><?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env=" http://schemas.xmlsoap.org/soap/envelope/"
              xmlns:tns=" http://sample">
  <env:Body>
    <tns:say>
      <tns:value>World</tns:value>
    </tns:say>
  </env:Body>
</env:Envelope>
  </textarea>
    </td>
    <td>
  <textarea id="response" style="width:600px;height:400px">
  </textarea>
    </td>
  </tr>
  <tr>
    <td colspan=2>
  <input type="button" value="Send" onClick="send();"/>
    </td>
  </tr>
</table>
</body>
</html>
        在浏览器中打开这个html,点击send,就可以看到结果
       
        注:
        1,soap是用xml作为传输介质,所以传输一定要是xml
        2,这里左边xml内容中,有一个tns的namespace,这个namespace和目标的接口有关,一定要和目标 wsdl的message传输接口一致
 
 
 
         到此,我们成功地制作了一个WebService,并且把这个WebService发布到了Servicemix上面,本示例到此 结束。
 

评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值