Axis2 创建 web service (2) : 同步异步调用

继续上个章节的内容，采用示例探讨一下web service同步异步调用的问题

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

1. 创建java project, AsyncServer

里面创建类如下

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

为了模拟需要一定时间才返回的WebService方法，在getName方法中使用了sleep方法来延迟5秒。

采用和前面章节一样的方式创建server并且部署到axis2下面

生成的wsdl如下

http://localhost:8080/axis2/services/asyncServer?wsdl

2. 创建java project: AsyncClient异步调用web service

为了更方便地实现异步调用，有几种方式

1） 可以使用wsdl2java命令的-a参数生成可异步调用的Stub类。下面的命令可生成同步和异步调用的客户端代码（两个类），

其中-s表示生成同步调用代码，-a表示生成异步调用代码

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

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

package test;import client.AsyncServerStub.GetNameResponse;import client.AsyncServerStub;class MyCallback extends client.AsyncServerCallbackHandler{    public void receiveResultgetName(GetNameResponse result)    {        //  输出getName方法的返回结果        System.out.println(result.get_return());    }}public class AsyncCallTest{    public static void main(String[] args) throws Exception      {        AsyncServerStub stub = new AsyncServerStub();                //  异步调用WebService        stub.startgetName( new MyCallback() );        System.out.println("异步调用！");        System.in.read();        } }  

启动tomcat，执行代码

最终执行结果是在console控制台上输出

在tomcat的控制台会输出

从这个输出过程来看，还真是异步调用webservice，不然“异步调用！”怎么会出现在“getName方法正在执行”之前呢。

2） 使用axis2 code generator生成异步调用代码

生成代码结构如下

然后建立像前面一样的代码，得到的结果是一样的

对生成代码AsyncServerCallbackHandler的解析