mrglavas 2003/11/17 10:35:32 Modified: java/docs dom.xml faq-dom.xml readme.xml dom3.xml Log: Patch to documentation concerning DOM Level 3. Submitted by Neil Delima. Revision Changes Path 1.3 +1 -1 xml-xerces/java/docs/dom.xml Index: dom.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/dom.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- dom.xml 21 Jan 2003 23:17:01 -0000 1.2 +++ dom.xml 17 Nov 2003 18:35:32 -0000 1.3 @@ -10,7 +10,7 @@ <li><jump href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/'>DOM Level 2 Events: Mutation Events</jump></li> </ul> <p> -Xerces2 also provides an <strong>experimental</strong> implementation of <link idref="dom3">DOM Level 3 'Core' and 'Load and Save' Working Drafts</link>. +Xerces2 also provides an <strong>experimental</strong> implementation of <link idref="dom3">DOM Level 3 'Core' and 'Load and Save' Candidate Recommendations.</link>. </p> </s2> 1.9 +13 -13 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.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- faq-dom.xml 30 Jul 2003 20:47:01 -0000 1.8 +++ faq-dom.xml 17 Nov 2003 18:35:32 -0000 1.9 @@ -114,7 +114,7 @@ <source>import org.w3c.dom.DOMImplementationRegistry; import org.w3c.dom.Document; import org.w3c.dom.ls.DOMImplementationLS; -import org.w3c.dom.ls.DOMBuilder; +import org.w3c.dom.ls.LSParser; ... @@ -126,7 +126,7 @@ DOMImplementationLS impl = (DOMImplementationLS)registry.getDOMImplementation("LS-Load"); -DOMBuilder builder = impl.createDOMBuilder( +LSParser builder = impl.createLSParser( DOMImplementationLS.MODE_SYNCHRONOUS, null); Document document = builder.parseURI("data/personal.xml");</source> @@ -164,7 +164,7 @@ <source>import org.w3c.dom.DOMImplementationRegistry; import org.w3c.dom.Document; import org.w3c.dom.ls.DOMImplementationLS; -import org.w3c.dom.ls.DOMWriter; +import org.w3c.dom.ls.LSWriter; ... @@ -177,8 +177,8 @@ ... -DOMWriter builder = impl.createDOMWriter(); -writer.writeNode(System.out, document);</source> +LSWriter writer = impl.createLSSerializer(); +String str = writer.writeToString(document);</source> </a> </faq> @@ -199,7 +199,7 @@ <jump href="#dom3">Build</jump> DOM Level 3 Xerces jars. </li> <li> - <jump href="#domparser">Create</jump> the DOMBuilder. + <jump href="#domparser">Create</jump> the DOMParser. </li> <li> Retrieve <code>DOMConfiguration</code> from the <code>Document</code>, @@ -214,19 +214,19 @@ </li> <li> Relative URIs for the schema documents will be resolved relative to the - <jump href="http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20020409/core.html#Document3-documentURI";>documentURI</jump> + <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-Core-20031107/core.html#Document3-documentURI";>documentURI</jump> (which should be set). - Otherwise, you can implement your own <code>DOMEntityResolver</code> and set it - via <code>entity-resolver</code> on the <code>DOMConfiguration</code>. + Otherwise, you can implement your own <code>DOMResourceResolver</code> and set it + via <code>resource-resolver</code> on the <code>DOMConfiguration</code>. </li> </ul> <p> <strong>Note:</strong> if a document contains any DOM Level 1 nodes (the nodes created using createElement, createAttribute, etc.) the fatal error will occur as described in the - <jump href='http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20021022/namespaces-algorithms.html'>Namespace Normalization</jump> + <jump href='http://www.w3.org/TR/2003/CR-DOM-Level-3-Core-20031107/namespaces-algorithms.html'>Namespace Normalization</jump> algorithm. In general, the - <jump href='http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20021022/core.html#Namespaces-Considerations'>DOM specification</jump> + <jump href='http://www.w3.org/TR/2003/CR-DOM-Level-3-Core-20031107/core.html#Namespaces-Considerations'>DOM specification</jump> discourages using DOM Level 1 nodes in the namespace aware application: </p> <p><em>DOM Level 1 methods are namespace ignorant. Therefore, while it is safe to use these methods when not @@ -238,7 +238,7 @@ <source> import org.w3c.dom.Document; import org.w3c.dom.DOMConfiguration; -import org.w3c.dom.ls.DOMBuilder; +import org.w3c.dom.ls.LSParser; ..... @@ -368,7 +368,7 @@ <faq title="Accessing type information"> <q>How do I access type information in the DOM?</q> - <a> <p><jump href="#dom3">DOM Level 3</jump> defines a <jump href="http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20021022/core.html#TypeInfo";>TypeInfo</jump> + <a> <p><jump href="#dom3">DOM Level 3</jump> defines a <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-Core-20031107/core.html#TypeInfo";>TypeInfo</jump> interface that exposes type information for element and attribute nodes. The type information depends on the document schema and is only available if Xerces was able to find the corresponding grammar (DOM Level 3 <code>validate</code> or 1.39 +1 -1 xml-xerces/java/docs/readme.xml Index: readme.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/readme.xml,v retrieving revision 1.38 retrieving revision 1.39 diff -u -r1.38 -r1.39 --- readme.xml 13 Nov 2003 23:04:22 -0000 1.38 +++ readme.xml 17 Nov 2003 18:35:32 -0000 1.39 @@ -25,7 +25,7 @@ </p> <p> Xerces2 also provides an <link idref='dom3'>experimental implementation</link> of the Document - Object Model Level 3 Core and Load/Save Working Drafts and provides a + Object Model Level 3 Core and Load/Save Candidate Recommendations and provides a <link idref='faq-xinclude'>partial implementation</link> of the XML Inclusions (XInclude) W3C Candidate Recommendation. </p> 1.11 +27 -21 xml-xerces/java/docs/dom3.xml Index: dom3.xml =================================================================== RCS file: /home/cvs/xml-xerces/java/docs/dom3.xml,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- dom3.xml 30 Jul 2003 20:47:01 -0000 1.10 +++ dom3.xml 17 Nov 2003 18:35:32 -0000 1.11 @@ -11,10 +11,9 @@ The <jump href="http://www.w3.org/DOM/DOMTR#DOML3";>DOM Level 3</jump> specification is at the stage of - <strong>Working Draft in Last Call</strong>, which represents work in progress and thus may be - updated, replaced, or obsoleted by other documents at any - time. - + <strong>Candidate Recommendation</strong>, which represents work in progress + and has been widely reviewed and satisfies certain technical requirements + but may still change based on implementation experience. This implementation is experimental: it should not be considered as complete or correct. @@ -23,8 +22,8 @@ <s2 title="Introduction"> <p> The &ParserNameLong; &ParserVersion; contains an implementation of - the Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-Core-20030609/";>Core</jump> - and Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030619/";>Load and Save</jump> Working drafts. + the Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-Core-20031107/";>Core</jump> + and Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/";>Load and Save</jump> Candidate Recommendations. To learn how to program with the DOM Level 3 see <jump href="samples-dom.html#DOM3">dom.DOM3</jump> sample. </p> <p> @@ -59,7 +58,7 @@ ] </li> <li> - <strong>entity-resolver</strong> + <strong>resource-resolver</strong> [ <em>DOMResourceResolver</em> ] @@ -95,6 +94,12 @@ ] </li> <li> + <strong>namespaces</strong> + [ + <em>true/false</em> + ] + </li> + <li> <strong>entities</strong> [ <em>true/false</em> @@ -143,14 +148,6 @@ ] </li> <li> - <strong>discard-default-content</strong> - [ - <em>true/false</em> - ] -- the removal of default content depends on - <code>isSpecified</code> - flag. - </li> - <li> <strong>validate</strong> [ <em>true/false</em> @@ -165,17 +162,26 @@ ] </li> <li> + <strong>check-character-normalization</strong> + [ + <em>false</em> + ] + </li> + <li> + <strong>well-formed</strong> + [ + <em>false</em> + ] + </li> + <li> <strong>psvi</strong> [ <em>true/false</em> - ] -- setting the value of this parameter to true will include + ] -- (NON-DOM) setting the value of this parameter to true will include PSVI information in the DOM tree. To access the information, cast dom.Element to org.apache.xerces.xni.psvi.ElementPSVI and dom.Attr to org.apache.xerces.xni.psvi.AttributePSVI. </li> - - - </ul> </s2> @@ -184,12 +190,12 @@ <ul> <li> - <strong>DOMParser</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/load-save.html#LS-DOMBuilder-parseWithContext";> + <strong>DOMParser</strong> <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/load-save.html#LS-LSParser-parseWithContext";> parserWithContext</jump> -- not supported. </li> <li><strong>DocumentLS, ElementLS</strong> - convenience interfaces are not supported.</li> - <li><strong>DOMImplementationLS</strong> <jump href="http://www.w3.org/TR/2003/WD-DOM-Level-3-LS-20030226/load-save.html#LS-DOMIMplementationLS-MODE_SYNC";> + <li><strong>DOMImplementationLS</strong> <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/load-save.html#LS-DOMIMplementationLS-MODE_ASYNCH";> MODE_ASYNCHRONOUS</jump> -- not supported. </li>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
