使用版本:
eclipse:eclipse-jee-kepler-R-win32.zip
JDK:jdk-7u25-windows-i586.exe j2sdk1.4.2_06.rar
Myeclipse:myeclipse-8.5.0-win32.exe
Tomcat:apache-tomcat-7.0.42-windows-x86.zip apache-tomcat-5.0.12.zip
Axis2:axis2-1.6.2-bin.zip axis2-1.6.2-war.zip axis2-eclipse-codegen-plugin-1.6.2.zip axis2-eclipse-service-plugin-1.6.2.zip
Axis1:axis-1.4.rar
WebLogic:oepe-indigo-installer-12.1.1.0.1.201203120349-12.1.1-win32.exe
Spring:spring-framework-3.1.1.RELEASE-with-docs.zip
Hibernate:hibernate-distribution-3.6.10.Final-dist.zip
Structs2;struts-2.3.15.1-all.zip
SVN:eclipse-svnplugin(subclipse site-1.6.2)
Oracle9i:Oracle 9i Disk1.iso Oracle 9i Disk2.iso Oracle 9i Disk3.iso
一、编写和发布WebService
1.1 新建
新建JAVA PROJECT工程,编写类文件
Axis2中不需要进行任何的配置,就可以直接将一个简单的POJO发布成WebService。
package com.pojo;
public class SimpleService {
public String getGreeting(String name) {
return "你好 " + name;
}
public int getPrice() {
return new java.util.Random().nextInt(1000);
}
}
1.2 编译
编译:javac SimpleService.java
1.3 发布
将SimpleService.class文件放到<Tomcat安装目录>\webapps\axis2\WEB-INF\pojo目录中(如果没有pojo目录,则建立该目录)。
现在我们已经成功将SimpleService类发布成了WebService。在浏览器地址栏中输入如下的URL:http://localhost:8080/axis2/services/listServices(需要启动TOMCAT)
1.4 如果失败
需要重新编译.CLASS文件,不带PACKAGE
//package com.pojo;
public class SimpleService {
public String getGreeting(String name) {
return "你好 " + name;
}
public int getPrice() {
return new java.util.Random().nextInt(1000);
}
}
重新编译:javac SimpleService.java
重启Tomcat
1.5 注意事项
包:POJO类不能使用package关键字声明包。
热启动、热更新:Axis2在默认情况下可以热发布WebService,也就是说,将WebService的.class文件复制到pojo目录中时,Tomcat不需要重新启动就可以自动发布WebService。如果想取消Axis2的热发布功能,可以打开<Tomcat安装目录>\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即可。
URL:在浏览器中测试WebService时,如果WebService方法有参数,需要使用URL的请求参数来指定该WebService方法参数的值,请求参数名与方法参数名要一致,例如,要测试getGreeting方法,请求参数名应为name,如上面的URL所示。
修改目录:发布WebService的pojo目录只是默认的,如果读者想在其他的目录发布WebService,可以打开axis2.xml文件,并在<axisconfig>元素中添加如下的子元素: <deployer extension=”.class” directory=”my” class=”org.apache.axis2.deployment.POJODeployer”/> 上面的配置允许在<Tomcat安装目录>\webapps\axis2\WEB-INF\my目录中发布WebService。例如,将本例中的SimpleService.class复制到my目录中也可以成功发布(但要删除pojo目录中的SimpleService.class,否则WebService会重名)。
二、Java调用WS客户端
新建JAVA PROJECT工程,引入AXIS2 JAR包
编写类
package com.client;
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 RPCClient {
public static void main(String[] args) {
try {
// 使用RPC方式调用WebService
RPCServiceClient serviceClient = new RPCServiceClient();
// 指定调用WebService的URL
Options options = serviceClient.getOptions();
EndpointReference targetEPR = new EndpointReference(
"http://localhost:8080/axis2/services/SimpleService");
options.setTo(targetEPR);
// 指定getGreeting方法的参数值
Object[] opAddEntryArgs = new Object[] { "超人" };
// 指定getGreeting方法返回值的数据类型的Class对象
Class[] classes = new Class[] { String.class };
// 指定要调用的getGreeting方法及WSDL文件的命名空间
QName opAddEntry = new QName("http://ws.apache.org/axis2",
"getGreeting");
// 调用getGreeting方法并输出该方法的返回值
System.out.println(serviceClient.invokeBlocking(opAddEntry,
opAddEntryArgs, classes)[0]);
// 下面是调用getPrice方法的代码,这些代码与调用getGreeting方法的代码类似
classes = new Class[] { int.class };
opAddEntry = new QName("http://ws.apache.org/axis2", "getPrice");
System.out.println(serviceClient.invokeBlocking(opAddEntry,
new Object[] {}, classes)[0]);
} catch (Exception ex) {
}
}
}
运行:
三、用wsdl2java简化客户端的编写
命令生成辅助文件:wsdl2java -uri http://localhost:8080/axis2/service/SimpleService?wsdl -p com.client -o stub
其中-uri参数指定了wsdl文件的路径,可以是本地路径,也可以是网络路径。-p参数指定了生成的Java类的包名,-o参数指定了生成的一系列文件保存的根目录。在执行完上面的命令后,读者就会发现在当前目录下多了个stub目录,可以找到一个HelloServiceStub.java文件,该文件复杂调用WebService。
执行完后,生成的辅助文件:
其中HelloServiceStub.java是客户端程序,HelloServiceCallbackHandler.java是异步客户端程序。把这两个类复制到建立好的服务端工程里,如下图所示
添加新建类:
package com.client;
public class StubClient {
public static void main(String[] args) {
// TODO Auto-generated method stub
try {
SimpleServiceStub stub = new SimpleServiceStub();
SimpleServiceStub.GetGreeting greeting = new SimpleServiceStub.GetGreeting();
SimpleServiceStub.GetPrice price = new SimpleServiceStub.GetPrice();
greeting.setArgs0("比尔");
System.out.println(stub.getGreeting(greeting).get_return());
System.out.println(stub.getPrice(price).get_return());
} catch (Exception ex) {
}
}
}
上面的代码大大简化了调用WebService的步骤,并使代码更加简洁。但要注意的是,wsdl2java.bat命令生成的Stub类将WebService方法的参数都封装在了相应的类中,类名为方法名,例如,getGreeting方法的参数都封装在了GetGreeting类中,要想调用getGreeting方法,必须先创建GetGreeting类的对象实例。