Return-Path: 
 <xerces-cvs-return-11948-apmail-xml-xerces-cvs-archive=xml.apache.org@xml.apache.org>
Delivered-To: apmail-xml-xerces-cvs-archive@www.apache.org
Received: (qmail 80794 invoked from network); 19 Feb 2004 22:34:07 -0000
Received: from daedalus.apache.org (HELO mail.apache.org) (208.185.179.12)
  by minotaur-2.apache.org with SMTP; 19 Feb 2004 22:34:07 -0000
Received: (qmail 55703 invoked by uid 500); 19 Feb 2004 22:33:54 -0000
Delivered-To: apmail-xml-xerces-cvs-archive@xml.apache.org
Received: (qmail 55680 invoked by uid 500); 19 Feb 2004 22:33:54 -0000
Mailing-List: contact xerces-cvs-help@xml.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:xerces-cvs-help@xml.apache.org>
list-unsubscribe: <mailto:xerces-cvs-unsubscribe@xml.apache.org>
list-post: <mailto:xerces-cvs@xml.apache.org>
Reply-To: <xerces-dev@xml.apache.org>
Delivered-To: mailing list xerces-cvs@xml.apache.org
Received: (qmail 55667 invoked from network); 19 Feb 2004 22:33:54 -0000
Received: from unknown (HELO minotaur.apache.org) (209.237.227.194)
  by daedalus.apache.org with SMTP; 19 Feb 2004 22:33:54 -0000
Received: (qmail 80774 invoked by uid 1678); 19 Feb 2004 22:34:06 -0000
Date: 19 Feb 2004 22:34:06 -0000
Message-ID: <20040219223406.80773.qmail@minotaur.apache.org>
From: mrglavas@apache.org
To: xml-xerces-cvs@apache.org
Subject: cvs commit: xml-xerces/java/docs faq-dom.xml
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N
X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N

mrglavas    2004/02/19 14:34:06

  Modified:    java/docs faq-dom.xml
  Log:
  Adding FAQ on Java Object Serialization.
  
  Revision  Changes    Path
  1.14      +22 -3     xml-xerces/java/docs/faq-dom.xml
  
  Index: faq-dom.xml
  ===================================================================
  RCS file: /home/cvs/xml-xerces/java/docs/faq-dom.xml,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- faq-dom.xml	30 Jan 2004 15:12:35 -0000	1.13
  +++ faq-dom.xml	19 Feb 2004 22:34:06 -0000	1.14
  @@ -79,9 +79,10 @@
       </a>
     </faq>
   
  -  <faq title="Serializing a DOM document.">
  +  <faq title="Serializing a DOM document">
       <q>How do I serialize DOM to an output stream?</q>
  -    <a> <p>
  +    <a><anchor name="dom-xml-serialization"/>
  +      <p>
   	You can serialize a DOM tree by using Xerces <code>org.apache.xml.XMLSerializer</code>:
         </p>
         <source>import org.apache.xml.serialize.OutputFormat;
  @@ -123,6 +124,25 @@
   String str = writer.writeToString(document);</source>  
       </a>
     </faq>
  +  
  +  <faq title="Java Object Serialization of a DOM">
  +    <q>Does Xerces DOM implement java.io.Serializable?</q>
  +    <a>
  +      <p>Yes. Xerces DOM can be serialized using Java object serialization.
  +         It is recommended that a DOM be serialized as 
  +         <link anchor='dom-xml-serialization'>XML</link> where possible
  +         instead of using object serialization.
  +      </p>
  +      <p>By choosing object serialization you sacrifice interoperability 
  +         between parsers and we do not guarantee interoperability 
  +         between versions of Xerces. It should be used with caution.
  +      </p>
  +      <p>Some rough measurements have shown that XML serialization performs
  +         better than Java object serialization and that XML instance documents 
  +         require less storage space than object serialized DOMs.
  +      </p>
  +    </a>
  +  </faq>
   
     <faq title="Specifying non-Xerces DOM implementation">
       <q>How do I supply my own implementation of the DOM?</q>
  @@ -235,7 +255,6 @@
     		<p>
     			DOM revalidation is supported via W3C DOM Level 3 Core
     			<em>Document.normalizeDocument()</em>.
  -  			.
     		</p>
     		<note>This release only supports revalidation against XML Schemas. Revalidation against DTDs or any other schema type is not implemented.</note>
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: xerces-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-cvs-help@xml.apache.org