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类的配置代码:

<!--   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
    下面是异步调用MyServiceJava客户端代码:

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

    在执行上面的命令后,将生成两个类:MyServiceStubMyServiceCallbackHandler类,其中MyServiceStub类负责同步和异步调用WebServiceMyServiceCallbackHandler类是一个抽象类,也是一个回调类,当使用异步方式调用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();

你可能感兴趣的:(webservice)