简介
WebService是一种服务的提供方式,通过WebService,不同应用间相互间调用变的很方便,网络上有很多常用的WebService服务,如:http://developer.51cto.com/art/200908/147125.htm,不同的语言平台对WebService都有实现,Java的WebService实现,比较流行的有Axis2、Jaxws,本文介绍的是Axis2。
Axis2下载和部署
Axis2是Apache开发的一个开源项目,再次感叹Apache的伟大!
下载地址:
将其内axis2.war解压到/webapps下,启动Tomcat,war包会自动解压,
配置Axis2
/webapps/axis2/WEB-INF/conf/axis2.xml,配置其内两个属性,以便调试。
true
true
编写服务
所谓服务就是编写一个类,写一些方法,方法返回数据,WebService客户端获取数据。
public classHelloService {publicString sayHello() {return "hello";
}
}
0配置POJO发布服务
服务类创建好后,我们需要发布到服务器上,将HelloService.class放到/webapps/axis2/WEB-INF/pojo下,pojo没有需要创建。
至此,我们已经成功的创建了一个WebService服务了,so easy!
再次访问http://localhost:8080/axis2/,点击Services,可以发现可用services中多了一个HelloService,其内有一个可用操作sayHello,说明发布成功。
HelloService
Service Description : No description availablefor thisservice
Service EPR : http://localhost:8080/axis2/services/HelloService
Service Status : Active
Available Operations
sayHello
hello
这里有两点需要注意:
- POJO发布的类不能放在包里,既不能使用package关键字;
- 默认的发布目录是pojo,可以在/webapps/axis2/WEB-INF/conf/axis2.xml中增加目录,
"class="org.apache.axis2.deployment.POJODeployer" />
要注意多个目录见WebService要唯一,否则会重名,重名后,先部署的会成功,后部署的会报错。
services.xml配置文件发布服务
虽然POJO的方式不需要配置文件,但是其服务类不能放在包内,显然是不符合我们日常开发的,Axis2也允许带包的类发布WebService,如果不允许,估计就没人用了。
首先写一个较复杂的服务类,多个方法,带参数,有返回值的。
packagewebservice.test;/*** 计算器运算
*
*@authorgaoshuang*/
public classCalculateService {//加法
public float plus(float x, floaty) {return x +y;
}//减法
public float minus(float x, floaty) {return x -y;
}//乘法
public float multiply(float x, floaty) {return x *y;
}//除法
public float divide(float x, floaty) {if (y != 0)return x /y;else
return -1;
}
}
然后编写services.xml,该文件需要放在META-INF文件夹下。
加减乘除计算服务
com.runqianapp.webservice.test.CalculateService
最后将这两个文件打成jar包,不论用工具还是手动打,打的都是最外层的文件夹。
我打的名字是server.jar,更改后缀为aar,所以最后是server.aar,Axis2建议使用aar发布WebService,
将server.aar放到/webapps/axis2/WEB-INF/services下,访问http://localhost:8080/axis2/services/listServices,
多出了一个CalculateService,说明发布成功。
CalculateService
Service Description : CalculateService
Service EPR : http://localhost:8080/axis2/services/CalculateService
Service Status : Active
Available Operations
divide
plus
minus
multiply
分别访问
...
...
客户端实现
以上介绍的都是WebService服务创建及发布,那么有了一个WebService服务后,我们如何调用呢?只在浏览器上访问是没有意义的。
新建工程WebServiceClientTest,将/lib下所有jar包添加到工程中;
编写客户端代码;
packagewebservice.client.test;importjavax.xml.namespace.QName;importorg.apache.axis2.AxisFault;importorg.apache.axis2.addressing.EndpointReference;importorg.apache.axis2.client.Options;importorg.apache.axis2.rpc.client.RPCServiceClient;public classClient1 {/***@paramargs
*@throwsAxisFault*/
public static void main(String[] args) throwsAxisFault {//使用RPC方式调用WebService
RPCServiceClient serviceClient = newRPCServiceClient();
Options options=serviceClient.getOptions();//指定调用WebService的URL
EndpointReference targetEPR = newEndpointReference("http://localhost:8080/axis2/services/CalculateService");
options.setTo(targetEPR);//调用方法的参数值
Object[] entryArgs = new Object[] {1, 2};//调用方法返回值的数据类型的Class对象
Class[] classes = new Class[] { float.class};//调用方法名及WSDL文件的命名空间//命名空间是http://localhost:8080/axis2/services/CalculateService?wsdl中wsdl:definitions标签targetNamespace属性
QName opName = new QName("http://test.webservice", "plus");//执行方法获取返回值//没有返回值的方法使用serviceClient.invokeRobust(opName, entryArgs)
Object result = serviceClient.invokeBlocking(opName, entryArgs, classes)[0];
System.out.println(result);//out: 3.0
}
}
以上是实现了一个简单的WebSerivce客户端,调用CalculateService中的plus方法,由代码可见,这种调用方式比较杂乱,代码不太友好。
wsdl2java简化客户端
/bin目录,其内有两个bat,wsdl2java.bat和java2wsdl.bat,可以实现WSDL文件和Java之间的互相转换。
考虑到我们以后可能经常使用这些命令,设置环境变量,方便以后调用。在系统变量中加入AXIS2_HOME=,path中追加;%AXIS2_HOME%\bin。
启动命令提示符,进入WebServiceTestClient所在根目录,运行
wsdl2java -uri http://localhost:8080/axis2/services/CalculateService?wsdl -p webservice.client.test -s
参数说明:uri - wsdl文件路径,网络路径或本地路径,p - 打包,这里和上一个客户端实现类打在了一个包里,webservice.client.test为包名,wsdl2java有很多参数,详细可以运行该命令去查看。
执行后,如果没有报错,说明运行成功,刷新项目,该包下多出了一个CalculateServiceStub类,里面的代码极其复杂,还乱呼呼的,这我们不用管,调用该类。
packagewebservice.client.test;importjava.rmi.RemoteException;importwebservice.client.test.CalculateServiceStub.Plus;public classClient2 {/***@paramargs
*@throwsRemoteException*/
public static void main(String[] args) throwsRemoteException {
CalculateServiceStub stub= newCalculateServiceStub();
Plus plus= newPlus();
plus.setX(1);
plus.setY(2);float result = stub.plus(plus).get_return();//返回值自动转型,这也是强大之处
System.out.println(result);
}
}
如此做的好处就是调用时不需要在去查看WSDL,和正常使用一个类一样,对WebService的封装都由wsdl2java自动生成,代码更优雅、简洁。
利用wsdl2java轻松使用第三方WebService服务
有了wsdl2java,已知一个WSDL文件我们就可以轻松的生成WebService客户端供我们调用,给我们服务。文章开头给出的链接包含了一些第三方服务,有一个服务是生成随机个数中文,WSDL:http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl,同样,启动命令提示符,进入项目路径,执行
wsdl2java -uri http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl -p webservice.client.test -s
调用该类
packagewebservice.client.test;importjava.rmi.RemoteException;importwebservice.client.test.RandomFontsWebServiceStub.ArrayOfString;importwebservice.client.test.RandomFontsWebServiceStub.GetChineseFonts;public classThirdClient {/***@paramargs
*@throwsRemoteException*/
public static void main(String[] args) throwsRemoteException {
RandomFontsWebServiceStub stub= newRandomFontsWebServiceStub();
GetChineseFonts getChineseFonts= newGetChineseFonts();
getChineseFonts.setByFontsLength(10);//免费使用有限制,最多8个
ArrayOfString result =stub.getChineseFonts(getChineseFonts).getGetChineseFontsResult();for(String str : result.getString()) {
System.out.println(str);
}
}
}