You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by di...@apache.org on 2006/12/22 05:24:27 UTC
svn commit: r489555 [3/4] - in /webservices/axis2/site/c: ./ docs/
docs/hello/client/ docs/hello/service/
Modified: webservices/axis2/site/c/docs/developerguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/developerguide.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/developerguide.html (original)
+++ webservices/axis2/site/c/docs/developerguide.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../style/maven-base.css");
@import url("../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../docs/index.html">Documentation</a></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_Developer_Guide"></a><h2>Axis2/C Developer Guide</h2><p>Please send your feedback to developer mailing list: <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a> (Please
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../docs/index.html">Documentation</a><ul><li class="none"><a href="../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../docs/userguide.html">User Guide</a></li><li class="none"><a href="../docs/axis2c_manual.html">Axis2/C manual</a>
</li></ul></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_Developer_Guide"></a><h2>Axis2/C Developer Guide</h2><p>Please send your feedback to developer mailing list: <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a> (Please
remember to prefix the subject with [Axis2]). To subscribe to developer
mailing lists see <a href="../mail-lists.html">here</a>.</p><div class="subsection"><a name="Content"></a><h3>Content</h3><p>This guide walks you through the following topics with the aim of helping you get
familiar with the Axis2/C project and its development norms quickly.</p><ul>
Modified: webservices/axis2/site/c/docs/hello/client/hello.c.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/hello/client/hello.c.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/hello/client/hello.c.html (original)
+++ webservices/axis2/site/c/docs/hello/client/hello.c.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../../../style/maven-base.css");
@import url("../../../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../../../index.html">Home</a></li><li class="expanded"><a href="../../../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../../../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../../../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../../../docs/index.html">Documentation</a></li><li class="expanded"><a href="../../../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../../../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../../../team-list.html">Project Information</a><ul><li class="none"><a href="../../../t
eam-list.html">Project Team</a></li><li class="none"><a href="../../../issue-tracking.html">Issue Tracking</a></li></ul></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"><font face="Monospace">
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../../../index.html">Home</a></li><li class="expanded"><a href="../../../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../../../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../../../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../../../docs/index.html">Documentation</a><ul><li class="none"><a href="../../../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../../../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../../../docs/userguide.html">User Guide</a></li><li class="none"><a href
="../../../docs/axis2c_manual.html">Axis2/C manual</a></li></ul></li><li class="expanded"><a href="../../../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../../../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../../../team-list.html">Project Information</a><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></ul></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"><font face="Monospace">
<font color="#808080"><i>/*<br></br>
* Copyright 2004,2005 The Apache Software Foundation.<br></br>
*<br></br>
Modified: webservices/axis2/site/c/docs/hello/service/hello.c.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/hello/service/hello.c.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/hello/service/hello.c.html (original)
+++ webservices/axis2/site/c/docs/hello/service/hello.c.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../../../style/maven-base.css");
@import url("../../../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../../../index.html">Home</a></li><li class="expanded"><a href="../../../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../../../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../../../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../../../docs/index.html">Documentation</a></li><li class="expanded"><a href="../../../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../../../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../../../team-list.html">Project Information</a><ul><li class="none"><a href="../../../t
eam-list.html">Project Team</a></li><li class="none"><a href="../../../issue-tracking.html">Issue Tracking</a></li></ul></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"><font face="Monospace">
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../../../index.html">Home</a></li><li class="expanded"><a href="../../../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../../../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../../../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../../../docs/index.html">Documentation</a><ul><li class="none"><a href="../../../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../../../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../../../docs/userguide.html">User Guide</a></li><li class="none"><a href
="../../../docs/axis2c_manual.html">Axis2/C manual</a></li></ul></li><li class="expanded"><a href="../../../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../../../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../../../team-list.html">Project Information</a><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></ul></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"><font face="Monospace">
<font color="#808080"><i>/*<br></br>
* Copyright 2004,2005 The Apache Software Foundation.<br></br>
*<br></br>
Modified: webservices/axis2/site/c/docs/index.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/index.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/index.html (original)
+++ webservices/axis2/site/c/docs/index.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../style/maven-base.css");
@import url("../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../docs/index.html">Documentation</a></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_Documentation"></a><h2>Axis2/C Documentation</h2><div class="subsection"><a name="Getting_Started"></a><h3>Getting Started</h3><ul>
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../docs/index.html">Documentation</a><ul><li class="none"><a href="../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../docs/userguide.html">User Guide</a></li><li class="none"><a href="../docs/axis2c_manual.html">Axis2/C manual</a>
</li></ul></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_Documentation"></a><h2>Axis2/C Documentation</h2><div class="subsection"><a name="Getting_Started"></a><h3>Getting Started</h3><ul>
<li><a href="installationguide.html">Installation Guide</a></li>
<li><a href="developerguide.html">Developer Guide</a></li>
<li><a href="userguide.html">User Guide</a></li>
Modified: webservices/axis2/site/c/docs/installationguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/installationguide.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/installationguide.html (original)
+++ webservices/axis2/site/c/docs/installationguide.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../style/maven-base.css");
@import url("../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../docs/index.html">Documentation</a></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_Installation_Guide"></a><h2>Axis2/C Installation Guide</h2><p>This document will guide you on how to install Axis2/C and run the server
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../docs/index.html">Documentation</a><ul><li class="none"><a href="../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../docs/userguide.html">User Guide</a></li><li class="none"><a href="../docs/axis2c_manual.html">Axis2/C manual</a>
</li></ul></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_Installation_Guide"></a><h2>Axis2/C Installation Guide</h2><p>This document will guide you on how to install Axis2/C and run the server
and client samples on Linux and Microsoft Windows operating systems.</p><p>This release comes in two forms, source and binary. Instructions are given
below to install using any of those two forms.</p><p>Please send your feedback to the developer mailing list: <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a> (please
remember to prefix the subject with [Axis2]). To subscribe to developer
@@ -468,11 +468,11 @@
<li>Edit Apache2's configuration file (generally httpd.conf) and add
the following directive : -
<pre> LoadModule axis2_module <apache2 modules directory>/mod_axis2.so
+ Axis2RepoPath <axis2 repository path>
+ Axis2LogFile <axis2 log file path>
+ Axis2LogLevel LOG_LEVEL
<Location /axis2>
SetHandler axis2_module
- RepoPath <axis2 repository path>
- LogFile <axis2 log file path>
- Axis2LogLevel LOG_LEVEL
</Location>
</pre>
<p>LOG_LEVEL can be one of following</p>
Modified: webservices/axis2/site/c/docs/om_tutorial.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/om_tutorial.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/om_tutorial.html (original)
+++ webservices/axis2/site/c/docs/om_tutorial.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../style/maven-base.css");
@import url("../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../docs/index.html">Documentation</a></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_OM_Tutorial"></a><h2>Axis2/C OM Tutorial</h2><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../docs/index.html">Documentation</a><ul><li class="none"><a href="../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../docs/userguide.html">User Guide</a></li><li class="none"><a href="../docs/axis2c_manual.html">Axis2/C manual</a>
</li></ul></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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="Axis2_C_OM_Tutorial"></a><h2>Axis2/C OM Tutorial</h2><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
<li><a href="#Introduction">Introduction</a>
<ul>
<li><a href="#What_is_OM">What is OM</a></li>
@@ -475,17 +475,11 @@
<p></p>
<p><b>Code Listing 10</b></p>
</div>
- <div class="source"><pre>#include <axiom_node.h>
-#include <axis2.h>
+ <div class="source"><pre>#include <axiom.h>
+#include <axis2_util.h>
#include <axis2_env.h>
-#include <axiom_element.h>
-#include <axiom_document.h>
-#include <axiom_stax_builder.h>
-#include <axiom_xml_reader.h>
#include <axis2_log_default.h>
#include <axis2_error_default.h>
-#include <axiom_xml_writer.h>
-#include <axiom_output.h>
#include <stdio.h>
FILE *f = NULL;
@@ -512,7 +506,7 @@
env;
}
-build_and_serialize_om(axis2_env_t **env)
+build_and_serialize_om(axis2_env_t *env)
{
axiom_node_t *root_node = NULL;
@@ -535,7 +529,7 @@
om_builder = axiom_stax_builder_create(env, xml_reader);
(!om_builder)
{
- AXIS2_XML_READER_FREE(xml_reader, env);
+ AXIOM_XML_READER_FREE(xml_reader, env);
AXIS2_FAILURE;
}
document = AXIOM_STAX_BUILDER_GET_DOCUMENT(om_builder, env);
@@ -569,7 +563,7 @@
om_output = axiom_output_create(env, xml_writer);
AXIOM_NODE_SERIALIZE(root_node, env, om_output);
- buffer = (axis2_char_t*)AXIS2_XML_WRITER_GET_XML(xml_writer, env);
+ buffer = (axis2_char_t*)AXIOM_XML_WRITER_GET_XML(xml_writer, env);
printf("The output XML is ->>>>\n %s ", buffer);
Modified: webservices/axis2/site/c/docs/userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/c/docs/userguide.html?view=diff&rev=489555&r1=489554&r2=489555
==============================================================================
--- webservices/axis2/site/c/docs/userguide.html (original)
+++ webservices/axis2/site/c/docs/userguide.html Thu Dec 21 20:24:26 2006
@@ -2,8 +2,8 @@
@import url("../style/maven-base.css");
@import url("../style/maven-classic.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/c" id="projectLogo"><img alt="Apache Axis2 C" 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: 11 November 2006
- | Doc for 0.94</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="none"><a href="../docs/index.html">Documentation</a></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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_C_User_s_Guide"></a><h2>Apache Axis2/C User's Guide</h2><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
+ Last published: 22 December 2006
+ | Doc for 0.96</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_C"><h5>Axis2/C</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../download.cgi">Download Axis2/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/c/" class="externalLink" title="External Link">View Source Code Online</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../docs/index.html">Documentation</a><ul><li class="none"><a href="../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../docs/developerguide.html">Developer Guide</a></li><li class="none"><a href="../docs/userguide.html">User Guide</a></li><li class="none"><a href="../docs/axis2c_manual.html">Axis2/C manual</a>
</li></ul></li><li class="expanded"><a href="../mail-lists.html">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><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></ul></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_C_User_s_Guide"></a><h2>Apache Axis2/C User's Guide</h2><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
<li><p><a href="#Introduction">Introduction</a></p>
<ul>
<li><a href="#What_is_Axis2_">What is Axis2/C?</a></li>
@@ -470,5 +470,531 @@
return echo_out;
}
+
+</pre></div>
+ </div><div class="subsection"><a name="echoStringArray"></a><h3>echoStringArray</h3>
+ <div class="source"><pre>
+axis2_echoStringArrayResponse_t*
+axis2_WSDLInteropTestDocLitService_echoStringArray
+ (const axis2_env_t* env ,axis2_echoStringArray_t* param2 )
+
+{
+ axis2_echoStringArray_t* echo_in = param2;
+ axis2_echoStringArrayResponse_t* echo_out = NULL;
+ axis2_ArrayOfstring_literal_t* array_in = NULL;
+ axis2_ArrayOfstring_literal_t* array_out = NULL;
+ char ** string_array = NULL;
+ int string_array_length = 0;
+
+ /* retrieve the array from input*/
+ array_in = AXIS2_ECHOSTRINGARRAY_GET_PARAM0( echo_in, env);
+ /* retrieve the string_array and array length */
+ string_array =
+ AXIS2_ARRAYOFSTRING_LITERAL_GET_STRING
+ (array_in, env,&string_array_length );
+
+ /* create the output array and set the string array and length */
+ array_out = axis2_ArrayOfstring_literal_create ( env );
+ AXIS2_ARRAYOFSTRING_LITERAL_SET_STRING(
+ array_out, env, string_array, string_array_length );
+
+ /* create the response and set the output*/
+ echo_out = axis2_echoStringArrayResponse_create ( env );
+ AXIS2_ECHOSTRINGARRAYRESPONSE_SET_RETURN ( echo_out, env , array_out
+ );
+
+ return echo_out;
+
+</pre></div>
+ </div><div class="subsection"><a name="echoStruct"></a><h3>echoStruct</h3>
+ <div class="source"><pre>
+axis2_echoStructResponse_t*
+axis2_WSDLInteropTestDocLitService_echoStruct
+ (const axis2_env_t* env ,axis2_echoStruct_t* param4 )
+
+{
+ axis2_echoStruct_t* echo_in = param4;
+ axis2_echoStructResponse_t* echo_out = NULL;
+ axis2_SOAPStruct_t* struct_in = NULL;
+ axis2_SOAPStruct_t* struct_out = NULL;
+
+ float float_val = 0;
+ int int_val = 0;
+ char* string_val = NULL;
+
+ /* retrieve the structure from input */
+ struct_in = AXIS2_ECHOSTRUCT_GET_PARAM0( echo_in, env);
+
+ /* retrieve each value from the structure */
+ float_val = AXIS2_SOAPSTRUCT_GET_VARFLOAT ( struct_in, env);
+ int_val = AXIS2_SOAPSTRUCT_GET_VARINT ( struct_in, env);
+ string_val = AXIS2_SOAPSTRUCT_GET_VARSTRING ( struct_in, env);
+
+ /* create the output structure and set values */
+ struct_out = axis2_SOAPStruct_create( env );
+ AXIS2_SOAPSTRUCT_SET_VARFLOAT ( struct_out, env, float_val );
+ AXIS2_SOAPSTRUCT_SET_VARINT ( struct_out, env, int_val );
+ AXIS2_SOAPSTRUCT_SET_VARSTRING ( struct_out, env, string_val );
+
+ /* create the response and set the output structure*/
+ echo_out = axis2_echoStructResponse_create ( env );
+ AXIS2_ECHOSTRUCTRESPONSE_SET_RETURN ( echo_out, env, struct_out );
+
+ return echo_out;
+
+</pre></div>
+ </div><div class="subsection"><a name="services_xml"></a><h3>services.xml</h3><p>
+Axis2 uses "services.xml" to hold the configurations for a particular Web
+service deployed in the Axis2 engine. When we generate the skeleton using the
+WSDL2Java tool, it will generate the required services.xml for this Web
+service as well. This is essential to <a href="#deploy">deploy the
+service</a>. Please refer to the '<a href="#Step3">Write the
+services.xml</a>' section in this guide to learn more about services.xml.
+<a name="deploy"></a></p></div><div class="subsection"><a name="Deploy_the_Web_Service"></a><h3>Deploy the Web Service</h3><p>We simply put our service folder or the ".aar" file to the services
+directory. You need restart the server for the engine to pick this
+service.</p><p><a name="Web_Service_Clients_Using_Axis2"></a></p></div><div class="subsection"><a name="Web_Service_Clients_Using_Axis2_C"></a><h3>Web Service Clients Using Axis2/C</h3><p>Now let's see how we can write a Web service client to consume a Web
+service.</p><p>Web services can be used to provide wide range of functionality to the
+users ranging from simple, less time consuming operations such as
+"getStockQuote" to time consuming business services. When we utilize (invoke
+using client applications) these Web services, we cannot use some simple
+generic invocation paradigm that suits all the timing complexities involved
+in the service operations. For example, if we use a single transport channel
+(such as HTTP) to invoke a Web service with an IN-OUT operation which takes
+a long time to complete, then most of the time we may end up with "connection
+time outs". On the other hand, if there are simultaneous service invocations
+that we need to perform from a single client application, then the use of a
+"blocking" client API will degrade the performance of the client application.
+Similarly, there are various other consequences such as One-Way transports
+that come into play when we need them. Let's try to analyze some common
+service invocation paradigms.</p><p>Many Web service engines provide the users with a Blocking and
+Non-Blocking client APIs.</p><ul>
+ <li><p style="margin-bottom: 0in;"><b>Blocking API</b> -Once the service
+ invocation is called, the client application hangs and only gets control
+ back when the operation completes, after which client receives a response
+ or a fault. This is the simplest way of invoking Web services and it also
+ suits many business situations.</p>
+ </li>
+ <li><b>Non-Blocking API</b>- This is a callback or polling based API.
+ Hence, once a service invocation is called, the client application
+ immediately gets the control back and the response is retrieved using the
+ callback object provided. This approach provides the client application
+ with the flexibility to invoke several Web services simultaneously without
+ blocking the operation that has already been invoked.</li>
+</ul><p>Both these mechanisms work in the API level. Let's name the asynchronous
+behavior that we can get using the <strong>Non-Blocking API</strong> as
+<b>API Level Asynchrony.</b></p><p>Both these mechanisms use single transport connection to send the request
+and to receive the response. They severely lack the capability of using two
+transport connections for the request and the response (either One-Way of
+Two-Way). So both these mechanisms fail to address the problem of long
+running transactions (the transport connection may time-out before the
+operation completes). A possible solution would be to use <strong>two
+separate transport connections for request and response</strong>. The
+asynchronous behavior that we gain using this solution can be called
+<b>Transport Level Asynchrony</b>.</p><p>By combining API Level Asynchrony & Transport Level Asynchrony we can
+obtain four different invocation patterns for Web services as shown in the
+following table.</p><p></p><table class="bodyTable"><tbody>
+ <tr class="a"><td><strong>API (Blocking/Non-Blocking)</strong></td><td><strong> Dual Transports (Yes/No)</strong></td><td><strong>Description</strong></td></tr>
+ <tr class="b"><td>Blocking</td><td>No</td><td>Simplest and the familiar invocation pattern</td></tr>
+ <tr class="a"><td>Non-Blocking</td><td>No</td><td>Using callbacks or polling</td></tr>
+ <tr class="b"><td>Blocking</td><td>Yes</td><td>This is useful when the service operation is IN-OUT in nature but
+ the transport used is One-Way (e.g. SMTP)</td></tr>
+ <tr class="a"><td>Non-Blocking</td><td>Yes</td><td>This can be used to gain the maximum asynchronous behavior. No
+ blocking in the API level and also in the transport level</td></tr>
+ </tbody></table><p>Axis2/C provides the user with all these possibilities to invoke Web
+services.</p><p>Below we describe how to write Web Services Clients using Axis2/C.</p><p><a name="Writing_Web_Service_Clients_using_Axis2%27s_Primary_APIs"></a></p></div><div class="subsection"><a name="Writing_Web_Service_Clients_Using_Axis2_s_Primary_APIs"></a><h3>Writing Web Service Clients Using Axis2's Primary APIs</h3><p><a id="EchoBlockingClient"></a></p></div><div class="subsection"><a name="echo_blocking_Client"></a><h3>echo_blocking Client</h3><p>Axis2/C provides the user with several invocation patterns for Web
+Services, ranging from pure blocking single channel invocations to a
+non-blocking dual channel invocation. Let's first see how we can write a
+client to invoke "echo" operation of "echo" service using the simplest
+blocking invocation. The client code you need to write is as follows.</p>
+ <div class="source"><pre>
+ /* Create EPR with given address */
+endpoint_ref = axis2_endpoint_ref_create(env, address);
+/* Setup options */
+options = axis2_options_create(env);
+AXIS2_OPTIONS_SET_TO(options, env, endpoint_ref);
+/* Set the deploy folder */
+client_home = AXIS2_GETENV("AXIS2C_HOME");
+if (!client_home)
+client_home = "../../deploy";
+/* Create service client */
+svc_client = axis2_svc_client_create(env, client_home);
+ if (!svc_client)
+ {
+ printf("Error creating service client\n");
+ AXIS2_LOG_ERROR(env->log, AXIS2_LOG_SI, "Stub invoke FAILED:
+ Error code:
+% d :: %s", env->error->error_number,
+ AXIS2_ERROR_GET_MESSAGE(env->error));
+ }
+/* Set service client options */
+AXIS2_SVC_CLIENT_SET_OPTIONS(svc_client, env, options); /* Build the
+SOAP request message payload using OM API.*/
+payload = build_om_payload_for_echo_svc(env);
+/* Send request */
+ret_node = AXIS2_SVC_CLIENT_SEND_RECEIVE(svc_client, env, payload);
+/* Print result */
+ if(ret_node)
+ {
+ axis2_char_t *om_str = NULL;
+ om_str = AXIOM_NODE_TO_STRING(ret_node, env);
+ if (om_str)
+ printf("\nReceived OM : %s\n", om_str);
+ printf("\necho client invoke SUCCESSFUL!\n");
+ }
+ else
+ {
+ AXIS2_LOG_ERROR(env->log, AXIS2_LOG_SI, "Stub invoke FAILED: Error code:"
+" %d :: %s", env->error->error_number,
+ AXIS2_ERROR_GET_MESSAGE(env->error));
+ printf("echo client invoke FAILED!\n");
+}
+
+</pre></div>
+ <p>The comments in the above code explains the code. In simple terms, these
+are the steps:</p><ol>
+ <li>Set up the options to be used in the invocation.</li>
+ <li>Create the service client.</li>
+ <li>Set the options to service client.</li>
+ <li>Build the XML payload to be sent out using AXIOM.</li>
+ <li>Send payload and receive result XML as OM.</li>
+ <li>Consume result.</li>
+</ol><p>Options can be used to define the invocation parameters such as target
+endpoint, soap version, addressing parameters, etc. When creating service
+client, the deployment folder has to be passed as a parameter. It is from the
+deploy folder, the configuration is picked up, using the axis2.xml file. The
+send_receive function of the service client sends the XML given as a payload
+to the server side and returns the result received. Basically this is the XML
+in/out model. Once the result is received, the user can consume the result in
+whichever the way(s) he wishes.</p><p><a id="EchoNonBlockingClient"></a></p></div><div class="subsection"><a name="echo_non_blocking_Client"></a><h3>echo_non_blocking Client</h3><p>In the echo_blocking client once the "send_receive" function is called,
+the client is blocked till the operation is completed. This behavior is not
+desirable when there are many Web service invocations to be done in a single
+client application or within a GUI. A solution would be to use a non-blocking
+API to invoke Web services. Axis2/C provides a callback based non-blocking
+API for users.</p><p>A sample client for this can be found under
+"<axis2c_home>/samples/user_guide/clients" with the name
+echo_non_blocking.c. The changes that user may have to do with respect to the
+"echo_blocking" client in order to make it non-blocking, would be as
+follows:</p>
+ <div class="source"><pre>AXIS2_SVC_CLIENT_SEND_RECEIVE_NON_BLOCKING(svc_client, env, payload, callback);
+
+</pre></div>
+ <p>Unlike "send_receive", "send_receive_non_blocking" accepts a callback
+struct in addition to payload. Axis2/C client API provides a callback struct
+with the following associated functions:</p>
+ <div class="source"><pre>
+axis2_status_t (AXIS2_CALL *
+on_complete)(
+ struct axis2_callback *callback,
+ const axis2_env_t *env);
+
+axis2_status_t (AXIS2_CALL *
+on_error)(
+ struct axis2_callback *callback,
+ const axis2_env_t *env,
+ int exception);
+
+axis2_bool_t (AXIS2_CALL *
+get_complete)(
+ struct axis2_callback *callback,
+ const axis2_env_t *env);
+
+</pre></div>
+ <p>The user is expected to implement the "on_complete " and "on_error "
+functions and set them on the callback using the "set_on_complete" and
+"set_on_error" API calls. In the sample, ''on complete'' is implemented by
+"echo_callback_on_complete" function and is set on the callback struct
+created as shown below:</p>
+ <div class="source"><pre>AXIS2_CALLBACK_SET_ON_COMPLETE(callback, echo_callback_on_complete);
+
+</pre></div>
+ <p>Axis2/C engine calls the "on_complete" method once the Web service
+response is received by the Axis2/C client API (that is service_client). This
+will eliminate the blocking nature of the Web service invocations and
+provide the user with the flexibility to use non-blocking API for Web
+service clients.</p><p>Please have a look at the echo_non_blocking.c file located at
+"<axis2c_home>/samples/user_guide/client" for more details.</p><p><a id="EchoNonBlockingDualClient"></a></p></div><div class="subsection"><a name="echo_non_blocking_dual_Client"></a><h3>echo_non_blocking_dual Client</h3><p>The solution provided by the non-blocking API has one limitation when it
+comes to Web service invocations,it takes a long time to complete. The
+limitation is due to the use of a single transport connection to invoke the
+Web service and to retrieve the response. In other words, client API provides
+a non blocking invocation mechanism for the users, but the request and the
+response comes in a single transport (Two-Way transport) connection (like
+HTTP). Long running Web service invocations or Web service invocations using
+One-Way transports (like SMTP) cannot be utilized by simply using a non
+blocking invocation.</p><p>The trivial solution is to use separate transport connections (either
+One-Way or Two-Way) for the request and response. The next problem that needs
+to be solved is the correlation (correlating the request and the response).
+<a href="http://www.w3.org/2002/ws/addr/" class="externalLink" title="External Link">WS-Addressing</a> provides a neat
+solution to this using <wsa:MessageID> and <wsa:RelatesTo>
+headers. Axis2/C provides support for addressing based correlation mechanism
+and a compliant client API to invoke Web services with two transport
+connections.</p><p>Users can select between blocking or non-blocking APIs for the Web service
+clients with two transport connections. By simply using a boolean flag, the
+same API can be used to invoke Web services (IN-OUT operations) using two
+separate transport connections. All you have to do is to set
+"use_separate_listener" to true in options:</p>
+ <div class="source"><pre>AXIS2_OPTIONS_SET_USE_SEPERATE_LISTENER(options, env, AXIS2_TRUE);
+
+</pre></div>
+ <p>In addition to setting the use_separate_listener to true, to use dual
+transports one has to"engage" the addressing module.</p></div><div class="subsection"><a name="Engaging_Addressing_on_Server_Side"></a><h3>Engaging Addressing on Server Side</h3><p>To engage the addressing module simply add a module reference for
+addressing in the "axis2.xml" configuration file. This can be done by adding
+the following line to "axis2.xml" file in the deployment folder.</p>
+ <div class="source"><pre> <module ref="addressing"/>
+
+</pre></div>
+ <p><strong>Note:</strong> Once you modify the "axis2.xml" file you have to restart the server.
+You also have to have the addressing module installed in the modules folder
+of the deployment folder. This is done by default when you make the
+installation.</p></div><div class="subsection"><a name="Engaging_Addressing_on_Client_Side"></a><h3>Engaging Addressing on Client Side</h3><p>There are two ways of doing this:</p><ol>
+ <li>Engage addressing globally. This can be done by following the same
+ steps as done in the case of the server side; add module reference to
+ axis2.xml and have the module installed in the modules folder of the
+ deploy folder.</li>
+ <li>Engage the module on service client using the service_client API.
+ <pre>AXIS2_SVC_CLIENT_ENGAGE_MODULE(svc_client, env, AXIS2_MODULE_ADDRESSING);</pre>
+ </li>
+</ol><p>Once addressing is engaged, echo_non_blocking_dual client would work
+perfectly. Note that by default, Axis2/C comes with addressing enabled
+globally.</p><p><a id="EchoBlockingDualClient"></a></p></div><div class="subsection"><a name="echo_blocking_dual_Client"></a><h3>echo_blocking_dual Client</h3><p>This is again a Two-Way transport request/response client, but this time,
+we use a Blocking API in the client code. Sample code for this can be found
+in the "<axis2c_home>/samples/user_guide/clients/" directory and the
+explanation is similar to the <a href="#EchoNonBlockingDualClient">echo_non_blocking_dual client</a>, except
+that here we do not use a callback object to handle response. This is an extremely
+useful mechanism when the service invocation is IN-OUT in nature and the
+transports are One-Way (e.g. SMTP). For the sample client we use two HTTP
+connections for request and response.</p><p><a id="Writing_Web_Clients_Using_Code_Generator"></a></p></div><div class="subsection"><a name="Writing_Web_Service_Clients_using_Code_Generation_with_Data_Binding_Support"></a><h3>Writing Web Service Clients using Code Generation with Data Binding Support</h3><p>Axis2 code generator provides the data binding support for Web service
+client generation as well. You can generate the required stubs from a given
+WSDL with the other supporting files. Use the following parameters to
+generate the Axis2/C stub code with data binding support. You should have
+<a href="http://svn.apache.org/viewvc/webservices/axis2/trunk/java" class="externalLink" title="External Link">Axis2/Java
+source SVN</a> revision 414253 or later to generate Axis2/C code.</p>
+ <div class="source"><pre>java WSDL2C -uri interoptestdoclitparameters.wsdl -d adb -u
+
+</pre></div>
+ <p>In order to ignore the data binding support (to use XML in/out model),
+just use the following parameters.</p>
+ <div class="source"><pre>java WSDL2C -uri interoptestdoclitparameters.wsdl -d none
+
+</pre></div>
+ <p>The following section demonstrates how to use the generated code using the
+wsdl file "interoptestdoclitparameters.wsdl" to implement the client business
+logic.</p><p><a id="Codegenerator_Client_echoString"></a></p></div><div class="subsection"><a name="Client_for_echoString_operation"></a><h3>Client for echoString operation</h3>
+ <div class="source"><pre>#include "axis2_WSDLInteropTestDocLitService_stub.h"
+/*
+ * demonstrates how to execute the service using databinding */
+void invoke_service_using_databinding ( axis2_stub_t* stub,
+ const axis2_env_t* env );
+int main(int argc, char** argv)
+{
+/* variables to keep the environment */
+ axis2_env_t* env = NULL;
+ axis2_char_t* client_home = NULL;
+ axis2_char_t* endpoint_uri =NULL;
+ axis2_stub_t* stub= NULL;
+ /* endpoint uri: if it is NULL endpoint will be picked from the WSDL */
+ endpoint_uri =
+ "http://localhost:9090/axis2/services/WSDLInteropTestDocLitService";
+ env = axis2_env_create_all( "codegen_utest_blocking.log",
+ AXIS2_LOG_LEVEL_TRACE);
+ /* Set up deploy folder.*/
+ client_home = AXIS2_GETENV("AXIS2C_HOME");
+ if (!client_home)
+ client_home = "../../../deploy";
+ /* create the stub using generated code */
+ stub = axis2_WSDLInteropTestDocLitService_stub_create( env,
+ client_home , endpoint_uri);
+ /* calls the service*/
+ invoke_service_using_databinding ( stub, env );
+ return 0;
+}
+
+void invoke_service_using_databinding ( axis2_stub_t* stub,
+ const axis2_env_t* env )
+ {
+ /* variables used by databinding */
+ axis2_echoString_t* echo_in = NULL;
+ axis2_echoStringResponse_t* echo_out = NULL;
+ /* variables to store data */
+ char* echo_str = "hello";
+ char* return_echo_str = NULL;
+ /* create the input params using databinding */
+ echo_in = axis2_echoString_create( env );
+ AXIS2_ECHOSTRING_SET_PARAM0( echo_in, env, echo_str );
+ /* invoke the web service method*/
+ echo_out = axis2_echoString( stub, env, echo_in );
+ /* return the output params using databinding */
+ return_echo_str = AXIS2_ECHOSTRUCTRESPONSE_GET_RETURN( echo_out, env
+ );
+ /* print the result */
+ printf ( "returned string %s\n", return_echo_str );
+}
+</pre></div>
+ <p><a id="Codegenerator_Client_echoStringArray"></a></p></div><div class="subsection"><a name="Client_for_echoStringArray_operation"></a><h3>Client for echoStringArray operation</h3><p>
+You can change the <code>invoke_service_using_databinding</code> function to
+invoke the echoStringArray operation as follows.
+
+ <div class="source"><pre>void invoke_service_using_databinding ( axis2_stub_t* stub, const
+axis2_env_t* env )
+ {
+ /* variables used by databinding */
+ axis2_echoStringArray_t* echo_in = NULL;
+ axis2_echoStringArrayResponse_t* echo_out = NULL;
+ axis2_ArrayOfstring_literal_t* array_in = NULL;
+ axis2_ArrayOfstring_literal_t* array_out = NULL;
+ /* variables to store data */
+ char *string_array[]= { "test","this","array" };
+ int array_length = 3;
+ char **string_return_string_array = NULL;
+ int return_array_length = 0;
+ int i = 0;
+
+ /*create the input array and set the string array and length*/
+ array_in = axis2_ArrayOfstring_literal_create (env );
+ AXIS2_ARRAYOFSTRING_LITERAL_SET_STRING( array_in, env,
+ string_array, array_length );
+
+ /* create the request and set the inputs */
+ echo_in = axis2_echoStringArray_create ( env );
+ AXIS2_ECHOSTRINGARRAY_SET_PARAM0( echo_in, env, array_in );
+
+ /* invoke the web service method*/
+ echo_out = axis2_echoStringArray( stub, env, echo_in );
+
+ /* return the output params using databinding */
+ array_out = AXIS2_ECHOSTRINGARRAYRESPONSE_GET_RETURN( echo_out, env
+ );
+
+ /* retrieve the string array values and length */
+ string_return_string_array = AXIS2_ARRAYOFSTRING_LITERAL_GET_STRING
+ ( array_out, env, &return_array_length );
+
+ /* print the output */
+ for ( i = 0; i < return_array_length ; i ++ )
+ {
+ printf("value%d: %s \n", i, string_return_string_array[i] );
+ }
+ </pre></div>
+
+
+<a id="Codegenerator_Client_echoStruct"></a></p></div><div class="subsection"><a name="Client_for_echoStruct_operation"></a><h3>Client for echoStruct operation</h3>
+ <div class="source"><pre>void invoke_service_using_databinding ( axis2_stub_t* stub,
+ const axis2_env_t* env )
+ {
+ /* variables used by databinding */
+ axis2_echoStruct_t* echo_in = NULL;
+ axis2_echoStructResponse_t* echo_out = NULL;
+ axis2_SOAPStruct_t* struct_in = NULL;
+ axis2_SOAPStruct_t* struct_out = NULL;
+
+
+ /* variables to store data */
+ float float_val = 11;
+ int int_val = 10;
+ char* string_val = "hello struct";
+ int ret_int_val = 0;
+ float ret_float_val = 0;
+ char* ret_string_val = "";
+
+ /* create the struct and set input values*/
+ struct_in = axis2_SOAPStruct_create( env );
+ AXIS2_SOAPSTRUCT_SET_VARFLOAT ( struct_in, env, float_val );
+ AXIS2_SOAPSTRUCT_SET_VARINT ( struct_in, env, int_val );
+ AXIS2_SOAPSTRUCT_SET_VARSTRING ( struct_in, env, string_val );
+
+ /* create the request and set the struct */
+ echo_in = axis2_echoStruct_create( env );
+ AXIS2_ECHOSTRUCT_SET_PARAM0( echo_in, env, struct_in );
+ /* invoke the web service method */
+ echo_out = axis2_echoStruct( stub, env, echo_in );
+
+ /* retrieve the structure from response */
+ struct_out = AXIS2_ECHOSTRUCTRESPONSE_GET_RETURN( echo_out, env );
+
+ /* retrieve each value from the structure */
+ ret_float_val = AXIS2_SOAPSTRUCT_GET_VARFLOAT ( struct_out, env );
+ ret_int_val = AXIS2_SOAPSTRUCT_GET_VARINT ( struct_out, env );
+ ret_string_val = AXIS2_SOAPSTRUCT_GET_VARSTRING ( struct_out, env );
+
+ /* print the values */
+ printf ( "returned values \n");
+ printf (" float %f\n", ret_float_val );
+ printf (" int %d \n", ret_int_val );
+ printf (" string %s \n", ret_string_val);
+ }
+
+</pre></div>
+ <p><a id="Providing_security_using_Rampart"></a></p></div><div class="subsection"><a name="Providing_Security_using_Rampart_C"></a><h3>Providing Security using Rampart/C</h3><p>Rampart/C is the security module for Axis2/C, which supports UsernameToken
+based authentication and Timestamps as per WS-Security specification. In this
+User's Guide we will explain how to use Rampart inside Axis2/C.</p><p><a id="Engaging_rampart_module"></a></p></div><div class="subsection"><a name="Engaging_rampart_module"></a><h3>Engaging rampart module</h3><ul>
+ <li><b>Step 1:</b> Copy rampart directory created in
+ AXIS2C_HOME/deploy/rampart to AXIS2C_HOME/deploy/modules
+ <pre>cp $AXIS2C_HOME/deploy/rampart/rampart $AXIS2C_HOME/deploy/modules</pre>
+ </li>
+ <li><b>Step 2:</b>Add following line to the axis2.xml under axisconfig.
+ This will engage the rampart module.
+ <pre><module ref="rampart"/></pre>
+ </li>
+ <li><b>Step 3:</b>Then add the following to axis2.xml file to specify
+ In/Out flow parameters. You may find a sample axis2.xml file in
+ rampart/samples/client/echo/data/
+ <p> <parameter name="OutflowSecurity"><action><br></br> <items>UsernameToken Timestamp</items><br></br> <user>Gajaba</user><br></br> <passwordType>passwordDigest</passwordType><br></br> <passwordCallbackClass>/home/gajaba/axis2/c/deploy/rampart/samples/callback/libpwcb.so</passwordCallbackClass><br></br> <timeToLive>360</timeToLive><br></br> </action><br></br> </parameter><br></br> </p>
+ <p class="code"> <parameter name="InflowSecurity"><br></br>
+ <action><br></br> <items>UsernameToken
+ Timestamp</items><br></br>
+ <passwordCallbackClass>/home/gajaba/axis2/c/deploy/rampart/samples/callback/libpwcb.so</passwordCallbackClass><br></br> </action><br></br> </parameter><br></br> </p>
+
+ </li>
+</ul><p><strong>Note:</strong> You must replace the value of
+<code>passwordCallbackClass</code> parameter to suit your settings.</p><p>Now everything is setup to try out the sample. Start axis2 server and run
+the sample under rampart/samples/client/echo. If everything works fine a
+security header should be added to the outgoing SOAP message.</p><p><wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><br></br> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><br></br> <wsse:Username>Gajaba</wsse:Username><br></br> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">WNPznBN3PeLypKYXlwV7w9zJZ9o=</wsse:Password><br></br> <wsse:Nonce>ICAgICAgIDEwNDY0NDk1Mg==</wsse:Nonce><br></br> <wsu:Created>2006-08-28T11:52:27Z</wsu:Created><br></br> </wsse:UsernameToken><br></br> <wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><br></br> <wsu:Created>2006-08-28T11:52:27Z</wsu:Created><br></br> <wsu:Expires>2006-08-28T11:58:27Z</wsu
:Expires><br></br> </wsu:Timestamp><br></br></wsse:Security><br></br></p><p><strong>Note: </strong>For the above sample we have used the same axis2.xml file for
+both server and the client. But in the real world this is not possible. In
+such a situation you can specify a client home as an argument.</p>
+ <div class="source"><pre>./echo [endpoint_url] [path to your client_home]
+
+</pre></div>
+ </div><div class="subsection"><a name="Semantics_of_Parameters_Specified_in_axis2_xml"></a><h3>Semantics of Parameters Specified in axis2.xml</h3><table class="bodyTable"><tbody>
+ <tr class="b"><td><strong>Parameter</strong></td><td><strong>Semantic</strong></td></tr>
+ <tr class="a"><td>items</td><td>Specify the tokens to be used for the credential exchange. In the
+ above example we used both UsernameTokens and Timestamps</td></tr>
+ <tr class="b"><td>user</td><td>The username of the UsernameToken</td></tr>
+ <tr class="a"><td>passwordType</td><td>The way password is delivered. This can be either passwordText or
+ the passwordDigest. The former delivers password in plainText whilst
+ the latter delivers the hashed value of the password. Default is
+ passwordText</td></tr>
+ <tr class="b"><td>passwordCallbackClass</td><td>The module that provides the password for a particular user</td></tr>
+ <tr class="a"><td>timeToLive</td><td>The validity period of the TimestampToken after issuing. The time
+ is in seconds. In the above example, it's 6 minutes. If not
+ specified, the default is 5 minutes</td></tr>
+ </tbody></table><p><a id="Writing_own_password_callback_module"></a></p></div><div class="subsection"><a name="Writing_Your_Own_Password_Callback_Module"></a><h3>Writing Your Own Password Callback Module</h3><p>The Rampart module is not dependent on the way that passwords are stored.
+For example, you may have passwords in a flat file or in a secured database.
+What ever the way, Rampart expects a password callback module to retrieve
+passwords for a given username. The sample coming under
+"<axis2c_home>rampart/samples/callback" is a simple one containing a
+few hard-coded passwords. It assigns a function to the function pointer.</p>
+ <div class="source"><pre>rcb->ops->callback_password = get_sample_password;
+
+</pre></div>
+ <p><code>callback_password</code> is a function pointer to any function which
+has the following signature.</p>
+ <div class="source"><pre>*
+your_function(rampart_callback_t *rcb,
+ const axis2_env_t *env, const axis2_char_t *username)
+
+</pre></div>
+ <p><code>your_function</code> should return the password as
+<code>axis2_char_t</code>* per the username specified, if any. Inside your
+function, you may write your code to supply stored passwords.</p><p>Then the path to the callback module needs to be specified in axis2.xml
+under passwordCallbackClass. [The word Class, instead of Module is only for
+compatibility with java implementation]</p><p><a id="Adding_security_parameters_dynamically"></a></p></div><div class="subsection"><a name="Adding_Security_Parameters_Dynamically"></a><h3>Adding Security Parameters Dynamically</h3><p>Outflow parameters specified in the axis2.xml can be added dynamically in
+the client level. This can be done as shown in the following sample code.</p>
+ <div class="source"><pre> un_property = axis2_property_create(env);
+AXIS2_PROPERTY_SET_VALUE(un_property, env, "Gajaba");
+AXIS2_OPTIONS_SET_PROPERTY(options, env, RAMPART_ACTION_USER, un_property);
+
</pre></div>
- </div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2005-2006, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+ <p>The above code will set the username parameter dynamically. All the values
+specified in the axis2.xml will be overridden by the dynamic settings.</p></div><div class="subsection"><a name="References"></a><h3>References</h3><ul>
+ <li>Introducing Apache Axis2/C - <a href="http://www.wso2.net/articles/axis2/c/2006/09/04/introduction" class="externalLink" title="External Link">http://www.wso2.net/articles/axis2/c/2006/09/04/introduction</a></li>
+ <li>Introducing Rampart/C- <a href="http://www.wso2.net/articles/rampart/c/2006/09/19/introduction" class="externalLink" title="External Link">http://www.wso2.net/articles/rampart/c/2006/09/19/introduction</a></li>
+</ul></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2005-2006, 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