You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by gu...@apache.org on 2005/05/24 17:54:49 UTC
cvs commit: ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/java user-guide.xml reference.xml
guillaume 2005/05/24 08:54:49
Modified: site/src4forrest-060/java/src/documentation/content/xdocs
site.xml who.xml
site/src4forrest-060/java/src/documentation/content/xdocs/java
user-guide.xml reference.xml
Log:
* Update documentation for arrayMapping thingy
* add my name in committers list :)
* update wsdl4j link
* add jUDDI in related projects
Revision Changes Path
1.2 +2 -1 ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/site.xml
Index: site.xml
===================================================================
RCS file: /home/cvs/ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/site.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- site.xml 27 Jan 2005 09:42:06 -0000 1.1
+++ site.xml 24 May 2005 15:54:49 -0000 1.2
@@ -56,8 +56,9 @@
</translation>
<related label="Related Projects">
<wsif label="WSIF" href="http://ws.apache.org/wsif/"/>
+ <wsif label="jUDDI" href="http://ws.apache.org/juddi/"/>
<wsil label="WSIL" href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm"/>
- <wsdl4j label="WSDL4J" href="http://www-124.ibm.com/developerworks/projects/wsdl4j/"/>
+ <wsdl4j label="WSDL4J" href="http://wsdl4j.sourceforge.net"/>
<uddi4j label="UDDI4J" href="http://www.uddi4j.org/"/>
</related>
<misc label="Misc">
1.3 +4 -0 ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/who.xml
Index: who.xml
===================================================================
RCS file: /home/cvs/ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/who.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- who.xml 24 Feb 2005 10:00:35 -0000 1.2
+++ who.xml 24 May 2005 15:54:49 -0000 1.3
@@ -106,6 +106,10 @@
<b>Jongjin Choi</b>
<<a href="mailto:jjchoe@tmax.co.kr">jjchoe@tmax.co.kr</a>>
</li>
+ <li>
+ <b>Guillaume Sauthier</b>
+ <<a href="mailto:guillaume@apache.org">guillaume@apache.org</a>>
+ </li>
</ul>
</section>
1.2 +17 -1 ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/java/user-guide.xml
Index: user-guide.xml
===================================================================
RCS file: /home/cvs/ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/java/user-guide.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- user-guide.xml 27 Jan 2005 09:42:52 -0000 1.1
+++ user-guide.xml 24 May 2005 15:54:49 -0000 1.2
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "./dtd/document-v12.dtd">
<document>
<header>
@@ -800,6 +800,22 @@
</section>
+<section>
+<title>Deploying array mappings - the <arrayMapping> tag</title>
+
+<p>nother variation around typeMapping is arrayMapping. The arrayMapping tag is useful for advanced users wanting to exatly control how their arrays are serialized throught the wire. </p>
+
+<source><arrayMapping qname="ns:ArrayOfthingy" xmlns:ns="someNamespaceURI"
+ languageSpecificType="java:my.java.array.thingy[]"
+ innerType="ns2:thingy" xmlns:ns2="anotherNamespaceURI"
+ encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/></source>
+
+<p>No need here to specify a serializer/deserializer couple, the arrayMapping tag
+is only about arrays (no List, ...). The added attribute (<i>innerType</i>) is used
+to tell Axis what precisely is the item type of the Array.</p>
+
+</section>
+
</section>
</section>
1.3 +7 -4 ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/java/reference.xml
Index: reference.xml
===================================================================
RCS file: /home/cvs/ws-axis/site/src4forrest-060/java/src/documentation/content/xdocs/java/reference.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- reference.xml 24 Feb 2005 09:58:08 -0000 1.2
+++ reference.xml 24 May 2005 15:54:49 -0000 1.3
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "./dtd/document-v12.dtd">
<document>
<header>
@@ -481,14 +481,17 @@
<dd>Defines a transport on the client side, which is invoked when sending a SOAP message. The "pivot" attribute specifies a Handler to be used as the actual sender for this transport (for example, the HTTPSender). Request and response flows may be specified as in server-side transports to do processing on the request (i.e. outgoing message) or response (i.e. incoming message).</dd>
-<dt><typeMapping qname="<i>ns:localName</i>" classname="<i>classname</i>" serializer="<i>classname</i>" deserializer="<i>classname</i>"/></dt>
+<dt><typeMapping qname="<i>ns:localName</i>" type="<i>java:classname</i>" serializer="<i>classname</i>" deserializer="<i>classname</i>"/></dt>
<dd>Each typeMapping maps an XML qualified name to/from a Java class, using a specified Serializer and Deserializer.</dd>
-<dt><beanMapping qname="<i>ns:localName</i>" classname="<i>classname</i>"></dt>
+<dt><beanMapping qname="<i>ns:localName</i>" type="<i>java:classname</i>"></dt>
<dd>A simplified type mapping, which uses pre-defined serializers/deserializers to encode/decode JavaBeans. The class named by "classname" must follow the JavaBean standard pattern of get/set accessors.</dd>
-<dt><documentation></dt>
+<dt><arrayMapping qname="<i>ns:localName</i>" type="<i>java:classname</i>" innerType="<i>ns:innerTypeQName</i>"></dt>
+<dd>A specialized type mapping, which uses pre-defined serializers/deserializers to encode/decode Arrays. The class named by "classname" must be an array type (ie name ending with "[]").</dd>
+
+ <dt><documentation></dt>
<dd>Can be used inside a <b><service></b>, an <b><operation></b> or an operation <b><parameter></b>. The content of the element is arbitrary text which will be put in the generated wsdl inside a wsdl:document element.<br/><br/>
Example:
<source><operation name="echoString" >