axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cha...@apache.org
Subject svn commit: r488944 [2/2] - /webservices/axis2/trunk/java/xdocs/1_1/
Date Wed, 20 Dec 2006 07:40:49 GMT
Modified: webservices/axis2/trunk/java/xdocs/1_1/userguide-installingtesting.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/userguide-installingtesting.html?view=diff&rev=488944&r1=488943&r2=488944
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/userguide-installingtesting.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/userguide-installingtesting.html Tue Dec 19 23:40:48 2006
@@ -1,129 +1,129 @@
-<html lang="en">
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Apache Axis2 User's Guide-Installing and Testing Client Code</title>
-  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
-  media="all">
-</head>
-
-<body lang="en">
-<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 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-intro.html#intro">Introducing Axis2</a><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>
-
-    <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>
-
-    <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>
-
-    <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>
-
-<p><b>The Short Story:</b></p>
-<ol>
-  <li>Install Axis2 into 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 of the Axis2 libraries are on the CLASSPATH.</li>
-  <li>Run the client</li>
-</ol>
-<!--stopped here-->
-
-<p><b>The Long Story:</b></p>
-
-<p>Start by installing a suitable container, such as <a
-href="http://tomcat.apache.org/">Apache Tomcat</a>. Any J2EE server will do.
-To install 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, seen in the <a
-href="userguide-intro.html#hierarchy">earlier section</a>.</p>
-
-<p>Axis2 services come bundled as *.aar files, which contain all of 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
-&lt;AXIS2_HOME&gt;/samples/userguide/build/MyService.aar file which is built
-using the <code>ant</code> command from &lt;AXIS2_HOME&gt;/samples/userguide,
-to the directory &lt;J2EE_HOME&gt;/webapps/axis2-1.1/WEB-INF/services (Note
-that if you installed a SNAPSHOT version of Axis2, this location might take a
-form such as
-&lt;J2EE_HOME&gt;/webapps/axis2-1.1.1-SNAPSHOT/WEB-INF/services)</p>
-
-<p>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_1/download.cgi#std-bin">Axis2
-Standard Distribution</a> and adding the *.jar files in the lib directory to
-your CLASSPATH, but you also have the option to run 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.</p>
-
-<p><strong>See Next Section</strong>- <a
-href="userguide-introtoservices.html#introservices">Introduction to
-Services</a></p>
-</body>
-</html>
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Apache Axis2 User's Guide-Installing and Testing Client Code</title>
+  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
+  media="all" />
+</head>
+
+<body lang="en">
+<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 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-intro.html#intro">Introducing Axis2</a><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>
+
+    <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>
+
+    <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>
+
+    <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>
+
+<p><b>The Short Story:</b></p>
+<ol>
+  <li>Install Axis2 into 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 of the Axis2 libraries are on the CLASSPATH.</li>
+  <li>Run the client</li>
+</ol>
+<!--stopped here-->
+
+<p><b>The Long Story:</b></p>
+
+<p>Start by installing a suitable container, such as <a
+href="http://tomcat.apache.org/">Apache Tomcat</a>. Any J2EE server will do.
+To install 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, seen in the <a
+href="userguide-intro.html#hierarchy">earlier section</a>.</p>
+
+<p>Axis2 services come bundled as *.aar files, which contain all of 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
+&lt;AXIS2_HOME&gt;/samples/userguide/build/MyService.aar file which is built
+using the <code>ant</code> command from &lt;AXIS2_HOME&gt;/samples/userguide,
+to the directory &lt;J2EE_HOME&gt;/webapps/axis2-1.1/WEB-INF/services (Note
+that if you installed a SNAPSHOT version of Axis2, this location might take a
+form such as
+&lt;J2EE_HOME&gt;/webapps/axis2-1.1.1-SNAPSHOT/WEB-INF/services)</p>
+
+<p>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_1/download.cgi#std-bin">Axis2
+Standard Distribution</a> and adding the *.jar files in the lib directory to
+your CLASSPATH, but you also have the option to run 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.</p>
+
+<p><strong>See Next Section</strong>- <a
+href="userguide-introtoservices.html#introservices">Introduction to
+Services</a></p>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/1_1/userguide-introtoservices.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/userguide-introtoservices.html?view=diff&rev=488944&r1=488943&r2=488944
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/userguide-introtoservices.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/userguide-introtoservices.html Tue Dec 19 23:40:48 2006
@@ -1,164 +1,164 @@
-<html lang="en">
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Apache Axis2 User's Guide- Introduction to Services</title>
-  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
-  media="all">
-</head>
-
-<body>
-<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 to send
-information back and forth, but 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>
-
-    <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>
-
-    <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>
-
-    <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>
-
-    <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>
-
-<h3>Code Listing 4: Example SOAP Message</h3>
-<pre>&lt;?xml version='1.0' ?&gt;
-&lt;env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
-xmlns:wsa="http://www.w3.org/2005/03/addressing"&gt; 
- &lt;env:Header&gt;
-
-    &lt;wsa:MessageID&gt;
-      http://ws.apache.org/9C21DE32-DB42-1228-C42E-66CB101421AD
-    &lt;/wsa:MessageID&gt;
-    &lt;wsa:ReplyTo&gt;
-      &lt;wsa:Address&gt;http://example.com/projects/clientApp&lt;/wsa:Address&gt;
-    &lt;/wsa:ReplyTo&gt;
-    
-&lt;wsa:To&gt;http://example.com/axis2/publishingService&lt;/wsa:To&gt;
-    
-&lt;wsa:Action&gt;http://example.com/axis2/addDocument&lt;/wsa:Action&gt;
- 
-&lt;/env:Header&gt;
- &lt;env:Body&gt;
-
-  &lt;addDocument&gt;
-   &lt;docTitle&gt;What I Did On My Summer Vacation&lt;/doctitle&gt;
-   &lt;docSubtitle&gt;Children's Essays from Accross the World&lt;/docSubtitle&gt;
-   &lt;docLocation&gt;contentRepos/summerVac.doc&lt;/docLocation&gt;
-  &lt;/addDocument&gt;
-
- &lt;/env:Body&gt;
-&lt;/env:Envelope&gt;</pre>
-
-<p>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.</p>
-
-<p>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.</p>
-
-<p>The third and arguably 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 is the information that the main
-application will ultimately process.</p>
-<a name="messageexchange"></a>
-
-<h2>Message Exchange Patterns</h2>
-
-<p>Although all SOAP messages carry the same structure, the ways in which use
-them can be combined into a number of different "message exchange patterns",
-or MEPs. The two major message exchange patterns are:</p>
-<ul>
-  <li>In-Out: in this MEP, the client sends a soap message to the server, in
-    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 which
-    acknowledgment is important.</li>
-  <li>In-Only: In this MEP, the client sends a message to the server without
-    the expectation of receiving a response. You may use this MEP for
-    activities such as pinging a server to wake it up, reporting logging
-    information for which you need no acknowledgment, and so on.</li>
-</ul>
-
-<p>Within these two MEPs, you also have several variables to consider:</p>
-<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 then move on, 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
-    require no parameters, or it may require one or more parameters. These
-    parameters must be encoded as part of the payload of the message.</li>
-</ul>
-
-<p>Taking all of 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. Axis2 also includes support for less prominent MEPs,
-such as Robust-In-Only.</p>
-
-<p><strong>See Next Section</strong> - <a
-href="userguide-creatingclients.html#createclients">Creating Clients</a></p>
-</body>
-</html>
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Apache Axis2 User's Guide- Introduction to Services</title>
+  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
+  media="all" />
+</head>
+
+<body>
+<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 to send
+information back and forth, but 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>
+
+    <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>
+
+    <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>
+
+    <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>
+
+    <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>
+
+<h3>Code Listing 4: Example SOAP Message</h3>
+<pre>&lt;?xml version='1.0' ?&gt;
+&lt;env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
+xmlns:wsa="http://www.w3.org/2005/03/addressing"&gt; 
+ &lt;env:Header&gt;
+
+    &lt;wsa:MessageID&gt;
+      http://ws.apache.org/9C21DE32-DB42-1228-C42E-66CB101421AD
+    &lt;/wsa:MessageID&gt;
+    &lt;wsa:ReplyTo&gt;
+      &lt;wsa:Address&gt;http://example.com/projects/clientApp&lt;/wsa:Address&gt;
+    &lt;/wsa:ReplyTo&gt;
+    
+&lt;wsa:To&gt;http://example.com/axis2/publishingService&lt;/wsa:To&gt;
+    
+&lt;wsa:Action&gt;http://example.com/axis2/addDocument&lt;/wsa:Action&gt;
+ 
+&lt;/env:Header&gt;
+ &lt;env:Body&gt;
+
+  &lt;addDocument&gt;
+   &lt;docTitle&gt;What I Did On My Summer Vacation&lt;/doctitle&gt;
+   &lt;docSubtitle&gt;Children's Essays from Accross the World&lt;/docSubtitle&gt;
+   &lt;docLocation&gt;contentRepos/summerVac.doc&lt;/docLocation&gt;
+  &lt;/addDocument&gt;
+
+ &lt;/env:Body&gt;
+&lt;/env:Envelope&gt;</pre>
+
+<p>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.</p>
+
+<p>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.</p>
+
+<p>The third and arguably 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 is the information that the main
+application will ultimately process.</p>
+<a name="messageexchange"></a>
+
+<h2>Message Exchange Patterns</h2>
+
+<p>Although all SOAP messages carry the same structure, the ways in which use
+them can be combined into a number of different "message exchange patterns",
+or MEPs. The two major message exchange patterns are:</p>
+<ul>
+  <li>In-Out: in this MEP, the client sends a soap message to the server, in
+    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 which
+    acknowledgment is important.</li>
+  <li>In-Only: In this MEP, the client sends a message to the server without
+    the expectation of receiving a response. You may use this MEP for
+    activities such as pinging a server to wake it up, reporting logging
+    information for which you need no acknowledgment, and so on.</li>
+</ul>
+
+<p>Within these two MEPs, you also have several variables to consider:</p>
+<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 then move on, 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
+    require no parameters, or it may require one or more parameters. These
+    parameters must be encoded as part of the payload of the message.</li>
+</ul>
+
+<p>Taking all of 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. Axis2 also includes support for less prominent MEPs,
+such as Robust-In-Only.</p>
+
+<p><strong>See Next Section</strong> - <a
+href="userguide-creatingclients.html#createclients">Creating Clients</a></p>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/1_1/userguide-samples.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/userguide-samples.html?view=diff&rev=488944&r1=488943&r2=488944
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/userguide-samples.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/userguide-samples.html Tue Dec 19 23:40:48 2006
@@ -1,184 +1,184 @@
-<html lang="en">
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Apache Axis2 User's Guide- The Samples</title>
-  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
-  media="all">
-</head>
-
-<body lang="en">
-<a name="samples"></a>
-
-<h1>Apache Axis2 User's Guide - The Samples</h1>
-
-<p>The 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>
-
-    <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>
-
-    <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>
-
-    <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>
-
-    <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"><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 samples/userguide/src/clients):</h2>
-
-<p>EchoBlockingClient.java: A basic example of the send/receive MEP.</p>
-
-<p>EchoBlockingDualClient.java: Specifies that the return message should be
-sent over a different channel than the request message.</p>
-
-<p>EchoBlockingWsaBasedClient.java: Provides an example of using the
-capabilities of WS-Addressing action mapping.</p>
-
-<p>EchoNonBlockingClient.java: Demonstrates an asynchronous request and using
-Callbacks.</p>
-
-<p>EchoNonBlockingDualClient.java: Similar to above, but uses a separate
-listener for the response.</p>
-
-<p>ClientForWebServiceWithModule.java: Simply makes a call to a service with
-engaged modules.</p>
-
-<p>ClientSideModuleEngagement.java: Demonstrates the use of modules on the
-client side, in addition to the server side.</p>
-
-<p>MailClient.java: Demonstrates the use of the Robust In-Only MEP.</p>
-
-<p>PingClient.java: A simple "fire and forget" client.</p>
-
-<p>RESTClient.java: Demonstrates the ability to request a REST response
-rather than a SOAP response. Also demonstrates setting arbitrary properties
-on the Options object.</p>
-
-<p>TCPClient.java: Provides an example of using the TCP transport rather than
-HTTP.</p>
-<a name="services"></a>
-
-<h2>Services (in samples/userguide):</h2>
-
-<p>groovyService.aar: Demonstrates how to use Groovy classes in the
-processing of SOAP messages.</p>
-
-<p>MyService.aar: Provides simple "echo" and "ping" operations.</p>
-
-<p>MyServiceWithModule.aar: Same as above, but demonstrates how to engage a
-module.</p>
-
-<p>WsaMappingService.aar: Demonstrates the mapping of WS-Addressing
-actions.</p>
-<a name="wsdl"></a>
-
-<h2>Sample WSDL files (in samples):</h2>
-
-<p>Axis2SampleDocLit.wsdl: Demonstrates the use of the Document/Literal WSDL
-pattern, rather than RPC.</p>
-
-<p>perf.wsdl: Demonstrates the use of array values as input values.</p>
-<a name="other"></a>
-
-<h2>Other samples (in samples):</h2>
-<!--<p><strong>amazonqs</strong>: Uses the Amazon Queue Service to store and
-retrieve String objects.</p>-->
-
-<p><strong>faulthandling</strong>: Demonstrates the use of SOAP faults and
-their definition in WSDL, enabling exception processing in the client.</p>
-<!--<p><strong>googlesearch</strong>: Creates a GUI-based application making use
-of Google Web Services asynchronously.</p>-->
-
-<p><strong>googleSpellcheck</strong>: Demonstrates both synchronous and
-non-synchronous use of the Google Web Service in a GUI.</p>
-
-<p><strong>mtom</strong>: Demonstrates the use of MTOM and SOAP with
-Attachments to send binary files to a service.</p>
-
-<p><strong>saopwithattachments</strong>: Demonstrates the capabilities and
-power of SOAP with Attachment support and the Attachment API of Axis2.</p>
-
-<p><strong>pojo</strong>: Example POJO (Plain Old Java Object) Web service.
-It shows how to expose the methods of a Java class as a Web service using
-Aixs2</p>
-
-<p><strong>servicelifecycle</strong>: Demonstrate usage of service life cycle
-and bit of session management. The main idea is to show where and how to use
-service life cycle interface and session related methods.</p>
-<!--<p><strong>sgccalculator</strong>: A simple calculator that demonstrates the
-use of Service Groups.</p>-->
-
-<p><strong>databinding</strong>: Demonstrates how to use WSDL2Java generated
-code with Castor.</p>
-
-<p><strong>version</strong>: A very simple service that simply outputs the
-Axis2 version.</p>
-
-<p><strong>yahoorestearch</strong>: Complete example of the use of a REST
-service rather than a SOAP service.</p>
-
-<p><strong>See Next Section</strong> - <a
-href="userguide-forfurtherstudy.html">For Further Study</a></p>
-</body>
-</html>
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Apache Axis2 User's Guide- The Samples</title>
+  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
+  media="all" />
+</head>
+
+<body lang="en">
+<a name="samples"></a>
+
+<h1>Apache Axis2 User's Guide - The Samples</h1>
+
+<p>The 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>
+
+    <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>
+
+    <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>
+
+    <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>
+
+    <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"><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 samples/userguide/src/clients):</h2>
+
+<p>EchoBlockingClient.java: A basic example of the send/receive MEP.</p>
+
+<p>EchoBlockingDualClient.java: Specifies that the return message should be
+sent over a different channel than the request message.</p>
+
+<p>EchoBlockingWsaBasedClient.java: Provides an example of using the
+capabilities of WS-Addressing action mapping.</p>
+
+<p>EchoNonBlockingClient.java: Demonstrates an asynchronous request and using
+Callbacks.</p>
+
+<p>EchoNonBlockingDualClient.java: Similar to above, but uses a separate
+listener for the response.</p>
+
+<p>ClientForWebServiceWithModule.java: Simply makes a call to a service with
+engaged modules.</p>
+
+<p>ClientSideModuleEngagement.java: Demonstrates the use of modules on the
+client side, in addition to the server side.</p>
+
+<p>MailClient.java: Demonstrates the use of the Robust In-Only MEP.</p>
+
+<p>PingClient.java: A simple "fire and forget" client.</p>
+
+<p>RESTClient.java: Demonstrates the ability to request a REST response
+rather than a SOAP response. Also demonstrates setting arbitrary properties
+on the Options object.</p>
+
+<p>TCPClient.java: Provides an example of using the TCP transport rather than
+HTTP.</p>
+<a name="services"></a>
+
+<h2>Services (in samples/userguide):</h2>
+
+<p>groovyService.aar: Demonstrates how to use Groovy classes in the
+processing of SOAP messages.</p>
+
+<p>MyService.aar: Provides simple "echo" and "ping" operations.</p>
+
+<p>MyServiceWithModule.aar: Same as above, but demonstrates how to engage a
+module.</p>
+
+<p>WsaMappingService.aar: Demonstrates the mapping of WS-Addressing
+actions.</p>
+<a name="wsdl"></a>
+
+<h2>Sample WSDL files (in samples):</h2>
+
+<p>Axis2SampleDocLit.wsdl: Demonstrates the use of the Document/Literal WSDL
+pattern, rather than RPC.</p>
+
+<p>perf.wsdl: Demonstrates the use of array values as input values.</p>
+<a name="other"></a>
+
+<h2>Other samples (in samples):</h2>
+<!--<p><strong>amazonqs</strong>: Uses the Amazon Queue Service to store and
+retrieve String objects.</p>-->
+
+<p><strong>faulthandling</strong>: Demonstrates the use of SOAP faults and
+their definition in WSDL, enabling exception processing in the client.</p>
+<!--<p><strong>googlesearch</strong>: Creates a GUI-based application making use
+of Google Web Services asynchronously.</p>-->
+
+<p><strong>googleSpellcheck</strong>: Demonstrates both synchronous and
+non-synchronous use of the Google Web Service in a GUI.</p>
+
+<p><strong>mtom</strong>: Demonstrates the use of MTOM and SOAP with
+Attachments to send binary files to a service.</p>
+
+<p><strong>saopwithattachments</strong>: Demonstrates the capabilities and
+power of SOAP with Attachment support and the Attachment API of Axis2.</p>
+
+<p><strong>pojo</strong>: Example POJO (Plain Old Java Object) Web service.
+It shows how to expose the methods of a Java class as a Web service using
+Aixs2</p>
+
+<p><strong>servicelifecycle</strong>: Demonstrate usage of service life cycle
+and bit of session management. The main idea is to show where and how to use
+service life cycle interface and session related methods.</p>
+<!--<p><strong>sgccalculator</strong>: A simple calculator that demonstrates the
+use of Service Groups.</p>-->
+
+<p><strong>databinding</strong>: Demonstrates how to use WSDL2Java generated
+code with Castor.</p>
+
+<p><strong>version</strong>: A very simple service that simply outputs the
+Axis2 version.</p>
+
+<p><strong>yahoorestearch</strong>: Complete example of the use of a REST
+service rather than a SOAP service.</p>
+
+<p><strong>See Next Section</strong> - <a
+href="userguide-forfurtherstudy.html">For Further Study</a></p>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/1_1/userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/userguide.html?view=diff&rev=488944&r1=488943&r2=488944
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/userguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/userguide.html Tue Dec 19 23:40:48 2006
@@ -4,7 +4,7 @@
   <meta http-equiv="content-type" content="" />
   <title>Apache Axis2 User's Guide- Introducing Axis2</title>
   <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
-  media="all">
+  media="all" />
 </head>
 
 <body xml:lang="en" lang="en">



---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org


Mime
View raw message