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 pr...@apache.org on 2006/03/02 15:56:53 UTC

svn commit: r382398 - in /webservices/axis: site/cpp/arch/XSD_Objects.html trunk/c/docs/linkmap.html trunk/c/docs/user-guide.html trunk/c/docs/user-guide.pdf

Author: prestonf
Date: Thu Mar  2 06:56:44 2006
New Revision: 382398

URL: http://svn.apache.org/viewcvs?rev=382398&view=rev
Log:
Updates to 1.6b documentation and web site pages.

Added:
    webservices/axis/site/cpp/arch/XSD_Objects.html
    webservices/axis/trunk/c/docs/linkmap.html
    webservices/axis/trunk/c/docs/user-guide.html
    webservices/axis/trunk/c/docs/user-guide.pdf

Added: webservices/axis/site/cpp/arch/XSD_Objects.html
URL: http://svn.apache.org/viewcvs/webservices/axis/site/cpp/arch/XSD_Objects.html?rev=382398&view=auto
==============================================================================
--- webservices/axis/site/cpp/arch/XSD_Objects.html (added)
+++ webservices/axis/site/cpp/arch/XSD_Objects.html Thu Mar  2 06:56:44 2006
@@ -0,0 +1,133 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML>
+<HEAD>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<META name="GENERATOR" content="IBM Software Development Platform">
+<TITLE>XSD_Objects.html</TITLE>
+</HEAD>
+<BODY>
+<H1 align="center">XSD Objects</H1>
+<H2>XML Schema Part 2 : Datatypes</H2>
+<P>The types and formatting of data transmitted in a SOAP message is defined by the XML Schema, in particular Part 2 : Datatypes. The full specification can be seen <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">here</A>.</P>
+<H3>Built-in types</H3>
+<P>Within <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#built-in-datatypes">section
+3</A>  of the above specification 44 built-in datatypes are described, encompasing Strings, numeric, time and encoded binary datatypes. These datatypes are split into two groups, primitive and derived types.</P>
+<P><IMG border="1" src="../images/XSD_Objects_Heirarchy.JPG" width="680"
+	height="588"></P>
+<H4>Primitive Types</H4>
+<P>The XML schema provides 19 primitive types. As all data is represented in text form within XML, the value space for each datatype needs to be specified, for example numeric types cannot  contain alphabetic characters. To do this, each type defines a number of contraining facets and the values within these facets allows the XML engine to validate the data. See <A
+	href="#Constraining Facets">Constraining Facets</A> below for further information on how these are used.</P>
+<P><IMG border="1" src="../images/XSD_PrimitiveTypes.JPG" width="680"
+	height="233" alt="The 19 primitive data types are: string, boolean, decimal, float, double, duration, dateTime, time, date, gYearMonth, gYear, gMonthDay, gDay, gMonth, hexBinary, base64Binary, anyURI, QName, NOTATION"></P><P>See <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#built-in-primitive-datatypes">section
+3.2</A> of the specification for full detail on each datatype.</P>
+<H4>Derived Types</H4>
+<P>The XML Schema allows additional types to be derived from the primitive types, and has 25 built-in derived types. 12 data types are derived from the string primitive data type.</P>
+<IMG border="1" src="../images/XSD_String_DerivedTypes.JPG" width="252"
+	height="359" alt="The 12 types derived from the string primitive data type are: normalizedString, token, language, Name, NCName, ID, IDREF, IDREFS, ENTITY, ENTITIES, NMTOKEN and NMTOKENS">
+<P>The remaining 13 data types are derived from the decimal primitive data type.</P>
+
+<P><IMG border="1" src="../images/XSD_Decimal_DerivedTypes.JPG"
+	width="503" height="359" alt="The 13 data types derived from the decimal primitive data type are: integer, nonPositiveInteger, negativeInteger, long, int, short, byte, nonNegativeInteger, unsignedLong, unsignedInt, unsignedShort, unsignedByte, positiveInteger"></P>
+<P>A derived type uses the same contraining facets as the type from which it is derived, but provides differing values for one or more facet so as to further restrict the value space. For example; the decimal allows fraction digits, while the integer derived type sets this facet to 0.</P><P>See <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#built-in-derived">section
+3.3</A> of the specification for full detail on each datatype.</P>
+<H4>User defined derived types</H4>
+<P>In the same way as the XML Schema defines a number of built-in datatypes the user can also provide additional derived types. This can be done in the WSDL document, or an XSD referred from a WSDL document.</P>
+<P>The following shows how you can create a new type called <code>direction</code>, which is derived from the <code>NMTOKEN</code> built-in type, to only have the values <code>fromKey</code> and <code>toKey</code>, by restricting the <code>enumeration</code> constraining facet.</P>
+<PRE>	&lt;xsd:simpleType name="direction"&gt;
+		&lt;xsd:restriction base="NMTOKEN"&gt;
+			&lt;xsd:enumeration value="fromKey"/&gt;
+			&lt;xsd:enumeration value="toKey"/&gt;
+		&lt;/xsd:restriction&gt;
+	&lt;/xsd:simpleType&gt;</PRE>
+<H3><A name="Constraining Facets">Constraining Facets</A></H3>
+<P>As mentioned above, the value spaces of each of the built-in types are controlled by constraining facets. The XML Schema provides 12 constraining facets, as described in <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#rf-facets">section
+4.3</A>.</P>
+<P>The 12 constraining facets are:</P>
+<UL>
+<LI><code>length</code></LI>
+<LI><code>minLength</code></LI>
+<LI><code>maxLength</code></LI>
+<LI><code>pattern</code> - describes the form of the data, typically using regular expression syntax.</LI>
+<LI><code>enumeration</code> - specifies a fixed set of permitted values</LI>
+<LI><code>whiteSpace</code> - how to handle whitespace characters</LI>
+<UL>
+<LI><code>preserve</code> - value is unchanged</LI>
+<LI><code>replace</code> - all occurances of tab, line feed and carriage return are replaced with a space</LI>
+<LI><code>collapse</code> - after the process of <CODE>replace</CODE>, remove all contigious repeating occurances of spaces, and strip leading and trailing spaces</LI>
+</UL>
+<LI><code>maxInclusive</code></LI>
+<LI><code>maxExclusive</code></LI>
+<LI><code>minExclusive</code></LI>
+<LI><code>minInclusive</code></LI>
+<LI><code>totalDigits</code></LI>
+<LI><code>fractionDigits</code></LI>
+</UL>
+<P>Each primitive datatype uses a subset of these contraining facets, to suit the characteristics of that particular datatype. <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#defn-coss">Section
+4.1.5</A> of the XML Schema provides a table of which facets are used for each datatype.</P>
+<P>It is permitted for the value of a constraining facet to be undefined, with the exception of whitespace which must be specified as one of preserve, replace or collapse.</P>
+<HR>
+<H1 align="center">Axis C++ Implementation of XSD built-in types</H1>
+<H2>C++ Objects</H2>
+<P>In version 1.5 of Apache Axis C++, an object model was introduced to the SOAP engine for the XSD built-in types. The object heirarchy mimics the order in which the datatypes are derived from each other.</P>
+<H3>IAnySimpleType Interface</H3>
+<P>All the XSD type objects implement the IAnySimpleType interface, which provides the following methods, which must be implemented by all implementing classes</P>
+<UL>
+<code>AxisChar* serialize() throw (AxisSoapException)</code><BR>
+<code>void deserialize(const AxisChar* valueAsChar) throw (AxisSoapException)</code><BR>
+<code>XSDTYPE getType()</code><BR>
+<code>void* getValue()</code>
+</UL>
+<P>In addition each implementation of this interface must provide a parameterized constructor, such that it can be constructed and will immediately serialize the provided value.</P>
+<P>The IAnySimpleType interface provides the following utility method, which should be called by all implementing classes when serializing data.</P>
+<UL>
+<code>AxisChar* serialize(const AxisChar* value) throw (AxisSoapException);</code>
+</UL>
+<P>This method resolves reserved characters (eg <code>&amp;</code> is replaced by <code>&amp;amp;</code>), processes <code>Whitespace</code>, validates <code>Pattern</code> and ensures value is contained within <code>Enumeration</code>.</P>
+<H3>Object Heirarchy</H3>
+<P>Below is a portion of the C++ object heirarchy, which, as you will notice, is very similar to the <A
+	href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#built-in-datatypes">diagram
+of built-in datatypes</A> in the XSD Schema.</P>
+<P><IMG border="1" src="../images/XSDObjects_Heirarchy.gif" width="824"
+	height="717"></P>
+<H3>Mapping XSD built-in types to C/C++ types</H3>
+<P>Within the Axis engine mappings are provided between the XSD built-in types and the native C/C++ types. To aid understanding and maintain consistency, these are declared as typedefs to match the XSD type names. These typedefs should be used throughout the engine for:</P>
+<UL>
+<LI>Clarity of code, making it clear which type is being handled at any point in the code</LI>
+<LI>Ease of maintenance, should a native type need to be altered, it need only be done in the typedef without further changes through the codebase.</LI>
+</UL>
+<H4>C++ Types</H4>
+<P>The mapping from C++ types to the XSD built-in types is defined in <code>AxisUserAPI.hpp</code>. For each XSD built-in type a corresponding typedef is declared in the form <code>xsd__&lt;<I>type</I>&gt;</code>, eg: <code>xsd__string</code>.</P>
+<P>Note: <code>AxisUserAPI.hpp</code> only declares those types currenty supported within the user API.</P>
+<H4>C Types</H4>
+<P>Similar to the C++ API, the mapping from C types to the XSD built-in types is defined in <code>AxisUserAPI.h</code>. A typedef is declared for each XSD built-in type, in the form <code>xsdc__&lt;<I>type</I>&gt;</code>, eg: <code>xsdc__string</code>.</P>
+<H3>IConstrainingFacet Interface</H3>
+<P>All the Constraining Facet objects implement the IConstrainingFacet interface. This provides the following utility method, which allows the XSD objects to determine if a given facet has been defined:</P>
+<UL><code>bool isSet();</code></UL>
+<P>The following Constraining Facet objects provide utility methods to assist the serialization/deserialization of XSD built-in types:</P>
+<UL>
+Enumeration
+<UL><code>void validateEnumeration(const AxisChar* value) throw (AxisSoapException);</code></UL>
+Pattern
+<UL><code>void validatePattern(const AxisChar* value) throw (AxisSoapException);</code></UL>
+WhiteSpace
+<UL><code>const AxisChar* processWhiteSpace(const AxisChar* valueToProcess);</code></UL>
+</UL>
+<HR>
+<H1>Current Limitations</H1>
+<H2>Function Limitation</H2>
+<P>Currently, the XSD objects are completely internal to the Axis engine. In the future we may wish to expose these on the external API, such that customers (via WSDL2Ws) will be able to derive additional simple types simply by refining one or more of the constraining facets, then simply re-using the serialization/deserialization logic we have already written.</P>
+<H2>Pattern Constraining Facet</H2>
+<P>The implementation of the pattern constraining facet is incomplete. It needs to validate against a given regular expression, following this, the pattern for each of data types needs to be updated with the regular expression to describe their particular data type.</P>
+<HR>
+<H1>References</H1>
+<P>XML Schema Part 2 : Datatypes - <A href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/</A></P>
+<H2>Outstanding Issues</H2>
+<A href="http://issues.apache.org/jira/browse/AXISCPP-291">AXISCPP-291</A> - dateTime unable to support dates prior to 1970.
+</BODY>
+</HTML>

