WebService之Axis2系列教程(七)异步调用WebService

在前面几篇文章中都是使用同步方式来调用WebService。也就是说,如果被调用的WebService方法长时间不返回,客户端将一直被阻塞,直到该方法返回为止。使用同步方法来调用WebService虽然很直观,但当WebService方法由于各种原因需要很长时间才能返回的话,就会使客户端程序一直处于等待状态,这样用户是无法忍受的。
      
当然,我们很容易就可以想到解决问题的方法,这就是多线程。解决问题的基本方法是将访问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 "火星";
              }
       }

      为了模拟需要一定时间才返回的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>

      从上面的配置代码可以看出,MyService的配置方式与前几章的WebService的配置方式完全一样,也就是说,MyService只是一个普通的WebService
      
下面是异步调用MyServiceJava客户端代码:

       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

      在执行上面的命令后,将生成两个类:MyServiceStubMyServiceCallbackHandler类,其中MyServiceStub类负责同步和异步调用WebServiceMyServiceCallbackHandler类是一个抽象类,也是一个回调类,当使用异步方式调用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();    
              } 
       }

      执行上面的程序后,将输出如下的信息:    

       异步调用!
       火星

 

 

 

 

 

教程源码下载:

AxisTest

AxisSpring

AxisProject

 

转载请标明出处http://blog.csdn.net/shimiso

欢迎有识之士加入我们的技术交流群:361579846

©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页