WebService之Axis2快速入门(8): WebService的异步调用
WebService之Axis2快速入门(8): WebService的异步调用
吕兵阳 发表于2年前
WebService之Axis2快速入门(8): WebService的异步调用
  • 发表于 2年前
  • 阅读 34
  • 收藏 0
  • 点赞 2
  • 评论 0

新睿云服务器60天免费使用,快来体验!>>>   

摘要: axis2系列学习教程

在前面几篇文章中都是使用同步方式来调用WebService。也就是说,如果被调用的WebService方法长时间不返回,客户端将一直被阻塞,直到该方法返回为止。使用同步方法来调用WebService虽然很直观,但当WebService方法由于各种原因需要很长时间才能返回的话,就会使客户端程序一直处于等待状态,这样用户是无法忍受的。

当然,我们很容易就可以想到解决问题的方法,这就是多线程。解决问题的基本方法是将访问WebService的任务交由一个或多个线程来完成,而主线程并不负责访问WebService。这样即使被访问的WebService方法长时间不返回,客户端仍然可以做其他的工作。我们可以管这种通过多线程访问WebService的方式称为异步访问。

虽然直接使用多线程可以很好地解决这个问题,但比较麻烦。幸好Axis2的客户端提供了异步访问WebService的功能。
RPCServiceClient类提供了一个invokeNonBlocking方法可以通过异步的方式来访问WebService。

下面先来建立一个WebService。
MyService是一个WebService类,代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
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类的配置代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
<!--  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客户端代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
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方法被调用。当运行上面的程序后,将输出如下的信息:

1
2
异步调用!
火星

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

1
%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的代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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();
    }
}

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

1
2
异步调用!
火星

在.net中也可以使用异步的方式来调用WebService,如在C#中可使用如下的代码来异步调用getName方法:

1
2
3
4
5
6
7
8
9
10
11
//  回调方法
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方法,否则将抛出异常。如下面的代码会抛出一个异常:

1
2
3
4
5
6
async.myService my = new WSC.async.myService();
my.getNameCompleted += new
    WSC.async.getNameCompletedEventHandler(getNameCompletedEvent);
my.getNameAsync();
//  将抛出异常
my.getNameAsync();

但不同的WebService实例的方法可以在方法未返回时调用,如下面的代码是可以正常工作的:

1
2
3
4
5
6
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();

标签: axis2 webservice
  • 打赏
  • 点赞
  • 收藏
  • 分享
共有 人打赏支持
粉丝 77
博文 271
码字总数 104293
×
吕兵阳
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: