Axis2GetExchangeRateClient.java - rpc/encoded Style

This section provides a tutorial example on how to invoke an RPC method based Web service using Axis2 RPCServiceClient class. Input parameters and return values are handled as Java data objects instead of OMElement objects.

To test the org.apache.axis2.rpc.client.RPCServiceClient class, I wrote this client test program, Axis2GetExchangeRateClient.java:

/**
 * Axis2GetExchangeRateClient.java
 * Copyright (c) 2009 by Dr. Herong Yang, herongyang.com
 * All rights reserved
 */
import java.io.PrintStream;
import java.net.URL;
import javax.xml.namespace.QName;
import org.apache.axis2.rpc.client.RPCServiceClient;
import org.apache.axis2.client.Options;
import org.apache.axis2.transport.http.HTTPConstants;
class Axis2GetExchangeRateClient {
   public static void main(String[] args) {
      PrintStream out = System.out;

// Setting initial values
      String wsdl = 
"file:///C:/herong/GetExchangeRate_WSDL_11_SOAP_11_RPC.wsdl";
      String tns = "http://www.herongyang.com/Service/";
      String serviceName = "getExchangeRateService";
      String portName = "getExchangeRatePort";

      try {
         RPCServiceClient client = new RPCServiceClient(null, 
            new URL(wsdl), new QName(tns, serviceName), portName);
         Options option = client.getOptions();
         option.setProperty(HTTPConstants.CHUNKED,false);

// Building the input parameter array
         Object[] inputArgs = new Object[3];
         inputArgs[0] = new String("USD");
         inputArgs[1] = new String("JPY");
         inputArgs[2] = new String("2007-07-07");

// Building the return value type array
         Class[] returnTypes = new Class[1];
         returnTypes[0] = Class.forName("java.lang.String");

// Invoking the Web service
         Object[] returnValues = client.invokeBlocking(
	    new QName(tns, "GetExchangeRate"),
	    inputArgs, returnTypes);

// Printing the return value
         out.println(returnValues[0]);

      } catch (Exception e) {
         e.printStackTrace(); 
      }
   }
}

In this program, I used the WSDL document located at http://www.herongyang.com/Service/ GetExchangeRate_WSDL_11_SOAP_11_RPC.wsdl. This Web services uses the rpc/encoded message style.

Output of this program is presented below:

C:\herong>\local\jdk\bin\java -Djava.ext.dirs=\local\axis2\lib\
   Axis2GetExchangeRateClient

123.14

Cool. My test program worked nicely. But:

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)

 Axis2RegistrationClient.java - document/literal Style

 Axis2GetSpeechClient.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

 SOAP 1.2 Binding - PHP, Java and Perl Clients

 WSDL Related Terminologies

 References

 PDF Printing Version