WSDL Tutorials - Herong's Tutorial Examples - Version 2.03, by Dr. Herong Yang
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 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.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 wsdl = "file:///C:/herong/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", "2008-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="2008-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
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
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
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
►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