axis2开发webservice之异步子用WebService

axis2开发webservice之异步调用WebService

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

package asynchronous;

public class MyService
{
    public String getName()
    {
        try
        {            
            System.out.println("getName方法正在执行 ");
            //  延迟5秒
            Thread.sleep(3000);
        }
        catch (Exception e)
        {        
        }
        return "火星";
    }
}

为了模拟需要一定时间才返回的WebService方法,在getName方法中使用了sleep方法来延迟5秒。
   
 下面是MyService类的配置代码:

<service name="asynchronous">
    <description>
        异步调用演示
    </description>
    <parameter name="ServiceClass">
        asynchronous.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

    为了更方便地实现异步调用,可以使用wsdl2java命令的-a参数生成可异步调用的Stub类。下面的命令可生成同步和异步调用的客户端代码(两个类),其中-s表示生成同步调用代码,-a表示生成异步调用代码

%AXIS2_HOME%\bin\wsdl2java -uri http://localhost:8080/axis2/services/myService?wsdl -p client -s -a -o stub

    在执行上面的命令后,将生成两个类:AsynchronousStub和AsynchronousCallbackHandler类,其中AsynchronousStub类负责同步和异步调用WebService,AsynchronousCallbackHandler类是一个抽象类,也是一个回调类,当使用异步方式调用WebService方法时,如果方法返回,则AsynchronousCallbackHandler类的receiveResultgetName方法被调用。下面是使用AsynchronousStub类异步访问WebService的代码:

package asynchronous;

import asynchronous.AsynchronousStub.GetNameResponse;

class MyCallback extends AsynchronousCallbackHandler
{
    public void receiveResultgetName(GetNameResponse result)
    {
        //  输出getName方法的返回结果
        System.out.println(result.get_return());
    }
}
public class StubClient
{
    public static void main(String[] args) throws Exception  
    {
        AsynchronousStub stub = new AsynchronousStub();        
        //  异步调用WebService
        AsynchronousStub.GetName gn = new AsynchronousStub.GetName();
        stub.startgetName(gn, new MyCallback());
        System.out.println("异步调用!");
        System.in.read();    
    } 
}  

 执行上面的程序后,过程如下

  axis2开发webservice之异步子用WebServiceaxis2开发webservice之异步子用WebServiceaxis2开发webservice之异步子用WebService

     最终的结果就是第三幅图所示的信息,从这个输出过程来看,还真是异步调用webservice,不然“异步调用!”怎么会出现在“getName方法正在执行”之前呢。