Axis2RegistrationClient.java - document/literal Style

This section provides a tutorial example on how to build a SOAP Body message in document/literal style and call the Registration Web service.

With the help of AXIOM classes and methods, I can write my first real Axis2 client program now, Axis2RegistrationClient.java.

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

/* Axis2RegistrationClient.java
 * Copyright (c) 2009-2018 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.axis2.client.Options;
import org.apache.axis2.transport.http.HTTPConstants;
import org.apache.axiom.om.OMAbstractFactory;
import org.apache.axiom.om.OMElement;
import org.apache.axiom.om.OMFactory;
import org.apache.axiom.om.OMNamespace;
class Axis2RegistrationClient {
   public static void main(String[] args) {
      PrintStream out = System.out;

// Setting initial values
      String server = "http://www.herongyang.com/Service/";
      String wsdl = server+"Registration_WSDL_11_SOAP_11_Document.wsdl";
      String tns = "http://www.herongyang.com/Service/";
      String serviceName = "registrationService";
      String portName = "registrationPort";

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

// Building SOAP Body element for the request
         OMFactory factory = OMAbstractFactory.getOMFactory();
         OMNamespace namespace = factory.createOMNamespace(tns, "hy");
         OMElement request = factory.createOMElement(
            "RegistrationRequest", namespace);
         request.addAttribute("event", "OpenGame", namespace);
         request.addAttribute("date", "2018-08-08", namespace);

         OMElement guest1 = factory.createOMElement(
            "Guest", namespace);
         guest1.setText("Herong Yang");
	 request.addChild(guest1);
	 
         OMElement guest2 = factory.createOMElement(
            "Guest", namespace);
         guest2.setText("Joe Smith");
	 request.addChild(guest2);

// Printing the request as an XML string
	 out.println();
	 out.println("Request XML message");
	 out.println(request);
         OMElement response = client.sendReceive(
	    new QName(tns, "Registration"), request);

// Printing the response as an XML string
	 out.println();
	 out.println("Response XML message");
	 out.println(response);
      } catch (Exception e) {
         e.printStackTrace(); 
      }
   }
}

Output of this program is presented below:

Request XML message
<hy:RegistrationRequest
   xmlns:hy="http://www.herongyang.com/Service/"
   hy:event="OpenGame" hy:date="2018-08-08">
   <hy:Guest>Herong Yang</hy:Guest>
   <hy:Guest>Joe Smith</hy:Guest>
</hy:RegistrationRequest>

Response XML message
<hy:RegistrationResponse
   xmlns:hy="http://www.herongyang.com/Service/">
   <hy:Confirmation guest="Herong Yang" event="OpenGame" />
   <hy:Confirmation guest="Joe Smith" event="OpenGame" />
</hy:RegistrationResponse>

This is very cool! My first Axis2 client program worked nicely.

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

 Using WSDL Document in Java Apache Axis2/Java for WSDL

 Apache Woden for WSDL Documents in Java

 SoapUI - Web Service Testing Tool

 PHP SOAP Extension for WSDL

 Perl SOAP::Lite for WSDL

 Introduction to WSDL 1.1

 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

 Perl SOAP::Lite 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

 AXIOM (AXIs Object Model)

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

 SOAP 1.2 Binding - PHP, Java and Perl Clients

 WSDL Related Terminologies

 Outdated Tutorials

 References

 Full Version in PDF/EPUB