使用Axis2实现WebService的发布和调用
一、Axis2简介：
Axis2是一套崭新的WebService引擎，该版本是对Axis1.x重新设计的产物。Axis2不仅支持SOAP1.1和SOAP1.2，还集成了非常流行的REST WebService，同时还支持Spring、JSON等技术。在本文中主要介绍了如何使用Axis2开发一个不需要任何配置文件的WebService，并在客户端使用Java调用这个WebService。
二、Axis2下载安装：
Axis下载地址： http://ws.apache.org/axis2/
在本文使用了目前Axis2的最新版本1.6.4。读者可以下载如下两个zip包：axis2-1..6.4-bin.zip
axis2-1.6.4-war.zip
其中 axis2-1.6.4-bin.zip 文件中包含了Axis2中所有的jar文件,axis2-1.6.4-war.zip 文件用于将WebService发布到Web容器中。
将 axis2-1.6.4-war.zip 文件解压到相应的目录，将目录中的axis2.war文件放到Tomcat服务器的webapps目录中（本文使用的Tomcat的版本是7.x），并启动Tomcat。
在浏览器地址栏中输入如下的URL： http://localhost:8080/axis2/
如果在浏览器中显示出如下所示的页面，则表示Axis2安装成功。
三、编写和发布WebService
在Axis2中不需要进行任何的配置，就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。
新建一个Java工程Axis2_1，直接点击src右键新建一个名为 SimpleService 的类，这样建好的Java文件会默认放在 default package中，在Java代码中将不会出现package 定义语句 （这很重要，因为发布webservice服务的class文件不能使用package关键字声明包）
SimpleService类：
import java.util.Random;
//注意：无package包声明
public class SimpleService {
public String getGreeting(String name){
return "Hello " + name;
}
public int getPrice(){
return new Random().nextInt(100);
}
}在SimpleService类中有两个方法，由于这两个方法都是public方法，因此，它们都将作为WebService方法被发布
编译SimpleService类后，将SimpleService.class文件放到Tomcat容器的webapps\axis2\WEB-INF\pojo目录中（如果没有pojo目录，则新建该目录）。现在我们已经成功将SimpleService类发布成了WebService。在浏览器地址栏中输入如下的URL：
http://localhost:8080/axis2/services/listServices ，如果成功发布，则出现下图：
注意事项：
1. POJO类不能使用package关键字声明包。
2. Axis2在默认情况下可以热发布WebService，也就是说，将WebService的.class文件复制到pojo目录中时，Tomcat不需要重新启动就可以自动发布WebService。如果想取消Axis2的热发布功能，可以打开\webapps\axis2\WEB-INF\conf\axis2.xml，找到如下的配置代码：
<parameter name="hotdeployment">true</parameter>将true改为false即可。要注意的是，Axis2在默认情况下虽然是热发布，但并不是热更新，也就是说，一旦成功发布了WebService，再想更新该WebService，就必须重启Tomcat。这对于开发人员调试WebService非常不方便，因此，在开发WebService时，可以将Axis2设为热更新，同样在axis2.xml文件中找到如下配置：
<parameter name="hotupdate">false</parameter>将false改为true 即可
3. 发布WebService的pojo目录只是默认的，如果想在其他的目录发布WebService，可以打开axis2.xml文件，并在<axisconfig>元素中添加如下的子元素：
<deployer extension=".class" directory="pojo" class="org.apache.axis2.deployment.POJODeployer"/>directory属性的值 设置为你的发布目录即可
四、Java调用WebService
导入用到的jar包：
axiom-api-1.2.15.jar axiom-impl-1.2.15.jar axis2-adb-1.6.4.jar axis2-kernel-1.6.4.jar axis2-transport-http-1.6.4.jar axis2-transport-local-1.6.4.jar commons-codec-1.3.jar commons-httpclient-3.1.jar commons-logging-1.1.1.jar httpcore-4.0.jar neethi-3.0.2.jar wsdl4j-1.6.2.jar XmlSchema-1.4.7.jar
Java调用代码（RPC方式）：
public class RPCClient {
public static String address="http://localhost:8080/axis2/services/SimpleService";
public static void main(String[] args) throws IOException{
Object[] result=invoke("getPrice", new Object[]{}, new Class[]{int.class});
System.out.println(result[0]);
result=invoke("getGreeting", new Object[]{"jack"}, new Class[]{String.class});
System.out.println(result[0]);
}
@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(address);
option.setTo(reference);
/*
* 设置要调用的方法
* http://ws.apache.org/axis2 为默认的（无package的情况）命名空间，
* 如果有包名，则为 http://axis2.webservice.elgin.com ,包名倒过来即可
* method为方法名称
*
*/
QName qname=new QName("http://ws.apache.org/axis2", method);
//调用远程方法,并指定方法参数以及返回值类型
Object[] result=client.invokeBlocking(qname,params,classes);
return result;
}输出结果：
五、Java复杂数据的调用处理
在default package下新建返回复杂类型的WebService类
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Random;
import com.elgin.webservice.axis2.User;
public class ComplexTypeServices {
/**
* @Title: upload
* @Description: 文件数据处理
* @param b
* @param len
* @return 参数
*/
public String upload(byte[] b ,int len){
FileOutputStream fos=null;
String path="";
try {
String dir=System.getProperty("user.dir");
File file=new File(dir + "/" + new Random().nextInt(1000) + ".jsp");
fos=new FileOutputStream(file);
fos.write(b , 0 ,len);
path=file.getAbsolutePath();
System.out.println("File path:" + path);
} catch (Exception e) {
} finally{
try {
fos.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return path;
}
/**
* @Title: getArray
* @Description: 返回一维数组
* @param i 数组长度
* @return 参数
*/
public int[] getArray(int i){
int[] arr=new int[i];
for (int j = 0; j < arr.length; j++) {
arr[j]=new Random().nextInt(100);
}
return arr;
}
/**
* @Title: getTwoArray
* @Description: 返回二维数组
* @return 参数
*/
public String[][] getTwoArray(){
return new String[][]{{"北京","上海"},{"南京","苏州"},{"深圳","厦门"},{"西安","兰州"}};
}
/**
* @Title: getUser
* @Description: 返回JavaBean对象
* @return 参数
*/
public User getUser(){
User user=new User();
user.setUsername("elgin");
user.setAge(26);
user.setEmail("[email protected]");
return user;
}
}
User类：
package com.elgin.webservice.axis2;
public class User implements Serializable{
private static final long serialVersionUID = 1L;
private String username;
private int age;
private String email;
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
@Override
public String toString() {
return "User [username=" + username + ", age=" + age + ", email=" + email + "]";
}
}
编译完成之后，将上述ComplexTypeServices类的class文件放到Tomcat容器的webapps\axis2\WEB-INF\pojo目录下，在Tomcat的webapps/axis2工程下的classes文件中新建文件路径：com/elgin/webservice/axis2 (User的包路径) ，然后将User的class文件放到此文件夹下，重启Tomcat，访问
http://localhost:8080/axis2/services/listServices 可以看到发布成功了，在list中有 ComplexTypeServices这个服务
逐一调用各个方法：
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 address="http://localhost:8080/axis2/services/SimpleService";
public static String address1="http://localhost:8080/axis2/services/ComplexTypeServices";
public static void main(String[] args) throws IOException{
testUpload();
testArray();
testTwoArray();
testUser();
}
@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(address1);
option.setTo(reference);
/*
* 设置要调用的方法
* http://ws.apache.org/axis2 为默认的（无package的情况）命名空间，
* 如果有包名，则为 http://axis2.webservice.elgin.com ,包名倒过来即可
* method为方法名称
*
*/
QName qname=new QName("http://ws.apache.org/axis2", method);
//调用远程方法,并指定方法参数以及返回值类型
Object[] result=client.invokeBlocking(qname,params,classes);
return result;
}
public static void testUpload() throws IOException{
String dir=System.getProperty("user.dir");
File file=new File(dir +"/WebContent"+ "/hello.jsp");
FileInputStream fis=new FileInputStream(file);
int len=(int) file.length();
byte[] b=new byte[len];
int read=fis.read(b);
fis.close();
Object[] result=invoke("upload", new Object[]{b,read}, new Class[]{String.class});
System.out.println(result[0]);
}
public static void testArray() throws AxisFault{
Object[] result=invoke("getArray", new Object[]{5}, new Class[]{int[].class});
int[] arr=(int[]) result[0];
for (int i : arr) {
System.out.println(i );
}
}
public static void testTwoArray() throws AxisFault{
Object[] result=invoke("getTwoArray", new Object[]{}, new Class[]{String[][].class});
String[][] arr=(String[][]) result[0];
for (String[] strings : arr) {
for (String str : strings) {
System.out.println(str);
}
}
}
public static void testUser() throws AxisFault{
Object[] result=invoke("getUser", new Object[]{}, new Class[]{User.class});
User user=(User) result[0];
System.out.println(user.toString());
}
}
调用结果：