Added: webservices/axis/trunk/c/docs/linkmap.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/linkmap.html?rev=382398&view=auto
==============================================================================
--- webservices/axis/trunk/c/docs/linkmap.html (added)
+++ webservices/axis/trunk/c/docs/linkmap.html Thu Mar  2 06:56:44 2006
@@ -0,0 +1,545 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--*** This is a generated file.  Do not edit.  ***-->
+<link rel="stylesheet" href="skin/tigris.css" type="text/css">
+<link rel="stylesheet" href="skin/mysite.css" type="text/css">
+<link rel="stylesheet" href="skin/site.css" type="text/css">
+<link media="print" rel="stylesheet" href="skin/print.css" type="text/css">
+<title>Site Linkmap</title>
+</head>
+<body bgcolor="white" class="composite">
+<!--================= start Banner ==================-->
+<div id="banner">
+<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
+<tbody>
+<tr>
+<!--================= start Group Logo ==================-->
+<td align="left">
+<div class="groupLogo">
+<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="images/project-logo.jpg"></a>
+</div>
+</td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td align="right">
+<div class="projectLogo">
+<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="images/axis.jpg"></a>
+</div>
+</td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top" rowspan="2" align="right" class="search">
+<form target="_blank" action="http://www.google.com/search" method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="3"><img height="8" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit">
+<br>
+                          Search WS</td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="3"><img height="7" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= end Search ==================-->
+</tr>
+</tbody>
+</table>
+</div>
+<!--================= end Banner ==================-->
+<!--================= start Main ==================-->
+<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
+<tbody>
+<!--================= start Status ==================-->
+<tr class="status">
+<td>
+<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a>
+<!--================= end BreadCrumb ==================--></td><td id="tabs">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<span class="selectedTab"><a class="base-selected" href="index.html">WebServices-Axis</a></span>
+</div>
+<!--================= end Tabs ==================-->
+</td>
+</tr>
+</tbody>
+</table>
+<!--================= end Status ==================-->
+<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
+<tbody>
+<tr valign="top">
+<!--================= start Menu ==================-->
+<td id="leftcol">
+<div id="navcolumn">
+<div class="menuBar">
+<div class="menu">
+<span class="menuLabel">Axis</span>
+ 
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
+</div>
+ 
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/news.html">News</a>
+</div>
+ 
+<div class="menuItem">
+<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+</div>
+ 
+<div class="menu">
+<span class="menuLabel">Get Involved</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
+</div>
+ 
+</div>
+ 
+<div class="menu">
+<span class="menuLabel">Axis (Java)</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
+</div>
+ 
+</div>
+ 
+<div class="menu">
+<span class="menuLabel">Axis (C++)</span>
+  
+<div class="menuItem">
+<a href="cpp/index.html">Latest Axis C++ Release!</a>
+</div>
+  
+<div class="menuItem">
+<a href="cpp/documentation.html">Documentation</a>
+</div>
+  
+<div class="menuItem">
+<a href="cpp/download.html">Download</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki Pages</a>
+</div>
+  
+<div class="menuItem">
+<a href="cpp/who.html">Who we are</a>
+</div>
+  
+</div>
+
+<div class="menu">
+<span class="menuLabel">Downloads</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Translation</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Related Projects</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/wsif/">WSIF</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://www.uddi4j.org/">UDDI4J</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Misc</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
+</div>
+
+</div>
+
+
+</div>
+</div>
+</div>
+</td>
+<!--================= end Menu ==================-->
+<!--================= start Content ==================--><td>
+<div id="bodycol">
+<div class="app">
+<div align="center">
+<h1>Site Linkmap</h1>
+</div>
+<div class="h3">
+<div class="h3">
+<h3>Table of Contents</h3>
+</div>
+<li>
+<a href="">Axis</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>site</em>
+</li>
+<ul>
+
+<li>
+<a href="">Axis</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>Axis</em>
+</li>
+<ul>
+ 
+<li>
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>introduction</em>
+</li>
+ 
+<li>
+<a href="http://ws.apache.org/axis/news.html">News</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>news</em>
+</li>
+ 
+<li>
+<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>wiki</em>
+</li>
+ 
+<li>
+<a href="">Get Involved</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>getinvolved</em>
+</li>
+<ul>
+  
+<li>
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>overview</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>cvs</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>mailinglist</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>library</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>bugs</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>buildsite</em>
+</li>
+ 
+</ul>
+ 
+<li>
+<a href="">Axis (Java)</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>axisjava</em>
+</li>
+<ul>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>documentation</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>installation</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>users</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>developers</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>integration</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>architecture</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>reference</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>read</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>requirements</em>
+</li>
+ 
+</ul>
+ 
+<li>
+<a href="">Axis (C++)</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>axiscpp</em>
+</li>
+<ul>
+  
+<li>
+<a href="cpp/index.html">Latest Axis C++ Release!</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>axisc</em>
+</li>
+  
+<li>
+<a href="cpp/documentation.html">Documentation</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>documentation</em>
+</li>
+  
+<li>
+<a href="cpp/download.html">Download</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>download</em>
+</li>
+  
+<li>
+<a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki Pages</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>wiki</em>
+</li>
+  
+<li>
+<a href="cpp/who.html">Who we are</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>who</em>
+</li>
+  
+</ul>
+
+<li>
+<a href="">Downloads</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>downloads</em>
+</li>
+<ul>
+  
+<li>
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>releases</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>interim</em>
+</li>
+  
+<li>
+<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>sourcecode</em>
+</li>
+
+</ul>
+
+<li>
+<a href="">Translation</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>translation</em>
+</li>
+<ul>
+  
+<li>
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>releases</em>
+</li>
+
+</ul>
+
+<li>
+<a href="">Related Projects</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>related</em>
+</li>
+<ul>
+  
+<li>
+<a href="http://ws.apache.org/wsif/">WSIF</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>wsif</em>
+</li>
+  
+<li>
+<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>wsil</em>
+</li>
+  
+<li>
+<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>wsdl4j</em>
+</li>
+  
+<li>
+<a href="http://www.uddi4j.org/">UDDI4J</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>uddi4j</em>
+</li>
+
+</ul>
+
+<li>
+<a href="">Misc</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>misc</em>
+</li>
+<ul>
+  
+<li>
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>who</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>contact</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>legal</em>
+</li>
+  
+<li>
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>&nbsp;&nbsp;&nbsp;_________________________&nbsp;&nbsp;<em>notes</em>
+</li>
+
+</ul>
+
+
+</ul>
+
+  
+<ul>
+    
+<ul>
+      
+<ul>
+        
+        
+        
+      
+</ul>
+      
+      
+    
+</ul>
+  
+</ul>
+
+
+</ul>
+<div id="pdf" align="right">
+<a href="linkmap.pdf"><img alt="PDF" src="skin/images/pdfdoc.gif" class="skin"><br>
+          PDF</a>
+</div>
+</div>
+</div>
+</div>
+</td>
+<!--================= end Content ==================-->
+</tr>
+</tbody>
+</table>
+<!--================= end Main ==================-->
+<!--================= start Footer ==================-->
+<div id="footer">
+<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
+<tbody>
+<tr>
+<!--================= start Copyright ==================-->
+<td colspan="2">
+<div align="center">
+<div class="copyright">
+              Copyright &copy; 2000-2005&nbsp;The Apache Software Foundation. All rights reserved.
+            </div>
+</div>
+</td>
+<!--================= end Copyright ==================-->
+</tr>
+<tr>
+<td align="left">
+<!--================= start Host ==================-->
+<!--================= end Host ==================--></td><td align="right">
+<!--================= start Credits ==================-->
+<div align="right">
+<div class="credit"></div>
+</div>
+<!--================= end Credits ==================-->
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<!--================= end Footer ==================-->
+</body>
+</html>

