最近一直在研究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.2Maven 2.0.9JDK 1.5WTP插件,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中添加一个packagepackage名字为sample在该包中添加一个classClass的名字为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则我们可以找到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文件得到我们刚才发布的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则最终修改好的文件如下<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns=" http://www.springframework.org/schema/beans"
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"><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 openfunction 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作为传输介质,所以传输一定要是xml2,这里左边xml内容中,有一个tns的namespace,这个namespace和目标的接口有关,一定要和目标 wsdl的message传输接口一致到此,我们成功地制作了一个WebService,并且把这个WebService发布到了Servicemix上面,本示例到此 结束。