You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by de...@apache.org on 2007/08/13 12:13:23 UTC
svn commit: r565295 [13/14] - in /webservices/axis2/site/1_3: ./ adb/ jibx/
src/
Added: webservices/axis2/site/1_3/userguide-creatingclients.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/userguide-creatingclients.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/userguide-creatingclients.html (added)
+++ webservices/axis2/site/1_3/userguide-creatingclients.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,505 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache Axis2 - </title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../" id="bannerLeft">
+
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+
+ </a>
+ <span id="bannerRight">
+
+ <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 08/13/2007
+ </div>
+ <div class="xright"> <a href="../index.html">Axis2/Java</a>
+ |
+ <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+ |
+ <a href="../../../">Apache WS</a>
+ |
+ <a href="http://www.apache.org">Apache</a>
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Axis2/Java</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Home</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../download.cgi">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="../modules/index.html">Modules</a>
+ </li>
+
+ <li class="none">
+ <a href="../tools/index.html">Tools</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../1_3/contents.html">Version 1.3</a>
+ <ul>
+
+ <li class="none">
+ <a href="../1_3/toc.html">Table of Contents</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/installationguide.html">Installation Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/userguide.html">User Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/pojoguide.html">POJO Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/spring.html">Spring Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+ </li>
+ </ul>
+ </li>
+
+ <li class="none">
+ <a href="../1_2/contents.html">Version 1.2</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1_1/contents.html">Version 1.1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1/contents.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_0/index.html">Version 1.0</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_95/index.html">Version 0.95</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_94/index.html">Version 0.94</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_93/index.html">Version 0.93</a>
+ </li>
+ </ul>
+ <h5>Resources</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../articles.html">Articles</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="../refLib.html">Reference Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+ </li>
+ </ul>
+ <h5>Get Involved</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../overview.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Checkout the Source</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../release-process.html">Release Process</a>
+ </li>
+
+ <li class="none">
+ <a href="../guidelines.html">Developer Guidelines</a>
+ </li>
+
+ <li class="none">
+ <a href="../siteHowTo.html">Build the Site</a>
+ </li>
+ </ul>
+ <h5>Project Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+ </li>
+
+ <li class="none">
+ <a href="../thanks.html">Acknowledgements</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+Apache Axis2 User's Guide- Creating Clients
+<link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<a name="createclients"></a>
+<h1>Apache Axis2 User's Guide - Creating Clients</h1>
+<p>When it comes to creating a Web service client, you can do it
+manually (see <a href="userguide-buildingservices.html">Building
+Services</a>), but in most cases you have a Web Service Description
+Language (WSDL) definition that describes the messages clients
+should send and expect to receive. Axis2 provides several ways to
+use this definition to automatically generate a client.</p>
+<h2>Content</h2>
+<ul>
+<li><a href="userguide.html#intro">Introducing Axis2</a><br></br>
+<ul>
+<li><a href="userguide.html#whatis">What is Axis2?</a></li>
+<li><a href="userguide.html#underhood">What's Under the
+hood?</a></li>
+<li><a href="userguide.html#handlessoap">How Axis2 Handles SOAP
+Messages</a></li>
+<li><a href="userguide.html#distributions">Axis2
+Distributions</a></li>
+<li><a href="userguide.html#sbd">The Axis2 Standard Binary
+Distribution</a></li>
+<li><a href="userguide.html#hierarchy">Axis2.war Directory
+hierarchy</a></li>
+<li><a href="userguide.html#docs">Axis2 Documents
+Distribution</a></li>
+<li><a href="userguide.html#clients">Axis2 and Clients</a></li>
+</ul>
+</li>
+<li><a href="userguide-installingtesting.html#installingtesting">Installing and
+Testing Client Code</a></li>
+<li><a href="userguide-introtoservices.html#introservices">Introduction to
+Services</a><br></br>
+<ul>
+<li><a href="userguide-introtoservices.html#messageexchange">Message Exchange
+Patterns</a></li>
+</ul>
+</li>
+<li><a href="userguide-creatingclients.html#createclients"><strong>Creating
+Clients</strong></a><br></br>
+<ul>
+<li><a href="userguide-creatingclients.html#choosingclient"><strong>Choosing a
+Client Generation Method</strong></a></li>
+<li><a href="userguide-creatingclients.html#generating"><strong>Generating
+Clients</strong></a></li>
+<li><a href="userguide-creatingclients.html#adb"><strong>Axis Data
+Binding (ADB)</strong></a></li>
+</ul>
+</li>
+<li><a href="userguide-buildingservices.html#buildservices">Building
+Services</a><br></br>
+<ul>
+<li><a href="userguide-buildingservices.html#getcomfortable">Getting
+Comfortable with Available Options</a></li>
+<li><a href="userguide-buildingservices.html#createscratch">Creating a service
+from Scratch</a></li>
+<li><a href="userguide-buildingservices.html#deploypojo">Deploying
+Plain Old Java Objects</a></li>
+<li><a href="userguide-buildingservices.html#deployrun">Deploying
+and Running an Axis2 Service Created from WSDL</a></li>
+</ul>
+</li>
+<li><a href="userguide-samples.html">Samples</a></li>
+<li><a href="userguide-forfurtherstudy.html">For Further
+Study</a></li>
+</ul>
+<a name="choosingclient"></a>
+<h2>Choosing a Client Generation Method</h2>
+Axis2 gives you several options when it comes to mapping WSDL to
+objects when generating clients. Three of these options are Axis2
+DataBinding Framework, XMLBeans, and JiBX databinding. All of these
+methods involve using databinding to create Java objects out of the
+XML structures used by the service, and each has its pros and cons.
+You can also generate XML in-out stubs that are not based on
+databinding.
+Axis2 Databinding Framework (ADB): ADB is probably the simplest
+method of generating an Axis2 client. In most cases, all of the
+pertinent classes are created as inner classes of a main stub
+class. ADB is very easy to use, but it does have limitations. It is
+not meant to be a full schema binding application, and has
+difficulty with structures such as XML Schema element extensions
+and restrictions.
+XMLBeans: Unlike ADB, XMLBeans is a fully functional schema
+compiler, so it doesn't carry the same limitations as ADB. It is,
+however, a bit more complicated to use than ADB. It generates a
+huge number of files, and the programming model, while being
+certainly usable, is not as straightforward as ADB.
+JiBX: JiBX is a complete databinding framework that actually
+provides not only WSDL-to-Java conversion, as covered in this
+document, but also Java-to-XML conversion. In some ways, JiBX
+provides the best of both worlds. JiBX is extremely flexible,
+enabling you to choose the classes that represent your entities,
+but it can be complicated to set up. On the other hand, once it is
+set up, actually using the generated code is as easy as using
+ADB.
+In the end, for simple structures, ADB will likely be enough for
+you. If, on the other hand you need more power or flexibility,
+whether you choose XMLBeans or JiBX depends on how much power or
+flexibility you need and your tolerance for complexity.
+<a name="generating"></a>
+<h2>Generating Clients</h2>
+The process for generating and using a client varies slightly
+depending on the method of generation you choose. In all three
+cases in this document, clients are generated from the same WSDL
+file (see <a href="userguide-codelisting5.html">Code Listing
+5</a>).
+Note that the document defines four operations, DoInOnly,
+NoParameters, TwoWayOneParameterEcho, and
+MultipleParametersAddItem. Each of the clients will include methods
+for calling each of these operations.
+(You can get more information on WSDL at <a href="http://www.w3.org/2002/ws/desc/">http://www.w3.org/2002/ws/desc/</a>
+.)
+<a name="adb"></a>
+<h2>Axis Data Binding (ADB)</h2>
+To create a client using ADB, execute the following steps:
+<b>The short story:</b>
+<ol type="1">
+<li>
+href="http://ws.apache.org/axis2/download/1_3/download.cgi#std-bin"
+<a href="">Download</a> and unpack the Apache Axis2 Standard
+Distribution, if you have not done it already.</li>
+<li>Create the client stub with the following command:
+<pre>
+%AXIS2_HOME%\bin\WSDL2Java -uri Axis2UserGuide.wsdl -p org.apache.axis2.axis2userguide -d adb -s
+</pre></li>
+<li>Create the client (for example, Client.java), a Java
+application that uses the generated stub, and save it in the
+org/apache/axis2/axis2userguide directory.</li>
+<li>Build the client by typing: ant jar.client.</li>
+<li>Assuming you have a corresponding service, run the client by
+adding the generated Axis2UserGuideService-test-client.jar file
+located in build/lib to the classpath and type: java
+org.apache.axis2.axis2userguide.Client</li>
+</ol>
+<b>The long story:</b>
+If you have not done it already, <a href="http://ws.apache.org/axis2/download/1_3/download.cgi#std-bin">
+download</a> and unpack the Apache Axis2 Standard Distribution. The
+Axis2 WAR Distribution does not include the necessary utilities for
+generating code, such as WSDL2Java.
+In the ADB method of generating clients, all the functionalities
+of the services are contained in a single class called a stub. The
+stub contains inner classes corresponding to all the necessary
+objects defined in the WSDL file, such as, in the case of this
+WSDL, DoInOnlyRequestMessage. Once you have the stub, you will be
+able to create a client by simply referring to these classes and
+their methods. To generate the client, issue the following command
+in Code Listing 6.
+<h3><b>Code Listing 6 - Generating the Client</b></h3>
+<pre>
+%AXIS2_HOME%\bin\WSDL2Java -uri Axis2UserGuide.wsdl -p org.apache.axis2.axis2userguide -d adb -s
+</pre>
+This command analyzes the WSDL file and creates the stub in the
+package org.apache.axis2.axis2userguide. The options specify that
+you want the ADB data binding method (-d), and synchronous or
+blocking, methods (-s). In other words, when the client makes an
+In-Out call to the service, it will wait for a response before
+continuing.
+Once you run this command, you will see two new items in the
+directory. The first is the build.xml file, which contains the
+instructions for <a href="http://ant.apache.org/">Ant</a> to
+compile the generated classes. The second is the src directory,
+which contains the actual Axis2UserGuideServiceStub.java file. If
+you open this file, you will see a collection of inner classes for
+each of the items in the WSDL file. You'll also see a number of
+calls to the Axis2 client API, including those that use AXIOM to
+build and analyze the incoming and outgoing messages.
+Now you need a client to make use of this code. To create a
+client, create a new class and save it as Client.java in the
+org/apache/axis2/axis2userguide directory. It should contain the
+following code in <a href="userguide-codelisting7.html">Code
+Listing 7</a>.
+Note that using the service is simply a matter of creating and
+populating the appropriate type of request using the names defined
+in the WSDL file, and then using the stub to actually send the
+request to the appropriate method. For example, to call the
+DoInOnly operation, you create a DoInOnlyRequest, use its
+setMessageString() method to set the contents of its messageString
+element, and pass it as an argument to stub.DoInOnly().
+To build the client, type: ant jar.client
+This action creates two new directories, build and test. The
+test directory will be empty, but the build directory contains two
+versions of the client. The first version, in the lib directory, is
+a .jar file that contains the client class and the stub. The
+second, in the classes directory, is just raw classes.
+Make sure all the jar files in the Axis2 lib directory are in
+the classpath.
+If you have a service corresponding to this client you can run
+the client by adding the jar file to your classpath and typing:
+java org.apache.axis2.axis2userguide.Client
+(If you don't have such a service,, refer to the <a href="userguide-buildingservices.html">Building services</a>
+document.)
+You should see the response in the console window of your
+servlet container. It should look something like this:
+<img alt="Response in a console window of your servlet container" src="images/fig03.jpg"></img><br clear="all"></br>
+ADB is not your only option for generating Web service clients.
+Other options include <a href="userguide-creatingclients-xmlbeans.html">XmlBeans</a>, <a href="userguide-creatingclients-jibx.html">JiBX</a>, JAXME and
+JAXBRI.
+<strong>See the Next Section</strong> -<a href="userguide-buildingservices.html#buildservices">Building
+Services</a>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/1_3/userguide-forfurtherstudy.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/userguide-forfurtherstudy.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/userguide-forfurtherstudy.html (added)
+++ webservices/axis2/site/1_3/userguide-forfurtherstudy.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,321 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache Axis2 - </title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../" id="bannerLeft">
+
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+
+ </a>
+ <span id="bannerRight">
+
+ <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 08/13/2007
+ </div>
+ <div class="xright"> <a href="../index.html">Axis2/Java</a>
+ |
+ <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+ |
+ <a href="../../../">Apache WS</a>
+ |
+ <a href="http://www.apache.org">Apache</a>
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Axis2/Java</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Home</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../download.cgi">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="../modules/index.html">Modules</a>
+ </li>
+
+ <li class="none">
+ <a href="../tools/index.html">Tools</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../1_3/contents.html">Version 1.3</a>
+ <ul>
+
+ <li class="none">
+ <a href="../1_3/toc.html">Table of Contents</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/installationguide.html">Installation Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/userguide.html">User Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/pojoguide.html">POJO Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/spring.html">Spring Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+ </li>
+ </ul>
+ </li>
+
+ <li class="none">
+ <a href="../1_2/contents.html">Version 1.2</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1_1/contents.html">Version 1.1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1/contents.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_0/index.html">Version 1.0</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_95/index.html">Version 0.95</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_94/index.html">Version 0.94</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_93/index.html">Version 0.93</a>
+ </li>
+ </ul>
+ <h5>Resources</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../articles.html">Articles</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="../refLib.html">Reference Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+ </li>
+ </ul>
+ <h5>Get Involved</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../overview.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Checkout the Source</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../release-process.html">Release Process</a>
+ </li>
+
+ <li class="none">
+ <a href="../guidelines.html">Developer Guidelines</a>
+ </li>
+
+ <li class="none">
+ <a href="../siteHowTo.html">Build the Site</a>
+ </li>
+ </ul>
+ <h5>Project Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+ </li>
+
+ <li class="none">
+ <a href="../thanks.html">Acknowledgements</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+Apache Axis2 User's Guide-For Further Study
+<link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<a name="#forfurtherstudy"></a>
+<h1>Apache Axis2 User's Guide - For Further Study</h1>
+
+<h2>Resources</h2>
+<p>Axis2 Architecture-<a href="http://ws.apache.org/axis2/1_3/Axis2ArchitectureGuide.html">http://ws.apache.org/axis2/1_3/Axis2ArchitectureGuide.html</a></p>
+<p>XML processing with AXIOM-<a href="http://ws.apache.org/commons/axiom/OMTutorial.html">http://ws.apache.org/commons/axiom/OMTutorial.html</a></p>
+<p>RESTful Web Services-<a href="http://ws.apache.org/axis2/1_3/rest-ws.html">http://ws.apache.org/axis2/1_3/rest-ws.html</a></p>
+<p>TCP Transport-<a href="http://ws.apache.org/axis2/1_3/tcp-transport.html">http://ws.apache.org/axis2/1_3/tcp-transport.html</a></p>
+<p>Mail Transport-<a href="http://ws.apache.org/axis2/1_3/mail-transport.html">http://ws.apache.org/axis2/1_3/mail-transport.html</a></p>
+<p>HTTP Transports-<a href="http://ws.apache.org/axis2/1_3/http-transport.html">http://ws.apache.org/axis2/1_3/http-transport.html</a></p>
+<p>MTOM with Axis2-<a href="http://ws.apache.org/axis2/1_3/mtom-guide.html">http://ws.apache.org/axis2/1_3/mtom-guide.html</a></p>
+<p>Securing SOAP Messages with Apache Rampart- <a href="../modules/rampart/1_3/security-module.html">http://ws.apache.org/axis2/modules/rampart/1_3/security-module.html</a></p>
+<p>SOAPMonitor-<a href="http://ws.apache.org/axis2/1_3/soapmonitor-module.html">http://ws.apache.org/axis2/1_3/soapmonitor-module.html</a></p>
+<p>Apache Axis2 Advance User's Guide- <a href="adv-userguide.html">http://ws.apache.org/axis2/1_3/adv-userguide.html</a></p>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/1_3/userguide-installingtesting.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/userguide-installingtesting.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/userguide-installingtesting.html (added)
+++ webservices/axis2/site/1_3/userguide-installingtesting.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,417 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache Axis2 - </title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../" id="bannerLeft">
+
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+
+ </a>
+ <span id="bannerRight">
+
+ <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 08/13/2007
+ </div>
+ <div class="xright"> <a href="../index.html">Axis2/Java</a>
+ |
+ <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+ |
+ <a href="../../../">Apache WS</a>
+ |
+ <a href="http://www.apache.org">Apache</a>
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Axis2/Java</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Home</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../download.cgi">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="../modules/index.html">Modules</a>
+ </li>
+
+ <li class="none">
+ <a href="../tools/index.html">Tools</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../1_3/contents.html">Version 1.3</a>
+ <ul>
+
+ <li class="none">
+ <a href="../1_3/toc.html">Table of Contents</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/installationguide.html">Installation Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/userguide.html">User Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/pojoguide.html">POJO Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/spring.html">Spring Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+ </li>
+ </ul>
+ </li>
+
+ <li class="none">
+ <a href="../1_2/contents.html">Version 1.2</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1_1/contents.html">Version 1.1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1/contents.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_0/index.html">Version 1.0</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_95/index.html">Version 0.95</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_94/index.html">Version 0.94</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_93/index.html">Version 0.93</a>
+ </li>
+ </ul>
+ <h5>Resources</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../articles.html">Articles</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="../refLib.html">Reference Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+ </li>
+ </ul>
+ <h5>Get Involved</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../overview.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Checkout the Source</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../release-process.html">Release Process</a>
+ </li>
+
+ <li class="none">
+ <a href="../guidelines.html">Developer Guidelines</a>
+ </li>
+
+ <li class="none">
+ <a href="../siteHowTo.html">Build the Site</a>
+ </li>
+ </ul>
+ <h5>Project Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+ </li>
+
+ <li class="none">
+ <a href="../thanks.html">Acknowledgements</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+Apache Axis2 User's Guide-Installing and Testing Client
+Code
+<link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<a name="installingtesting"></a>
+<h1>Apache Axis2 User's Guide - Installing and Testing Client
+Code</h1>
+<p>The best way to make sure that your system is running Apache
+Axis2 is to install and test both a service and a client. The
+process involves the following steps:</p>
+<h2>Content</h2>
+<ul>
+<li><a href="userguide.html#intro">Introducing Axis2</a><br></br>
+<ul>
+<li><a href="userguide.html#whatis">What is Axis2?</a></li>
+<li><a href="userguide.html#underhood">What's under the
+hood?</a></li>
+<li><a href="userguide.html#handlessoap">How Axis2 handles SOAP
+messages</a></li>
+<li><a href="userguide.html#distributions">Axis2
+distributions</a></li>
+<li><a href="userguide.html#sbd">The Axis2 Standard Binary
+Distribution</a></li>
+<li><a href="userguide.html#hierarchy">Axis2.war Directory
+Hierarchy</a></li>
+<li><a href="userguide.html#docs">Axis2 Documents
+Distribution</a></li>
+<li><a href="userguide.html#clients">Axis2 and clients</a></li>
+</ul>
+</li>
+<li><a href="userguide-installingtesting.html#installingtesting"><strong>Installing
+and testing client code</strong></a></li>
+<li><a href="userguide-introtoservices.html#introservices">Introduction to
+Services</a><br></br>
+<ul>
+<li><a href="userguide-introtoservices.html#messageexchange">Message Exchange
+Patterns</a></li>
+</ul>
+</li>
+<li><a href="userguide-creatingclients.html#createclients">Creating
+Clients</a><br></br>
+<ul>
+<li><a href="userguide-creatingclients.html#choosingclient">Choosing a Client
+Generation Method</a></li>
+<li><a href="userguide-creatingclients.html#generating">Generating
+Clients</a></li>
+<li><a href="userguide-creatingclients.html#adb">Axis Data Binding
+(ADB)</a></li>
+</ul>
+</li>
+<li><a href="userguide-buildingservices.html#buildservices">Building
+Services</a><br></br>
+<ul>
+<li><a href="userguide-buildingservices.html#getcomfortable">Getting
+Comfortable with the Available Options</a></li>
+<li><a href="userguide-buildingservices.html#createscratch">Creating a service
+from scratch</a></li>
+<li><a href="userguide-buildingservices.html#deploypojo">Deploying
+Plain Old Java Objects</a></li>
+<li><a href="userguide-buildingservices.html#deployrun">Deploying
+and running an Axis2 service created from WSDL</a></li>
+</ul>
+</li>
+<li><a href="userguide-samples.html">Samples</a></li>
+<li><a href="userguide-forfurtherstudy.html">For Further
+Study</a></li>
+</ul>
+<b>The Short Story:</b>
+<ol type="1">
+<li>Install Apache Axis2 in a suitable container, such as Apache
+Tomcat, by copying the axis2.war file to the webapps
+directory.</li>
+<li>Install the service into the Axis2 application by copying the
+*.aar file into the Axis2 services directory.</li>
+<li>Install the client on the system on which you want to run it,
+and make sure all the Axis2 libraries are on the CLASSPATH.</li>
+<li>Run the client.</li>
+</ol>
+
+<b>The Long Story:</b>
+Start by installing a suitable container, such as <a href="http://tomcat.apache.org/">Apache Tomcat</a>. Any J2EE server will
+do. To install Apache Axis2 on the server, download the Axis2 WAR
+distribution from <a href="http://ws.apache.org/axis2/download.cgi">http://ws.apache.org/axis2/download.cgi</a>
+and place the axis2.war file in the server's webapps directory. The
+server will then expand the distribution into its proper structure,
+as seen in the <a href="userguide-intro.html#hierarchy">earlier
+section</a>.
+Apache Axis2 services come bundled as *.aar files, which contain
+all the pieces necessary to define the service, such as the
+necessary classes and libraries and the services.xml file that
+defines the service's behavior. You can install the service using
+the <a href="webadminguide.html">Web administration
+application</a>, but to make things simple for now, copy the *.aar
+file into the Axis2 services directory. For example, to install the
+MyService service distributed as one of the Axis2 samples, copy the
+file <AXIS2_HOME>/samples/userguide/build/MyService.aar file,
+which is built using the <code>ant</code> command, from
+<AXIS2_HOME>/samples/userguide, to the directory
+<J2EE_HOME>/webapps/axis2/WEB-INF/services.
+Your client can come in any number of forms, from a collection
+of files to a single *.jar file. The important thing is to ensure
+that all the appropriate classes are on the classpath. In addition
+to the classes that pertain to the actual client, you must also add
+the Axis2 .jar files into the CLASSPATH. Normally you will do this
+by downloading and unpacking the <a href="http://ws.apache.org/axis2/download/1_3/download.cgi#std-bin">
+Axis2 Standard Distribution</a> and adding the *.jar files in the
+lib directory to your CLASSPATH, or you also have the option of
+running your client using the axis2.bat (or axis2.sh) script, which
+takes care of it for you. For example, you can run a client with
+the command:
+axis2 org.apache.axis2.axis2userguide.Client.
+<strong>See Next Section</strong>- <a href="userguide-introtoservices.html#introservices">Introduction to
+Services</a>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/1_3/userguide-introtoservices.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/userguide-introtoservices.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/userguide-introtoservices.html (added)
+++ webservices/axis2/site/1_3/userguide-introtoservices.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,456 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache Axis2 - </title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../" id="bannerLeft">
+
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+
+ </a>
+ <span id="bannerRight">
+
+ <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 08/13/2007
+ </div>
+ <div class="xright"> <a href="../index.html">Axis2/Java</a>
+ |
+ <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+ |
+ <a href="../../../">Apache WS</a>
+ |
+ <a href="http://www.apache.org">Apache</a>
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Axis2/Java</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Home</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../download.cgi">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="../modules/index.html">Modules</a>
+ </li>
+
+ <li class="none">
+ <a href="../tools/index.html">Tools</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../1_3/contents.html">Version 1.3</a>
+ <ul>
+
+ <li class="none">
+ <a href="../1_3/toc.html">Table of Contents</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/installationguide.html">Installation Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/userguide.html">User Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/pojoguide.html">POJO Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/spring.html">Spring Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+ </li>
+ </ul>
+ </li>
+
+ <li class="none">
+ <a href="../1_2/contents.html">Version 1.2</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1_1/contents.html">Version 1.1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1/contents.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_0/index.html">Version 1.0</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_95/index.html">Version 0.95</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_94/index.html">Version 0.94</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_93/index.html">Version 0.93</a>
+ </li>
+ </ul>
+ <h5>Resources</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../articles.html">Articles</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="../refLib.html">Reference Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+ </li>
+ </ul>
+ <h5>Get Involved</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../overview.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Checkout the Source</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../release-process.html">Release Process</a>
+ </li>
+
+ <li class="none">
+ <a href="../guidelines.html">Developer Guidelines</a>
+ </li>
+
+ <li class="none">
+ <a href="../siteHowTo.html">Build the Site</a>
+ </li>
+ </ul>
+ <h5>Project Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+ </li>
+
+ <li class="none">
+ <a href="../thanks.html">Acknowledgements</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+Apache Axis2 User's Guide- Introduction to Services
+<link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<a name="introservices"></a>
+<h1>Apache Axis2 User's Guide - Introduction to Services</h1>
+<p>The term "Web services" can apply to a number of different ways
+of sending information back and forth. However, this guide focuses
+on the sending and receiving of SOAP messages. SOAP messages are
+XML documents that consist of an "envelope" containing a "payload"
+(see Code Listing 4).</p>
+<h2>Content</h2>
+<ul>
+<li><a href="userguide.html#intro">Introducing Axis2</a><br></br>
+<ul>
+<li><a href="userguide.html#whatis">What is Axis2?</a></li>
+<li><a href="userguide.html#underhood">What's under the
+hood?</a></li>
+<li><a href="userguide.html#handlessoap">How Axis2 handles SOAP
+messages</a></li>
+<li><a href="userguide.html#distributions">Axis2
+distributions</a></li>
+<li><a href="userguide.html#sbd">The Axis2 Standard Binary
+Distribution</a></li>
+<li><a href="userguide.html#hierarchy">Axis2.war Directory
+Hierarchy</a></li>
+<li><a href="userguide.html#docs">Axis2 Documents
+Distribution</a></li>
+<li><a href="userguide.html#clients">Axis2 and clients</a></li>
+</ul>
+</li>
+<li><a href="userguide-installingtesting.html#installingtesting">Installing and
+testing client code</a></li>
+<li><a href="userguide-introtoservices.html#introservices"><strong>Introduction
+to Services</strong></a><br></br>
+<ul>
+<li><a href="userguide-introtoservices.html#messageexchange"><strong>Message
+Exchange Patterns</strong></a></li>
+</ul>
+</li>
+<li><a href="userguide-creatingclients.html#createclients">Creating
+Clients</a><br></br>
+<ul>
+<li><a href="userguide-creatingclients.html#choosingclient">Choosing a Client
+Generation Method</a></li>
+<li><a href="userguide-creatingclients.html#generating">Generating
+Clients</a></li>
+<li><a href="userguide-creatingclients.html#adb">Axis Data Binding
+(ADB)</a></li>
+</ul>
+</li>
+<li><a href="userguide-buildingservices.html#buildservices">Building
+Services</a><br></br>
+<ul>
+<li><a href="userguide-buildingservices.html#getcomfortable">Getting
+Comfortable with the Available Options</a></li>
+<li><a href="userguide-buildingservices.html#createscratch">Creating a service
+from scratch</a></li>
+<li><a href="userguide-buildingservices.html#deploypojo">Deploying
+Plain Old Java Objects</a></li>
+<li><a href="userguide-buildingservices.html#deployrun">Deploying
+and running an Axis2 service created from WSDL</a></li>
+</ul>
+</li>
+<li><a href="userguide-samples.html">Samples</a></li>
+<li><a href="userguide-forfurtherstudy.html">For Further
+Study</a></li>
+</ul>
+<h3>Code Listing 4: Example SOAP Message</h3>
+<pre>
+<?xml version='1.0' ?>
+<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
+xmlns:wsa="http://www.w3.org/2005/03/addressing">
+ <env:Header>
+
+ <wsa:MessageID>
+ http://ws.apache.org/9C21DE32-DB42-1228-C42E-66CB101421AD
+ </wsa:MessageID>
+ <wsa:ReplyTo>
+ <wsa:Address>http://example.com/projects/clientApp</wsa:Address>
+ </wsa:ReplyTo>
+
+<wsa:To>http://example.com/axis2/publishingService</wsa:To>
+
+<wsa:Action>http://example.com/axis2/addDocument</wsa:Action>
+
+</env:Header>
+ <env:Body>
+
+ <addDocument>
+ <docTitle>What I Did On My Summer Vacation</doctitle>
+ <docSubtitle>Children's Essays from Accross the World</docSubtitle>
+ <docLocation>contentRepos/summerVac.doc</docLocation>
+ </addDocument>
+
+ </env:Body>
+</env:Envelope>
+</pre>
+This XML document consists of the outer element or the SOAP
+Envelope, and its contents. The SOAP Envelope is in the SOAP
+namespace, http://www.w3.org/2003/05/soap-envelope, prefixed as
+env: and contains up to two children. This envelope is a standard
+format that pertains to every single SOAP message sent and received
+by any SOAP Web service.
+The contents of the Envelope consists of two parts; the first
+being the SOAP headers-the contents of the env:Header element.
+These headers, such as the WS-Addressing elements shown here,
+provide additional information about the message and how it should
+be handled. A SOAP message may carry headers relating to several
+aspects of the message, or it may carry no headers at all. These
+headers are typically processed by the message handlers.
+The second and arguably the most important part of the message
+is the payload, which consists of the contents of the env:Body
+element. This is the actual message intended for the receiver, and
+it is the information that the main application will ultimately
+process.
+<a name="messageexchange"></a>
+<h2>Message Exchange Patterns</h2>
+Although all SOAP messages carry the same structure, the ways in
+which they are used can be combined into a number of different
+"message exchange patterns", or MEPs. The two major message
+exchange patterns are:
+<ul>
+<li>In-Out: in this MEP, the client sends a SOAP message to the
+server, which processes the message and sends a response back. This
+is probably the most commonly used MEP, and is useful for tasks
+such as searching for information or submitting information in
+situations in where acknowledgment is important.</li>
+<li>In-Only: In this MEP, the client sends a message to the server
+without expecting a response. You may use this MEP for activities
+such as pinging a server to wake it up, reporting logging
+information for which you do not need an acknowledgment and so
+on.</li>
+</ul>
+Within these two MEPs, you also have several variables to
+consider:
+<ul>
+<li>Blocking versus non-blocking: When the client sends a message,
+the application may wait to receive a response before moving on, or
+it may simply send a message and move on by specifying a callback
+action to be completed when the response is received.</li>
+<li>Number of parameters: Ultimately, a message sent from a client
+to server is intended to execute a particular action. That action
+may not require any parameters, or it may require one or more
+parameters. These parameters must be encoded as part of the payload
+of the message.</li>
+</ul>
+Taking all these options into consideration, you can create
+virtually any MEP. For example, you can create an Out-Only system
+by reversing roles for the In-Only MEP. Apache Axis2 also includes
+support for less prominent MEPs, such as Robust-In-Only.
+<strong>See Next Section</strong> - <a href="userguide-creatingclients.html#createclients">Creating
+Clients</a>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/1_3/userguide-samples.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/userguide-samples.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/userguide-samples.html (added)
+++ webservices/axis2/site/1_3/userguide-samples.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,464 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache Axis2 - </title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../" id="bannerLeft">
+
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+
+ </a>
+ <span id="bannerRight">
+
+ <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 08/13/2007
+ </div>
+ <div class="xright"> <a href="../index.html">Axis2/Java</a>
+ |
+ <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+ |
+ <a href="../../../">Apache WS</a>
+ |
+ <a href="http://www.apache.org">Apache</a>
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Axis2/Java</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Home</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../download.cgi">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="../modules/index.html">Modules</a>
+ </li>
+
+ <li class="none">
+ <a href="../tools/index.html">Tools</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../1_3/contents.html">Version 1.3</a>
+ <ul>
+
+ <li class="none">
+ <a href="../1_3/toc.html">Table of Contents</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/installationguide.html">Installation Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/userguide.html">User Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/pojoguide.html">POJO Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/spring.html">Spring Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+ </li>
+ </ul>
+ </li>
+
+ <li class="none">
+ <a href="../1_2/contents.html">Version 1.2</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1_1/contents.html">Version 1.1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_1/contents.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="../1_0/index.html">Version 1.0</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_95/index.html">Version 0.95</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_94/index.html">Version 0.94</a>
+ </li>
+
+ <li class="none">
+ <a href="../0_93/index.html">Version 0.93</a>
+ </li>
+ </ul>
+ <h5>Resources</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../articles.html">Articles</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="../refLib.html">Reference Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+ </li>
+ </ul>
+ <h5>Get Involved</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../overview.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Checkout the Source</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../release-process.html">Release Process</a>
+ </li>
+
+ <li class="none">
+ <a href="../guidelines.html">Developer Guidelines</a>
+ </li>
+
+ <li class="none">
+ <a href="../siteHowTo.html">Build the Site</a>
+ </li>
+ </ul>
+ <h5>Project Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+ </li>
+
+ <li class="none">
+ <a href="../thanks.html">Acknowledgements</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+Apache Axis2 User's Guide- The Samples
+<link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<a name="samples"></a>
+<h1>Apache Axis2 User's Guide - The Samples</h1>
+<p>The Apache Axis2 Standard Distribution provides a number of
+samples you can use as a guide for implementing specific features
+and capabilities. These services are listed in this section.</p>
+<h2>Content</h2>
+<ul>
+<li><a href="userguide.html#intro">Introducing Axis2</a><br></br>
+<ul>
+<li><a href="userguide.html#whatis">What is Axis2?</a></li>
+<li><a href="userguide.html#underhood">What's under the
+hood?</a></li>
+<li><a href="userguide.html#handlessoap">How Axis2 handles SOAP
+messages</a></li>
+<li><a href="userguide.html#distributions">Axis2
+distributions</a></li>
+<li><a href="userguide.html#sbd">The Axis2 Standard Binary
+Distribution</a></li>
+<li><a href="userguide.html#hierarchy">Axis2.war Directory
+Hierarchy</a></li>
+<li><a href="userguide.html#docs">Axis2 Documents
+Distribution</a></li>
+<li><a href="userguide.html#clients">Axis2 and clients</a></li>
+</ul>
+</li>
+<li><a href="userguide-installingtesting.html#installingtesting">Installing and
+testing client code</a></li>
+<li><a href="userguide-introtoservices.html#introservices">Introduction to
+Services</a><br></br>
+<ul>
+<li><a href="userguide-introtoservices.html#messageexchange">Message Exchange
+Patterns</a></li>
+</ul>
+</li>
+<li><a href="userguide-creatingclients.html#createclients">Creating
+Clients</a><br></br>
+<ul>
+<li><a href="userguide-creatingclients.html#choosingclient">Choosing a Client
+Generation Method</a></li>
+<li><a href="userguide-creatingclients.html#generating">Generating
+Clients</a></li>
+<li><a href="userguide-creatingclients.html#adb">Axis Data Binding
+(ADB)</a></li>
+</ul>
+</li>
+<li><a href="userguide-buildingservices.html#buildservices">Building
+Services</a><br></br>
+<ul>
+<li><a href="userguide-buildingservices.html#getcomfortable">Getting
+Comfortable with the Available Options</a></li>
+<li><a href="userguide-buildingservices.html#createscratch">Creating a service
+from scratch</a></li>
+<li><a href="userguide-buildingservices.html#deploypojo">Deploying
+Plain Old Java Objects</a></li>
+<li><a href="userguide-buildingservices.html#deployrun">Deploying
+and running an Axis2 service created from WSDL</a></li>
+</ul>
+</li>
+<li><a href="userguide-samples.html"><strong>Samples</strong></a>
+<ul>
+<li><a href="userguide-samples.html#clients"><strong>Clients</strong></a></li>
+<li><a href="userguide-samples.html#services"><strong>Services</strong></a></li>
+<li><a href="userguide-samples.html#wsdl"><strong>Sample WSDL
+files</strong></a></li>
+<li><a href="userguide-samples.html#others"><strong>Other
+Samples</strong></a></li>
+</ul>
+</li>
+<li><a href="userguide-forfurtherstudy.html">For Further
+Study</a></li>
+</ul>
+<a name="clients"></a>
+<h2>Clients (in AXIS2_HOME/samples/userguide/src/clients):</h2>
+<strong>EchoBlockingClient.java</strong>: A basic example of the
+send/receive MEP.
+<strong>EchoBlockingDualClient.java</strong>: Specifies that the
+return message should be sent over a different channel than the
+request message.
+<strong>EchoBlockingWsaBasedClient.java</strong>: Provides an
+example of using the capabilities of WS-Addressing action
+mapping.
+<strong>EchoNonBlockingClient.java</strong>: Demonstrates an
+asynchronous request using Callbacks.
+<strong>EchoNonBlockingDualClient.java</strong>: Similar to the
+above, but uses a separate listener for the response.
+<strong>ClientForWebServiceWithModule.java</strong>: Simply
+makes a call to a service with engaged modules.
+<strong>ClientSideModuleEngagement.java</strong>: Demonstrates
+the use of modules on the client side, in addition to the server
+side.
+<strong>MailClient.java</strong>: Demonstrates the use of the
+Robust In-Only MEP.
+<strong>PingClient.java</strong>: A simple "fire and forget"
+client.
+<strong>RESTClient.java</strong>: Demonstrates the ability to
+request a REST response rather than a SOAP response. Also
+demonstrates setting arbitrary properties on the Options
+object.
+<strong>TCPClient.java</strong>: Provides an example of using
+the TCP transport rather than HTTP.
+<a name="services"></a>
+<h2>Services (in AXIS2_HOME/samples/userguide):</h2>
+<strong>groovyService.aar</strong>: Demonstrates how to use
+Groovy classes in the processing of SOAP messages.
+<strong>MyService.aar</strong>: Provides simple "echo" and
+"ping" operations.
+<strong>MyServiceWithModule.aar</strong>: Same as above, but
+demonstrates how to engage a module.
+<strong>WsaMappingService.aar</strong>: Demonstrates the mapping
+of WS-Addressing actions.
+<a name="wsdl"></a>
+<h2>Sample WSDL files (in AXIS2_HOME/samples):</h2>
+<strong>Axis2SampleDocLit.wsdl</strong>: Demonstrates the use of
+the Document/Literal WSDL pattern, rather than RPC.
+<strong>perf.wsdl</strong>: Demonstrates the use of array values
+as input values.
+<a name="others"></a>
+<h2>Other samples</h2>
+<h3>In AXIS2_HOME/samples Directory:</h3>
+
+<strong>faulthandling</strong>: Demonstrates the use of SOAP
+faults and their definitions in WSDL enabling exception processing
+in the client.
+
+<strong>googleSpellcheck</strong>: Demonstrates both synchronous
+and non-synchronous use of the Google Web Service in a GUI.
+<strong>mtom</strong>: Demonstrates the use of MTOM and SOAP
+with Attachments to send binary files to a service.
+<strong>saopwithattachments</strong>: Demonstrates the
+capabilities and power of SOAP with Attachment support and the
+Attachment API of Axis2.
+<strong>pojo</strong>: Example of a POJO (Plain Old Java Object)
+Web service. It shows how to expose the methods of a Java class as
+a Web service using Apache Aixs2.
+<strong>servicelifecycle</strong>: Demonstrates the usage of a
+service life cycle and a bit of session management. The main idea
+is to show where and how to use the service life cycle interface
+and session related methods.
+
+<strong>databinding</strong>: Demonstrates how to use WSDL2Java
+generated code with Castor.
+<strong>version</strong>: A very simple service that simply
+outputs the Apache Axis2 version.
+<strong>yahoorestearch</strong>: A complete example of the use
+of a REST service rather than a SOAP service.
+<h3>External:</h3>
+<strong>FlickrClient</strong> : Demonstrates code generation
+capabilities for WSDL 2.0. The FlickrService.wsdl describes
+services offered by flickr in terms of WSDL 2.0. It also
+demonstrates how a restful service can be described using the
+HTTPBinding of wsdl 2.0.
+<p>Extract the <a href="http://dist.wso2.org/products/wsas/java/nightly-build/">WSO2 WSAS
+for Java nightly build distribution</a> and you will find the
+sample at WSAS_HOME/samples/FlickrClient or checkout sample from
+SVN:
+http://wso2.org/repos/wso2/trunk/wsas/java/modules/samples/FlickrClient</p>
+<p><strong>See Next Section</strong> - <a href="userguide-forfurtherstudy.html">For Further Study</a></p>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org