Axis2与Web项目整合

article/2025/9/14 2:17:01

一、说明:

上一篇介绍了通过使用Axis2来发布和调用WebService，但是是把WebService发布在Axis2提供的项目中，如果我们需要在自己的Web项目中来使用Axis2发布WebService该怎么做呢？

本篇即介绍在Web项目中使用Axis2来发布WebService.

二、具体操作:

① 新建一个动态的web工程（Dynamic Web project）

本例中新建的工程名为：AxisWebDemo

② 将上次下载的 axis2-1.6.4-war.zip 文件解压到相应的目录，将目录中的axis2.war文件放到Tomcat服务器的webapps目录中（本文使用的Tomcat的版本是7.x），并启动Tomcat。这时在Tomcat的webapps文件夹中会出现一个名为 axis2 的文件夹（其实这就是部署好的 axis2工程），如下图

③ 将 axis2 下的 axis2-web 文件夹移动到我们 AxisWebDemo 工程的 WebContent目录下

将WEB-INF 下的 lib 、conf 、modules文件夹移动到 AxisWebDemo工程的 WEB-INF目录下，结构如下图：

④ 在src右键，新建package　：　com.elgin.webservice

在这个包中新建一个我们需要发布的 WebService 服务的类： WebServiceDemo

代码如下：

package com.elgin.webservice;public class WebServiceDemo {public String  sayHello(String name){return "hello " + name;}public int getAge(){return 26;}
}

⑤ 在 AxisWebDemo 工程的 WEB-INF 下新建如下层次结构目录： services/webservices/META-INF/services.xml ,如下图所示：

经过我的验证，发现：目录层次必须是 services / 任意名称文件夹 / META-INF / services.xml ,否则 WebService发布会失败，也就是说上图的层次中，只有webservice这个文件夹的名字是可以自由指定，其它的文件、文件夹名字都是固定的！

services.xml 配置文件内容：

<?xml version="1.0" encoding="UTF-8"?>
<serviceGroup>  
<!- name属性配置WebService的名称 -><service name="myService">  <description>Web Service</description>  
<!-- ServiceClass属性配置提供WebService服务类的全类名 --><parameter name="ServiceClass">com.elgin.webservice.WebServiceDemo</parameter>  <messageReceivers>  <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />  </messageReceivers>  </service>  
</serviceGroup>

⑥ 在 AxisWebDemo 工程的 web.xml 文件中加入axis2的配置支持：

<!-- 加入axis2支持 --><servlet><servlet-name>AxisServlet</servlet-name><servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>AxisServlet</servlet-name><url-pattern>/services/*</url-pattern></servlet-mapping>

经过以上6个步骤， axis2 已经整合到工程中了，把项目加入的Tomcat中，启动Tomcat服务器，在浏览器中输入以下URL：

http://localhost:8080/AxisWebDemo/services/listServices

如果出现下图所示的信息，说明你的 WebService服务发布成功了：

上图中的 myService 即是你在 services.xml 中配置的 WebService的名称

输入下面URL：

http://localhost:8080/AxisWebDemo/services/myService?wsdl

出现下图所显示的关于服务的xml信息：

注意上图中 <wsdl:definitions> 元素中的 targetNamespace的值，上一篇介绍中也提到过，是提供WebService服务的类所在的包名倒过来。

三、调用上面工程中发布的WebService服务：

Java调用代码：

package com.elgin.webservice.axis2;import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import javax.xml.namespace.QName;import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;public class RPCClient {public static String address2="http://localhost:8080/AxisWebDemo/services/myService?wsdl";public static void main(String[] args) throws IOException{testWebDemo();}@SuppressWarnings("rawtypes")public static Object[] invoke(String method,Object[] params,Class[] classes) throws AxisFault{//使用RPC方式调用WebServiceRPCServiceClient client=new RPCServiceClient();Options option=client.getOptions();//指定调用的URLEndpointReference reference=new EndpointReference(address2);option.setTo(reference);/** 设置要调用的方法* http://ws.apache.org/axis2 为默认的（无package的情况）命名空间，* 如果有包名，则为 http://axis2.webservice.elgin.com ,包名倒过来即可* method为方法名称* */QName  qname=new QName("http://webservice.elgin.com", method);//调用远程方法,并指定方法参数以及返回值类型Object[] result=client.invokeBlocking(qname,params,classes);return result;}public static void testWebDemo() throws AxisFault{Object[] result=invoke("sayHello", new Object[]{"elgin"}, new Class[]{String.class});System.out.println(result[0]);result=invoke("getAge", new Object[]{}, new Class[]{int.class});System.out.println(result[0]);}}

运行结果：