WebService大讲堂之Axis2(8)：异步调用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类的配置代码：

<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();
    }
}

从上面的代码可以看出，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();
    }
}

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

异步调用！
火星

在.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("完成调用");
}

其中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();

本文转自 androidguy 51CTO博客，原文链接：http://blog.51cto.com/androidguy/215187，如需转载请自行联系原作者

WebService大讲堂之Axis2(8)：异步调用WebService相关推荐

WebService大讲堂之Axis2(6)：跨服务会话(Session)管理
在<WebService大讲堂之Axis2(5):会话(Session)管理>一文中介绍了如何使用Axis2来管理同一个服务的会话,但对于一个复杂的系统,不可能只有一个WebService ...
WebService大讲堂之Axis2(4)：二进制文件传输
在< WebService大讲堂之Axis2(2):复合类型数据的传递 >中讲过,如果要传递二进制文件(如图像.音频文件等),可以使用byte[] 作为数据类型进行传递,然后客户端使用RP ...
WebService大讲堂之Axis2(3)：使用services.xml文件发布WebService
用Axis2 实现Web Service ,虽然可以将POJO 类放在axis2\WEB-INF\pojo 目录中直接发布成Web Service ,这样做不需要进行任何配置,但这些POJO 类不能在 ...
xml提示无法连接到远程服务器,异步调用WebService时，如何捕捉“无法连接远程服务器”异常...
在winform窗体中调用webservice,过程如下: ①Form1中弹出Form2 Form2 form2 = new Form2(); form2.ShowDialoag(); ②Form2中 ...
异步调用WebService
这里用Winform演示如何异步调用WebService. 首先在界面中拖入2个按纽,一个是同步,一个是异步,作为比较.新建立一个WebService,就用默认的HelloWorld方法来演示. 在W ...
asp.net中异步调用WebService（异步页）[转]
由于asp2.0提供了异步页的支持使异步调用WebService的性能有了真正的提升. 使用异步页,首先要设置Async="true",异步页是在Prerender和Prerend ...
cmd 调用webservice接口_c# 三种方法调用WebService接口
1.引用*.wsdl文件 WebService服务端会提供wsdl文件,客户端通过该文件生成.cs文件以及生成.dll. 注意:若服务端只提供的了URL,在URL后面加上"?wsdl&quo ...
WebService大讲堂之Axis2（2）：复合类型数据的传递
在实际的应用中,不仅需要使用WebService 来传递简单类型的数据,有时也需要传递更复杂的数据,这些数据可以被称为复合类型的数据.数组与类(接口)是比较常用的复合类型.在Axis2 中可以直接使用 ...
WebService大讲堂之Axis2（1）：用POJO实现0配置的WebService
Axis2 是一套崭新的WebService 引擎,该版本是对Axis1.x 重新设计的产物.Axis2 不仅支持SOAP1.1 和SOAP1.2 ,还集成了非常流行的REST WebService ...

WebService大讲堂之Axis2(8)：异步调用WebService

WebService大讲堂之Axis2(8)：异步调用WebService相关推荐

最新文章

热门文章