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]);
    }
    
}

运行结果：