Added: webservices/axis/trunk/c/docs/user-guide.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/user-guide.html?rev=382398&view=auto
==============================================================================
--- webservices/axis/trunk/c/docs/user-guide.html (added)
+++ webservices/axis/trunk/c/docs/user-guide.html Thu Mar  2 06:56:44 2006
@@ -0,0 +1,294 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
+<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
+<link rel="stylesheet" href="../skin/site.css" type="text/css">
+<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css">
+<title>Axis C++ User's Guide</title>
+</head>
+<body bgcolor="white" class="composite">
+<div id="banner">
+<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
+<tbody>
+<tr>
+<td align="left">
+<div class="groupLogo">
+<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../images/project-logo.jpg"></a>
+</div>
+</td><td align="right">
+<div class="projectLogo">
+<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../images/axis.jpg"></a>
+</div>
+</td><td valign="top" rowspan="2" align="right" class="search">
+<form target="_blank" action="http://www.google.com/search" method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit">
+<br>
+                          Search WS</td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
+</tr>
+</table>
+</form>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
+<tbody>
+<tr class="status">
+<td><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a></td><td id="tabs">
+<div class="tab">
+<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
+</div>
+</td>
+</tr>
+</tbody>
+</table>
+<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
+<tbody>
+<tr valign="top">
+<td id="leftcol">
+<div id="navcolumn">
+<div class="menuBar">
+<div class="menu">
+<span class="menuLabel">Axis</span>
+ 
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
+</div>
+ 
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/news.html">News</a>
+</div>
+ 
+<div class="menuItem">
+<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+</div>
+ 
+<div class="menu">
+<span class="menuLabel">Get Involved</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
+</div>
+ 
+</div>
+ 
+<div class="menu">
+<span class="menuLabel">Axis (Java)</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
+</div>
+ 
+</div>
+ 
+<div class="menu">
+<span class="menuLabel">Axis (C++)</span>
+  
+<div class="menuItem">
+<a href="../cpp/index.html">Home</a>
+</div>
+  
+<div class="menuItem">
+<a href="../cpp/documentation.html">Documentation</a>
+</div>
+  
+<div class="menuItem">
+<a href="../cpp/download.html">Download</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki Pages</a>
+</div>
+  
+<div class="menuItem">
+<a href="../cpp/who.html">Who we are</a>
+</div>
+  
+</div>
+
+<div class="menu">
+<span class="menuLabel">Downloads</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Translation</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Related Projects</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/wsif/">WSIF</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://www.uddi4j.org/">UDDI4J</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Misc</span>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
+</div>
+  
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
+</div>
+
+</div>
+
+
+</div>
+</div>
+</div>
+</td><td>
+<div id="bodycol">
+<div class="app">
+<div align="center">
+<h1>Axis C++ User's Guide</h1>
+</div>
+<div class="h3">
+<div class="h3">
+<h3>Axis C++ User's Guide</h3>
+</div>
+<div id="pdf" align="right">
+<a href="user-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
+          PDF</a>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</tbody>
+</table>
+<div id="footer">
+<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
+<tbody>
+<tr>
+<td colspan="2">
+<div align="center">
+<div class="copyright">
+              Copyright &copy; 2000-2005&nbsp;The Apache Software Foundation. All rights reserved.
+            </div>
+</div>
+</td>
+</tr>
+<tr>
+<td align="left"></td><td align="right">
+<div align="right">
+<div class="credit"></div>
+</div>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</body>
+</html>

