java 调用webservice 的各种方法总结
现在webservice 加xml 技术已经逐渐成熟,但要真正要用起来还需时日!!
由于毕业设计缘故,我看了很多关于webservice 方面的知识,今天和大家一起来研究研究webservice 的各种使用方法。
一、利用jdk web 服务api 实现,这里使用基于 SOAP message 的 Web 服务
1. 首先建立一个Web services EndPoint : package Hello;
import javax.jws.WebService;
import javax.jws.WebMethod;
import javax.xml.ws.Endpoint;
@WebService
public class Hello {
@WebMethod
public String hello(String name) {
return "Hello, " + name + "/n";
}
public static void main(String[] args) {
// create and publish an endpoint
Hello hello = new Hello();
Endpoint endpoint = Endpoint.publish("http://localhost:8080/hello ", hello);
}
}
2. 使用 apt 编译 Hello.java( 例:apt -d [ 存放编译后的文件目录] Hello.java ) , 会生成 jaws 目录
3. 使用java Hello.Hello 运行,然后将浏览器指向http://localhost:8080/hello?wsdl 就会出现下列显示
4. 使用wsimport 生成客户端
使用如下:wsimport -p . -keep http://localhost:8080/hello?wsdl
这时,会在当前目录中生成如下文件:
5. 客户端程序:
1class HelloClient{
2public static void main(String args[]) {
3 HelloService service = new HelloService();
4 Hello helloProxy = service.getHelloPort();
5 String hello = helloProxy.hello(" 你好");
6 System.out.println(hello);
7 }
8}
9
以上方法还稍显繁琐,还有更加简单的方法
二、使用xfire ,我这里使用的是myeclipse 集成的xfire 进行测试的
利用xfire 开发WebService ,可以有三种方法:
1 一种是从javabean 中生成;
2 一种是从wsdl 文件中生成;
3 还有一种是自己建立webservice
步骤如下:
用myeclipse 建立webservice 工程,目录结构如下:
首先建立webservice 接口,
代码如下:
1package com.myeclipse.wsExample;
2//Generated by MyEclipse
3
4public interface IHelloWorldService {
5
6 public String example(String message);
7
8} 接着实现这个借口: 1package com.myeclipse.wsExample;
2//Generated by MyEclipse
3
4public class HelloWorldServiceImpl implements IHelloWorldService {
5
6 public String example(String message) {
7 return message;
8 }
9
10} 修改service.xml 文件,加入以下代码:
1<service>
2 <name>HelloWorldService</name>
3 <serviceClass>
4 com.myeclipse.wsExample.IHelloWorldService
5 </serviceClass>
6 <implementationClass>
7 com.myeclipse.wsExample.HelloWorldServiceImpl
8 </implementationClass>
9 <style>wrapped</style>
10 <use>literal</use>
11 <scope>application</scope>
12 </service> 把整个项目部署到tomcat 服务器中 ,打开浏览器,输入http://localhost:8989/HelloWorld/services/HelloWorldService?wsdl , 可以看到如下:
然后再展开HelloWorldService 后面的wsdl 可以看到:
客户端实现如下: 1package com.myeclipse.wsExample.client;
2
3import java.net.MalformedURLException;
4import java.net.URL;
5
6import org.codehaus.xfire.XFireFactory;
7import org.codehaus.xfire.client.Client;
8import org.codehaus.xfire.client.XFireProxyFactory;
9import org.codehaus.xfire.service.Service;
10import org.codehaus.xfire.service.binding.ObjectServiceFactory;
11
12import com.myeclipse.wsExample.IHelloWorldService;
13
14public class HelloWorldClient {
15public static void main(String[] args) throws MalformedURLException, Exception {
16// TODO Auto-generated method stub
17Service s=new ObjectServiceFactory().create(IHelloWorldService.class);
18XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());
19String url="http://localhost:8989/HelloWorld/services/HelloWorldService ";
20
21 try
22 {
23
24 IHelloWorldService hs=(IHelloWorldService) xf.create(s,url);
25 String st=hs.example("zhangjin");
26 System.out.print(st);
27 }
28 catch(Exception e)
29 {
30 e.printStackTrace();
31 }
32 }
33
34}
35 这里再说点题外话,有时候我们知道一个wsdl 地址,比如想用java 客户端引用.net 做得webservice ,使用myeclipse 引用,但是却出现无法通过验证的错误,这时我们可以直接在类中引用,步骤如下:
1public static void main(String[] args) throws MalformedURLException, Exception {
2 // TODO Auto-generated method stub
3 Service s=new ObjectServiceFactory().create(IHelloWorldService.class);
4 XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());
5
6
7// 远程调用.net 开发的webservice
8Client c=new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl "));
9 Object[] o=c.invoke("qqCheckOnline", new String[]{"531086641","591284436"});
10
11// 调用.net 本机开发的webservice
12Client c1=new Client(new URL("http://localhost/zj/Service.asmx?wsdl "));
13Object[] o1=c1.invoke("HelloWorld",new String[]{});
14
15}
三、使用axis1.4 调用webservice 方法
前提条件:下载axis1.4 包和tomcat 服务器 ,并将axis 文件夹复制到tomcat 服务器的webapp 文件夹中
这里我就说一下最简单的方法:
首先建立一个任意的java 类(例如:HelloWorld.java ),复制到axis 文件夹下, 将其扩展名改为jws ,然后重新启动tomcat ,在浏览器中输入http://localhost:8989/axis/HelloWorld.jws?wsdl ,就会得到一个wsdl 文件,其客户端调用方法如下:
1import javax.xml.rpc.Service;
2import javax.xml.rpc.ServiceException;
3import javax.xml.rpc.ServiceFactory;
4
5import java.net.MalformedURLException;
6import java.net.URL;
7import java.rmi.RemoteException;
8
9import javax.xml.namespace.QName;
10
11public class TestHelloWorld {
12
13
14 public static void main(String[] args) throws MalformedURLException, ServiceException, RemoteException {
15 // TODO Auto-generated method stub
16
17 String wsdlUrl ="http://localhost:8989/axis/HelloWorld.jws?wsdl ";
18 String nameSpaceUri ="http://localhost:8989/axis/HelloWorld.jws ";
19 String serviceName = "HelloWorldService";
20 String portName = "HelloWorld";
21
22 ServiceFactory serviceFactory = ServiceFactory.newInstance();
23 Service afService =serviceFactory.createService(new URL(wsdlUrl),new QName(nameSpaceUri, serviceName));
24 HelloWorldInterface proxy = (HelloWorldInterface)afService.getPort(new QName(nameSpaceUri, portName),HelloWorldInterface.class);
25 System.out.println("return value is "+proxy.getName("john") ) ;
26
27 }
28
29}
30 四、使用axis2 开发webservice (这里首先感谢李宁老师)
使用axis2 需要先下载
axis2-1.4.1-bin.zip
axis2-1.4.1-war.zip
http://ws.apache.org/axis2/
同理,也需要将axis2 复制到webapp 目录中
在axis2 中部署webservice 有两种方法,
第一种是pojo 方式,这种方式比较简单,但是有一些限制,例如部署的类不能加上包名
第二种方式是利用xml 发布webservice ,这种方法比较灵活,不需要限制类的声明
下面分别说明使用方法:
1.pojo 方式:在Axis2 中不需要进行任何的配置,就可以直接将一个简单的POJO 发布成WebService 。其中POJO 中所有的public 方法将被发布成WebService 方法。先实现一个pojo 类:
1public class HelloWorld{
2 public String getName(String name)
3 {
4 return " 你好 " + name;
5 }
6 public int add(int a,int b)
7 {
8 return a+b;
9 }
10}
11 由于这两个方法都是public 类型,所以都会发布成webservice 。编译HelloWorld 类后,将HelloWorld.class 文件放 到%tomcat%/webapps/axis2/WEB-INF/pojo 目录中(如果没有pojo 目录,则建立该目录),然后打开浏览器进行测试:
输入一下url :
http://localhost:8080/axis2/services/listServices
会列出所有webservice
这是其中的两个webservice 列表,接着,在客户端进行测试:
首先可以写一个封装类,减少编码,代码如下:
1package MZ.GetWebService;
2import javax.xml.namespace.QName;
3
4import org.apache.axis2.AxisFault;
5import org.apache.axis2.addressing.EndpointReference;
6import org.apache.axis2.client.Options;
7import org.apache.axis2.rpc.client.RPCServiceClient;
8
9
10public class GetWSByAxis2 {
11 private static String EndPointUrl;
12 private static String QUrl="http://ws.apache.org/axis2 ";
13 private QName opAddEntry;
14 public String WSUrl;
15 public RPCServiceClient setOption() throws AxisFault
16 {
17 RPCServiceClient serviceClient = new RPCServiceClient();
18 Options options = serviceClient.getOptions();
19 EndpointReference targetEPR = new EndpointReference(WSUrl);
20 options.setTo(targetEPR);
21 return serviceClient;
22 }
23
24 public QName getQname(String Option){
25
26 return new QName (QUrl,Option);
27 }
28 // 返回String
29 public String getStr(String Option) throws AxisFault
30 {
31 RPCServiceClient serviceClient =this.setOption();
32
33 opAddEntry =this.getQname(Option);
34
35 String str = (String) serviceClient.invokeBlocking(opAddEntry,
36 new Object[]{}, new Class[]{String.class })[0];
37 return str;
38 }
39// 返回一维String 数组
40 public String[] getArray(String Option) throws AxisFault
41 {
42 RPCServiceClient serviceClient =this.setOption();
43
44 opAddEntry =this.getQname(Option);
45
46 String[] strArray = (String[]) serviceClient.invokeBlocking(opAddEntry,
47 new Object[]{}, new Class[]{String[].class })[0];
48 return strArray;
49 }
50 // 从WebService 中返回一个对象的实例
51 public Object getObject(String Option,Object o) throws AxisFault
52 {
53 RPCServiceClient serviceClient =this.setOption();
54 QName qname=this.getQname(Option);
55 Object object = serviceClient.invokeBlocking(qname, new Object[]{},new Class[]{o.getClass()})[0];
56 return object;
57 }
58
59/ 读者可以自己封装数据类型,如int,byte,float 等数据类型
60}
61 客户端调用方法:
MZ.GetWebService.GetWSByAxis2 ws=new MZ.GetWebService.GetWSByAxis2();
ws.WSUrl="http://localhost:8989/axis2/services/HelloWorld ";
HelloWorld hello= (HelloWorld)ws.getObject("getName", HelloWorld.class);
System.out.println(hello.getName("zhangjin"));
2. 使用service.xml 发布webservice ,这种方式和直接放在pojo 目录中的POJO 类不同。要想将MyService 类发布成Web Service ,需要一个services.xml 文件,这个文件需要放在META-INF 目录中,该文件的内容如下: <service name="HelloWorld">
<description>
HelloWorld webservice
</description>
<parameter name="ServiceClass">
service.HelloWorld
</parameter>
<messageReceivers>
<messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out "
class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
<messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only "
class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
</messageReceivers>
</service>
其中<service> 元素用于发布Web Service ,一个<service> 元素只能发布一个WebService 类,name 属性表示WebService 名,如下面的URL 可以获得这个WebService 的WSDL 内容:
http://localhost:8080/axis2/services/myService?wsdl
除此之外,还有直接可以在其中制定webservice 操作方法:可以这样些service.xml 文件
1<service name="HelloWorld">
2 <description>
3 HelloWorld service
4 </description>
5 <parameter name="ServiceClass">
6 service.HelloWorld
7 </parameter>
8 <operation name="getName">
9 <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
10 </operation>
11 <operation name="add">
12 <messageReceiver
13 class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
14 </operation>
15</service>
16 如果要发布多个webservice ,可以在文件两段加 上<serviceGroup><service></service>...<service>< /service></serviceGroup> 发布