Axis Web Service开发之旅 (十) --异步调用WebService
2011-03-24 21:40
417 查看
在前面几篇文章中都是使用同步方式来调用WebService。也就是说,如果被调用的WebService方法长时间不返回,客户端将一直被阻塞,直到该方法返回为止。使用同步方法来调用WebService虽然很直观,但当WebService方法由于各种原因需要很长时间才能返回的话,就会使客户端程序一直处于等待状态,这样用户是无法忍受的。
当然,我们很容易就可以想到解决问题的方法,这就是多线程。解决问题的基本方法是将访问WebService的任务交由一个或多个线程来完成,而主线程并不负责访问WebService。这样即使被访问的WebService方法长时间不返回,客户端仍然可以做其他的工作。我们可以管这种通过多线程访问WebService的方式称为异步访问。
虽然直接使用多线程可以很好地解决这个问题,但比较麻烦。幸好Axis2的客户端提供了异步访问WebService的功能。
RPCServiceClient类提供了一个invokeNonBlocking方法可以通过异步的方式来访问WebService。下面先来建立一个WebService。
MyService是一个WebService类,代码如下:
为了模拟需要一定时间才返回的WebService方法,在getName方法中使用了sleep方法来延迟5秒。
下面是MyService类的配置代码:
从上面的配置代码可以看出,MyService的配置方式与前几章的WebService的配置方式完全一样,也就是说,MyService只是一个普通的WebService。
下面是异步调用MyService的Java客户端代码:
从上面的代码可以看出,invokeNonBlocking方法有三个参数,前两个参数分别指定了要调用的方法及方法参数的相关信息,而最后一个参数并不是方法返回值的类型信息,而是一个实现org.apache.axis2.client.async.AxisCallback接口的类的对象实例。在本例中隐式实现了AxisCallback接口。在AxisCallback接口中有四个方法需要实现,其中当被异步调用的方法返回时onMessage方法被调用。当运行上面的程序后,将输出如下的信息:
异步调用!
火星
虽然上面的例子可以实现异步调用,但比较麻烦。为了更方便地实现异步调用,可以使用wsdl2java命令的-a参数生成可异步调用的Stub类。下面的命令可生成同步和异步调用的客户端代码(两个类),其中-s表示生成同步调用代码,-a表示生成异步调用代码。
%AXIS2_HOME%/bin/wsdl2java -uri http://localhost:8080/axis2/services/myService?wsdl -p client -s -a -o stub
在执行上面的命令后,将生成两个类:MyServiceStub和MyServiceCallbackHandler类,其中MyServiceStub类负责同步和异步调用WebService,MyServiceCallbackHandler类是一个抽象类,也是一个回调类,当使用异步方式调用WebService方法时,如果方法返回,则MyServiceCallbackHandler类的receiveResultgetName方法被调用。下面是使用MyServiceStub类异步访问WebService的代码:
执行上面的程序后,将输出如下的信息:
异步调用!
火星
在.net中也可以使用异步的方式来调用WebService,如在C#中可使用如下的代码来异步调用getName方法:
其中async是引用MyService的服务名。要注意的是,在C#中不能在同一个WebService实例的getName方法未返回之前,再次调用该实例的getName方法,否则将抛出异常。如下面的代码会抛出一个异常:
async.myService my = new WSC.async.myService();
my.getNameCompleted += new WSC.async.getNameCompletedEventHandler(getNameCompletedEvent);
my.getNameAsync();
// 将抛出异常
my.getNameAsync();
但不同的WebService实例的方法可以在方法未返回时调用,如下面的代码是可以正常工作的:
本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/crazystone4/archive/2009/06/20/4285777.aspx
当然,我们很容易就可以想到解决问题的方法,这就是多线程。解决问题的基本方法是将访问WebService的任务交由一个或多个线程来完成,而主线程并不负责访问WebService。这样即使被访问的WebService方法长时间不返回,客户端仍然可以做其他的工作。我们可以管这种通过多线程访问WebService的方式称为异步访问。
虽然直接使用多线程可以很好地解决这个问题,但比较麻烦。幸好Axis2的客户端提供了异步访问WebService的功能。
RPCServiceClient类提供了一个invokeNonBlocking方法可以通过异步的方式来访问WebService。下面先来建立一个WebService。
MyService是一个WebService类,代码如下:
package service; public class MyService { public String getName() { try { System.out.println("getName方法正在执行 "); // 延迟5秒 Thread.sleep(5000); } catch (Exception e) { } return "火星"; } } package service; public class MyService { public String getName() { try { System.out.println("getName方法正在执行 "); // 延迟5秒 Thread.sleep(5000); } catch (Exception e) { } return "火星"; } }
为了模拟需要一定时间才返回的WebService方法,在getName方法中使用了sleep方法来延迟5秒。
下面是MyService类的配置代码:
<!-- services.xml --> <service name="myService"> <description> 异步调用演示 </description> <parameter name="ServiceClass"> service.MyService </parameter> <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> </messageReceivers> </service> <!-- services.xml --> <service name="myService"> <description> 异步调用演示 </description> <parameter name="ServiceClass"> service.MyService </parameter> <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> </messageReceivers> </service>
从上面的配置代码可以看出,MyService的配置方式与前几章的WebService的配置方式完全一样,也就是说,MyService只是一个普通的WebService。
下面是异步调用MyService的Java客户端代码:
package client; import javax.xml.namespace.QName; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.context.MessageContext; import org.apache.axis2.rpc.client.RPCServiceClient; public class RPCAsyncClient { public static void main(String[] args) throws Exception { RPCServiceClient serviceClient = new RPCServiceClient(); Options options = serviceClient.getOptions(); EndpointReference targetEPR = new EndpointReference( "http://localhost:8080/axis2/services/myService"); options.setTo(targetEPR); Object[] opAddEntryArgs = new Object[]{}; QName opAddEntry = new QName("http://service", "getName"); serviceClient.invokeNonBlocking(opAddEntry, opAddEntryArgs, new org.apache.axis2.client.async.AxisCallback() { @Override public void onComplete() { } @Override public void onError(Exception arg0) { } } @Override public void onFault(MessageContext arg0) { } @Override public void onMessage(MessageContext mc) { // 输出返回值 System.out.println(mc.getEnvelope().getFirstElement() .getFirstElement().getFirstElement().getText()); } }); System.out.println("异步调用!"); // 阻止程序退出 System.in.read(); } } package client; import javax.xml.namespace.QName; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.context.MessageContext; import org.apache.axis2.rpc.client.RPCServiceClient; public class RPCAsyncClient { public static void main(String[] args) throws Exception { RPCServiceClient serviceClient = new RPCServiceClient(); Options options = serviceClient.getOptions(); EndpointReference targetEPR = new EndpointReference( "http://localhost:8080/axis2/services/myService"); options.setTo(targetEPR); Object[] opAddEntryArgs = new Object[]{}; QName opAddEntry = new QName("http://service", "getName"); serviceClient.invokeNonBlocking(opAddEntry, opAddEntryArgs, new org.apache.axis2.client.async.AxisCallback() { @Override public void onComplete() { } @Override public void onError(Exception arg0) { } } @Override public void onFault(MessageContext arg0) { } @Override public void onMessage(MessageContext mc) { // 输出返回值 System.out.println(mc.getEnvelope().getFirstElement() .getFirstElement().getFirstElement().getText()); } }); System.out.println("异步调用!"); // 阻止程序退出 System.in.read(); } }
从上面的代码可以看出,invokeNonBlocking方法有三个参数,前两个参数分别指定了要调用的方法及方法参数的相关信息,而最后一个参数并不是方法返回值的类型信息,而是一个实现org.apache.axis2.client.async.AxisCallback接口的类的对象实例。在本例中隐式实现了AxisCallback接口。在AxisCallback接口中有四个方法需要实现,其中当被异步调用的方法返回时onMessage方法被调用。当运行上面的程序后,将输出如下的信息:
异步调用!
火星
虽然上面的例子可以实现异步调用,但比较麻烦。为了更方便地实现异步调用,可以使用wsdl2java命令的-a参数生成可异步调用的Stub类。下面的命令可生成同步和异步调用的客户端代码(两个类),其中-s表示生成同步调用代码,-a表示生成异步调用代码。
%AXIS2_HOME%/bin/wsdl2java -uri http://localhost:8080/axis2/services/myService?wsdl -p client -s -a -o stub
在执行上面的命令后,将生成两个类:MyServiceStub和MyServiceCallbackHandler类,其中MyServiceStub类负责同步和异步调用WebService,MyServiceCallbackHandler类是一个抽象类,也是一个回调类,当使用异步方式调用WebService方法时,如果方法返回,则MyServiceCallbackHandler类的receiveResultgetName方法被调用。下面是使用MyServiceStub类异步访问WebService的代码:
package client; import client.MyServiceStub.GetNameResponse; class MyCallback extends MyServiceCallbackHandler { @Override public void receiveResultgetName(GetNameResponse result) { // 输出getName方法的返回结果 System.out.println(result.get_return()); } } public class StubClient { public static void main(String[] args) throws Exception { MyServiceStub stub = new MyServiceStub(); // 异步调用WebService stub.startgetName(new MyCallback()); System.out.println("异步调用!"); System.in.read(); } } package client; import client.MyServiceStub.GetNameResponse; class MyCallback extends MyServiceCallbackHandler { @Override public void receiveResultgetName(GetNameResponse result) { // 输出getName方法的返回结果 System.out.println(result.get_return()); } } public class StubClient { public static void main(String[] args) throws Exception { MyServiceStub stub = new MyServiceStub(); // 异步调用WebService stub.startgetName(new MyCallback()); System.out.println("异步调用!"); System.in.read(); } }
执行上面的程序后,将输出如下的信息:
异步调用!
火星
在.net中也可以使用异步的方式来调用WebService,如在C#中可使用如下的代码来异步调用getName方法:
private void getNameCompletedEvent(object sender, WSC.asyn.getNameCompletedEventArgs e) { listBox1.Items.Add( e.Result.@return); } private void button1_Click(object sender, EventArgs e) { async.myService my = new WSC.async.myService(); my.getNameCompleted += new WSC.async.getNameCompletedEventHandler(getNameCompletedEvent); my.getNameAsync(); MessageBox.Show("完成调用"); } private void getNameCompletedEvent(object sender, WSC.asyn.getNameCompletedEventArgs e) { listBox1.Items.Add( e.Result.@return); } private void button1_Click(object sender, EventArgs e) { async.myService my = new WSC.async.myService(); my.getNameCompleted += new WSC.async.getNameCompletedEventHandler(getNameCompletedEvent); my.getNameAsync(); MessageBox.Show("完成调用"); }
其中async是引用MyService的服务名。要注意的是,在C#中不能在同一个WebService实例的getName方法未返回之前,再次调用该实例的getName方法,否则将抛出异常。如下面的代码会抛出一个异常:
async.myService my = new WSC.async.myService();
my.getNameCompleted += new WSC.async.getNameCompletedEventHandler(getNameCompletedEvent);
my.getNameAsync();
// 将抛出异常
my.getNameAsync();
但不同的WebService实例的方法可以在方法未返回时调用,如下面的代码是可以正常工作的:
asyn.myService my = new WSC.asyn.myService(); my.getNameAsync(); my.getNameCompleted += new WSC.asyn.getNameCompletedEventHandler(getNameCompletedEvent); asyn.myService my1 = new WSC.asyn.myService(); my1.getNameCompleted += new WSC.asyn.getNameCompletedEventHandler(getNameCompletedEvent); my1.getNameAsync();
本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/crazystone4/archive/2009/06/20/4285777.aspx
相关文章推荐
- axis调用webservice客户端开发
- 采用axis框架,进行webservice接口开发、调用时,http://127.0.0.1:8080/TestService/services/TestService?wsdl即wsdl的xml文件
- iPhone开发中如何异步调用web service
- webservice系列教学(14)-如何调用webservice(vc5)-.NET教程,Web Service开发
- Axis实现 web service接口开发 + 客户端调用
- 【知识积累】服务器端获取客户端的IP地址(当客户端调用由Axis开发的WebService)
- 使用Axis2开发webservice服务端接口+axis开发的客户端调用
- 使用Axis开发Web Service应用及调用
- .net知识系列之九:分布式开发(xml webservice介绍和服务器开发,异步调用)
- C# 调用JAVA(使用axis)开发的webservice 提示错误的问题
- iPhone开发中如何异步调用web service
- axis2开发webservice之异步调用WebService
- 采用axis框架,进行webservice接口开发、调用时,http://127.0.0.1:8080/TestService/services/TestService?wsdl是什么
- 体验.net 2.0 的优雅 -- 异步WebService调用
- 在Web Service中的异步开发模式
- Jquery Ajax学习实例5 向WebService发出请求,返回泛型集合数据的异步调用
- Winform异步调用WebService
- MyEclipse下开发Web Service(Axis)
- 异步调用 WebService 及 同步模式下通过Session以共享计数
- jQuery dialog 异步调用ashx,webservice数据的代码