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/04/27 14:39:46 UTC
svn commit: r533081 [13/23] - in /webservices/axis2/site: ./ 1_2/ 1_2/adb/
1_2/adb/images/ 1_2/images/ 1_2/images/archi-guide/ 1_2/images/userguide/
1_2/jibx/ 1_2/resources/ 1_2/resources/schemas/ 1_2/src/ css/ download/0_9/
download/0_91/ download/0_9...
Added: webservices/axis2/site/1_2/userguide-introtoservices.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_2/userguide-introtoservices.html?view=auto&rev=533081
==============================================================================
--- webservices/axis2/site/1_2/userguide-introtoservices.html (added)
+++ webservices/axis2/site/1_2/userguide-introtoservices.html Fri Apr 27 05:39:33 2007
@@ -0,0 +1,154 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - Apache Axis2 User's Guide- Introduction to Services</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 27 April 2007
+ | Doc for 1.2</div><div class="xright">
+
+ <a href="../index.html">Axis2/Java</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="../index.html">Home</a></li></ul></div><div id="menuDownloads"><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></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="../1_2/contents.html">Version 1.2</a><ul><li class="none"><a href="../1_2/toc.html">Table of Contents</a></li><li class="none"><a href="../1_2/installationguide.html">Installation Guide</a></li><li class="none"><a href="../1_2/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="../1_2/userguide.html">User Guide</a></li><li class="none"><a href="../1_2/pojoguide.html">POJO Guide</a></li><li class="none"><a href="../1_2/spring.html">
Spring Guide</a></li><li class="none"><a href="../1_2/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="../1_2/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="../1_1_1/index.html">Version 1.0</a></li><li class="none"><a href="../1_1/index.html">Version 1.0</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></div><div id="menuResources"><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/" class="externalLink" title="External Link">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_2/api/index.html" class="externalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><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="../guidelines.html">Developer Guidelines</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><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" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="none"><a hr
ef="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="External Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="introservices"></a></p></div><div class="section"><a name="Apache_Axis2_User_s_Guide_-_Introduction_to_Services"></a><h2>Apache Axis2 User's Guide - Introduction to Services</h2><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><div class="subsection"><a name="Content"></a><h3>Content</h3><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></div><div class="subsection"><a name="Code_Listing_4:_Example_SOAP_Message"></a><h3>Code Listing 4: Example SOAP Message</h3>
+ <div class="source"><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></div>
+ <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 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.</p><p><a name="messageexchange"></a></p></div><div class="subsection"><a name="Message_Exchange_Patterns"></a><h3>Message Exchange Patterns</h3><p>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:</p><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><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 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><p>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.</p><p><strong>See Next Section</strong> - <a href="userguide-creatingclients.html#createclients">Creating Clients</a></p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/axis2/site/1_2/userguide-samples.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_2/userguide-samples.html?view=auto&rev=533081
==============================================================================
--- webservices/axis2/site/1_2/userguide-samples.html (added)
+++ webservices/axis2/site/1_2/userguide-samples.html Fri Apr 27 05:39:33 2007
@@ -0,0 +1,137 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - Apache Axis2 User's Guide- The Samples</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 27 April 2007
+ | Doc for 1.2</div><div class="xright">
+
+ <a href="../index.html">Axis2/Java</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="../index.html">Home</a></li></ul></div><div id="menuDownloads"><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></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="../1_2/contents.html">Version 1.2</a><ul><li class="none"><a href="../1_2/toc.html">Table of Contents</a></li><li class="none"><a href="../1_2/installationguide.html">Installation Guide</a></li><li class="none"><a href="../1_2/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="../1_2/userguide.html">User Guide</a></li><li class="none"><a href="../1_2/pojoguide.html">POJO Guide</a></li><li class="none"><a href="../1_2/spring.html">
Spring Guide</a></li><li class="none"><a href="../1_2/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="../1_2/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="../1_1_1/index.html">Version 1.0</a></li><li class="none"><a href="../1_1/index.html">Version 1.0</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></div><div id="menuResources"><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/" class="externalLink" title="External Link">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_2/api/index.html" class="externalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><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="../guidelines.html">Developer Guidelines</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><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" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="none"><a hr
ef="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="External Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="samples"></a></p></div><div class="section"><a name="Apache_Axis2_User_s_Guide_-_The_Samples"></a><h2>Apache Axis2 User's Guide - The Samples</h2><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><div class="subsection"><a name="Content"></a><h3>Content</h3><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><p><a name="clients"></a></p></div><div class="subsection"><a name="Clients__in_AXIS2_HOME_samples_userguide_src_clients_:"></a><h3>Clients (in AXIS2_HOME/samples/userguide/src/clients):</h3><p><strong>EchoBlockingClient.java</strong>: A basic example of the
+send/receive MEP.</p><p><strong>EchoBlockingDualClient.java</strong>: Specifies that the return
+message should be sent over a different channel than the request message.</p><p><strong>EchoBlockingWsaBasedClient.java</strong>: Provides an example of
+using the capabilities of WS-Addressing action mapping.</p><p><strong>EchoNonBlockingClient.java</strong>: Demonstrates an asynchronous
+request using Callbacks.</p><p><strong>EchoNonBlockingDualClient.java</strong>: Similar to the above, but
+uses a separate listener for the response.</p><p><strong>ClientForWebServiceWithModule.java</strong>: Simply makes a call
+to a service with engaged modules.</p><p><strong>ClientSideModuleEngagement.java</strong>: Demonstrates the use of
+modules on the client side, in addition to the server side.</p><p><strong>MailClient.java</strong>: Demonstrates the use of the Robust
+In-Only MEP.</p><p><strong>PingClient.java</strong>: A simple "fire and forget" client.</p><p><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.</p><p><strong>TCPClient.java</strong>: Provides an example of using the TCP
+transport rather than HTTP.</p><p><a name="services"></a></p></div><div class="subsection"><a name="Services__in_AXIS2_HOME_samples_userguide_:"></a><h3>Services (in AXIS2_HOME/samples/userguide):</h3><p><strong>groovyService.aar</strong>: Demonstrates how to use Groovy classes
+in the processing of SOAP messages.</p><p><strong>MyService.aar</strong>: Provides simple "echo" and "ping"
+operations.</p><p><strong>MyServiceWithModule.aar</strong>: Same as above, but demonstrates
+how to engage a module.</p><p><strong>WsaMappingService.aar</strong>: Demonstrates the mapping of
+WS-Addressing actions.</p><p><a name="wsdl"></a></p></div><div class="subsection"><a name="Sample_WSDL_files__in_AXIS2_HOME_samples_:"></a><h3>Sample WSDL files (in AXIS2_HOME/samples):</h3><p><strong>Axis2SampleDocLit.wsdl</strong>: Demonstrates the use of the
+Document/Literal WSDL pattern, rather than RPC.</p><p><strong>perf.wsdl</strong>: Demonstrates the use of array values as input
+values.</p><p><a name="others"></a></p></div><div class="subsection"><a name="Other_samples"></a><h3>Other samples</h3></div><div class="subsection"><a name="In_AXIS2_HOME_samples_Directory:"></a><h3>In AXIS2_HOME/samples Directory:</h3><p>
+
+</p><p><strong>faulthandling</strong>: Demonstrates the use of SOAP faults and
+their definitions in WSDL enabling exception processing in the client.</p><p>
+
+</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 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.</p><p><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.</p><p>
+
+</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
+Apache Axis2 version.</p><p><strong>yahoorestearch</strong>: A complete example of the use of a REST
+service rather than a SOAP service.</p></div><div class="subsection"><a name="External:"></a><h3>External:</h3><p><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><p>Extract the <a href="http://dist.wso2.org/products/wsas/java/nightly-build/" class="externalLink" title="External Link">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></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/axis2/site/1_2/userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_2/userguide.html?view=auto&rev=533081
==============================================================================
--- webservices/axis2/site/1_2/userguide.html (added)
+++ webservices/axis2/site/1_2/userguide.html Fri Apr 27 05:39:33 2007
@@ -0,0 +1,274 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - Apache Axis2 User's Guide- Introducing Axis2</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 27 April 2007
+ | Doc for 1.2</div><div class="xright">
+
+ <a href="../index.html">Axis2/Java</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="../index.html">Home</a></li></ul></div><div id="menuDownloads"><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></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="../1_2/contents.html">Version 1.2</a><ul><li class="none"><a href="../1_2/toc.html">Table of Contents</a></li><li class="none"><a href="../1_2/installationguide.html">Installation Guide</a></li><li class="none"><a href="../1_2/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="../1_2/userguide.html">User Guide</a></li><li class="none"><a href="../1_2/pojoguide.html">POJO Guide</a></li><li class="none"><a href="../1_2/spring.html">
Spring Guide</a></li><li class="none"><a href="../1_2/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="../1_2/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="../1_1_1/index.html">Version 1.0</a></li><li class="none"><a href="../1_1/index.html">Version 1.0</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></div><div id="menuResources"><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/" class="externalLink" title="External Link">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_2/api/index.html" class="externalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><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="../guidelines.html">Developer Guidelines</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><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" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="none"><a hr
ef="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="External Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_Axis2_User_s_Guide"></a><h2>Apache Axis2 User's Guide</h2><p>This guide provides a starting place for users who are new to Apache
+Axis2. It also covers some advanced topics, such as how to use Axis2 to
+create and deploy Web services as well as how to use WSDL to generate both
+clients and services.</p><p>
+For experienced users of Apache Axis2, we recommend the <a href="adv-userguide.html">Advanced User's Guide.</a><a name="intro"></a></p></div><div class="section"><a name="Introducing_Axis2"></a><h2>Introducing Axis2</h2><p>This section introduces Axis2 and its structure, including an explanation
+of various directories/files included in the latest Axis2 <a href="http://ws.apache.org/axis2/download.cgi" class="externalLink" title="External Link">download</a>.</p><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
+ <li><a href="userguide.html#intro"><strong>Introducing
+ Axis2</strong></a><br></br>
+
+ <ul>
+ <li><a href="userguide.html#whatis"><strong>What is
+ Axis2?</strong></a></li>
+ <li><a href="userguide.html#underhood"><strong>What's under the
+ hood?</strong></a></li>
+ <li><a href="userguide.html#handlessoap"><strong>How Axis2 handles SOAP
+ messages</strong></a></li>
+ <li><a href="userguide.html#distributions"><strong>Axis2
+ Distributions</strong></a></li>
+ <li><a href="userguide.html#sbd"><strong>The Axis2 Standard Binary
+ Distribution</strong></a></li>
+ <li><a href="userguide.html#hierarchy"><strong>Axis2.war Directory
+ Hierarchy</strong></a></li>
+ <li><a href="userguide.html#docs"><strong>Axis2 Documents
+ Distribution</strong></a></li>
+ <li><a href="userguide.html#clients"><strong>Axis2 and
+ Clients</strong></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 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><a name="whatis"></a></p></div><div class="subsection"><a name="What_is_Axis2_"></a><h3>What is Axis2?</h3><p>The Apache Axis2 project is a Java-based implementation of both the client
+and server sides of the Web services equation. Designed to take advantage of
+the lessons learned from Apache Axis 1.0, Apache Axis2 provides a complete
+object model and a modular architecture that makes it easy to add
+functionality and support for new Web services-related specifications and
+recommendations.</p><p>Axis2 enables you to easily perform the following tasks:</p><ul>
+ <li>Send SOAP messages</li>
+ <li>Receive and process SOAP messages</li>
+ <li>Create a Web service out of a plain Java class</li>
+ <li>Create implementation classes for both the server and client using
+ WSDL</li>
+ <li>Easily retrieve the WSDL for a service</li>
+ <li>Send and receive SOAP messages with attachments</li>
+ <li>Create or utilize a REST-based Web service</li>
+ <li>Create or utilize services that take advantage of the <a href="http://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-os-SOAPMessageSecurity.pdf" class="externalLink" title="External Link">WS-Security</a>,
+ <a href="http://xml.coverpages.org/ws-reliablemessaging20030313.pdf" class="externalLink" title="External Link">WS-ReliableMessaging</a>,
+ <a href="http://www.w3.org/2002/ws/addr/" class="externalLink" title="External Link">WS-Addressing</a>, <a href="http://dev2dev.bea.com/pub/a/2004/03/ws-coordination.html" class="externalLink" title="External Link">WS-Coordination</a>,
+ and <a href="ftp://www6.software.ibm.com/software/developer/library/WS-AtomicTransaction.pdf">WS-Atomic
+ Transaction</a> recommendations</li>
+ <li>Use Axis2's modular structure to easily add support for new
+ recommendations as they emerge</li>
+</ul><p>Many more features exist as well, but this user guide concentrates on
+showing you how to accomplish the first five tasks on this list.</p><p><a name="underhood"></a></p></div><div class="subsection"><a name="What_s_Under_the_Hood_"></a><h3>What's Under the Hood?</h3><p>To understand Axis2 and what it does, you must have a good idea of the
+life cycle of a Web services message. Typically, it looks something like
+this:</p><p><img alt="Lifecycle of a Web services message" src="images/fig01.jpg"></img><br clear="all"></br>
+</p><p>The sending application creates the original SOAP message, an XML message
+that consists of headers and a body. (For more information on SOAP, see "<a href="userguide-introtoservices.html/">Introduction to Services</a>".) If the
+system requires the use of WS* recommendations such as WS-Addressing or
+WS-Security, the message may undergo additional processing before it leaves
+the sender. Once the message is ready, it is sent via a particular transport
+such as HTTP, JMS, and so on.</p><p>The message works its way over to the receiver, which takes in the message
+via the transport listener. (In other words, if the application doesn't have
+an HTTP listener running, it's not going to receive any HTTP messages.)
+Again, if the message is part of a system that requires the use of
+WS-Security or other recommendations, it may need additional processing for
+the purpose of checking credentials or decrypting sensitive information.
+Finally, a dispatcher determines the specific application (or other
+component, such as a Java method) for which the message was intended, and
+sends it to that component. That component is part of an overall application
+designed to work with the data being sent back and forth.</p><p><a name="handlessoap"></a></p></div><div class="subsection"><a name="How_Axis2_Handles_SOAP_Messages"></a><h3>How Axis2 Handles SOAP Messages</h3><p>Axis2 can handle processing for both the sender and the receiver in a
+transaction. From the Axis2 perspective, the structure looks like this:</p><p><img alt="Axis2 handles SOAP messages" src="images/fig02.jpg"></img><br clear="all"></br>
+</p><p>On each end, you have an application designed to deal with the (sent or
+received) messages. In the middle, you have Axis2, or rather, you
+<em>can</em> have Axis2. The value of Web services is that the sender and
+receiver (each of which can be either the server or the client) don't even
+have to be on the same platform, much less running the same application.
+Assuming that Axis2 is running on both sides, the process looks like this:</p><ul>
+ <li>The sender creates the SOAP message.</li>
+ <li>Axis "handlers" perform any necessary actions on that message such as
+ encryption of WS-Security related messages.</li>
+ <li>The transport sender sends the message.</li>
+ <li>On the receiving end, the transport listener detects the message.</li>
+ <li>The transport listener passes the message on to any handlers on the
+ receiving side.</li>
+ <li>Once the message has been processed in the "pre-dispatch" phase, it is
+ handed off to the dispatchers, which pass it on to the appropriate
+ application.</li>
+</ul><p>In Axis2, these actions are broken down into "phases", with several
+pre-defined phases, such as the "pre-dispatch", "dispatch," and "message
+processing", being built into Axis2. Each phase is a collection of
+"handlers". Axis2 enables you to control what handlers go into which phases,
+and the order in which the handlers are executed within the phases. You can
+also add your own phases and handlers.</p><p>Handlers come from "modules" that can be plugged into a running Axis2
+system. These modules, such as Rampart, which provides an implementation of
+WS-Security, and Sandesha, which provides an implementation of
+WS-ReliableMessaging, are the main extensibility mechanisms in Axis2.</p><p><a name="distributions"></a></p></div><div class="subsection"><a name="Axis2_Distributions"></a><h3>Axis2 Distributions</h3><p>Axis2 is released in several <a href="http://ws.apache.org/axis2/download/1_2/download.cgi" class="externalLink" title="External Link">distributions</a>.
+Which one you need depends on what you'll be doing with it.</p><p><a name="sbd"></a></p></div><div class="subsection"><a name="The_Axis2_Standard_Binary_Distribution"></a><h3>The Axis2 Standard Binary Distribution</h3><p>If you're developing services and applications, you'll need the Axis2 <a href="http://ws.apache.org/axis2/download/1_2/download.cgi#std-bin" class="externalLink" title="External Link">Standard
+Binary Distribution</a>. The distribution includes all the necessary *.jar
+files, as well as a variety of scripts that ease development. It has the
+following structure.</p><p><b>Code Listing 1: Axis2 Standard Binary Distribution</b></p>
+ <div class="source"><pre>bin
+ axis2.bat
+ axis2.sh
+ axis2server.bat
+ axis2server.sh
+ java2wsdl.bat
+ java2wsdl.sh
+ wsdl2java.bat
+ wsdl2java.sh
+ setenv.sh
+lib
+ activation-1.1.jar
+ ...
+ XmlSchema.jar
+repository
+ modules
+ modules.list
+ addressing-1.1.mar
+ ..
+ services
+ services.list
+ version.aar
+ ..
+samples
+ ...
+webapp
+ ...
+conf
+ axis2.xml
+
+LICENSE.txt
+README.txt
+NOTICE.txt
+INSTALL.txt
+release-notes.html
+
+</pre></div>
+ <p>The bin directory includes a number of useful scripts. They include
+axis2.bat (or axis2.sh), which enables you to easily execute a Java command
+without having to manually add all the Axis2 jar files to the classpath,
+java2wsdl.bat (and .sh) and wsdl2java.bat (and .sh), which enable you to
+easily generate Java code from a WSDL file and vice versa, and
+axis2server.bat (and sh), a simple Web server that enables you to build
+Axis2's capability to send and receive messages into your own application.</p><p>As expected, the lib directory includes all the necessary .jar files.
+Services and modules are added to the repository directory. Axis2 comes with
+a standard module implementing WS-Addressing, and you can add any other
+necessary module such as Rampart to the repository/modules directory.</p><p>conf directory includes the axis2.xml which is the global deployment
+descriptor.</p><p>Finally, the samples directory includes all the sample code distributed
+with Axis2. See the list of <a href="userguide-samples.html">samples and
+their descriptions</a>.</p><p><a name="hierarchy"></a></p></div><div class="subsection"><a name="axis2_war_Distribution_Directory_Hierarchy"></a><h3>axis2.war Distribution Directory Hierarchy</h3><p>axis2.war is available in <a href="http://ws.apache.org/axis2/download/1_2/download.cgi#war" class="externalLink" title="External Link">WAR (Web
+Archive) Distribution</a>. The server side of Axis2 ships as a J2EE
+application, and has the following structure shown in Code Listing 2.</p><p><b>Code Listing 2: Server Side of Axis2</b></p>
+ <div class="source"><pre>axis2-web
+META-INF
+WEB-INF
+ classes
+ conf
+ axis2.xml
+ lib
+ activation.jar
+ ...
+ xmlSchema.jar
+ modules
+ modules.list
+ addressing.mar
+ ...
+ soapmonitor.mar
+ services
+ services.list
+ aservice.aar
+ ...
+ version.aar
+ web.xml
+
+</pre></div>
+ <p>Starting at the top, axis2-web is a collection of JSPs that make up the <a href="webadminguide.html">Axis2 administration application</a>, through which
+you can perform any needed actions such as adding services and engaging and
+dis-engaging modules. The WEB-INF directory represents the actual Axis2
+application, including all the *.jar files, any included modules, and even
+the deployed services themselves.</p><p>The classes directory holds any class or property files that are needed by
+Axis2 itself, such as log4j.properties. Any actual services to be handled by
+the system reside in the services directory in the form of an axis archive,
+or *.aar file. This file contains any classes related to the service, as well
+as the services.xml file, which controls any additional requirements, such as
+the definition of message senders and message receivers.</p><p>The main file in all this is axis2.xml, which controls how the application
+deals with received messages. It defines message receivers and transport
+receivers, as well as defining transport senders and determining which
+modules are active. It also defines the order of phases, and the handlers to
+be executed within each phase.</p><p>You can control all of this information through the use of the Web
+application, but if you restart the Axis2 application, these changes are lost
+and the server goes back to the definitions in the axis2.xml file.</p><p>Axis2 also provides a third distribution, the <a href="http://ws.apache.org/axis2/download/1_2/download.cgi#src" class="externalLink" title="External Link">source
+distribution</a>, which enables you to generate this .war file yourself.</p><p><a id="docs"></a></p></div><div class="subsection"><a name="Axis2_Documentation_Distribution_Directory_Hierarchy"></a><h3>Axis2 Documentation Distribution Directory Hierarchy</h3><p>The Documents distribution includes all Axis2 documentation including the
+xdcos and javadocs. It has the following structure:</p><p><b>Code Listing 3: Axis2 Documents Distribution</b></p>
+ <div class="source"><pre>docs
+ javadocs
+ xdocs
+
+LICENSE.txt
+README.txt
+release-notes.html
+
+</pre></div>
+ <p>The javadocs directory includes all the standard <a href="../../javadocs/index.html">API documentation</a> for the Axis2 API,
+with other documentation (like this document) in the xdocs directory.</p><p><a name="clients"></a></p></div><div class="subsection"><a name="Axis2_and_Clients"></a><h3>Axis2 and Clients</h3><p>Now that explains how Axis2 behaves as part of a Web application. What
+about a standalone client that is not part of a J2EE application? In that
+case, a sender can use the Axis2 default properties, in other words, no
+special handlers, and so on. But you also have the option to tell the client
+to load its own copy of the axis2.xml file and behave accordingly.</p><p><strong>See Next Section</strong> - <a href="userguide-installingtesting.html#installingtesting">Installing and
+Testing Client Code</a></p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/axis2/site/1_2/webadminguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_2/webadminguide.html?view=auto&rev=533081
==============================================================================
--- webservices/axis2/site/1_2/webadminguide.html (added)
+++ webservices/axis2/site/1_2/webadminguide.html Fri Apr 27 05:39:33 2007
@@ -0,0 +1,201 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - Apache Axis2 Web Administrator's Guide</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 27 April 2007
+ | Doc for 1.2</div><div class="xright">
+
+ <a href="../index.html">Axis2/Java</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="../index.html">Home</a></li></ul></div><div id="menuDownloads"><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></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="../1_2/contents.html">Version 1.2</a><ul><li class="none"><a href="../1_2/toc.html">Table of Contents</a></li><li class="none"><a href="../1_2/installationguide.html">Installation Guide</a></li><li class="none"><a href="../1_2/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="../1_2/userguide.html">User Guide</a></li><li class="none"><a href="../1_2/pojoguide.html">POJO Guide</a></li><li class="none"><a href="../1_2/spring.html">
Spring Guide</a></li><li class="none"><a href="../1_2/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="../1_2/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="../1_1_1/index.html">Version 1.0</a></li><li class="none"><a href="../1_1/index.html">Version 1.0</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></div><div id="menuResources"><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/" class="externalLink" title="External Link">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_2/api/index.html" class="externalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><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="../guidelines.html">Developer Guidelines</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><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" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="none"><a hr
ef="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="External Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_Axis2_Web_Administrator_s_Guide"></a><h2>Apache Axis2 Web Administrator's Guide</h2><p>This document gives you detailed information on the administration console
+of the Apache Axis2 Web application. Apache Axis2 Administration is all about
+configuring Apache Axis2 at run time, where the configuration is
+transient.</p><p><i>Send your feedback to: <a href="mailto:axis-dev@ws.apache.org?subject=[Axis2]">axis-dev@ws.apache.org</a></i>.
+(Subscription details are available on the <a href="http://ws.apache.org/axis2/mail-lists.html" class="externalLink" title="External Link">Axis2 site</a>.) Kindly
+prefix every email subject with [Axis2].</p><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
+ <li><a href="#Intro">Introduction</a>
+ <ul>
+ <li><p><a href="#login">Login into Administration Site</a></p>
+ </li>
+ </ul>
+ </li>
+ <li><a href="#adminoptions">Administration Options</a>
+ <ul>
+ <li><p><a href="#tools">Tools</a></p>
+ <ul>
+ <li><a href="#upservice">Upload Service</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#syscomponents">System components</a></p>
+ <ul>
+ <li><a href="#heading1">Available services</a></li>
+ <li><a href="#servgroups">Available service groups</a></li>
+ <li><a href="#avmodules">Available modules</a></li>
+ <li><a href="#globalmodules">Globally engaged modules</a></li>
+ <li><a href="#phases">Available phases</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#executionchains">Execution chains</a></p>
+ <ul>
+ <li><a href="#globalchains">Global chains</a></li>
+ <li><a href="#operationchains">Operation specific chains</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#engaginmodule">Engage module</a></p>
+ </li>
+ <li><a href="#services">Services</a>
+ <ul>
+ <li><a href="#turnoffservice">Deactivate Service</a></li>
+ <li><a href="#turnonservice">Activate Service</a></li>
+ <li><a href="#editservicepara">Edit service parameters</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#context">Contexts</a></p>
+ <ul>
+ <li><a href="#viewhierarchy">View Hierarchy</a></li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+</ul><p><a name="Intro"></a></p></div><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p>The Apache Axis2 Web application has three main sections: 'Services' lists
+all the available services deployed in this server, 'Validate' checks the
+system to see whether all the required libraries are in place and views the
+system information, and 'Administration' is the Axis2 Web Administration
+module which is the console for administering the Apache Axis2
+installation.</p><p>The Axis2 Web Administration module provides a way to configure Axis2
+dynamically. It's important to note that this dynamic configuration will NOT
+be persistent, i.e., if the servlet container is restarted, then all the
+dynamic configuration changes will be lost.</p><p><a name="login"></a></p></div><div class="subsection"><a name="Log_on_to_the_Administration_Site"></a><h3>Log on to the Administration Site</h3><p>Once Apache Axis2 is successfully installed, the Web application can be
+accessed (see <a href="installationguide.html">Installation Guide</a> for
+instructions). From the <a href="#homepage">Axis2 Web Application Home
+page</a> you can go to the Administration page by clicking the
+'Administration' link. The Login page shown below will appear requesting the
+user name and password. The default user name is 'admin' (without quotes) and
+default password is 'axis2' (without quotes).</p><p align="center"><img alt="" src="images/adminlogin.jpg"></img></p><p>You can change the user name and password values by changing the following
+two parameters in the axis2.xml as required.</p><p align="center"><img alt="" src="images/parameters.jpg"></img></p><p>If the log on is successful, you will see the screen below. This is where
+you can view the configuration and the status of the running system and
+dynamically configure it.</p><p align="center"><img alt="" src="images/admin.jpg"></img></p><p><a name="adminoptions"></a></p></div><div class="subsection"><a name="Administration_Options"></a><h3>Administration Options</h3><ul>
+ <a name="tools"><b>Tools</b></a>
+ <ul>
+ <li><a href="#upservice">Upload Service</a></li>
+ </ul>
+ <a name="syscomponents"><b>System components</b></a>
+ <ul>
+ <li><a href="#heading1">Available services</a></li>
+ <li><a href="#servgroups">Available service groups</a></li>
+ <li><a href="#avmodules">Available modules</a></li>
+ <li><a href="#globalmodules">Globally engaged modules</a></li>
+ <li><a href="#phases">Available phases</a></li>
+ </ul>
+ <a name="executionchains"><b>Execution chains</b></a>
+ <ul>
+ <li><a href="#globalchains">Global chains</a></li>
+ <li><a href="#operationchains">Operation specific chains</a></li>
+ </ul>
+ <b><a href="#engaginmodule">Engage module</a></b> <br></br>
+
+ <ul>
+ <li>For all Services</li>
+ <li>For a Service Group</li>
+ <li>For a Service</li>
+ <li>For an Operation</li>
+ </ul>
+ <a name="services"><b>Services</b></a>
+ <ul>
+ <li><a href="#turnoffservice">Deactivate service</a></li>
+ <li><a href="#turnonservice">Activate service</a></li>
+ <li><a href="#editservicepara">Edit service parameters</a></li>
+ </ul>
+ <a name="context"><b>Contexts</b></a>
+ <ul>
+ <li><a href="#viewhierarchy">View Hierarchy</a></li>
+ </ul>
+</ul><p><a name="homepage"></a></p></div><div class="subsection"><a name="Apache_Axis2_Web_Application_Home_Page"></a><h3>Apache Axis2 Web Application Home Page</h3><p align="center"><strong><img alt="" src="images/clip_image006.jpg"></img></strong></p><p><a name="upservice"></a></p></div><div class="subsection"><a name="Upload_Services"></a><h3>Upload Services</h3><p>You can upload packaged Apache Axis2<em> </em>service archive files using
+this page. This can be done in two simple steps:</p><ul>
+ <li>Browse to the location and select the axisService archive file you wish
+ to upload</li>
+ <li>Then click Upload</li>
+</ul><p align="center"><img alt="" src="images/clip_image010.jpg"></img></p><p><a name="heading1"></a></p></div><div class="subsection"><a name="Available_Services"></a><h3>Available Services</h3><p>The functionality of the 'Available Services' option is almost the same as
+the functionality of the 'Services' option on the Axis2 Web Application Home
+page, where it displays a list of deployed services and their operations. As
+an additional feature, the 'Available Services' page lists details of modules
+that are engaged to the deployed services and their operations on a global,
+service or on an operation level.</p><p>Using the 'Disengage' link, you can disengage the corresponding module as
+long as the module is not globally engaged (i.e., engaged to all the services
+and operations).</p><p>Click on a specific service and it will give you the WSDL file of that
+particular service.</p><p><strong>Faulty services</strong> of this system will also be listed on
+this page. Click on a faulty service to view a page that lists the exception
+stack trace of the exception, which caused the service to be faulty.</p><p align="center"><img alt="" src="images/adminmain.jpg"></img></p><p><a name="servgroups"></a></p></div><div class="subsection"><a name="Available_Service_Groups"></a><h3>Available Service Groups</h3><p>Service group is a logical collection of related services, and the
+'Available Service Groups' link will list all the available service groups in
+the system.</p><p align="center"><img alt="" src="images/servicegroups.jpg"></img></p><p><a name="avmodules"></a></p></div><div class="subsection"><a name="Available_Modules"></a><h3>Available Modules</h3><p>To view the available modules in the 'modules' directory of the
+repository, click 'Available Modules'. This will show you all the available
+modules in the system. Those modules can be engaged dynamically.</p><p align="center"><img alt="" src="images/modules.jpg"></img></p><br></br><p><a name="globalmodules"></a></p></div><div class="subsection"><a name="Globally_Engaged_Modules"></a><h3>Globally Engaged Modules</h3><p>Click the 'Globally Engaged Modules' to view the globally engaged modules,
+if any. If a module is engaged globally, then the handlers that belong to
+that module will be executed irrespective of the service.</p><p><a name="phases"></a></p></div><div class="subsection"><a name="Available_Phases"></a><h3>Available Phases</h3><p>The 'Available Phases' link will display all the available phases. In
+Axis2, there are two levels of phases:</p><ul>
+ <li>System predefined phases (not allowed to be changed)</li>
+ <li>User defined phases</li>
+</ul><p>The main difference between these two levels is that system predefined
+phases will be invoked irrespective of the services, while the user defined
+phases will be invoked when the dispatcher finds the operation. Note that it
+is essential for module developers and service writers to have a good
+understanding of phases and phase ordering.</p><p align="center"><img alt="" src="images/viewphases.jpg"></img></p><br></br><p><a name="globalchains"></a></p></div><div class="subsection"><a name="Global_Chains"></a><h3>Global Chains</h3><p>The 'Global Chains' link will display all the Global Execution Chains. The
+most interesting feature of the Axis2 Web Administration Module is that it
+provides a very basic method of viewing the global phase list and handlers
+inside the phases depending on both the phase and handler orders. This kind
+of information is extremely useful in debugging the system, as there is no
+other way to list out handlers in the global chains. If you engage a new
+module, the new handlers will be added to the global chains and will be
+displayed on this page.</p><p align="center"><img alt="" src="images/globalchain.jpg"></img></p><br></br><p><a name="operationchains"></a></p></div><div class="subsection"><a name="Operation_Specific_Chains"></a><h3>Operation Specific Chains</h3><p>The 'Operation Specific Chains' link can be used to view the handlers
+corresponding to a given service in the same order as it is in the real
+execution chain.</p><p align="center"><img alt="" src="images/select_service_for_handler.jpg"></img></p><br></br><p>Select the service of whose service handlers you wish to view from the
+list, and click 'View' to view the handlers. The page below shows the service
+handlers of the service <em>version</em></p><p align="center"><img alt="" src="images/serviceHandlers.jpg"></img></p><br></br><p><a name="engaginmodule"></a></p></div><div class="subsection"><a name="Engaging_Modules"></a><h3>Engaging Modules</h3><p>The 'Engaging Modules' link allows you to engage modules either globally
+(to all services), to a service group, to a service, or to an operation
+depending on the module implementation. If the module was designed to engage
+the handlers globally, then the handlers in the module can be included in any
+phase in the system. It can be either a system predefined phase or a user
+defined phase.</p><p>On the other hand, if the module was implemented in such a way that it is
+going to be deployed to a service or to an operation, then the module cannot
+be included in any of the <a href="#phases">System Predefined Phases</a>.
+Thus it can only be included in <a href="#phases">User Defined Phases</a>.</p><p>Immediately after engaging the module, you can see the status of the
+engagement indicating whether it is engaged properly or not.</p><p align="center"><img alt="" src="images/moduleengage.jpg"></img></p><p><a name="turnoffservice"></a></p></div><div class="subsection"><a name="Deactivate_Service"></a><h3>Deactivate Service</h3><p>The 'Deactivate Service' link under the 'Services' list will lead to the
+page below. The Deactivate service functionality provides a way to remove
+unnecessary services from the running system, but the removal is
+transient--which means that if you restart the system, the service will be
+active.</p><p>To deactivate a service, select a service from the list, select the
+'Deactivate service' check box, and then click 'Deactivate'.. The 'Clear'
+button will clear the 'Deactivate service' check box.</p><p align="center"><img alt="" src="images/inactivate.jpg"></img></p><br></br><p><a name="turnonservice"></a></p></div><div class="subsection"><a name="Activate_Service"></a><h3>Activate Service</h3><p>The 'Activate Service' link under the 'Services' list will lead to the
+page below. The Activate service functionality provides a way to activate
+services while the system is running, but the activation is transient-- which
+means that if you restart the system, the service will be inactive.</p><p>To activate a service, select a service from the list, select the
+'Activate Service' check box, then click 'Activate'. The 'Clear' button will
+clear the 'Activate service' check box.</p><p align="center"><img alt="" src="images/activate.jpg"></img></p><br></br><p><a name="editservicepara"></a></p></div><div class="subsection"><a name="Edit_Service_Parameters"></a><h3>Edit Service Parameters</h3><p>This functionality provides a way to change the parameters in a service or
+its operations. These changes will be transient too, which means if you
+restart the system, the changes will not be reflected.</p><p>The 'Edit Parameters' link under the 'Services' list (on the navigation
+bar) will link to the page where you can select the services of which you
+want to edit the parameters. Once the service is selected, click 'Edit
+Parameters'.. This will open the page shown below.</p><p align="center"><img alt="" src="images/editserviecpara.jpg"></img></p><br></br><p><a name="viewhierarchy"></a></p></div><div class="subsection"><a name="View_Hierarchy"></a><h3>View Hierarchy</h3><p>By listing the current context hierarchy, the 'View Hierarchy' link
+provides a means to look at the system state at run time. This will list out
+all the available service group contexts, service contexts, operation
+contexts, etc.</p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/axis2/site/1_2/xmlbased-server.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_2/xmlbased-server.html?view=auto&rev=533081
==============================================================================
--- webservices/axis2/site/1_2/xmlbased-server.html (added)
+++ webservices/axis2/site/1_2/xmlbased-server.html Fri Apr 27 05:39:33 2007
@@ -0,0 +1,146 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - Writing Web Services Using Axis2's Primary APIs</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 27 April 2007
+ | Doc for 1.2</div><div class="xright">
+
+ <a href="../index.html">Axis2/Java</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="../index.html">Home</a></li></ul></div><div id="menuDownloads"><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></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="../1_2/contents.html">Version 1.2</a><ul><li class="none"><a href="../1_2/toc.html">Table of Contents</a></li><li class="none"><a href="../1_2/installationguide.html">Installation Guide</a></li><li class="none"><a href="../1_2/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="../1_2/userguide.html">User Guide</a></li><li class="none"><a href="../1_2/pojoguide.html">POJO Guide</a></li><li class="none"><a href="../1_2/spring.html">
Spring Guide</a></li><li class="none"><a href="../1_2/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="../1_2/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="../1_1_1/index.html">Version 1.0</a></li><li class="none"><a href="../1_1/index.html">Version 1.0</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></div><div id="menuResources"><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/" class="externalLink" title="External Link">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_2/api/index.html" class="externalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><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="../guidelines.html">Developer Guidelines</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><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" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="none"><a hr
ef="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="External Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="Writing_Web_Services_Using_Axis2_s_Primary_APIs"></a></p></div><div class="section"><a name="Writing_Web_Services_Using_Apache_Axis2_s_Primary_APIs"></a><h2>Writing Web Services Using Apache Axis2's Primary APIs</h2><p>Apache Axis2 dispatches a component called
+<strong>MessageReceiver</strong> when Receiving a Message to the server.
+Apache Axis2 provides different implementations of this class and it can be
+configured by adding a messageReceiver tag to services.xml. Apache Axis2
+provides an implementation for a class of Message receivers called RawXml
+Message receivers. They work at the XML level and can only handle OMElements
+as parameters. This section explains how to write a service using them.</p><p>In our example, the Web service will have two operations.</p>
+ <div class="source"><pre>public void ping(OMElement element){} //IN-ONLY operation, just accepts the OMElement and does some processing.
+public OMElement echo(OMElement element){}//IN-OUT operation, accepts an OMElement and
+ // sends back the same again
+</pre></div>
+ <p><a name="How_to_write_the_Web_Service_"></a></p><div class="subsection"><a name="How_to_Write_a_Web_Service_"></a><h3>How to Write a Web Service?</h3><p>
+Writing a new Web service with Apache Axis2 involves four steps:
+<ol>
+ <li>Write the Implementation Class.</li>
+ <li>Write a services.xml file to explain the Web service.</li>
+ <li>Create a *.aar archive (Axis Archive) for the Web service.</li>
+ <li>Deploy the Web service.</li>
+</ol><a name="Step1_:Write_the_Implementation_Class"></a></p></div><div class="subsection"><a name="Step1:_Write_the_Implementation_Class"></a><h3>Step1: Write the Implementation Class</h3><p>An implementation class has the business logic for the Web service and
+implements the operations provided by the Web service. Unless you have data
+binding, the signature of the methods can have only one parameter of the type
+OMElement.</p><p>For more details on OMElement see the <a href="http://ws.apache.org/commons/axiom/OMTutorial.html" class="externalLink" title="External Link">OM Tutorial</a>.</p>
+ <div class="source"><pre>public class MyService{
+ public void ping(OMElement element){
+ // Business Logic
+ ......
+ }
+ public OMElement echo(OMElement element){
+ ......
+ }
+}
+</pre></div>
+ <p><a name="Step2_:Write_the_services_xml_file"></a></p></div><div class="subsection"><a name="Step2:_Write_the_services_xml_file"></a><h3>Step2: Write the services.xml file</h3><p>"services.xml" has the configuration for a Web service. Each Web service,
+deployed in Apache Axis2 , must have its configuration in "services.xml". The
+configuration for MyService is as follows:</p>
+ <div class="source"><pre><service >
+ <description>
+ This is a sample Web service with two operations, echo and ping.
+ </description>
+ <parameter name="ServiceClass" locked="false">userguide.example1.MyService</parameter>
+ <operation name="echo">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
+ <actionMapping>urn:echo</actionMapping>
+ </operation>
+ <operation name="ping">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
+ <actionMapping>urn:ping</actionMapping>
+ </operation>
+ </service>
+
+</pre></div>
+ <p>The above XML tags can be explained as follows:</p><p>1. The description of the service class is provided in the description
+tag.</p>
+ <div class="source"><pre><service >
+ <description>
+ This is a sample Web service with two operations, echo and ping.
+ </description>
+
+</pre></div>
+ <p>2. The name of the service class is provided as a parameter.</p>
+ <div class="source"><pre><parameter name="serviceClass" locked="false">userguide.example1.MyService</parameter>
+
+</pre></div>
+ <p>3. The "operation" XML tag describes the operations that are available in
+this service with respective message receivers.</p>
+ <div class="source"><pre> <operation name="echo">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
+ <actionMapping>urn:echo</actionMapping>
+ </operation>
+ <operation name="ping">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
+ <actionMapping>urn:ping</actionMapping>
+ </operation>
+
+</pre></div>
+ <p>4. Every operation must map to a corresponding MessageReceiver class.
+After a message is processed by the handlers, the Axis2 engine hands it over
+to a MessageReceiver.</p><p>5. For the "echo" operation, we have used a
+<strong>RawXMLINOutMessageReceiver</strong> since it is an IN-OUT operation.
+For the IN-ONLY operation "ping", we have used
+<strong>RawXMLINOnlyMessageReceiver</strong> as the message receiver.</p><p>6. The actionMapping is required only if you want to enable WS-Addressing.
+This will be used later in this user guide.</p><p>7. You can write a services.xml file to include a group of services
+instead of a single service. This makes the management and deployment of a
+set of related services very easy. At runtime, you can share information
+between these services within a single interaction using the
+ServiceGroupContext. If you hope to use this functionality, the services.xml
+file should have the following format.</p>
+ <div class="source"><pre><ServiceGroup>
+ <service name="Service1">
+ <!-- details for Service1 -->
+ </service>
+ <service name="Service2">
+ <!-- details for Service2 -->
+ </service>
+ <module ref="ModuleName" />
+ <parameter name="serviceGroupParam1" locked="false">value 1</parameter>
+</serviceGroup>
+
+</pre></div>
+ <p>Note : The name of the service is a compulsory attribute.</p><p><a name="Step3_:Create_the_Web_Service_Archive"></a></p></div><div class="subsection"><a name="Step3:_Create_the_Web_Service_Archive"></a><h3>Step3: Create the Web Service Archive</h3><p>Apache Axis2 uses the ".aar" (Axis Archive) file as the deployment package
+for Web services. Therefore, for MyService we will use "MyService.aar" with
+the "services.xml" packaged in the META-INF in the directory structure shown
+below. Please note that the name of the archive file will be the same as that
+of the service only if the services.xml contains only one service element.</p><p><img src="images/userguide/ServiceItems.jpg" name="Graphic1" align="bottom" width="176" height="91" border="0" alt=""></img></p><p>To create the archive file, you can create a .jar file containing all the
+necessary files and then rename it to a .aar file. This archive file can be
+found in the "Axis2_HOME/samples/userguide" directory. This file has to be
+deployed now.</p><p><a name="Step4_:Deploy_the_Web_Service"></a></p></div><div class="subsection"><a name="Step4:_Deploy_the_Web_Service"></a><h3>Step4: Deploy the Web Service</h3><p>The service can be deployed by dropping the ".aar" file into the
+"services" directory in "/webapps/axis2/WEB-INF" of your servlet container.
+Start the servlet container (if you have not already started), click the link
+"Services" on the <a href="http://localhost:8080/axis2/" class="newWindow" title="New Window" target="_blank">Home
+Page of Axis2 Web Application</a> (http://localhost:8080/axis2) and see
+whether MyService is deployed properly. If you can see the following output,
+then you have successfully deployed MyService on Apache Axis2.
+Congratulations !!</p><p align="center"><img src="images/userguide/MyServiceDeployed.jpg" name="Graphic2" align="bottom" border="0" alt=""></img></p><p>Note: Apache Axis2 provides an easy way to deploy Web services using the
+"Upload Service" tool on the Axis2 Web Application's Administration module.
+Please refer to the <a href="webadminguide.html" class="newWindow" title="New Window" target="_blank">Web
+Administration Guide</a> for more information.</p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org