axis2是apache的新一个版本SOAP引擎,不过因为axis2是基于新的体系结构编写的,使用方法和api与axis还是有很大区别。
axis2下载网址 它有区分java和c版本的。
最简单的使用,就是使用axis2的pojo模式,下载war版本,解压到tomcat的webapps目录(这里使用tomcat作为web容器)。启动tomcat后,默认设置下,访问http://localhost:8080/axis2/ 会看到一个欢迎界面。
点击Validate 可以检查axis2所必须的jar包是否安装完整。
点击Services 可以看到我们安装的对外提供的服务。
在webapps\axis2\WEB-INF 目录下新建一个pojo目录,axis2默认配置的目录名称是pojo,当然,这个可以在配置文件中修改。
在pojo目录新建一个Demo.java文件,作为服务。
public class Demo
{
public String hello(String name)
{
return "say:" + name;
}
public String test()
{
return "test";
}
}
编译为class。如果此时tomcat已经启动,axis2会自动载入这个class作为服务。
这个时候,你点击services 就可以看到多出一个Demo名称的服务,并有两个Available Operations。输入http://localhost:8080/axis2/services/Demo?wsdl就可以浏览axis2为这个服务自动生成的wsdl信息。(有关wsdl的信息可以w3c)
在浏览器中输入http://localhost:8080/axis2/services/Demo/test 可以直接访问test方法,并返回信息,但这个并不是webService服务的要点,我们还需要能在程序客户端直接访问。
在eclipse中新建一个普通工程,把webapps\axis2\WEB-INF\lib 中的jar文件加入到这个工程的path路径中,以便能正常使用axis2的jar包。
import javax.xml.namespace.QName;
import org.apache.axiom.om.OMElement;
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 Axis2Test1 {
//访问url 记住后面没有?wsdl
private static EndpointReference targetEPR = new EndpointReference(
"http://localhost:8080/axis2/services/Demo");
public static void main(String[] args)
{
try {
//初始化一个RPCservice客户端
RPCServiceClient service = new RPCServiceClient();
Options options = service.getOptions();
options.setTo(targetEPR);
//targetNamespace="http://ws.apache.org/axis2" 名称空间
//say 方法,名称空间
QName qn = new QName("http://ws.apache.org/axis2", "hello");
//参数 执行方法
Object[] objs = new Object[]{"suju"};
OMElement result = service.invokeBlocking(qn, objs);
//显示返回节点值
System.out.println(result.getFirstElement().getText());
} catch (Exception e) {
e.printStackTrace();
}
}
}
调用方法的时候,对使用axis提供的wsdl,名称空间有时候要指定,因为axis和axis2默认生成的名称空间不一定相同,至少我的电脑上测试是这样。如果不指定,程序使用默认名称空间,在axis2下调用axis提供的wsdl接口服务时,就会抛出名称空间不对应的error。
这是一个简单的demo,使用axis2发布一个服务,然后在客户端中访问这个带一个参数的服务接口hello。