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 sa...@apache.org on 2006/05/15 07:52:12 UTC
svn commit: r406544 [1/2] - in /webservices/axis2/site/c: ./ docs/
Author: samisa
Date: Sun May 14 22:52:10 2006
New Revision: 406544
URL: http://svn.apache.org/viewcvs?rev=406544&view=rev
Log:
Updating the website for 0.91 release
Modified:
webservices/axis2/site/c/coding_conventions.html
webservices/axis2/site/c/cvs-usage.html
webservices/axis2/site/c/dependencies.html
webservices/axis2/site/c/docs/architecture_notes.html
webservices/axis2/site/c/docs/developerguide.html
webservices/axis2/site/c/docs/index.html
webservices/axis2/site/c/docs/installationguide.html
webservices/axis2/site/c/docs/om_tutorial.html
webservices/axis2/site/c/docs/userguide.html
webservices/axis2/site/c/docs/userguide1.html
webservices/axis2/site/c/docs/userguide2.html
webservices/axis2/site/c/docs/userguide3.html
webservices/axis2/site/c/download.html
webservices/axis2/site/c/downloads.html
webservices/axis2/site/c/index.html
webservices/axis2/site/c/issue-tracking.html
webservices/axis2/site/c/mail-lists.html
webservices/axis2/site/c/maven-reports.html
webservices/axis2/site/c/project-info.html
webservices/axis2/site/c/team-list.html
Modified: webservices/axis2/site/c/coding_conventions.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/coding_conventions.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/coding_conventions.html (original)
+++ webservices/axis2/site/c/coding_conventions.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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.or
g/" 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_Coding_Conventions"></a><h2>Axis2/C Coding Conventions</h2><p> </p><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
<li><a href="#1_Naming_conventions_">Naming Conventions</a></li>
<ul>
Modified: webservices/axis2/site/c/cvs-usage.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/cvs-usage.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/cvs-usage.html (original)
+++ webservices/axis2/site/c/cvs-usage.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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.or
g/" 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="Repository"></a><h2>Repository</h2><p>
No SCM repository is defined.
</p></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>
Modified: webservices/axis2/site/c/dependencies.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/dependencies.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/dependencies.html (original)
+++ webservices/axis2/site/c/dependencies.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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.or
g/" 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="Dependencies"></a><h2>Dependencies</h2><p>
There are no dependencies for this project. It is a standalone
application that does not depend on any other project.
Modified: webservices/axis2/site/c/docs/architecture_notes.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/docs/architecture_notes.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/architecture_notes.html (original)
+++ webservices/axis2/site/c/docs/architecture_notes.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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 h
ref="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="C_Specific_Architectural_Notes_on_Axis2_C"></a><h2>C Specific Architectural Notes on Axis2/C</h2><p>Send your feedback to: <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a> (Prefix
the subject with [Axis2]). To subscribe to developer or user mailing lists
see <a href="../mail-lists.html">here</a></p><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
Modified: webservices/axis2/site/c/docs/developerguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/docs/developerguide.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/developerguide.html (original)
+++ webservices/axis2/site/c/docs/developerguide.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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 h
ref="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 that might help you get
Modified: webservices/axis2/site/c/docs/index.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/docs/index.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/index.html (original)
+++ webservices/axis2/site/c/docs/index.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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 h
ref="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>
Modified: webservices/axis2/site/c/docs/installationguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/docs/installationguide.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/installationguide.html (original)
+++ webservices/axis2/site/c/docs/installationguide.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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 h
ref="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
Modified: webservices/axis2/site/c/docs/om_tutorial.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/docs/om_tutorial.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/om_tutorial.html (original)
+++ webservices/axis2/site/c/docs/om_tutorial.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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 h
ref="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>
@@ -367,7 +367,7 @@
the whole object structure at once; it builds only what is required.</p><p>
<table class="bodyTable"><tbody>
- <tr class="b"><td><img src="images/OM005.gif" alt="" width="35" height="57"></img></td><td class="special-td">All iterator implementations internally stay one
+ <tr class="a"><td><img src="images/OM005.gif" alt="" width="35" height="57"></img></td><td class="special-td">All iterator implementations internally stay one
step ahead of their apparent location to provide the correct value
for the HAS_NEXT() function . This hidden advancement can build
elements that are not intended to be built at all.</td><td></td></tr>
@@ -388,7 +388,7 @@
om_output = axis2_om_output_create(env, xml_writer);
AXIS2_SOAP_ENVELOPE_SERIALIZE(envelope, env, om_output);
-buffer = AXIS2_XML_WRITER_GET_XML(xml_writer, env);
+buffer = (axis2_char_t*)AXIS2_XML_WRITER_GET_XML(xml_writer, env);
printf("%s ", buffer);
</pre></div>
@@ -412,8 +412,8 @@
</pre></div>
<p>Note that freing the returned buffer is users responsibility</p><p></p><p><b>Using axis2_xml_reader and axis2_xml_writer</b></p><p>axis2_xml_reader provides three create functions that and can be used for
different xml input sources.</p><p>axis2_xml_reader_create_for_file() functon can be used to read from a
-file.</p><p>axis2_xml_reader_create_for_memory uses a user defined callback function
-to pull xml.</p><p>axis2_xml_reader_create_for_buffer can be used to read from an xml string
+file.</p><p>axis2_xml_reader_create_for_io uses a user defined callback function
+to pull xml.</p><p>axis2_xml_reader_create_for_memory can be used to read from an xml string
that is in a character buffer.</p><p>Similarly xml_writer provides two create functions,</p><p>axis2_xml_writer_create_for_file can be used to write to a file.</p><p>axis2_xml_writer_create_for_memory can be used to write to an internal
memory buffer and obtain the xml string to a charcater buffer as</p><p>the output. Please refer to axis2_xml_reader.h and axis2_xml_writer.h for
more information.</p><p><b>How to avoid memory leaks and double frees when using om</b></p><p>You have to be extremly carefull when using om in order to avoid memory
@@ -493,7 +493,7 @@
axis2_char_t *buffer = NULL;
f = fopen("test.xml","r");
- xml_reader = axis2_xml_reader_create_for_memory(env, read_input_callback,
+ xml_reader = axis2_xml_reader_create_for_io(env, read_input_callback,
close_input_callback, NULL, NULL);
(!xml_reader)
-1;
@@ -530,12 +530,12 @@
}
AXIS2_OM_DOCUMENT_BUILD_ALL(document, env);
- xml_writer = axis2_xml_writer_create_for_memory(env, NULL, AXIS2_TRUE, 0);
+ xml_writer = axis2_xml_writer_create_for_memory(env, NULL, AXIS2_TRUE, 0, AXIS2_XML_PARSER_TYPE_BUFFER);
om_output = axis2_om_output_create(env, xml_writer);
AXIS2_OM_NODE_SERIALIZE(root_node, env, om_output);
- buffer = AXIS2_XML_WRITER_GET_XML(xml_writer, env);
+ buffer = (axis2_char_t*)AXIS2_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/viewcvs/webservices/axis2/site/c/docs/userguide.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/userguide.html (original)
+++ webservices/axis2/site/c/docs/userguide.html Sun May 14 22:52:10 2006
@@ -2,57 +2,600 @@
@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: 31 March 2006
- | Doc for 0.90</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">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 h
ref="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_User_s_Guide"></a><h2>Axis2/C User's Guide</h2><p>Pages: <b>Content</b>, <a href="userguide1.html">1</a>, <a href="userguide2.html">2</a>, <a href="userguide3.html">3</a></p><div class="subsection"><a name="Content"></a><h3>Content</h3><ul>
- <li>
- <p><a href="userguide1.html#Introduction">Introduction</a></p>
+ Last published: 15 May 2006
+ | Doc for 0.90</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">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 h
ref="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_User_s_Guide"></a><h2>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="userguide1.html#Attention">Attention</a></li>
- <li><a href="userguide1.html#What_is_Axis2_">What is Axis2/C?</a></li>
+ <li><a href="#What_is_Axis2_">What is Axis2/C?</a></li>
</ul>
</li>
- <li>
- <p><a href="userguide2.html#Web_Service_Clients_Using_Axis2">Web
-Service Clients Using Axis2/C</a></p>
+ <li><a href="#Web_Services_Using_Axis2">Web Services Using Axis2/C</a>
<ul>
- <li><a href="userguide2.html#Writing_Web_Service_Clients_using_Axis2%27s_Primary_APIs">Writing
-Web Service Clients Using Axis2's Primary APIs</a></li>
- <ul>
- <li><a href="userguide2.html#EchoBlockingClient">EchoBlockingClient</a></li>
- <li><a href="userguide2.html#Request_SOAP_Message">Request SOAP
-Message</a></li>
- <li><a href="userguide2.html#Response_SOAP_Message">Response
-SOAP Message</a></li>
- </ul>
- </ul>
- </li>
- <li>
- <p><a href="userguide3.html#Web_Services_Using_Axis2">Web Services
-Using Axis2/C</a></p>
- <ul>
- <li><a href="userguide3.html#Conventions">Conventions used in the
-document</a></li>
- <li><a href="userguide3.html#Writing_Web_Services_Using%20Axis2_C">Writing
-Web Services Using Axis2/C</a>
+ <li><a href="#Writing_Web_Services_Using%20Axis2_C">Writing Web
+ Services Using Axis2/C</a>
<ul>
- <li><a href="userguide3.html#Creating_Web_Service__MyService_">Creating
-Web Service (Echo service)</a></li>
- <li><a href="userguide3.html#How_to_write_the_Web_Service_">How
-to write the Web Service?</a>
+ <li><a href="#Creating_Web_Service__MyService_">Creating Web
+ Service (Echo service)</a></li>
+ <li><a href="#How_to_write_the_Web_Service_">How to write the Web
+ Service?</a>
<ul>
- <li><a href="userguide3.html#Step1">Step1 :Write the
-echo_skeleton.c file implementing the axis2_svc_skeleton.h</a></li>
- <li><a href="userguide3.html#Step2">Step2 : Now we can
-write the echo service in a file echo.c</a></li>
- <li><a href="userguide3.html#Step3">Step3 :Write the
-services.xml file</a></li>
- <li><a href="userguide3.html#Step4">Step4 :Create the
-WebService Folder in services folder.</a></li>
+ <li><a href="#Step1">Step1 :Write the echo_skeleton.c file
+ implementing the axis2_svc_skeleton.h</a></li>
+ <li><a href="#Step2">Step2 : Now we can write the echo service
+ in a file echo.c</a></li>
+ <li><a href="#Step3">Step3 :Write the services.xml file</a></li>
+ <li><a href="#Step4">Step4 :Create the WebService Folder in
+ services folder.</a></li>
</ul>
</li>
</ul>
</li>
- <li><a href="userguide3.html#deploy">Deploy the Web Service</a></li>
+ <li><a href="#deploy">Deploy the Web Service</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#Web_Service_Clients_Using_Axis2">Web Service Clients Using
+ Axis2/C</a></p>
+ <ul>
+ <li><a href="#Writing_Web_Service_Clients_using_Axis2%27s_Primary_APIs">Writing
+ Web Service Clients Using Axis2's Primary APIs</a>
+ <ul>
+ <li><a href="#EchoBlockingClient">echo_blocking Client</a></li>
+ <li><a href="#EchoNonBlockingClient">echo_non_blocking
+ Client</a></li>
+ <li><a href="#EchoNonBlockingDualClient">echo_non_blocking_dual
+ Client</a></li>
+ <li><a href="#EchoBlockingDualClient">echo_blocking_dual
+ Client</a></li>
+ </ul>
+ </li>
</ul>
</li>
-</ul><p><a href="userguide1.html">Next Page <img src="images/arrow_right.gif" alt=""></img></a></p><p>Pages: <b>Content</b>, <a href="userguide1.html">1</a>, <a href="userguide2.html">2</a>, <a href="userguide3.html">3</a></p></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
+</ul></div><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p>Welcome to Axis2/C, the Apache Axis2 implemented in C. This User's Guide
+will help you to understand what Axis2/C has to offer and how to get started
+with it.</p></div><div class="subsection"><a name="What_is_Axis2_C_"></a><h3>What is Axis2/C?</h3><p>Axis2/C is an effort to implement the Axis2 architecture in C programming
+language.</p><p>After months of continued discussion and coding in this direction, Axis2/C
+now delivers the following key features:</p><ul>
+ <li><p style="margin-bottom: 0in;"><strong>Speed</strong> - Axis2/C uses
+ its own XML object model and StAX (Streaming API for XML) parsing to
+ achieve significant speed. In addition to that, Axis2/C is inherently
+ benefited by the speed of its implementation language, namely C, compared
+ to the Java implementation.</p>
+ </li>
+ <li><p style="margin-bottom: 0in;"><strong>Low memory foot print</strong>-
+ Axis2 architecture was designed ground-up keeping the low memory foot
+ print in mind. Axis2/C strives to achieve the same with a well designed
+ memory management strategy.</p>
+ </li>
+ <li><p style="margin-bottom: 0in;"><strong>AXIOM/C</strong> Axis2/C comes
+ with its own light-weight object model for XML, AXIOM/C which is the C
+ implementation of <a href="http://ws.apache.org/commons/axiom/OMTutorial.html" class="externalLink" title="External Link">AXIOM</a>.</p>
+ </li>
+ <li><p style="margin-bottom: 0in;"><strong>MEP Support</strong> - Support
+ Message Exchange Patterns (MEP s)</p>
+ </li>
+ <li><p style="margin-bottom: 0in;"><strong>Flexibility</strong> - The
+ Axis2/C architecture gives the developer complete freedom to insert
+ extensions into the engine (using modules and handlers) for custom SOAP
+ header processing.</p>
+ </li>
+ <li><p style="margin-bottom: 0in;"><strong>Transport Framework</strong> -
+ We have a clean and simple abstraction for integrating and using
+ transports and the core of the engine is completely
+ transport-independent.</p>
+ </li>
+ <li><p style="margin-bottom: 0in;"><strong>Composition and
+ Extensibility</strong> - modules and phases improve support for
+ composability and extensibility. Modules supports composability and is
+ able to add support for new WS-* specifications in a simple and clean
+ manner. They are however not hot deployable as they change the overall
+ behavior of the system.</p>
+ </li>
+</ul><p>Axis2/C team is working hard to continuously improve the implementation.
+Please note that this is an open-source effort. If you feel you have some
+time to spare, please get involved and lend us a hand! The Axis2/C developer
+community welcomes your participation and contributions.</p><p>Let us know what you think! Please send your feedback on Axis2/C to "<a href="mailto:axis-user@ws.apache.org">axis-c-user@ws.apache.org</a>" and
+please remember to prefix the subject of the mail with [Axis2].</p><p>The following sections will guide through how to write web service clients
+and services.</p><p></p><p>Web Services Using Axis2/C</p><p>Before starting, please make sure that you have installed Axis2/C
+correctly and check whether you can run the axis2_http_server located in
+AXIS2C_HOME/bin . (See <a href="installationguide.html">Installation
+Guide</a>).</p><p><a id="Writing_Web_Services_Using_Axis2_C"></a></p></div><div class="subsection"><a name="Writing_Web_Services_Using_Axis2_C"></a><h3>Writing Web Services Using Axis2/C</h3></div><div class="subsection"><a name="Creating_Web_Service__Echo_service_"></a><h3>Creating Web Service (Echo service)</h3><p>First let's see how we can write a simple Web Service (echo service) using
+Axis2/C's primary interfaces and deploy it. For this purpose we will create a
+Web Service with one operation as follows.</p>
+ <div class="source"><pre>axis2_om_node_t* axis2_echo_echo(axis2_om_node_t *echo_node){}
+
+</pre></div>
+ <p>You can have a peek at the complete source code for this example echo
+service located in the "AXIS2C_HOME/samples/server/echo" directory .</p></div><div class="subsection"><a name="How_to_write_the_Web_Service_"></a><h3>How to write the Web Service?</h3><p>Writing a new Web Service with Axis2/C involve four steps.</p><p>(eg . echo service )</p><ol>
+ <li><p style="margin-bottom: 0in;">Write a echo_skeleton.c file which
+ implements the API given in axis2_svc_skeleton.h header file.</p>
+ </li>
+ <li>Write the service implementation source file (in this case echo.c
+ service) which implements the actual business logic.</li>
+ <li>Write a services.xml file to explain the Web Service.</li>
+ <li>Create a folder with the service name under AXIS2C_HOME/services and
+ put the compiled service ( .dll or .so file) for the Web Service and
+ services.xml file in to that folder</li>
+</ol><p><a id="Step1"></a></p></div><div class="subsection"><a name="Step1_:Write_the_echo_skeleton_c_file_implementing_the_axis2_svc_skeleton_h"></a><h3>Step1 :Write the echo_skeleton.c file implementing the axis2_svc_skeleton.h</h3><p>axis2_svc_skeleton.h header file has the axis2_svc_skeleton_ops_t
+operations struct which defines four function pointers to be implemented and
+assigned by a service skeleton.</p><p>They are:-</p>
+ <div class="source"><pre>int (AXIS2_CALL * init) (axis2_svc_skeleton_t *svc_skeleton,
+ axis2_env_t **env);
+
+axis2_om_node_t * (AXIS2_CALL* invoke)(axis2_svc_skeleton_t *svc_skeli,
+ axis2_env_t **env, axis2_om_node_t *node);
+
+axis2_om_node_t *(AXIS2_CALL* on_fault)(axis2_svc_skeleton_t *svc_skeli,
+ axis2_env_t **env, axis2_om_node_t *node);
+
+int (AXIS2_CALL *free)(axis2_svc_skeleton_t *svc_skeli,
+ axis2_env_t **env);
+
+</pre></div>
+ <p>Lets implement the above functions for echo service.</p><p><i>/* Initialize the service */</i><br></br>
+int AXIS2_CALL<br></br>
+echo_init(axis2_svc_skeleton_t *svc_skeleton,<br></br>
+ axis2_env_t **env)<br></br>
+{<br></br>
+ svc_skeleton->func_array = axis2_array_list_create(env, 0);<br></br>
+ <i>/* Add the implemented operation names of the service to <br></br>
+ * the array list of functions <br></br>
+ */</i><br></br>
+ AXIS2_ARRAY_LIST_ADD(svc_skeleton->func_array, env, "echoString");<br></br>
+ <i>/* Any initialization stuff of echo service should go here */</i><br></br>
+ <b>return</b> AXIS2_SUCCESS;<br></br>
+}<br></br>
+<br></br>
+<i>/*<br></br>
+ * This method invokes the right service method <br></br>
+ */</i><br></br>
+axis2_om_node_t* AXIS2_CALL<br></br>
+echo_invoke(axis2_svc_skeleton_t *svc_skeleton,<br></br>
+ axis2_env_t **env,<br></br>
+ axis2_om_node_t *node)<br></br>
+{<br></br>
+ <i>/* Invoke the business logic.<br></br>
+ * Depending on the function name invoke the correct impl method.<br></br>
+ * We have only echo in this sample, hence invoke echo method.<br></br>
+ * To see how to deal with multiple impl methods, have a look at the<br></br>
+ * math sample.<br></br>
+ */</i><br></br>
+ <b>return</b> axis2_echo_echo(env, node);<br></br>
+}<br></br>
+<br></br>
+<i>/* On fault, handle the fault */</i><br></br>
+axis2_om_node_t* AXIS2_CALL<br></br>
+echo_on_fault(axis2_svc_skeleton_t *svc_skeli, <br></br>
+ axis2_env_t **env, axis2_om_node_t *node)<br></br>
+{<br></br>
+ <i>/* Here we are just setting a simple error message inside an element <br></br>
+ * called 'EchoServiceError' <br></br>
+ */</i><br></br>
+ axis2_om_node_t *error_node = NULL;<br></br>
+ axis2_om_node_t* text_node = NULL;<br></br>
+ axis2_om_element_t *error_ele = NULL;<br></br>
+ error_ele = axis2_om_element_create(env, node, "EchoServiceError", NULL, <br></br>
+ &error_node);<br></br>
+ AXIS2_OM_ELEMENT_SET_TEXT(error_ele, env, "Echo service failed ", <br></br>
+ text_node);<br></br>
+ <b>return</b> error_node;<br></br>
+}<br></br>
+<br></br>
+<i>/* Free the resources used */</i><br></br>
+int AXIS2_CALL<br></br>
+echo_free(axis2_svc_skeleton_t *svc_skeleton,<br></br>
+ axis2_env_t **env)<br></br>
+{<br></br>
+ <i>/* Free the function array */</i><br></br>
+ <b>if</b>(svc_skeleton->func_array)<br></br>
+ {<br></br>
+ AXIS2_ARRAY_LIST_FREE(svc_skeleton->func_array, env);<br></br>
+ svc_skeleton->func_array = NULL;<br></br>
+ }<br></br>
+ <br></br>
+ <i>/* Free the function array */</i><br></br>
+ <b>if</b>(svc_skeleton->ops)<br></br>
+ {<br></br>
+ AXIS2_FREE((*env)->allocator, svc_skeleton->ops);<br></br>
+ svc_skeleton->ops = NULL;<br></br>
+ }<br></br>
+ <br></br>
+ <i>/* Free the service skeleton */</i><br></br>
+ <b>if</b>(svc_skeleton)<br></br>
+ {<br></br>
+ AXIS2_FREE((*env)->allocator, svc_skeleton);<br></br>
+ svc_skeleton = NULL;<br></br>
+ }<br></br>
+<br></br>
+ <b>return</b> AXIS2_SUCCESS; <br></br>
+}<br></br>
+</p><p>Now we can write the create function of the echo_service_skeleton as<br></br>
+follows.</p><p><i>/*Create function */<br></br>
+</i> axis2_svc_skeleton_t *<br></br>
+axis2_echo_create(axis2_env_t **env)<br></br>
+{<br></br>
+ axis2_svc_skeleton_t *svc_skeleton = NULL;<br></br>
+ <i>/* Allocate memory for the structs */</i><br></br>
+ svc_skeleton = AXIS2_MALLOC((*env)->allocator, <br></br>
+ <b>sizeof</b>(axis2_svc_skeleton_t));<br></br>
+<br></br>
+ svc_skeleton->ops = AXIS2_MALLOC(<br></br>
+ (*env)->allocator, <b>sizeof</b>(axis2_svc_skeleton_ops_t));<br></br>
+<br></br>
+ <i>/* Assign function pointers */</i><br></br>
+ svc_skeleton->ops->free = echo_free;<br></br>
+ svc_skeleton->ops->init = echo_init;<br></br>
+ svc_skeleton->ops->invoke = echo_invoke;<br></br>
+ svc_skeleton->ops->on_fault = echo_on_fault;<br></br>
+<br></br>
+ <b>return</b> svc_skeleton;<br></br>
+}</p><p></p><p>In addition to the above functions every service must have the following
+two functions with exactly the same function signature as in xxx_skeleton.c
+file.</p><p><br></br>
+</p><p>AXIS2_EXPORT int <br></br>
+axis2_get_instance(axis2_svc_skeleton_t **inst,<br></br>
+ axis2_env_t **env)<br></br>
+{<br></br>
+ *inst = axis2_echo_create(env);<br></br>
+ <b>if</b>(!(*inst))<br></br>
+ {<br></br>
+ <b>return</b> AXIS2_FAILURE;<br></br>
+ }<br></br>
+ <b>return</b> AXIS2_SUCCESS;<br></br>
+}<br></br>
+<br></br>
+AXIS2_EXPORT int <br></br>
+axis2_remove_instance(axis2_svc_skeleton_t *inst,<br></br>
+ axis2_env_t **env)<br></br>
+{<br></br>
+ axis2_status_t status = AXIS2_FAILURE;<br></br>
+ <b>if</b> (inst)<br></br>
+ {<br></br>
+ status = AXIS2_SVC_SKELETON_FREE(inst, env);<br></br>
+ }<br></br>
+ <b>return</b> status;<br></br>
+}<br></br>
+</p><p>Axis2/C engine can load the service dll, however, it needs to know which
+method to call. Since C does not have reflection, we need to have some dll
+exposed functions known to Axis2/C engine. <b>axis2_get_instance</b> and
+<b>axis2_remove_instance</b> are the two functions that need to be exposed
+from a service dll (or any other dll of Axis2/C engine). Axis2/C engine calls
+axis2_get_instance method, which creates a new service instance, and cast the
+return pointer to axis2_svc_skeleton interface.Then the interface methods can
+be called by Axis2/C engine.</p><p><a id="Step2"></a></p></div><div class="subsection"><a name="Step2_:_Now_we_can_write_the_echo_service_in_a_file_echo_c"></a><h3>Step2 : Now we can write the echo service in a file echo.c</h3><p><a id="Step3">axis2_om_node_t *<br></br>
+axis2_echo_echo (axis2_env_t **env, axis2_om_node_t *node)<br></br>
+{<br></br>
+ axis2_om_node_t *text_parent_node = NULL;<br></br>
+ axis2_om_node_t *text_node = NULL;<br></br>
+ axis2_om_node_t *ret_node = NULL;<br></br>
+<br></br>
+ AXIS2_ENV_CHECK(env, NULL);<br></br>
+ <br></br>
+ <i>/* Expected request format is :-<br></br>
+ * <ns1:echoString xmlns:ns1="http://localhost:9090/axis2/services/echo"><br></br>
+ * <text>echo5</text><br></br>
+ * </ns1:echoString><br></br>
+ */</i><br></br>
+ <b>if</b> (!node) <i>/* 'echoString' node */</i><br></br>
+ {<br></br>
+ AXIS2_ERROR_SET((*env)->error, AXIS2_ERROR_SVC_SKEL_INPUT_OM_NODE_NULL, AXIS2_FAILURE);<br></br>
+ printf("Echo client ERROR: input parameter NULL\n");<br></br>
+ <b>return</b> NULL;<br></br>
+ }<br></br>
+<br></br>
+ text_parent_node = AXIS2_OM_NODE_GET_FIRST_CHILD(node, env);<br></br>
+ <b>if</b> (!text_parent_node) <i>/* 'text' node */</i><br></br>
+ {<br></br>
+ AXIS2_ERROR_SET((*env)->error, AXIS2_ERROR_SVC_SKEL_INVALID_XML_FORMAT_IN_REQUEST, AXIS2_FAILURE);<br></br>
+ printf("Echo client ERROR: invalid XML in request\n");<br></br>
+ <b>return</b> NULL;<br></br>
+ }<br></br>
+ <br></br>
+ text_node = AXIS2_OM_NODE_GET_FIRST_CHILD(text_parent_node, env);<br></br>
+ <b>if</b> (!text_node) <i>/* actual text to echo */</i><br></br>
+ {<br></br>
+ AXIS2_ERROR_SET((*env)->error, AXIS2_ERROR_SVC_SKEL_INVALID_XML_FORMAT_IN_REQUEST, AXIS2_FAILURE);<br></br>
+ printf("Echo client ERROR: invalid XML in request\n");<br></br>
+ <b>return</b> NULL;<br></br>
+ }<br></br>
+ <br></br>
+ <b>if</b> (AXIS2_OM_NODE_GET_NODE_TYPE(text_node, env) == AXIS2_OM_TEXT)<br></br>
+ {<br></br>
+ axis2_om_text_t *text = (axis2_om_text_t *)AXIS2_OM_NODE_GET_DATA_ELEMENT(text_node, env);<br></br>
+ <b>if</b>( text && AXIS2_OM_TEXT_GET_VALUE(text , env))<br></br>
+ {<br></br>
+ axis2_char_t *text_str = AXIS2_OM_TEXT_GET_VALUE(text, env);<br></br>
+ printf("Echoing text value %s \n", text_str);<br></br>
+ ret_node = build_om_programatically(env, text_str);<br></br>
+ }<br></br>
+ }<br></br>
+ <b>else</b><br></br>
+ {<br></br>
+ AXIS2_ERROR_SET((*env)->error, AXIS2_ERROR_SVC_SKEL_INVALID_XML_FORMAT_IN_REQUEST, AXIS2_FAILURE);<br></br>
+ printf("Echo client ERROR: invalid XML in request\n");<br></br>
+ <b>return</b> NULL;<br></br>
+ }<br></br>
+ <br></br>
+ <b>return</b> ret_node;<br></br>
+}<br></br>
+<br></br>
+<i>/* Builds the response content */</i><br></br>
+axis2_om_node_t *<br></br>
+build_om_programatically(axis2_env_t **env, axis2_char_t *text)<br></br>
+{<br></br>
+ axis2_om_node_t *echo_om_node = NULL;<br></br>
+ axis2_om_element_t* echo_om_ele = NULL;<br></br>
+ axis2_om_node_t* text_om_node = NULL;<br></br>
+ axis2_om_element_t * text_om_ele = NULL;<br></br>
+ axis2_om_namespace_t *ns1 = NULL;<br></br>
+ <br></br>
+ ns1 = axis2_om_namespace_create (env, "http://localhost:9090/axis2/services/echo", "ns1");<br></br>
+<br></br>
+ echo_om_ele = axis2_om_element_create(env, NULL, "echoString", ns1, &echo_om_node);<br></br>
+ <br></br>
+ text_om_ele = axis2_om_element_create(env, echo_om_node, "text", NULL, &text_om_node);<br></br>
+<br></br>
+ AXIS2_OM_ELEMENT_SET_TEXT(text_om_ele, env, text, text_om_node);<br></br>
+ <br></br>
+ <b>return</b> echo_om_node;<br></br>
+}<br></br>
+</a></p></div><div class="subsection"><a name="Step3_:Write_the_services_xml_file"></a><h3>Step3 :Write the services.xml file</h3><p>Axis2/C uses "services.xml" to keep configurations for a Web Service. Each
+Web Service deployed in Axis2/C needs a "services.xml" containing the
+configurations. Note that services.xml has the same semantics as Axis2 Java's
+services.xml file. Only difference is that for class attributes instead of
+giving package qualified class name, we use dll name. services.xml for echo
+will be as follows.</p>
+ <div class="source"><pre><service name="echo">
+ <parameter name="ServiceClass" locked="xsd:false">echo</parameter>
+ <description>
+ This is a echo service
+ </description>
+
+ <operation name="echoString">
+ <parameter name="wsamapping">
+ http://localhost:9090/axis2/services/echo/echoString
+ </parameter>
+ </operation>
+</service>
+
+</pre></div>
+ <p><em></em></p><p>Name of the service will be the name of the Folder with the shared library
+and the services.xml , in this example case we will have a folder named echo
+in which we have the echo.dll (or libecho.so on Linux platform) and
+services.xml file.</p><p>You can write a services.xml file to include a group of services instead
+of a single service. This makes 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 axis2_svc_grp_ctx (Service
+Group Context ). If you hope to use this functionality, the services.xml file
+should have following format.<br></br>
+</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 : name of the service is a compulsory attribute</p><p><a id="Step4"></a></p></div><div class="subsection"><a name="Step4_:Create_the_Web_Service_Folder_in_services_folder_of_the_repository_"></a><h3>Step4 :Create the Web Service Folder in services folder of the repository.</h3><p>In Axis2/C , it is required to create a folder with the corresponding
+service/service group name which will contain the shared library (compiled
+service) and the services.xml file which describe the web service. So in this
+example case we will have a folder named echo which contain the services,xml
+file and echo dll.</p><p><a id="deploy"></a></p></div><div class="subsection"><a name="Deploy_the_Web_Service"></a><h3>Deploy the Web Service</h3><p>Deploying the service means putting the service folder to the services
+directory. At the moment the server has to be restarted for the service to be
+deployed since hot deployment has not yet been implemented.</p><p><a id="Web_Service_Clients_Using_Axis2"></a></p></div><div class="subsection"><a name="Web_Service_Clients_UsingAxis2_C"></a><h3>Web Service Clients UsingAxis2/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 Service we cannot use some simple
+generic invocation paradigm that suites 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 that take
+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 in to 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
+ suites 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 flexibility to the client
+ application to invoke several Web Services simultaneously without
+ blocking the operation already 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 lags 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><a id="table1"></a></p><table class="bodyTable"><tbody>
+ <tr class="b"><td><strong>API (Blocking/Non-Blocking)</strong></td><td><strong> Dual Transports (Yes/No)</strong></td><td><strong>Description</strong></td></tr>
+ <tr class="a"><td>Blocking</td><td>No</td><td>Simplest and the familiar invocation pattern</td></tr>
+ <tr class="b"><td>Non-Blocking</td><td>No</td><td>Using callbacks or polling</td></tr>
+ <tr class="a"><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="b"><td>Non-Blocking</td><td>Yes</td><td>This is 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 id="Writing_Web_Service_Clients_using_Axis2's_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 invocations. 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>
+
+ endpoint_ref = axis2_endpoint_ref_create(&env, address);
+
+
+ options = axis2_options_create(&env);
+ AXIS2_OPTIONS_SET_TO(options, &env, endpoint_ref);
+
+
+ client_home = AXIS2_GETENV("AXIS2C_HOME");
+ if (!client_home)
+ client_home = "../../deploy";
+
+
+ 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));
+ }
+
+
+ AXIS2_SVC_CLIENT_SET_OPTIONS(svc_client, &env, options);
+
+
+ payload = build_om_payload_for_echo_svc(&env);
+
+
+ ret_node = AXIS2_SVC_CLIENT_SEND_RECEIVE(svc_client, &env, payload);
+
+
+ if(ret_node)
+ {
+ axis2_char_t *om_str = NULL;
+ om_str = AXIS2_OM_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 OM.</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 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
+"Axis2CHome/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 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,
+ axis2_env_t **env);
+
+axis2_status_t (AXIS2_CALL *
+on_error)(
+ struct axis2_callback *callback,
+ axis2_env_t **env,
+ int exception);
+
+axis2_bool_t (AXIS2_CALL *
+get_complete)(
+ struct axis2_callback *callback,
+ 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 provides 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 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 which takes long time to complete. The
+limitation is due to the use of 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 that 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" 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 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>Note: 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 that. <br></br>
+One way is to engage addressing globally. This can be done by following the
+same steps as done in the case of the server side, add module ref to
+axis2.xml and have the module installed in the modules folder of the deploy
+folder.</p><p>The second method is to engage the module on service client using the
+service_client API.</p>
+ <div class="source"><pre>AXIS2_SVC_CLIENT_ENGAGE_MODULE(svc_client, &env, AXIS2_MODULE_ADDRESSING);
+
+</pre></div>
+ <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 "Axis2CHome/samples/user_guide/clients/" directory and the explanation
+is similar to the <a href="#EchoNonBlockingDualClient">EchoNonBlockingDualClient</a>, except that
+here we do not use a callback object to handle response. This is a very
+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></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
Modified: webservices/axis2/site/c/docs/userguide1.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/docs/userguide1.html?rev=406544&r1=406543&r2=406544&view=diff
==============================================================================
--- webservices/axis2/site/c/docs/userguide1.html (original)
+++ webservices/axis2/site/c/docs/userguide1.html Sun May 14 22:52:10 2006
@@ -2,7 +2,7 @@
@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: 31 March 2006
+ Last published: 15 May 2006
| Doc for 0.90</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">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 h
ref="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_User_s_Guide"></a><h2>Axis2/C User's Guide</h2><p align="right">Pages: <a href="userguide.html">Content</a>, <b>1</b>, <a href="userguide2.html">2</a>, <a href="userguide3.html">3</a></p><p><strong>User Feedback</strong>: <a href="mailto:axis-user@ws.apache.org">axis-c-user@ws.apache.org</a> (Please
remember to prefix the subject with [Axis2]). To subscribe to mailing list
see <a href="../mail-lists.html">here.</a></p></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>Welcome to Axis2/C, the Apache Axis2 implemented in C. This User's Guide