Added: webservices/axis/trunk/c/docs/user-guide.pdf
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/user-guide.pdf?rev=382398&view=auto
==============================================================================
--- webservices/axis/trunk/c/docs/user-guide.pdf (added)
+++ webservices/axis/trunk/c/docs/user-guide.pdf Thu Mar  2 06:56:44 2006
@@ -0,0 +1,86 @@
+%PDF-1.3
+%ª«¬­
+4 0 obj
+<< /Type /Info
+/Producer (FOP 0.20.5) >>
+endobj
+5 0 obj
+<< /Length 358 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+GarnR>u/?\'Rf.G>bBfWJA@i)`0bA!1\"$]5,f(;9"QEkSR(F!^R(6in6mJkS."N8Et:orY1@[PJl"-)U><(?'M?;o]#>fZC5JToSnKhHn1n-o=2uatY-bg/XCed=Sr^=jN%XQo<Gn`(#3Oe8@DKDAo1rV+7[Ortr;$KT^rQ4^A?.M&R5jnJNKK5O]D?3iUVWf4_5>8Xc!,faq>bha7MSc57/r8[/toOHTLZ@Gk6FTs8a!uR%p<Va4D^OB46aN(2-3+6OY\/:<1r%Lj],@SiMWZtD&]9W\RY_\8h"qQ$mi6>)D;TR-H8i(d=,Y$<*@hNI@diH]oQ:->l]<Qk\hF+;Z*m^$,QQAoZr*]~>
+endstream
+endobj
+6 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 5 0 R
+>>
+endobj
+7 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F3
+/BaseFont /Helvetica-Bold
+/Encoding /WinAnsiEncoding >>
+endobj
+8 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F1
+/BaseFont /Helvetica
+/Encoding /WinAnsiEncoding >>
+endobj
+9 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F2
+/BaseFont /Helvetica-Oblique
+/Encoding /WinAnsiEncoding >>
+endobj
+10 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F7
+/BaseFont /Times-Bold
+/Encoding /WinAnsiEncoding >>
+endobj
+1 0 obj
+<< /Type /Pages
+/Count 1
+/Kids [6 0 R ] >>
+endobj
+2 0 obj
+<< /Type /Catalog
+/Pages 1 0 R
+ >>
+endobj
+3 0 obj
+<< 
+/Font << /F3 7 0 R /F1 8 0 R /F2 9 0 R /F7 10 0 R >> 
+/ProcSet [ /PDF /ImageC /Text ] >> 
+endobj
+xref
+0 11
+0000000000 65535 f 
+0000001069 00000 n 
+0000001127 00000 n 
+0000001177 00000 n 
+0000000015 00000 n 
+0000000071 00000 n 
+0000000520 00000 n 
+0000000626 00000 n 
+0000000738 00000 n 
+0000000845 00000 n 
+0000000960 00000 n 
+trailer
+<<
+/Size 11
+/Root 2 0 R
+/Info 4 0 R
+>>
+startxref
+1286
+%%EOF