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 object
// "response" receives the SOAP Body element in the response message
//    as an object

For other RPCServiceClient methods, see Axis documentation.

Here is my first test program for the sendReceive() method,

 * Copyright (c) 2009 by Dr. Herong Yang,
 * All rights reserved
import javax.xml.namespace.QName;
import org.apache.axis2.client.ServiceClient;
class Axis2ServiceClientSendReceive {
   public static void main(String[] args) {
      PrintStream out = System.out;

// Setting initial values
      String wsdl = "file:///C:/herong/Hello_WSDL_11_SOAP.wsdl";
      String tns = "";
      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);
      } catch (Exception e) {

Execution of this program is described below:

C:\herong>\local\jdk\bin\java -Djava.ext.dirs=\local\axis2\lib\
org.apache.axis2.AxisFault: Transport error:
   411 Error: Length Required
   at org.apache.axis2.transport.http.HTTPSender.handleResponse
   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(
   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...

What's wrong with my program? Why I am getting the "org.apache.axis2.AxisFault: Transport error: 411 Error: Length Required" error? See the next section on how to fix this problem.

Last update: 2009.

Table of Contents

 About This Book

 Introduction to WSDL 2.0

 WSDL 2.0 Document Structure and Syntax

 WSDL Version 2.0 Part 2: Adjuncts

 WSDL 2.0 Document Examples with SOAP Binding

 WSDL 20 Programming APIs and Testing Tools

 Introduction to WSDL 1.1

 WSDL 1.1 Document Structure and Syntax

 WSDL 1.1 Binding Extension for SOAP 1.1

 soapUI 3.0.1 - Web Service Testing Tool

 WSDL 1.1 and SOAP 1.1 Examples - Document and RPC Styles

 PHP SOAP Extension in PHP 5.3.1

 Using WSDL in Perl with SOAP::Lite 0.710

Using WSDL Document in Java with Axis2 1.4.1

 What Is Axis2?

 Downloading and Installing Axis2/Java 1.4.1

 org.apache.axis2.client.ServiceClient Class

 Creating Service Client with WSDL Document

 org.apache.axis2.client.Options - Operation Client Options

sendReceive() Method - Invoking a Named Operation

 Turning Off the Chunked HTTP Flag

 AXIOM (AXIs Object Model) - document/literal Style - document/literal Style

 org.apache.axis2.rpc.client.RPCServiceClient Class - rpc/encoded Style - 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

 SOAP 1.2 Binding - PHP, Java and Perl Clients

 WSDL Related Terminologies


 PDF Printing Version