通过Axis2搭建一个简单的webservice服务端和客户端

本人是刚毕业的小白，进公司后的第一个任务就是搭建一个rpc框架，使用的是Axis2。因为完全没有接触过，并且应该是技术比较老，所以可以查询的经验和项目比较少。通过艰难的寻找终于写出了一个简单的服务端和客户端的demo。写下这篇一是给像我一样没用过的人一个经验，二是防止我忘记了一些东西再次查找会比较麻烦。

安装Axis2

1. 进入地址选择war包下载。http://axis.apache.org/axis2/java/core/download.html；我选的是1.7.9版本的war包。
2. 将下载的war进行解压并放到tomcat下的webapps路径下，之后在eclipse中启动tomcat。；我电脑中webapps的路径以及里面的文件。
3. 启动tomcat后输入 http://localhost:8080/axis2/ 出现以下页面时证明Axis2安装成功；

搭建服务端

1.新建一个web项目。
2.创建一个service用来处理客户端传来的数据。

package com.xcs.axis2;

public class HelloAxis2 {

   public String getHello(String name,String num,int age) {
   	return "Hello， " + name + "."+num+ ":" +age;
   }
   public String getWorld(String name) {
   	return "World," + name + ".";
   }
   public String getHelloWorld() {
   	return "Hello,Axis";
   }
}

3.修改web项目的web.xml。如果没有，可以通过右键项目->Java EE Tools->Generate Deployment Descriptor Stub来添加web.xml。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
   <!-- 加载Axis -->
<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>
</web-app>

4.找到自己tomcat下webapps的文件，在里面找到axis2文件夹。将axis2/WEB-INF下的modules、service和conf文件拷入服务端项目的WEB-INF目录下。
并将axis2/WEB-INF/lib文件夹中的jar包拷到项目中的WEB-INF/lib中。
5.在WEB-INF/services下创建一个HelloWorld/META-INF路径并在，HelloWorld/META-INF下新建services.xml。内容如下。

<?xml version="1.0" encoding="UTF-8"?>

<serviceGroup>
   <service name="HelloAxis2">  
       <description>  
           HelloWorld Service Example
       </description>  
       <parameter name="ServiceClass">  
           com.xcs.axis2.HelloAxis2
       </parameter>  
       <operation name="getHello">
           <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
       </operation>  
       <operation name="getWorld">  
           <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
       </operation>  
       <operation name="getHelloWorld">  
   <!-- 这里要注意，当没有返回值时才用 org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver，没有参数还是用RPCMessageReceiver-->
           <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
       </operation>  
   </service>
</serviceGroup>

其中 < serviceGroup >为服务组，其中可有多个service服务。< service name=“HelloAxis2” > 表示服务名，< parameter name=“ServiceClass” > 表示该服务的实现类，< operation name=“getHello” >表示其中该服务的getHello()实现方法。
6.服务端差不多已经成功了，进入 http://127.0.0.1:8080/HelloAxis2/services/HelloAxis2?wsdl 显示以下页面证明服务端已成功。

客户端

服务端写完了需要一个客户端去调用它。

package com.axis;


import javax.xml.namespace.QName;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;


public class ClientTest {
   public static void main(String[] args) {
   	String url = "http://127.0.0.1:8080/HelloAxis2/services/HelloAxis2";
   	String result = null;
   	try {
   	// 使用RPC方式调用WebService
   	RPCServiceClient serviceClient = new RPCServiceClient();
   	Options options = serviceClient.getOptions();
   	// 指定调用WebService的URL
   	EndpointReference targetEPR = new EndpointReference(url);
   	options.setTo(targetEPR);
   	// 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值
   	// // 指定要调用的getWorld方法及WSDL文件的命名空间.....
   	QName opAddEntry = new QName("http://axis2.xcs.com", "getWorld");
   	// 
   	// 指定getGreeting方法的参数值，如果有多个，继续往后面增加即可，不用指定参数的名称
   	Object[] opAddEntryArgs = new Object[] { "java" };
   	// 返回参数类型，这个和axis1有点区别
   	// invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；
   	// 第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；
   	// 第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。
   	// 当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}
   	// 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，
   	// 该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同
   	// 指定getGreeting方法返回值的数据类型的Class对象.....
   	Class[] classes = new Class[] { String.class };
   	// 调用getGreeting方法并输出该方法的返回值.......
   	result = (String) serviceClient.invokeBlocking(opAddEntry,
   	opAddEntryArgs, classes)[0];
   	System.out.println(result);
   	// 下面是调用getHello方法的代码，这些代码与调用getWorld方法的代码类似
   	// classes = new Class[] {String.class};
   	opAddEntry = new QName("http://axis2.xcs.com", "getHello");
   	opAddEntryArgs = new Object[] { "王亚坤" ,"22","21312"};
//		opAddEntryArgs = new Object[] { "王亚坤" ,"22",21312};
   	System.out.println(serviceClient.invokeBlocking(opAddEntry,
   	opAddEntryArgs, classes)[0]);
   	// 下面是调用getHelloWorld方法的代码
   	opAddEntry = new QName("http://axis2.xcs.com", "getHelloWorld");
   	System.out.println(serviceClient.invokeBlocking(opAddEntry,
   	new Object[]{}, classes)[0]);
   	} catch (Exception e) {
   	e.printStackTrace();
   	}
   	}
}

通过run as - >java application，在控制台得到结果

进阶

当想让调用地址不是services时需要修改两个地方。如：将http://127.0.0.1:8080/HelloAxis2/services/HelloAxis2修改为http://127.0.0.1:8080/HelloAxis2/shpt/services/HelloAxis2。如果只是修改web.xml，会在客户端报错，除了服务端的web.xml需要修改外，还需要修改WEB-INF/conf下的axis.xml。
1.web.xml中修改为**< url-pattern>/shpt/services/*< /url-pattern>**
2.axis2.xml中将< parameter name=“servicePath”>解注释，并修改为shpt/services，即**< parameter name=“servicePath”>shpt/services< /parameter>**。

参考

https://blog.csdn.net/csh624366188/article/details/8362696

我的github源码 https://github.com/kamisama000/myworkspace