WSDL Tutorials - Herong's Tutorial Examples - v2.22, by Herong Yang
sendReceive() Method - Invoking a Named Operation
This section provides a tutorial example on how to use the sendReceive() method to invoke an operation defined in the service inside the ServiceClient object.
After the ServiceClient object created correctly to represent a service defined in a WSDL document, the next step is to invoke an operation defined in the service.
One way to invoke an operation is to call the sendReceive() method, which invokes a named operation that uses an In-Out MEP (Message Exchange Pattern) using this syntax:
response = client.sendReceive(operationQName, request) // "operationQName" specifies an operation within the service // using a new QName(tns,operationName) // "tns" specifies the target namespace of the Web service // "request" specifies the SOAP Body element in the request message // as an org.apache.axiom.om.OMElement object // "response" receives the SOAP Body element in the response message // as an org.apache.axiom.om.OMElement object
For other RPCServiceClient methods, see Axis documentation.
Here is my first test program for the sendReceive() method, Axis2ServiceClientSendReceive.java:
/* Axis2ServiceClientSendReceive.java * Copyright (c) 2009 HerongYang.com. All Rights Reserved. */ import java.io.PrintStream; import java.net.URL; import javax.xml.namespace.QName; import org.apache.axis2.client.ServiceClient; import org.apache.axiom.om.OMElement; class Axis2ServiceClientSendReceive { public static void main(String[] args) { PrintStream out = System.out; // Setting initial values String server = "https://www.herongyang.com/Service/"; String wsdl = server+"Hello_WSDL_11_SOAP.wsdl"; String tns = "https://www.herongyang.com/Service/"; String serviceName = "helloService"; String portName = "helloPort"; try { ServiceClient client = new ServiceClient(null, new URL(wsdl), new QName(tns, serviceName), portName); OMElement request = null; OMElement response = client.sendReceive( new QName(tns, "Hello"), request); out.println(response); } catch (Exception e) { e.printStackTrace(); } } }
Execution of this program is described below:
herong> java -cp .;\local\axis2\lib\* Axis2ServiceClientSendReceive <hy:HelloResponse xmlns:hy="https://www.herongyang.com/Service/"> Hello from server - herongyang.com. </hy:HelloResponse>
Note that I got the following error when running the same program with Axis2 1.4.1:
herong> java -cp .;\local\axis2\lib\* Axis2ServiceClientSendReceive org.apache.axis2.AxisFault: Transport error: 411 Error: Length Required at org.apache.axis2.transport.http.HTTPSender.handleResponse (HTTPSender.java:296) at org.apache.axis2.transport.http.HTTPSender.sendViaPost(HTTPS... at org.apache.axis2.transport.http.HTTPSender.send(HTTPSender.j... at org.apache.axis2.transport.http.CommonsHTTPTransportSender.w... at org.apache.axis2.transport.http.CommonsHTTPTransportSender.i... at org.apache.axis2.engine.AxisEngine.send(AxisEngine.java:448) at org.apache.axis2.description.OutInAxisOperationClient.send(O... at org.apache.axis2.description.OutInAxisOperationClient.execut... at org.apache.axis2.client.OperationClient.execute(OperationCli... at org.apache.axis2.client.ServiceClient.sendReceive(ServiceCli... at Axis2ServiceClientSendReceive.main(Axis2ServiceClientSendRec...
Looks like this error has been fixed now in Axis2 1.7.8.
Table of Contents
WSDL 2.0 Document Structure and Syntax
WSDL Version 2.0 Part 2: Adjuncts
WSDL 2.0 Document Examples with SOAP Binding
Using WSDL Document in Java Apache Axis2/Java for WSDL
Apache Woden for WSDL Documents in Java
SoapUI - Web Service Testing Tool
WSDL 1.1 Document Structure and Syntax
WSDL 1.1 Binding Extension for SOAP 1.1
SoapUI as WSDL 1.1 Testing Tool
WSDL 1.1 and SOAP 1.1 Examples - Document and RPC Styles
PHP SOAP Extension for WSDL 1.1
►Apache Axis2/Java for WSDL 1.1
Creating Service Client with WSDL 1.1 Document
org.apache.axis2.client.Options - Operation Client Options
►sendReceive() Method - Invoking a Named Operation
Turning Off the Chunked HTTP Flag
Axis2RegistrationClient.java - document/literal Style
org.apache.axis2.rpc.client.RPCServiceClient Class
Axis2GetExchangeRateClient.java - rpc/encoded Style
SocketRequestResponseServer.java - Socket Server Testing Program
Capturing the HTTP Request from an Axis2 Client Program
Using WSDL2Java to Generate Web Service Stub Classes
WSDL 1.1 Binding Extension for SOAP 1.2
WSDL 1.1 and SOAP 1.2 Examples - Document and RPC Styles