Axis2与Web项目整合

一、说明:

上一篇介绍了通过使用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方式调用WebService
RPCServiceClient client=new RPCServiceClient();
Options option=client.getOptions();

//指定调用的URL
EndpointReference 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]);
}

}

运行结果：