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 ch...@apache.org on 2006/12/20 08:40:49 UTC
svn commit: r488944 [2/2] - /webservices/axis2/trunk/java/xdocs/1_1/
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
-<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-1.1/WEB-INF/services (Note
-that if you installed a SNAPSHOT version of Axis2, this location might take a
-form such as
-<J2EE_HOME>/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
+<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-1.1/WEB-INF/services (Note
+that if you installed a SNAPSHOT version of Axis2, this location might take a
+form such as
+<J2EE_HOME>/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><?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>
-
-<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><?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>
+
+<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