Package org.apache.axis2.rpc.client

Class RPCServiceClient

java.lang.Object

org.apache.axis2.client.ServiceClient

org.apache.axis2.rpc.client.RPCServiceClient

public class RPCServiceClient
extends ServiceClient

Field Summary

Fields inherited from class org.apache.axis2.client.ServiceClient

ANON_OUT_IN_OP, ANON_OUT_ONLY_OP, ANON_ROBUST_OUT_ONLY_OP, ANON_SERVICE, AUTO_OPERATION_CLEANUP, log

Constructor Summary

Constructors

Constructor	Description
RPCServiceClient()
RPCServiceClient(ConfigurationContext configContext, URL wsdlURL, QName wsdlServiceName, String portName)
RPCServiceClient(ConfigurationContext configContext, AxisService service)

Method Summary

Modifier and Type	Method	Description
OMElement	invokeBlocking(QName opName, Object[] args)	Return value can be a single a object or an object array (itself an object) , but it is difficulty to figure the return object correctly unless we have TyepMapping in the client side too.
Object[]	invokeBlocking(QName opName, Object[] args, Class[] returnTypes)
void	invokeNonBlocking(QName opName, Object[] args, AxisCallback callback)	Invoke the nonblocking/Asynchronous call
void	invokeRobust(QName opName, Object[] args)

Methods inherited from class org.apache.axis2.client.ServiceClient

addHeader, addHeader, addHeadersToEnvelope, addStringHeader, cleanup, cleanupTransport, createClient, disengageModule, engageModule, equals, finalize, fireAndForget, fireAndForget, getAxisConfiguration, getAxisService, getLastOperationContext, getMyEPR, getOptions, getOverrideOptions, getServiceContext, getTargetEPR, hashCode, removeHeaders, sendReceive, sendReceive, sendReceiveNonBlocking, sendReceiveNonBlocking, sendRobust, sendRobust, setAxisService, setOptions, setOverrideOptions, setTargetEPR

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RPCServiceClient

public RPCServiceClient(ConfigurationContext configContext,
                        AxisService service)
                 throws AxisFault

Throws:

AxisFault

RPCServiceClient

public RPCServiceClient()
                 throws AxisFault

Throws:

AxisFault

RPCServiceClient

public RPCServiceClient(ConfigurationContext configContext,
                        URL wsdlURL,
                        QName wsdlServiceName,
                        String portName)
                 throws AxisFault

Throws:

AxisFault

Method Detail

invokeBlocking

public OMElement invokeBlocking(QName opName,
                                Object[] args)
                         throws AxisFault

Return value can be a single a object or an object array (itself an object) , but it is difficulty to figure the return object correctly unless we have TyepMapping in the client side too. Until it is finalized lets return OMElement as return value. And the retuen value will be the body first element user has to deal with that and create his own object out of that.

Parameters:

opName - Operation QName (to get the body wrapper element)

args - Arraylist of objects

Returns:

Response OMElement

Throws:

AxisFault - in case of a problem - this can either be a processing fault or a received on-the-wire fault.

invokeBlocking

public Object[] invokeBlocking(QName opName,
                               Object[] args,
                               Class[] returnTypes)
                        throws AxisFault

Parameters:

opName - Operation QName (to get the body wrapper element)

args - Arraylist of objects

returnTypes - , this array contains the JavaTypes for the return object , it could be one or more depending on the return type , most of the type array will contain just one element It should be noted that the array should only contains JavaTypes NOT real object , what this methods does is , get the body first element , and if it contains more than one childern take ith element and convert that to ith javatype and fill the return arrya the array will look like as follows [Integer, String, MyBean , etc]

Returns:

Object array , whic will contains real object , but the object can either be simple type object or the JavaBeans, thats what this method can handle right now the return array will contains [10, "Axis2Echo", {"foo","baa","11"}]

Throws:

AxisFault - a problem occurred, either locally or on the other side of the wire

invokeNonBlocking

public void invokeNonBlocking(QName opName,
                              Object[] args,
                              AxisCallback callback)
                       throws AxisFault

Invoke the nonblocking/Asynchronous call

Parameters:

opName - Operation QName (to get the body wrapper element)

args - an array of argument Objects

callback - object implementing AxisCallback which will receive notifications

Throws:

AxisFault - in case of a local processing error

invokeRobust

public void invokeRobust(QName opName,
                         Object[] args)
                  throws AxisFault

Throws:

AxisFault