WebService大讲堂之Axis2系列教程之八：异步调用WebService

在前面几篇文章中都是使用同步方式来调用 WebService。也就是说，如果被调用的 WebService方法长时间不返回，客户端将一直被阻塞，直到该方法返回为止。使用同步方法来调用 WebService虽然很直观，但当 WebService方法由于各种原因需要很长时间才能返回的话，就会使客户端程序一直处于等待状态，这样用户是无法忍受的。
    当然，我们很容易就可以想到解决问题的方法，这就是多线程。解决问题的基本方法是将访问 WebService的任务交由一个或多个线程来完成，而主线程并不负责访问 WebService。这样即使被访问的 WebService方法长时间不返回，客户端仍然可以做其他的工作。我们可以管这种通过多线程访问 WebService的方式称为异步访问。
    虽然直接使用多线程可以很好地解决这个问题，但比较麻烦。幸好 Axis2的客户端提供了异步访问 WebService的功能。
    RPCServiceClient类提供了一个 invokeNonBlocking方法可以通过异步的方式来访问 WebService。下面先来建立一个 WebService。
    MyService 是一个 WebService类，代码如下：

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->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类的配置代码：

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> --><!--   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客户端代码：

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->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方法被调用。当运行上面的程序后，将输出如下的信息：

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->异步调用！
火星

    虽然上面的例子可以实现异步调用，但比较麻烦。为了更方便地实现异步调用，可以使用 wsdl2java命令的 -a参数生成可异步调用的 Stub类。下面的命令可生成同步和异步调用的客户端代码（两个类），其中 -s表示生成同步调用代码， -a表示生成异步调用代码。

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->%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的代码：

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->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();    
    } 
}

 

   执行上面的程序后，将输出如下的信息：   

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->异步调用！
火星

本文出处：

http://www.blogjava.net/nokiaguy/archive/2009/nokiaguy/archive/2009/nokiaguy/archive/2009/02/13/254548.html