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/03/20 07:27:22 UTC
svn commit: r387150 [1/3] - in /webservices/axis2/site/c: ./ M0_5/
Author: samisa
Date: Sun Mar 19 22:27:20 2006
New Revision: 387150
URL: http://svn.apache.org/viewcvs?rev=387150&view=rev
Log:
Fixed styles and some typos
Modified:
webservices/axis2/site/c/M0_5/architecture_notes.html
webservices/axis2/site/c/M0_5/developerguide.html
webservices/axis2/site/c/M0_5/index.html
webservices/axis2/site/c/M0_5/installationguide.html
webservices/axis2/site/c/M0_5/om_tutorial.html
webservices/axis2/site/c/M0_5/userguide.html
webservices/axis2/site/c/M0_5/userguide1.html
webservices/axis2/site/c/M0_5/userguide2.html
webservices/axis2/site/c/M0_5/userguide3.html
webservices/axis2/site/c/coding_conventions.html
webservices/axis2/site/c/cvs-usage.html
webservices/axis2/site/c/dependencies.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/M0_5/architecture_notes.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/architecture_notes.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/architecture_notes.html (original)
+++ webservices/axis2/site/c/M0_5/architecture_notes.html Sun Mar 19 22:27:20 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: 10 March 2006
+ Last published: 20 March 2006
| Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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="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/M0_5/developerguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/developerguide.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/developerguide.html (original)
+++ webservices/axis2/site/c/M0_5/developerguide.html Sun Mar 19 22:27:20 2006
@@ -2,29 +2,38 @@
@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: 10 March 2006
- | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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><div class="subsection"><a name="-Milestone_0_5_Release"></a><h3>-Milestone 0.5 Release</h3><p>Send your feedback to mailing list: <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 mailing lists
-see <a href="../mail-lists.html">here</a></p></div><div class="subsection"><a name="Content"></a><h3>Content</h3><p> This guide walks you through the following topics that might help
-you get familiar with the Axis2/C project quickly.</p><ul>
+ Last published: 20 March 2006
+ | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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><div class="subsection"><a name="-Milestone_0_5_Release"></a><h3>-Milestone 0.5 Release</h3><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><div class="subsection"><a name="Content"></a><h3>Content</h3><p>This guide walks you through the following topics that might help you get
+familiar with the Axis2/C project and its development norms in quick time.</p><ul>
<li><a href="#Programming_Model">Programming model</a></li>
<li><a href="#Memory_Management">Memory management</a></li>
<li><a href="#Coding_Conventions">Coding conventions</a></li>
<li><a href="#Unit_and_System_Tests">Unit and System tests</a></li>
-</ul><p><a name="Programming_Model"></a></p></div><div class="subsection"><a name="Programming_Model"></a><h3>Programming Model</h3><p>Axis2 programming model follows a clean approach to hide data and
-group functions together. The following example illustrates how Axis2/C
-achieves this.<br></br>
-Operations are bundled into an operation struct and macros are provided
-to access the functions in this struct. Actual function pointers are
-assigned in the implementation file. </p><p>Here's a sample header file.</p><br></br><strong>/* axis2_ foo.h */</strong>
+</ul><p><a id="Programming_Model"></a></p></div><div class="subsection"><a name="Programming_Model"></a><h3>Programming Model</h3><p>Axis2/C programming model uses a pseudo object oriented model to achieve
+data hiding. The following example illustrates how this is done in Axis2/C.
+Each struct corresponds to the "class" concept in object oriented
+programming. Hence, each struct has its own header file, that exposes the API
+for that struct and a source file, that contains the functional
+implementation. </p><p>Operations associated with a struct are bundled into an operations struct,
+and the operations struct is exposed in the header file. The real
+implementation struct with the data fields is hidden from the user, and lives
+in the source file. To ease the user from using the complex syntax required
+by the use of the operations struct, macros are provided to access the
+functions associated with a given struct. Since the data is hidden, it is the
+usual practice to provide getter and setter methods for the data fields of
+the struct, in addition to the other processing functionality. Actual
+function implementations are mapped to the functions in the operations struct
+in the source file by means of function pointer assignments. </p><p>Here is a sample header file associated with the "foo" struct.</p><strong>/* axis2_ foo.h */</strong>
<div class="source"><pre>
typedef struct axis2_foo_ops axis2_foo_ops_t;
typedef struct axis2_foo axis2_foo_t;
struct axis2_foo_ops
{
- void (AXIS2_CALL *bar)(void *data);
- axis2_status_t (AXIS2_CALL *free)(axis2_env_t **env, axis2_foo_t *foo);
+ void (AXIS2_CALL *bar)(axis2_foo_t *foo, axis2_env_t **env, void *data);
+ axis2_status_t (AXIS2_CALL *free)(axis2_foo_t *foo, axis2_env_t **env);
};
struct axis2_foo
@@ -32,6 +41,9 @@
axis2_foo_ops_t *ops;
}
+
+axis2_foo_t * axis2_foo_create(axis2_env_t **env);
+
/* Macros are provided to access functions defined in the ops (operations structure)*/
#define AXIS2_FOO_BAR(foo, data)\
@@ -40,8 +52,7 @@
((for)->ops->free(env, foo))
</pre></div>
- <p>The implementation file for the above header is shown below.<br></br>
-</p>
+ <p>The implementation file for "foo" struct is shown below.</p>
<div class="source"><pre>
#include <axis2_foo.h>
@@ -74,26 +85,25 @@
void AXIS2_CALL axis2_foo_bar(void *data)
{
+ /* do something */
}
axis2_status_t AXIS2_CALL axis2_foo_free(axis2_env_t **env, axis2_foo_t *foo)
{
/* do the dirty work of cleaning the allocated memory */
}
-
</pre></div>
- <p><a name="Memory_Management"></a></p></div><div class="subsection"><a name="Memory_Management"></a><h3>Memory Management</h3><p>We need to look into two senarios of memory management: services and
-clients development. You need to be aware of the parts of the memory
-you have allocated to deallocate in order to avoid memory leaks and
-segmentation faults.</p></div><div class="subsection"><a name="Memory_management_guidelines_for_developing_services"></a><h3>Memory management guidelines for developing services</h3><p>To understand, how the allocated memory is reclaimed, it is worth
-looking at the service skeleton interface which is defined in <strong>
-axis2_svc_skeleton.h</strong></p>
- <div class="source"><pre>
-AXIS2_DECLARE_DATA struct axis2_svc_skeleton_ops
+ <p><a id="Memory_Management"></a></p><p>If you had a closer look into the given sample above, you will see that
+almost all functions take a double pointer to the axis2_env struct. To learn
+more on environment used in Axis2/C, please have a look into the <a href="architecture_notes.html">architecture notes</a>.</p></div><div class="subsection"><a name="Memory_Management"></a><h3>Memory Management</h3><p>When writing services, as well as client programs, you have to ensure that
+you do proper memory management. You need to be aware of the parts of the
+memory you have allocated to deallocate in order to avoid memory leaks (and
+to avoid those nasty segmentation faults ;-) ).</p></div><div class="subsection"><a name="Memory_Management_Guidelines_for_Developing_Services"></a><h3>Memory Management Guidelines for Developing Services</h3><p>To understand, how the allocated memory is reclaimed, it is worth looking
+at the service skeleton interface which is defined in
+<strong>axis2_svc_skeleton.h</strong></p>
+ <div class="source"><pre>AXIS2_DECLARE_DATA struct axis2_svc_skeleton_ops
{
-
int (AXIS2_CALL * free)(axis2_svc_skeleton_t *svc_skeli, axis2_env_t **env);
-
...
};
@@ -103,25 +113,16 @@
axis2_array_list_t *func_array;
};
-
</pre></div>
- <p>The service skeleton implementation should implement the free
-function and attach that to the operations struct of
-axis2_svc_skeleton_t struct. This free function is called each time
-after serving a web services request. <br></br>
-</p><p>
-Let's try to understand this through an example.<br></br>
-<br></br>
-Example: <b> Service skeleton implementation for math service. </b> <br></br>
-The following code shows the implementation of math_free function which
-is to be attached to the ops of axis2_svc_skeleton_t struct. Usually
-the memory allocated for operations struct, function array and service
-skeleton struct are cleaned in this. You may clean additional memory
-here if you have allocated any specific memory block in math_create
-function.<br></br>
-</p>
- <div class="source"><pre>
-int AXIS2_CALL math_free(axis2_svc_skeleton_t *svc_skeleton, axis2_env_t **env)
+ <p>The service skeleton implementation should implement the free function and
+attach that to the operations struct of axis2_svc_skeleton_t struct. This
+free function is called each time after web services request is served.</p><p>Let's try to understand this through an example. </p><p>Example: <b>Service skeleton implementation for math service.</b> </p><p>The following code shows the implementation of math_free function which is
+to be attached to the ops of axis2_svc_skeleton_t struct. Usually the memory
+allocated for operations struct, function array and service skeleton struct
+are cleaned in this. You may clean additional memory here if you have
+allocated any specific memory blocks in math_create function or elsewhere
+depending on your implementation specifics.</p>
+ <div class="source"><pre>int AXIS2_CALL math_free(axis2_svc_skeleton_t *svc_skeleton, axis2_env_t **env)
{
if(svc_skeleton->ops)
{
@@ -133,7 +134,6 @@
AXIS2_ARRAY_LIST_FREE(svc_skeleton->func_array, env);
svc_skeleton->func_array = NULL;
}
-
if(svc_skeleton)
{
AXIS2_FREE((*env)->allocator, svc_skeleton);
@@ -143,12 +143,11 @@
}
</pre></div>
- <br></br><p>In the axis2_math_create function you assign the function pointer of
-math_free function to the free function of the operations struct. As
-you can see, now the SOAP engine has a function reference to perform
-garbage collection after each service request.</p>
- <div class="source"><pre>
-AXIS2_DECLARE(axis2_svc_skeleton_t *) axis2_math_create(axis2_env_t **env)
+ <p>In the axis2_math_create function you assign the function pointer of
+math_free function to the free function of the operations struct. As you can
+see, now the SOAP engine has a function reference to perform garbage
+collection after each service request.</p>
+ <div class="source"><pre>AXIS2_DECLARE(axis2_svc_skeleton_t *) axis2_math_create(axis2_env_t **env)
{
axis2_svc_skeleton_t *svc_skeleton = NULL;
svc_skeleton = AXIS2_MALLOC((*env)->allocator, sizeof(axis2_svc_skeleton_t));
@@ -162,28 +161,22 @@
}
</pre></div>
- <p>SOAP engine reclaims the memory allocated for the axis2_om_node_t
-structure to create the response SOAP message.
-However, it is the responsibility of the service developer to clean any
-additional memory allocated.</p></div><div class="subsection"><a name="Memory_management_guidelines_for_developing_clients"></a><h3>Memory management guidelines for developing clients</h3><p>
-Most of the memory allocated in the client side (including SOAP request
-and reply messges), should be cleaned in the client side itself. Memory
-allocated for properties are taken care of by the SOAP engine. SOAP
-engine reclaims the memory allocated for properties based on the scope
-(Request, Session or Application) you set for each property.
-<a name="Coding_Conventions"></a></p></div><div class="subsection"><a name="Coding_Conventions"></a><h3>Coding Conventions</h3><p>Coding conventions used with the Axis2 project is listed in <a href="../coding_conventions.html">this</a> document.</p><p><a name="Unit_and_System_Tests"></a></p></div><div class="subsection"><a name="Unit_and_System_Tests"></a><h3>Unit and System Tests</h3></div><div class="subsection"><a name="Unit_Tests"></a><h3>Unit Tests</h3><p>You need to follow two steps to write a unit test for a module.</p><p>
-1. Add the unit test to the module's test suite.</p><br></br><p>
-2. Add the modules test suite to the main unit test suite.</p><br></br><p>CuTest (opensource) library is used to write unit test. The
-following
-section illustrates the two steps.</p></div><div class="subsection"><a name="Step1:_Adding_a_unit_test_to_a_module_s_unit_test_suite"></a><h3>Step1: Adding a unit test to a module's unit test suite</h3><p>This section illustrates how to add a test case to the util module.
-Let's
-take for example the unit tests for axis2 stream. There are two files
-named
-util_stream_test.c/.h placed into modules/util/test folder. Here's a
-sample
-code written to test the operation axis2_stream_ops_read.</p>
- <div class="source"><pre>
-#include "util_stream_test.h"
+ <p>SOAP engine frees the memory allocated for the axis2_om_node_t struct that
+is used to from the response SOAP message. However, it is the responsibility
+of the service developer to clean any additional memory allocated.</p></div><div class="subsection"><a name="Memory_management_guidelines_for_developing_clients"></a><h3>Memory management guidelines for developing clients</h3><p>
+Most of the memory allocated in the client side (including SOAP request and
+reply messges), should be cleaned in the client side itself. Memory allocated
+for properties are taken care of by the SOAP engine. SOAP engine reclaims the
+memory allocated for properties based on the scope (Request, Session or
+Application) that you set for each property. <a id="Coding_Conventions"></a></p></div><div class="subsection"><a name="Coding_Conventions"></a><h3>Coding Conventions</h3><p>Coding conventions used with the Axis2 project is listed in <a href="../coding_conventions.html">this</a> document.</p><p><a id="Unit_and_System_Tests"></a></p></div><div class="subsection"><a name="Unit_and_System_Tests"></a><h3>Unit and System Tests</h3></div><div class="subsection"><a name="Unit_Tests"></a><h3>Unit Tests</h3><p><a href="http://cutest.sourceforge.net/" class="externalLink" title="External Link">CuTest</a> library is used to
+write unit tests in Axis2/C. </p><p>You need to follow two steps to write a unit test for a module.</p><p>
+1. Add the unit test to the module's test suite.
+
+</p><p>2. Add the module's test suite to the main unit test suite.</p></div><div class="subsection"><a name="Step1:_Adding_a_unit_test_to_a_module_s_unit_test_suite"></a><h3>Step1: Adding a unit test to a module's unit test suite</h3><p>This section illustrates how to add a unit test case to the util module.
+Let's take for example the unit tests for axis2 stream. There are two files
+named util_stream_test.c/.h placed into modules/util/test folder. Here's a
+sample code written to test the operation axis2_stream_ops_read.</p>
+ <div class="source"><pre>#include "util_stream_test.h"
void Testaxis2_stream_ops_read(CuTest *tc)
{
@@ -195,13 +188,11 @@
CuAssertStrEquals(tc, expected, actual);
}
-
</pre></div>
- <p>The prototype of the funciton should be added to the header file.
-The test suite is defined in util_test.c. You need to add the above
-defined test case to the test suite as shown below.</p>
- <div class="source"><pre>
-#include "util_test.h"
+ <p>The prototype of the function should be added to the header file. The test
+suite is defined in util_test.c. You need to add the above defined test case
+to the test suite as shown below.</p>
+ <div class="source"><pre>#include "util_test.h"
#include <axis2_allocator.h>
#include <axis2_environment.h>
@@ -216,10 +207,8 @@
}
</pre></div>
- </div><div class="subsection"><a name="Step2:_Adding_the_Module_test_suite_to_the_Main_Unit_Test_Suite"></a><h3>Step2: Adding the Module test suite to the Main Unit Test Suite</h3><p>Now you need to add the Util module test suite to the main test
-suite.</p>
- <div class="source"><pre>
-#include <CuTest.h>
+ </div><div class="subsection"><a name="Step2:_Adding_the_Module_test_suite_to_the_Main_Unit_Test_Suite"></a><h3>Step2: Adding the Module test suite to the Main Unit Test Suite</h3><p>Now you need to add the Util module test suite to the main test suite.</p>
+ <div class="source"><pre>#include <CuTest.h>
#include "../../util/test/util_test.h"
#include "../../common/test/common_test.h"
@@ -242,18 +231,14 @@
return 0;
}
-
</pre></div>
- <p>You can either run only the unit tests written for the util module
-or run all the tests.</p></div><div class="subsection"><a name="System_Tests"></a><h3>System Tests</h3><p>For each module, system tests should be provided in
-modules/test/<module folder>. For each system test you need to
-add a
-new function and call it from the main method.</p><p>Example:</p><p>To test the OM module, you need to create a file named test_om.c
-under the
-directory modules/test/om. A sample test_om.c might look like as
+ <p>You can either run only the unit tests written for the util module or run
+all the tests.</p></div><div class="subsection"><a name="System_Tests"></a><h3>System Tests</h3><p>For each module, system tests should be provided in
+modules/test/<module folder>. For each system test you need to add a
+new function and call it from the main method.</p><p>Example:</p><p>To test the OM module, you need to create a file named test_om.c under the
+directory modules/test/xml/om. A sample test_om.c might look like as
follows.</p>
- <div class="source"><pre>
-#include <axis2_stax_ombuilder.h>
+ <div class="source"><pre>#include <axis2_stax_ombuilder.h>
#include <axis2_om_document.h>
#include <axis2_om_node.h>
#include <axis2_om_element.h>
Modified: webservices/axis2/site/c/M0_5/index.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/index.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/index.html (original)
+++ webservices/axis2/site/c/M0_5/index.html Sun Mar 19 22:27:20 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: 10 March 2006
+ Last published: 20 March 2006
| Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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_Milestone_0_5_Release_Documentation"></a><h2>Axis2/C Milestone 0.5 Release 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/M0_5/installationguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/installationguide.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/installationguide.html (original)
+++ webservices/axis2/site/c/M0_5/installationguide.html Sun Mar 19 22:27:20 2006
@@ -2,19 +2,19 @@
@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: 10 March 2006
- | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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><div class="subsection"><a name="-Milestone_Release_0_5"></a><h3>-Milestone Release 0.5</h3><p>This document will give you in step by step instructions on how to install
-Axis2/C, run the server & web service client samples on Linux & MS
-Windows operating systems.</p><p>This release comes in two forms, source and binary. Instructions are given
-below to install in both methods.</p><p>Hope you would enjoy this version of Axis2/C SOAP engine.</p><p>Send your feedback to mailing list: <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 mailing lists see <a href="../mail-lists.html">here</a></p></div><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
+ Last published: 20 March 2006
+ | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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><div class="subsection"><a name="-Milestone_Release_0_5"></a><h3>-Milestone Release 0.5</h3><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
+mailing list see <a href="../mail-lists.html">here</a></p></div><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
<li><a href="#linux">Installing and running on Linux</a>
<ul>
<li><a href="#linux_binary">Using binary release</a></li>
<li><a href="#linux_source">Using source release</a></li>
</ul>
</li>
- <li><a href="#win">Installing and running on MS Windows (win32)</a>
+ <li><a href="#win">Installing and running on Microsoft Windows (win32)</a>
<ul>
<li><a href="#win_binary">Using the binary release</a>
<ul>
@@ -33,7 +33,8 @@
</li>
</ul>
</li>
-</ul><p><a></a></p></div><div class="subsection"><a name="Installing_and_running_on_Linux"></a><h3>Installing and running on Linux</h3><p>This can be done using binary or source distributions</p><p>To get both the binary and source distributions, you need libxml2 from <a href="http://xmlsoft.org/downloads.html" class="newWindow" title="New Window" target="_blank">here</a>.</p><p>(NOTE: most Linux systems has libxml2 by default.)</p><p><a></a></p></div><div class="subsection"><a name="1__Using_binary_release"></a><h3>1. Using binary release</h3><p>The following steps need to be taken to install and run Axis2/C using
+</ul><p><a></a></p></div><div class="subsection"><a name="Installing_and_running_on_Linux"></a><h3>Installing and running on Linux</h3><p>This can be done using binary or source distributions</p><p>To get both the binary and source distributions working, you need libxml2,
+which can be downloaded from <a href="http://xmlsoft.org/downloads.html" class="newWindow" title="New Window" target="_blank">here</a>.</p><p>(NOTE: most Linux systems has libxml2 by default.)</p><p><a></a></p></div><div class="subsection"><a name="1__Using_binary_release"></a><h3>1. Using binary release</h3><p>The following steps need to be taken to install and run Axis2/C using
binary distribution on Linux</p></div><div class="subsection"><a name="1__Extract_the_binary_tar_package_to_a_folder_"></a><h3>1. Extract the binary tar package to a folder.</h3><ul>
<li>Set AXIS2C_HOME environment variable pointing to the location where you
have extracted Axis2C</li>
@@ -41,35 +42,43 @@
<li>export AXIS2C_HOME
<p>Note: You will need to set AXIS2C_HOME only if you need to run axis2c
samples or tests. The reason is</p>
- <p>that from sample and test codes it used AXIS2C_HOME to get the path to
- axis2c. To write your own </p>
- <p>services or clients this is not neccessary.</p>
+ <p>that the samples and tests use the AXIS2C_HOME envioronment variable
+ to locate the repository path. To write your own</p>
+ <p>services or clients this would not be neccessary.</p>
</li>
</ul></div><div class="subsection"><a name="2__Run_the_simple_axis_server:"></a><h3>2. Run the simple axis server:</h3><ul>
- <li>To start the simple axis server on port 9090, run the following command
- lines.
+ <li>To start the simple axis server on default port 9090, run the following
+ commands.
<ul>
<li>cd /your_path_to_axis2c/bin</li>
<li>./axis2_http_server</li>
</ul>
</li>
<li>To see the possible command line options run ./axis2_http_server -h</li>
- <li>NOTE: If you run into shared lib problems,
+ <li>NOTE: If you run into shared lib problems, try setting the
+ LD_LIBRARY_PATH
<ul>
- <li>set the LD_LIBRARY_PATH</li>
<li>export
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</li>
</ul>
</li>
</ul></div><div class="subsection"><a name="3__Run_the_sample_clients_in_a_new_shell"></a><h3>3. Run the sample clients in a new shell</h3><ul>
<li>cd /your_path_to_axis2c/bin/samples</li>
- <li>./echo will invoke the echo service.</li>
- <li>./math will invoke the math service.</li>
+ <li>to run client for echo service
+ <ul>
+ <li>./echo</li>
+ </ul>
+ </li>
+ <li>to run client for math service
+ <ul>
+ <li>./math</li>
+ </ul>
+ </li>
<li>To see the possible command line options for sample clients run them
with '-h' option</li>
- <li>NOTE: If you run into shared lib problems,
+ <li>NOTE: If you run into shared lib problems, try setting the
+ LD_LIBRARY_PATH
<ul>
- <li>set the LD_LIBRARY_PATH</li>
<li>export
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</li>
</ul>
@@ -126,18 +135,26 @@
<li>Run the sample clients in a new shell using the following command lines
<ul>
<li>cd bin/samples</li>
- <li>./echo will invoke the echo service.</li>
- <li>./math will invoke the math service.</li>
+ <li>to run client for echo service
+ <ul>
+ <li>./echo</li>
+ </ul>
+ </li>
+ <li>to run client for math service
+ <ul>
+ <li>./math</li>
+ </ul>
+ </li>
<li>To see the possible command line options for sample clients run
them with '-h' option</li>
</ul>
</li>
-</ol><p><a></a></p></div><div class="subsection"><a name="Installing_and_running_on_MS_Windows__win32_"></a><h3>Installing and running on MS Windows (win32)</h3><p>This too can be done using binary or source distributions</p><p>To get both the binary and source distribution, you need libxml2 from <a href="http://xmlsoft.org/downloads.html" class="externalLink" title="External Link">here</a>.</p><p>(NOTE: most Linux systems has libxml2 by default. On Windows you need to
+</ol><p><a></a></p></div><div class="subsection"><a name="Installing_and_running_on_Microsoft_Windows__win32_"></a><h3>Installing and running on Microsoft Windows (win32)</h3><p>This too can be done using either binary or source distributions</p><p>For both the binary and source distributions, you need libxml2 from <a href="http://xmlsoft.org/downloads.html" class="externalLink" title="External Link">here</a>.</p><p>(NOTE: most Linux systems has libxml2 by default. On Windows you need to
download and install libxml2)</p><p><a></a></p></div><div class="subsection"><a name="1__Using_binary_release"></a><h3>1. Using binary release</h3><p><a></a></p></div><div class="subsection"><a name="Requirements"></a><h3>Requirements</h3><ul>
<li>The binaries shipped with this version is compiled with Microsoft
visual studio compiler (cl)</li>
- <p>(Note: you can download microsoft VSExpress2005 edition from microsoft
+ <p>(Note: you can download Microsoft VSExpress2005 edition from Microsoft
web site and install it to run these binaries)</p>
<li>You also need the following dlls
<ul>
@@ -159,11 +176,11 @@
<p><em>The above folders contain the following files:</em></p>
<ul>
<li>bin - server and other executables</li>
- <li>samples - samples go here</li>
+ <li>bin\samples - client samples go here</li>
<li>lib - library modules</li>
<li>services - deployed services</li>
<li>modules - deployed modules</li>
- <li>include - all include files of axis2</li>
+ <li>include - all include files of Axis2 C</li>
<li>logs - system and client logs are written to this folder</li>
</ul>
<li>Copy libxml2.dll, iconv.dll and zlib1.dll downloaded to
@@ -177,26 +194,26 @@
(%AXIS2C_HOME%\lib)</li>
</ul>
</li>
- <li>Now everything is set to run the server
- C:\axis2c\bin>axis2_http_server.exe</li>
+ <li>Now everything is set to run the server (C:\axis2c\bin\>
+ axis2_http_server.exe)</li>
<li>If the server is running successfully you should see the message
"Started Simple Axis2 HTTP Server..."</li>
- <li>The log is by default created under %AXIS2C_HOME%\logs folder with the
+ <li>The log is by default created in %AXIS2C_HOME%\logs folder with the
name axis2.log.</li>
<li>(Note: you may provide command line options to change the default
- behaviour. Type "axis2_http_server.exe -h" to learn about the usage)</li>
- <li>Now you can run any sample client deployed under
- %AXIS2C_HOME%\bin\samples\
+ behaviour. Use the command "axis2_http_server.exe -h" to learn about the
+ usage)</li>
+ <li>Now you can run any sample client located in %AXIS2C_HOME%\bin\samples\
<ul>
- <li>Example: C:\axis2c\bin\samples>echo.exe</li>
+ <li>Example: C:\axis2c\bin\samples\> echo.exe</li>
</ul>
</li>
</ul><p><a></a></p></div><div class="subsection"><a name="2__Using_the_source_release_"></a><h3>2. Using the source release.</h3><p><a></a></p></div><div class="subsection"><a name="Requirements"></a><h3>Requirements</h3><ul>
<li>The makefile shipped with this version needs Microsoft visual studio
compiler (cl) and nmake build tool</li>
- <p>(Note: you can download microsoft VSExpress2005 edition and Platform SDK
- from microsoft web site. You will need to add the path to Platform SDK
+ <p>(Note: you can download Microsoft VSExpress2005 edition and Platform SDK
+ from Microsoft web site. You will need to add the path to Platform SDK
Include and Lib folders to makefile)</p>
<li>You also need
<ul>
@@ -209,7 +226,7 @@
</ul>
</li>
</ul><p><a></a></p></div><div class="subsection"><a name="Editing_configure_in_file"></a><h3>Editing configure.in file</h3><ul>
- <li>The default places for libxml2 and iconv are speceficed in configure.in.
+ <li>The default paths for libxml2 and iconv are speceficed in configure.in.
<ul>
<li>Example:Default location for libxml2 is C:\libxml2</li>
</ul>
@@ -223,18 +240,24 @@
accordingly.</p>
<li>You need to have zlib1.dll in a library path. You may copy this dll to
libxml2/lib.</li>
-</ul><p><a></a></p></div><div class="subsection"><a name="Compiling_the_source_"></a><h3>Compiling the source.</h3><p>The following steps and command lines will take you through the source
-compilation</p><ul>
+</ul><p><a></a></p></div><div class="subsection"><a name="Compiling_the_source_"></a><h3>Compiling the source.</h3><p>The following steps will take you through the source compilation</p><ul>
<li>Extract the source distribution to a folder of your choice. (Example:
C:\axis2c)</li>
<li>Open a DOS shell</li>
<li>cd C:\axis2c\build\win32</li>
- <li>C:\axis2c\build\win32>vcvars32.bat to access .Net tools
- <p>(Note: You may need to set the environment PATH variable to
+ <li>to access .Net tools, run
+ <ul>
+ <li>C:\axis2c\build\win32> vcvars32.bat</li>
+ </ul>
+ <p>(Note: You may need to set the PATH environment variable to
vcvars32.bat if windows complaints that it cannot find this bat)</p>
</li>
- <li>C:\axis2c\build\win32>nmake install will build the system and create
- a directory named deploy under build directory.</li>
+ <li>build the system and create a directory named deploy under build
+ directory:
+ <ul>
+ <li>C:\axis2c\build\win32>nmake install</li>
+ </ul>
+ </li>
<li>The deploy folder structure is as follows:</li>
<p><img alt="Figure: deploy Folder Structure" src="images/folder_structure.jpg"></img></p>
@@ -242,11 +265,11 @@
<p><em>The above folders contain the following files:</em></p>
<ul>
<li>bin - server and other executables</li>
- <li>samples - samples</li>
+ <li>bin\samples - client samples</li>
<li>lib - library modules</li>
<li>services - deployed services</li>
<li>modules - deployed modules</li>
- <li>include - all include files of axis2</li>
+ <li>include - all include files of Axis2 C</li>
<li>logs - system and client logs are written to this folder</li>
</ul>
</ul><p><a></a></p></div><div class="subsection"><a name="Running_the_binaries"></a><h3>Running the binaries</h3><ul>
@@ -261,18 +284,19 @@
(%AXIS2C_HOME%\lib)</li>
</ul>
</li>
- <li>Now run the server -
- C:\axis2c\build\deploy\bin>axis2_http_server.exe</li>
+ <li>Now run the server - C:\axis2c\build\deploy\bin>
+ axis2_http_server.exe</li>
<li>If server is running successfully you should see the message "Started
Simple Axis2 HTTP Server..."</li>
<li>The log is by default created under %AXIS2C_HOME%\logs folder with the
name axis2.log.</li>
<li>(Note: you may provide command line options to change the default
- behaviour. Type "axis2_http_server.exe -h" to learn about the usage)</li>
+ behaviour. Use the command "axis2_http_server.exe -h" to learn about the
+ usage)</li>
<li>Now you can run any sample client deployed under
%AXIS2C_HOME%\bin\samples\
<ul>
- <li>Example: C:\axis2c\build\deploy\bin\samples>echo.exe</li>
+ <li>Example: C:\axis2c\build\deploy\bin\samples> echo.exe</li>
</ul>
</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>
Modified: webservices/axis2/site/c/M0_5/om_tutorial.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/om_tutorial.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/om_tutorial.html (original)
+++ webservices/axis2/site/c/M0_5/om_tutorial.html Sun Mar 19 22:27:20 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: 10 March 2006
+ Last published: 20 March 2006
| Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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></li>
<ul>
@@ -304,7 +304,7 @@
the whole object structure at once, until its 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>
Modified: webservices/axis2/site/c/M0_5/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/userguide.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/userguide.html (original)
+++ webservices/axis2/site/c/M0_5/userguide.html Sun Mar 19 22:27:20 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: 10 March 2006
- | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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_User_s_Guide"></a><h2>Axis2/C User's Guide</h2><div class="subsection"><a name="-Milestone_Release_0_5"></a><h3>-Milestone Release 0.5</h3><p align="right">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 class="subsection"><a name="Content"></a><h3>Content</h3><ul>
+ Last published: 20 March 2006
+ | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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_User_s_Guide"></a><h2>Axis2/C User's Guide</h2><div class="subsection"><a name="-Milestone_Release_0_5"></a><h3>-Milestone Release 0.5</h3><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 class="subsection"><a name="Content"></a><h3>Content</h3><ul>
<li>
<p><a href="userguide1.html#Introduction">Introduction</a></p>
<ul>
@@ -55,4 +55,4 @@
<li><a href="userguide3.html#deploy">Deploy the Web Service</a></li>
</ul>
</li>
-</ul><p align="right"><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><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
Modified: webservices/axis2/site/c/M0_5/userguide1.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/c/M0_5/userguide1.html?rev=387150&r1=387149&r2=387150&view=diff
==============================================================================
--- webservices/axis2/site/c/M0_5/userguide1.html (original)
+++ webservices/axis2/site/c/M0_5/userguide1.html Sun Mar 19 22:27:20 2006
@@ -2,82 +2,56 @@
@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: 10 March 2006
- | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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_User_s_Guide"></a><h2>Axis2/C User's Guide</h2><div class="subsection"><a name="-Milestone_Release_0_5"></a><h3>-Milestone Release 0.5</h3><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>
-(Prefix
-the subject with [Axis2]). To subscribe to mailing list see <a href="../mail-lists.html">here.</a></p></div></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>Welcome to Axis2/C, the next generation of Apache Axis 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. We hope you will benefit from the power of
-Axis2.</p><div class="subsection"><a name="Attention"></a><h3>Attention</h3><p>This User's Guide is written based on the Axis2 Milestone version
-0.5
-standard
-binary distribution. (The standard binary distribution can be created
-from
-the source distribution using 'sh build.sh' on source distribution).
-Please
-refer the <a href="installationguide.html#Download_Axis2">installation
-guide</a> for further information on the downloadables available in
-this
-release.</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 pure C.</p><p>After months of continued discussion and coding in this direction,
-Axis2/C
+ Last published: 20 March 2006
+ | Doc for M0.5</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 Axis2 C</a><ul><li class="none"><a href="../download.cgi">M0.5 Release</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="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../M0_5/index.html">Milestone 0.5</a></li></ul></li><li class="expanded"><a href="../">Get Involved</a><ul><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="http://issues.apache.org/jira/browse/AXIS2C" class="externalLink" title="External Link">Issue Tracking</a></l
i></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_User_s_Guide"></a><h2>Axis2/C User's Guide</h2><div class="subsection"><a name="-Milestone_Release_0_5"></a><h3>-Milestone Release 0.5</h3><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><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
+will help you to understand what Axis2/C has to offer and how to get started
+with it.</p><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 object model and StAX (Streaming API for XML) parsing to
-achieve significant speed.</p>
- </li>
- <li>
- <p style="margin-bottom: 0in;"><strong>Low memory foot print</strong>-
-Axis2 was designed ground-up keeping the low memory foot print in mind.</p>
- </li>
- <li>
- <p style="margin-bottom: 0in;"><strong>AXIOM</strong> C- Axis2/C
-comes with its own light-weight object model, AXIOM C which is a C
-implementation of AXIOM Java.</p>
- </li>
- <li>
- <p style="margin-bottom: 0in;"><strong>MEP Support</strong> - Now
-comes handy with the flexibility to support Message Exchange Patterns
-(MEP s) with in-built support for basic MEP s defined in WSDL 2.0.</p>
- </li>
- <li>
- <p style="margin-bottom: 0in;"><strong>Flexibility</strong> - The
-Axis2 architecture gives the developer complete freedom to insert
-extensions into the engine for custom 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>WSDL support</strong> -
-Axis2 supports the <a href="http://www.w3.org/TR/wsdl" class="newWindow" title="New Window" target="_blank">Web
-Service Description Language</a>, version 1.1 and 2.0.</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>We hope you enjoy using Axis2/C. Please note that this is an
-open-source
-effort. If you feel the code could use some new features or fixes,
-please get
-involved and lend us a hand! The Axis developer community welcomes your
-participation.</p><p>Let us know what you think!</p><p>Please send your feedback on Axis2 to "<a href="mailto:axis-user@ws.apache.org">axis-c-user@ws.apache.org</a>"
-and make
-sure to prefix the subject of the mail with [Axis2].<br></br>
+ <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/axis2/0_93/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) with in-built support for basic MEP s
+ defined in WSDL 2.0.</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].<br></br>
<br></br>
-The following pages will guide through how to write web services client
-and
-servers.</p><p align="right"><a href="userguide.html"><img src="images/arrow_left.gif" alt=""></img>
+The following pages will guide through how to write web service clients and
+services.</p><p align="right"><a href="userguide.html"><img src="images/arrow_left.gif" alt=""></img>
Previous</a> | <a href="userguide2.html">Next <img src="images/arrow_right.gif" alt=""></img></a></p><p>Pages: <a href="userguide.html">Content</a>, <b>1</b>, <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>