You are viewing a plain text version of this content. The canonical link for it is here.
Posted to soap-dev@xml.apache.org by du...@apache.org on 2001/05/21 22:14:15 UTC
cvs commit: xml-soap/java/docs/guide serializer.html
duftler 01/05/21 13:14:14
Modified: java/docs/guide serializer.html
Log:
More docs from Bill.
Submitted by: Bill Nagy (nagy@watson.ibm.com)
Reviewed by: Matthew J. Duftler (duftler@us.ibm.com)
Revision Changes Path
1.4 +22 -3 xml-soap/java/docs/guide/serializer.html
Index: serializer.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/guide/serializer.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- serializer.html 2001/05/21 16:51:29 1.3
+++ serializer.html 2001/05/21 20:14:07 1.4
@@ -41,7 +41,9 @@
<LI>java.util.GregorianCalendar
<LI>java.util.Vector
<LI>java.util.Hashtable
- <LI>java.util.Map
+ <LI>java.util.Map (under Java editions in which
+ this is supported)
+ <LI>java.math.BigDecimal
<LI>javax.mail.internet.MimeBodyPart
<LI>java.io.InputStream
<LI>javax.activation.DataSource
@@ -121,7 +123,24 @@
named accessors (elements) in the XML form.
To use the BeanSerializer, simply pass "org.apache.soap.encoding.soapenc.BeanSerializer"
as the last two parameters when you are registering
-the type mapping for your object.</P>
+the type mapping for your object.<BR>
+<I><BR>
+Note: The object that you are serializing
+with the BeanSerializer <B>MUST</B> be a <A href="http://java.sun.com/products/javabeans/docs/index.html">JavaBean</A> for this serializer to work:</I></P>
+<UL>
+ <LI><I>It <B>MUST</B> have a no-args constructor</I>
+ <LI><I>It <B>MUST</B> expose all interesting state through properties</I>
+ <LI><I>It <B>MUST</B> not matter what order the accessors for
+ the properties (i.e. the setX/getX methods)
+ are in</I>
+ <LI><I>etc.</I>
+</UL>
+<P><I> This is <B>NOT</B> a general/all-purpose serializer. It <B>WILL NOT</B> work if the object which you are serializing/deserializing
+does not conform to the <A href="http://java.sun.com/products/javabeans/docs/spec.html">JavaBeans definition</A>. It is <B>NOT</B> a bug if you cannot serialize/deserialize
+your non-Bean, Java class with this, any
+more than it is a bug that you can't serialize
+a java.awt.Panel with the java.util.Date
+serializer.</I> </P>
<H3>Creating New Serializers and Deserializers</H3>
<P>If you need to create a new serializer/deserializer,
then looking at the source code for the predefined
@@ -132,6 +151,6 @@
respectively. You can implement them both
in the same class, or use two different classes,
it really makes no difference.</P>
-<P>Last updated 5/20/2001 by Bill Nagy <<A href="mailto:nagy@watson.ibm.com">nagy@watson.ibm.com</A>>.</P>
+<P>Last updated 5/21/2001 by Bill Nagy <<A href="mailto:nagy@watson.ibm.com">nagy@watson.ibm.com</A>>.</P>
</body>
</HTML>