一、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,找到如下的配置代码:
true
将true改为false即可。要注意的是,Axis2在默认情况下虽然是热发布,但并不是热更新,也就是说,一旦成功发布了WebService,再想更新该WebService,就必须重启Tomcat。这对于开发人员调试WebService非常不方便,因此,在开发WebService时,可以将Axis2设为热更新,同样在axis2.xml文件中找到如下配置:
false
将false改为true 即可
3. 发布WebService的pojo目录只是默认的,如果想在其他的目录发布WebService,可以打开axis2.xml文件,并在
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());
}
}
调用结果: