Author: amassari
Date: Fri Mar 31 06:55:07 2006
New Revision: 390437
URL: http://svn.apache.org/viewcvs?rev=390437&view=rev
Log:
Updated part of the DOML3 documentation
Modified:
xerces/c/trunk/doc/build-winunix.xml
xerces/c/trunk/doc/dom3.xml
xerces/c/trunk/doc/domprint.xml
xerces/c/trunk/doc/faq-parse.xml
xerces/c/trunk/doc/html/ApacheDOMC++BindingL3.html
xerces/c/trunk/doc/program-dom.xml
xerces/c/trunk/doc/program-others.xml
xerces/c/trunk/doc/program.xml
Modified: xerces/c/trunk/doc/build-winunix.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/build-winunix.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/build-winunix.xml (original)
+++ xerces/c/trunk/doc/build-winunix.xml Fri Mar 31 06:55:07 2006
@@ -33,8 +33,12 @@
all other samples is in:</p>
<p>For MSVC Version 6:</p>
<source>&XercesCSrcInstallDir;\Projects\Win32\VC6\xerces-all\xerces-all.dsw</source>
- <p>For MSVC Version 7 (Visual C++.Net):</p>
+ <p>For MSVC Version 7 (Visual C++ .NET 2002):</p>
<source>&XercesCSrcInstallDir;\Projects\Win32\VC7\xerces-all\xerces-all.sln</source>
+ <p>For MSVC Version 7.1 (Visual C++ .NET 2003):</p>
+<source>&XercesCSrcInstallDir;\Projects\Win32\VC7.1\xerces-all\xerces-all.sln</source>
+ <p>For MSVC Version 8.0 (Visual C++ .NET 2005):</p>
+<source>&XercesCSrcInstallDir;\Projects\Win32\VC8\xerces-all\xerces-all.sln</source>
<p>Once you are inside MSVC, you need to build the project marked
<em>XercesLib</em>.</p>
@@ -42,6 +46,8 @@
you need to pick up:</p>
<source>(For MSVC V6)
&XercesCSrcInstallDir;\Projects\Win32\VC6\xerces-all\XercesLib\XercesLib.dsp
(For MSVC V7)
&XercesCSrcInstallDir;\Projects\Win32\VC7\xerces-all\XercesLib\XercesLib.vcproj</source>
+(For MSVC V7.1)
&XercesCSrcInstallDir;\Projects\Win32\VC7.1\xerces-all\XercesLib\XercesLib.vcproj</source>
+(For MSVC V8)
&XercesCSrcInstallDir;\Projects\Win32\VC8\xerces-all\XercesLib\XercesLib.vcproj</source>
<p>You must make sure that you are linking your application with
the &XercesCWindowsLib;.lib library and also make sure that
the associated DLL is somewhere in your path.</p>
Modified: xerces/c/trunk/doc/dom3.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/dom3.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/dom3.xml (original)
+++ xerces/c/trunk/doc/dom3.xml Fri Mar 31 06:55:07 2006
@@ -18,66 +18,27 @@
<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
<s1 title="DOM Level 3 Support">
-<s2 title="Disclaimer">
- <p>
- The &XercesCName; &XercesCVersion; contains a partial implementation of
the W3C Document Object Model
- Level 3. This implementation is experimental. The DOM Level 3
specification is
- still in working draft stage: you should not consider this implementation
complete or correct.</p>
- <p>The limitations of this implementation are detailed below.
- Please, read this document before using &XercesCName; &XercesCVersion;.
- </p>
-</s2>
<s2 title="Introduction">
<p>
- The &XercesCName; &XercesCVersion; contains an experimental implementation
of
- a subset of the W3C DOM Level 3 as specified in </p>
+ The &XercesCName; &XercesCVersion; contains an implementation of the W3C
DOM Level 3 as specified in </p>
<ul>
<li><jump href="http://www.w3.org/TR/DOM-Level-3-Core/";>
- DOM Level 3.0 Core Specification</jump>, Version 1.0 W3C Working
Draft 26 February 2003 and </li>
+ DOM Level 3.0 Core Specification</jump>, Version 1.0 W3C
Recommendation 07 April 2004</li> and
<li> <jump href="http://www.w3.org/TR/DOM-Level-3-LS/";>
Document Object Model (DOM) Level 3 Load and Save
Specification</jump>,
- Version 1.0 W3C Working Draft 26 February 2003 </li>
+ Version 1.0 W3C Recommendation 07 April 2004</li>
</ul>
</s2>
<s2 title='Implementation of DOM Level 3 Core'>
- <p>The following are implemented in &XercesCName; &XercesCVersion;.</p>
+ <p>The following are NOT implemented in &XercesCName; &XercesCVersion;.</p>
<ul>
<li>
- <code>DOMImplementationRegistry</code>,
<code>DOMImplementationSource</code>
- </li>
- <li>
- <code>DOMException</code>: VALIDATION_ERR
- </li>
- <li>
- <code>DOMDocument</code>: set/getActualEncoding, set/getEncoding,
set/getVersion, set/getStandalone,
- set/getDocumentURI, set/getStrictErrorChecking, renameNode,
normalizeDocument
- </li>
- <li>
- <code>DOMEntity</code>: set/getActualEncoding, set/getEncoding,
set/getVersion
- </li>
- <li>
- <code>DOMErrorHandler</code>, <code>DOMError</code>,
<code>DOMLocator</code>
- </li>
- <li>
- <code>DOMNode</code>: set/getUserData, isSameNode, isEqualNode,
compareTreePosition, lookupNamespaceURI, lookupNamespacePrefix,
isDefaultNamespace, baseURI
- </li>
- <li>
- <code>DOMText</code>: getIsWhitespaceInElementContent
+ <code>DOMError</code>: setRelatedException
</li>
<li>
- <code>DOMAttr</code>: isID, getTypeInfo
+ <code>DOMImplementation</code>: createLSParser(MODE_ASYNCHRONOUS)
</li>
- <li>
- <code>DOMElement</code>: setIdAttributeNode, setIdAttributeNS,
setIdAttribute, getTypeInfo
- </li>
- <li>
- <code>DOMUserDataHandler</code>
- </li>
- <li>
- <code>DOMConfiguration</code>
- </li>
-
</ul>
</s2>
@@ -85,24 +46,12 @@
<p>The following are implemented in &XercesCName; &XercesCVersion;.</p>
<ul>
<li>
- <code>DOMImplementationLS</code>
- </li>
- <li>
- <code>DOMBuilder</code>: does not provide implementation of
parseWithContext() and <code>DOMBuilderFilter</code>.
- </li>
- <li>
- <code>DOMEntityResolver</code>
- </li>
- <li>
- <code>DOMInputSource</code>
- </li>
- <li>
- <code>DOMWriter</code> and <code>DOMWriterFilter</code>
+ <code>DOMLSParser</code>: parseWithContext()</code>.
</li>
</ul>
</s2>
-<s2 title='Implementation of DOM Level 3 Abstract Schemas'>
+<s2 title='Implementation of DOM Level 3 Validation'>
<p>The entire section has not been implemented in &XercesCName;
&XercesCVersion;.</p>
</s2>
Modified: xerces/c/trunk/doc/domprint.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/domprint.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/domprint.xml (original)
+++ xerces/c/trunk/doc/domprint.xml Fri Mar 31 06:55:07 2006
@@ -21,7 +21,7 @@
<s2 title="DOMPrint">
<p>DOMPrint parses an XML file, constructs the DOM tree, and
- invokes DOMWriter::writeNode() to serialize the resultant
+ invokes DOMLSSerializer::write() to serialize the resultant
DOM tree back to XML stream.
</p>
@@ -29,7 +29,7 @@
<p>The DOMPrint sample parses an XML file, using either a validating
or non-validating DOM parser configuration, builds a DOM tree,
- and then invokes DOMWriter::writeNode() to serialize the
+ and then invokes DOMLSSerializer::write() to serialize the
resultant DOM tree. To run DOMPrint, enter the following:</p>
<source>DOMPrint <XML file></source>
<p>The following parameters may be set from the command line </p>
@@ -38,7 +38,7 @@
DOMPrint [options] <XML file>
This program invokes the DOM parser, and builds the DOM tree
-It then asks the DOMWriter to serialize the DOM tree.
+It then asks the DOMLSSerializer to serialize the DOM tree.
Options:
-e create entity reference nodes. Default is no expansion.
@@ -124,7 +124,7 @@
</p>
<p>Application needs to provide its own implementation of
- DOMWriterFilter (in this sample, the DOMPrintFilter),
+ DOMLSSerializerFilter (in this sample, the DOMPrintFilter),
if it would like to filter out certain part of the DOM
representation, but must be aware that thus may render the
resultant XML stream invalid.
Modified: xerces/c/trunk/doc/faq-parse.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/faq-parse.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/faq-parse.xml (original)
+++ xerces/c/trunk/doc/faq-parse.xml Fri Mar 31 06:55:07 2006
@@ -433,9 +433,9 @@
<p>Please make sure you are using &XercesCName; &XercesCVersion; or
up.</p>
<p>You can use
- the DOMWriter::writeToString, or DOMWriter::writeNode to serialize a
DOM tree.
+ the DOMLSSerializer::writeToString, or DOMLSSerializer::write to
serialize a DOM tree.
Please refer to the sample DOMPrint or the API documentation for more
details of
- DOMWriter.</p>
+ DOMLSSerializer.</p>
</a>
</faq>
@@ -769,10 +769,10 @@
<a>
<p>The function <code>SAX2XMLReader::setProperty(const XMLCh* const
name, void* value)</code>
- and <code>DOMBuilder::setProperty(const XMLCh* const name, void*
value)</code>
+ and <code>DOMLSParser::getDomConfig()->setParameter(const XMLCh*
name, const void* value)</code>
takes a void pointer for the property value. Application is required
to initialize this void pointer
to a correct type. See <jump
href="program-sax2.html#SAX2Properties">SAX2 Programming Guide</jump>
- and <jump href="program-dom.html#DOMBuilderProperties">DOM
Programming Guide</jump>
+ and <jump href="program-dom.html#DOMLSParserProperties">DOM
Programming Guide</jump>
to learn exactly what type of property value that each property
expects for processing.
Passing a void pointer that was initialized with a wrong type will
lead to unexpected result.
</p>
@@ -787,7 +787,7 @@
<a>
<p>The function <code>void* SAX2XMLReader::getProperty(const XMLCh*
const name)</code>
- and <code>void* DOMBuilder::getProperty(const XMLCh* const
name)</code>
+ and <code>void* DOMLSParser::getDomConfig()->getParameter(const
XMLCh* name)</code>
returns a void pointer for the property value. See
<jump href="program-sax2.html#SAX2Properties">SAX2 Programming
Guide</jump> and
exactly what type of object each property returns.
@@ -799,7 +799,7 @@
somewhere else; otherwise you may get unexpected result. Since the
returned
pointer is a generic void pointer, see
<jump href="program-sax2.html#SAX2Properties">SAX2 Programming
Guide</jump> and
- <jump href="program-dom.html#DOMBuilderProperties">DOM Programming
Guide</jump> to learn
+ <jump href="program-dom.html#DOMLSParserProperties">DOM Programming
Guide</jump> to learn
exactly what type of property value each property returns for
replication.
</p>
@@ -855,24 +855,24 @@
</a>
</faq>
- <faq title="Why does the XML data generated by the DOMWriter does not match
my original XML input?">
+ <faq title="Why does the XML data generated by the DOMLSSerializer does not
match my original XML input?">
- <q>Why does the XML data generated by the DOMWriter does not match my
original XML input?</q>
+ <q>Why does the XML data generated by the DOMLSSerializer does not match
my original XML input?</q>
<a>
- <p>If you parse an xml document using XercesDOMParser or DOMBuilder and
pass such DOMNode
- to DOMWriter for serialization, you may not get something that is
exactly the same
+ <p>If you parse an xml document using XercesDOMParser or DOMLSParser and
pass such DOMNode
+ to DOMLSSerializer for serialization, you may not get something that
is exactly the same
as the original XML data. The parser may have done normalization,
end of line conversion,
or has expanded the entity reference as per the XML 1.0 spec, 4.4 XML
Processor Treatment of
- Entities and References. From DOMWriter perspective, it does not
know what the original
+ Entities and References. From DOMLSSerializer perspective, it does
not know what the original
string was, all it sees is a processed DOMNode generated by the
parser.
- But since the DOMWriter is supposed to generate something that is
parsable if sent
- back to the parser, it will not print the DOMNode node value as is.
The DOMWriter
+ But since the DOMLSSerializer is supposed to generate something that
is parsable if sent
+ back to the parser, it will not print the DOMNode node value as is.
The DOMLSSerializer
may do some "touch up" to the output data for it to be parsable.</p>
- <p>See <jump href="program-dom.html#DOMWriterEntityRef">How does
DOMWriter handle built-in entity
- Reference in node value?</jump> to understand further how DOMWriter
touches up the entity reference.
+ <p>See <jump href="program-dom.html#DOMLSSerializerEntityRef">How does
DOMLSSerializer handle built-in entity
+ Reference in node value?</jump> to understand further how
DOMLSSerializer touches up the entity reference.
</p>
</a>
</faq>
Modified: xerces/c/trunk/doc/html/ApacheDOMC++BindingL3.html
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/html/ApacheDOMC%2B%2BBindingL3.html?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/html/ApacheDOMC++BindingL3.html (original)
+++ xerces/c/trunk/doc/html/ApacheDOMC++BindingL3.html Fri Mar 31 06:55:07 2006
@@ -2563,8 +2563,8 @@
<td><font face="Courier New,Courier"><font
size=-1>DOMDocumentType*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>createDocumentType(const
XMLCh *qName, const XMLCh*
publicId,
- const XMLCh* systemId
+<td><font face="Courier New,Courier"><font size=-1>createDocumentType(const
XMLCh *qName, const XMLCh*,
//publicId,
+ const XMLCh* //systemId
)
</font></font></td>
</tr>
@@ -3792,7 +3792,7 @@
<td><font face="Courier New,Courier"><font
size=-1>DOMLSInput*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>createLSInput() =
0;</font></font></td>
+<td><font face="Courier New,Courier"><font
size=-1>createLSInput(MemoryManager* const manager =
XMLPlatformUtils::fgMemoryManager) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -3802,7 +3802,7 @@
<td><font face="Courier New,Courier"><font
size=-1>DOMLSOutput*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>createLSOutput() =
0;</font></font></td>
+<td><font face="Courier New,Courier"><font
size=-1>createLSOutput(MemoryManager* const manager =
XMLPlatformUtils::fgMemoryManager) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
<td><font face="Courier New,Courier"><font size=-1>};</font></font></td>
@@ -3852,7 +3852,7 @@
<td><font face="Courier New,Courier"><font size=-1>const
XMLCh*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>getCharacterStream() const
= 0;</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>getStringData() const =
0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -3860,7 +3860,7 @@
<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
-<td><font face="Courier New,Courier"><font
size=-1>BinInputStream*</font></font></td>
+<td><font face="Courier New,Courier"><font
size=-1>InputSource*</font></font></td>
<td><font face="Courier New,Courier"><font size=-1>getByteStream() const =
0;</font></font></td>
</tr>
@@ -3912,7 +3912,7 @@
<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>setCharacterStream(const
XMLCh* data) = 0;</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>setStringData(const XMLCh*
data) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -3922,7 +3922,7 @@
<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font
size=-1>setByteStream(BinInputStream* stream) = 0;</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>setByteStream(InputSource*
stream) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -3972,7 +3972,7 @@
<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font
size=-1>setIssueFatalErrorIfNotFound(const bool flag) = 0;</font></font></td>
+<td><font face="Courier New,Courier"><font
size=-1>setIssueFatalErrorIfNotFound(bool flag) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -4040,6 +4040,16 @@
<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
+<td><font face="Courier New,Courier"><font
size=-1>XMLFormatTarget*</font></font></td>
+
+<td><font face="Courier New,Courier"><font size=-1>getByteStream() const =
0;</font></font></td>
+</tr>
+
+<tr ALIGN=LEFT VALIGN=TOP>
+<td></td>
+
+<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
+
<td><font face="Courier New,Courier"><font size=-1>const
XMLCh*</font></font></td>
<td><font face="Courier New,Courier"><font size=-1>getEncoding() const =
0;</font></font></td>
@@ -4062,7 +4072,7 @@
<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>setEncoding(const XMLCh*
const encodingStr) = 0;</font></font></td>
+<td><font face="Courier New,Courier"><font
size=-1>setByteStream(XMLFormatTarget* stream) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -4072,7 +4082,7 @@
<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>setSystemId(const XMLCh*
const systemId) = 0;</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>setEncoding(const XMLCh*
const encodingStr) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -4080,9 +4090,9 @@
<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
-<td><font face="Courier New,Courier"><font
size=-1>BinInputStream*</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>makeStream() const =
0;</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>setSystemId(const XMLCh*
const systemId) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -4192,7 +4202,7 @@
<td><font face="Courier New,Courier"><font
size=-1>DOMDocument*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>parse(const DOMLSInput&
source) = 0;</font></font></td>
+<td><font face="Courier New,Courier"><font size=-1>parse(const DOMLSInput*
source) = 0;</font></font></td>
</tr>
<tr ALIGN=LEFT VALIGN=TOP>
@@ -4252,7 +4262,7 @@
<td><font face="Courier New,Courier"><font size=-1>Grammar*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>loadGrammar(const
DOMLSInput& source, const short grammarType,
+<td><font face="Courier New,Courier"><font size=-1>loadGrammar(const
DOMLSInput* source, const short grammarType,
const bool toCache = false) = 0;
</font></font></td>
</tr>
@@ -4486,6 +4496,20 @@
<td></td>
</tr>
+
+<tr ALIGN=LEFT VALIGN=TOP>
+<td></td>
+
+<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
+
+<td><font face="Courier New,Courier"><font
size=-1>DOMLSInput*</font></font></td>
+
+<td><font face="Courier New,Courier"><font size=-1>resolveResource( const
XMLCh* const resourceType , const
XMLCh* const namespaceUri
+ , const XMLCh* const publicId
+ , const XMLCh* const systemId
+ , const XMLCh* const baseURI) = 0;
+</font></font></td>
+</tr>
<tr ALIGN=LEFT VALIGN=TOP>
<td><font face="Courier New,Courier"><font size=-1>};</font></font></td>
@@ -4544,16 +4568,6 @@
<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>setEncoding(const XMLCh*
const encoding) = 0;</font></font></td>
-</tr>
-
-<tr ALIGN=LEFT VALIGN=TOP>
-<td></td>
-
-<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
-
-<td><font face="Courier New,Courier"><font size=-1>void</font></font></td>
-
<td><font face="Courier New,Courier"><font size=-1>setNewLine(const XMLCh*
const newLine) = 0;</font></font></td>
</tr>
@@ -4574,16 +4588,6 @@
<td><font face="Courier New,Courier"><font size=-1>const
XMLCh*</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>getEncoding() const =
0;</font></font></td>
-</tr>
-
-<tr ALIGN=LEFT VALIGN=TOP>
-<td></td>
-
-<td><font face="Courier New,Courier"><font size=-1>virtual</font></font></td>
-
-<td><font face="Courier New,Courier"><font size=-1>const
XMLCh*</font></font></td>
-
<td><font face="Courier New,Courier"><font size=-1>getNewLine() const =
0;</font></font></td>
</tr>
@@ -4604,7 +4608,7 @@
<td><font face="Courier New,Courier"><font size=-1>bool</font></font></td>
-<td><font face="Courier New,Courier"><font size=-1>write(const DOMNode*
nodeToWrite, XMLFormatTarget* const destination) =
0;
+<td><font face="Courier New,Courier"><font size=-1>write(const DOMNode*
nodeToWrite, DOMLSOutput* const destination) = 0;
</font></font></td>
</tr>
@@ -5299,7 +5303,7 @@
<tr ALIGN=LEFT VALIGN=TOP>
<td ALIGN=CENTER><i><font color="#0086B2">
<font size=-1>
-Copyright © 1999-2005 The Apache Software Foundation. All Rights Reserved.
+Copyright © 1999-2006 The Apache Software Foundation. All Rights Reserved.
</font>
</font>
</i>
Modified: xerces/c/trunk/doc/program-dom.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/program-dom.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/program-dom.xml (original)
+++ xerces/c/trunk/doc/program-dom.xml Fri Mar 31 06:55:07 2006
@@ -100,7 +100,7 @@
<s4 title="Objects created by DOMImplementation::createXXXX">
<p>Users <em>must</em> call the release() function when finished
using any objects that
- were created by the DOMImplementation::createXXXX (e.g.
DOMBuilder, DOMWriter, DOMDocument,
+ were created by the DOMImplementation::createXXXX (e.g.
DOMLSParser, DOMLSSerializer, DOMLSInput, DOMLSOutput, DOMDocument,
DOMDocumentType).</p>
<p>Access to a released object will lead to unexpected behaviour.</p>
@@ -792,19 +792,19 @@
</s2>
- <anchor name="DOMBuilder"/>
- <s2 title="DOMBuilder">
+ <anchor name="DOMLSParser"/>
+ <s2 title="DOMLSParser">
- <anchor name="ConstructDOMBuilder"/>
- <s3 title="Constructing a DOMBuilder">
- <p>DOMBuilder is a new interface introduced by the
- <jump
href="http://www.w3.org/TR/2002/WD-DOM-Level-3-ASLS-20020409/";>
- W3C DOM Level 3.0 Abstract Schemas and Load and Save
Specification</jump>.
- DOMBuilder provides the "Load" interface for parsing XML documents
and building the
+ <anchor name="ConstructDOMLSParser"/>
+ <s3 title="Constructing a DOMLSParser">
+ <p>DOMLSParser is a new interface introduced by the
+ <jump
href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/";>
+ W3C DOM Level 3.0 Load and Save Specification</jump>.
+ DOMLSParser provides the "Load" interface for parsing XML
documents and building the
corresponding DOM document tree from various input sources.
</p>
- <p>A DOMBuilder instance is obtained from the DOMImplementationLS
interface by invoking
- its createDOMBuilder method. For example:
+ <p>A DOMLSParser instance is obtained from the DOMImplementationLS
interface by invoking
+ its createLSParser method. For example:
</p>
<source>
#include <xercesc/dom/DOM.hpp>
@@ -836,21 +836,21 @@
XMLCh tempStr[100];
XMLString::transcode("LS", tempStr, 99);
DOMImplementation *impl =
DOMImplementationRegistry::getDOMImplementation(tempStr);
- DOMBuilder* parser =
((DOMImplementationLS*)impl)->createDOMBuilder(DOMImplementationLS::MODE_SYNCHRONOUS,
0);
+ DOMLSParser* parser =
((DOMImplementationLS*)impl)->createLSParser(DOMImplementationLS::MODE_SYNCHRONOUS,
0);
// optionally you can set some features on this builder
- if (parser->canSetFeature(XMLUni::fgDOMValidation, true))
- parser->setFeature(XMLUni::fgDOMValidation, true);
- if (parser->canSetFeature(XMLUni::fgDOMNamespaces, true))
- parser->setFeature(XMLUni::fgDOMNamespaces, true);
- if (parser->canSetFeature((XMLUni::fgDOMDatatypeNormalization, true))
- parser->setFeature(XMLUni::fgDOMDatatypeNormalization, true);
+ if (parser->getDomConfig()->canSetParameter(XMLUni::fgDOMValidation,
true))
+ parser->getDomConfig()->setParameter(XMLUni::fgDOMValidation,
true);
+ if (parser->getDomConfig()->canSetParameter(XMLUni::fgDOMNamespaces,
true))
+ parser->getDomConfig()->setParameter(XMLUni::fgDOMNamespaces,
true);
+ if
(parser->getDomConfig()->canSetParameter((XMLUni::fgDOMDatatypeNormalization,
true))
+
parser->getDomConfig()->setParameter(XMLUni::fgDOMDatatypeNormalization, true);
// optionally you can implement your DOMErrorHandler (e.g.
MyDOMErrorHandler)
// and set it to the builder
MyDOMErrorHandler* errHandler = new myDOMErrorHandler();
- parser->setErrorHandler(errHandler);
+ parser->getDomConfig()->setParameter(XMLUni::fgDOMErrorHandler,
errHandler);
char* xmlFile = "x1.xml";
DOMDocument *doc = 0;
@@ -942,13 +942,13 @@
</p>
</s3>
- <anchor name="DOMBuilderFeatures"/>
- <s3 title="DOMBuilder Supported Features">
+ <anchor name="DOMLSParserFeatures"/>
+ <s3 title="DOMLSParser Supported Features">
- <p>The behavior of the DOMBuilder is dependent on the values of the
following features.
- All of the features below can be set using the function
<code>DOMBuilder::setFeature(cons XMLCh* const, const bool)</code>.
- And can be queried using the function <code>bool
DOMBuilder::getFeature(const XMLCh* const)</code>.
- User can also call <code>DOMBuilder::canSetFeature(const XMLCh*
const, const bool)</code>
+ <p>The behavior of the DOMLSParser is dependent on the values of
the following features.
+ All of the features below can be set using the function
<code>DOMLSParser::getDomConfig()->setParameter(cons XMLCh* , bool)</code>.
+ And can be queried using the function <code>bool
DOMLSParser::getDomConfig()->getParameter(const XMLCh* const)</code>.
+ User can also call
<code>DOMLSParser::getDomConfig()->canSetParameter(const XMLCh* , bool)</code>
to query whether setting a feature to a specific value is supported
</p>
@@ -1438,8 +1438,8 @@
<tr><th><em>default:</em></th><td> false </td></tr>
<tr><th><em>XMLUni Predefined Constant:</em></th><td>
fgXercesUserAdoptsDOMDocument </td></tr>
<tr><th><em>see:</em></th><td>
- <jump href="apiDocs/classDOMBuilder.html">
- DOMBuilder API Documentation</jump>, (DOMBuilder::parse and
DOMBuilder::resetDocumentPool)
+ <jump href="apiDocs/classDOMLSParser.html">
+ DOMLSParser API Documentation</jump>, (DOMLSParser::parse and
DOMLSParser::resetDocumentPool)
</td></tr>
</table>
@@ -1449,18 +1449,18 @@
</s3>
- <anchor name="DOMBuilderProperties"/>
- <s3 title="DOMBuilder Supported Properties">
+ <anchor name="DOMLSParserProperties"/>
+ <s3 title="DOMLSParser Supported Properties">
- <p>The behavior of the DOMBuilder is dependent on the values of the
following properties.
- All of the properties below can be set using the function
<code>DOMBuilder::setProperty(const XMLCh* const, void*)</code>.
+ <p>The behavior of the DOMLSParser is dependent on the values of
the following properties.
+ All of the properties below can be set using the function
<code>DOMLSParser::getDomConfig()->setParameter(const XMLCh* , const
void*)</code>.
It takes a void pointer as the property value. Application is
required to initialize this void
pointer to a correct type. Please check the column "Value Type"
below
to learn exactly what type of property value each property expects
for processing.
Passing a void pointer that was initialized with a wrong type will
lead to unexpected result.
If the same property is set more than once, the last one takes
effect.</p>
- <p>Property values can be queried using the function <code>void*
DOMBuilder::getFeature(const XMLCh* const)</code>.
+ <p>Property values can be queried using the function <code>void*
DOMLSParser::getDomConfig()->getParameter(const XMLCh* )</code>.
The parser owns the returned pointer, and the memory allocated for
the returned pointer will
be destroyed when the parser is released. To ensure accessibility
of the returned information after
the parser is released, callers need to copy and store the
returned information somewhere else.
@@ -1575,19 +1575,19 @@
</s2>
- <anchor name="DOMWriter"/>
- <s2 title="DOMWriter">
+ <anchor name="DOMLSSerializer"/>
+ <s2 title="DOMLSSerializer">
- <anchor name="ConstructDOMWriter"/>
- <s3 title="Constructing a DOMWriter">
+ <anchor name="ConstructDOMLSSerializer"/>
+ <s3 title="Constructing a DOMLSSerializer">
<p>DOMWriter is a new interface introduced by the
- <jump
href="http://www.w3.org/TR/2002/WD-DOM-Level-3-ASLS-20020409/";>
- W3C DOM Level 3.0 Abstract Schemas and Load and Save
Specification</jump>.
- DOMWriter provides the "Save" interface for serializing (writing)
a DOM document into
+ <jump
href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/";>
+ W3C DOM Level 3.0 Load and Save Specification</jump>.
+ DOMLSSerializer provides the "Save" interface for serializing
(writing) a DOM document into
XML data. The XML data can be written to various type of output
stream.
</p>
- <p>A DOMWriter instance is obtained from the DOMImplementationLS
interface by invoking
- its createDOMWriter method. For example:
+ <p>A DOMLSSerializer instance is obtained from the
DOMImplementationLS interface by invoking
+ its createLSSerializer method. For example:
</p>
<source>
#include <xercesc/dom/DOM.hpp>
@@ -1606,32 +1606,34 @@
XMLCh tempStr[100];
XMLString::transcode("LS", tempStr, 99);
DOMImplementation *impl =
DOMImplementationRegistry::getDOMImplementation(tempStr);
- DOMWriter* theSerializer =
((DOMImplementationLS*)impl)->createDOMWriter();
+ DOMLSSerializer* theSerializer =
((DOMImplementationLS*)impl)->createLSSerializer();
// optionally you can set some features on this serializer
- if
(theSerializer->canSetFeature(XMLUni::fgDOMWRTDiscardDefaultContent, true))
- theSerializer->setFeature(XMLUni::fgDOMWRTDiscardDefaultContent,
true);
+ if
(theSerializer->getDomConfig()->canSetParameter(XMLUni::fgDOMWRTDiscardDefaultContent,
true))
+
theSerializer->getDomConfig()->setParameter(XMLUni::fgDOMWRTDiscardDefaultContent,
true);
- if (theSerializer->canSetFeature(XMLUni::fgDOMWRTFormatPrettyPrint,
true))
- theSerializer->setFeature(XMLUni::fgDOMWRTFormatPrettyPrint,
true);
+ if
(theSerializer->getDomConfig()->canSetParameter(XMLUni::fgDOMWRTFormatPrettyPrint,
true))
+
theSerializer->getDomConfig()->setParameter(XMLUni::fgDOMWRTFormatPrettyPrint,
true);
- // optionally you can implement your DOMWriterFilter (e.g.
MyDOMWriterFilter)
+ // optionally you can implement your DOMLSSerializerFilter (e.g.
MyDOMLSSerializerFilter)
// and set it to the serializer
- DOMWriterFilter* myFilter = new myDOMWriterFilter();
+ DOMLSSerializer* myFilter = new myDOMLSSerializerFilter();
theSerializer->setFilter(myFilter);
// optionally you can implement your DOMErrorHandler (e.g.
MyDOMErrorHandler)
// and set it to the serializer
DOMErrorHandler* errHandler = new myDOMErrorHandler();
- theSerializer->setErrorHandler(myErrorHandler);
+ theSerializer->getDomConfig()->setParameter(XMLUni::fgDOMErrorHandler,
myErrorHandler);
// StdOutFormatTarget prints the resultant XML stream
// to stdout once it receives any thing from the serializer.
XMLFormatTarget *myFormTarget = new StdOutFormatTarget();
+ DOMLSOutput* theOutput =
((DOMImplementationLS*)impl)->createLSOutput();
+ theOutput->setByteStream(myFormTarget);
try {
- // do the serialization through DOMWriter::writeNode();
- theSerializer->writeNode(myFormTarget, *node);
+ // do the serialization through DOMLSSerializer::write();
+ theSerializer->write(node, theOutput);
}
catch (const XMLException& toCatch) {
char* message = XMLString::transcode(toCatch.getMessage());
@@ -1652,7 +1654,7 @@
return -1;
}
-
+ theOutput->release();
theSerializer->release();
delete myErrorHandler;
delete myFilter;
@@ -1666,10 +1668,10 @@
</p>
</s3>
- <anchor name="DOMWriterEntityRef"/>
- <s3 title="How does DOMWriter handle built-in entity Reference in node
value?">
+ <anchor name="DOMLSSerializerEntityRef"/>
+ <s3 title="How does DOMLSSerializer handle built-in entity Reference
in node value?">
- <p>Say for example you parse the following xml document using
XercesDOMParser or DOMBuilder</p>
+ <p>Say for example you parse the following xml document using
XercesDOMParser or DOMLSParser</p>
<source>
<root>
<Test attr=" > ' &lt; &gt; &amp; &quot; &apos;
"></Test>
@@ -1689,19 +1691,19 @@
</root>
</source>
- <p>and pass such DOMNode to DOMWriter for serialization. From
DOMWriter perspective, it
+ <p>and pass such DOMNode to DOMLSSerializer for serialization.
From DOMLSSerializer perspective, it
does not know what the original string was. All it sees is above
DOMNode from the
- parser. But since the DOMWriter is supposed to generate something
that is parsable if sent
- back to the parser, it cannot print such string as is. Thus the
DOMWriter is doing some
+ parser. But since the DOMLSSerializer is supposed to generate
something that is parsable if sent
+ back to the parser, it cannot print such string as is. Thus the
DOMLSSerializer is doing some
"touch up", just enough, to get the string parsable.</p>
<p>So for example since the appearance of < and & in text
value will lead to
- not well-form XML error, the DOMWriter fixes them to &lt; and
&amp;
- respectively; while the >, ' and " in text value are ok to the
parser, so DOMWriter does not
- do anything to them. Similarly the DOMWriter fixes some of the
characters for the attribute value
+ not well-form XML error, the DOMLSSerializer fixes them to &lt;
and &amp;
+ respectively; while the >, ' and " in text value are ok to the
parser, so DOMLSSerializer does not
+ do anything to them. Similarly the DOMLSSerializer fixes some of
the characters for the attribute value
but keep everything in CDATA.</p>
- <p>So the string that is generated by DOMWriter will look like
this</p>
+ <p>So the string that is generated by DOMLSSerializer will look
like this</p>
<source>
<root>
<Test attr=" > ' &lt; > &amp; &quot; ' "/>
@@ -1768,13 +1770,13 @@
</table>
</s3>
- <anchor name="DOMWriterFeatures"/>
- <s3 title="DOMWriter Supported Features">
+ <anchor name="DOMLSSerializerFeatures"/>
+ <s3 title="DOMLSSerializer Supported Features">
- <p>The behavior of the DOMWriter is dependent on the values of the
following features.
- All of the features below can be set using the function
<code>DOMWriter::setFeature(cons XMLCh* const, bool)</code>.
- And can be queried using the function <code>bool
DOMWriter::getFeature(const XMLCh* const)</code>.
- User can also call <code>DOMWriter::canSetFeature(const XMLCh*
const, bool)</code>
+ <p>The behavior of the DOMLSSerializer is dependent on the values
of the following features.
+ All of the features below can be set using the function
<code>DOMLSSerializer::getDomConfig()->setParameter(cons XMLCh* , bool)</code>.
+ And can be queried using the function <code>bool
DOMLSSerializer::getDomConfig()->getParameter(const XMLCh* const)</code>.
+ User can also call
<code>DOMLSSerializer::getDomConfig()->canSetParameter(const XMLCh* ,
bool)</code>
to query whether setting a feature to a specific value is supported
</p>
@@ -1793,8 +1795,8 @@
default content won't be removed if an implementation does not
have any information
available. </td></tr>
<tr><th><em>see:</em></th><td>
- <jump
href="http://www.w3.org/TR/2002/WD-DOM-Level-3-ASLS-20020409/";>
- DOM Level 3.0 Abstract Schemas and Load and Save
Specification</jump>
+ <jump
href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/";>
+ DOM Level 3.0 Load and Save Specification</jump>
</td></tr>
</table>
Modified: xerces/c/trunk/doc/program-others.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/program-others.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/program-others.xml (original)
+++ xerces/c/trunk/doc/program-others.xml Fri Mar 31 06:55:07 2006
@@ -891,15 +891,15 @@
</p>
<source>
-// Create a DOMBuilder parser
-DOMBuilder *parser =
((DOMImplementationLS*)impl)->createDOMBuilder(DOMImplementationLS::MODE_SYNCHRONOUS,
0);
+// Create a DOMLSParser parser
+DOMLSParser *parser =
((DOMImplementationLS*)impl)->createLSParser(DOMImplementationLS::MODE_SYNCHRONOUS,
0);
// Specify scanner name - This is optional as IGXMLScanner is the default
-parser->setProperty(XMLUni::fgXercesScannerName, (void
*)XMLUni::fgIGXMLScanner);
+parser->getDomConfig()->setParameter(XMLUni::fgXercesScannerName, (void
*)XMLUni::fgIGXMLScanner);
// Specify other parser features, e.g.
-parser->setFeature(XMLUni::fgDOMNamespaces, doNamespaces);
-parser->setFeature(XMLUni::fgXercesSchema, doSchema);
+parser->getDomConfig()->setParameter(XMLUni::fgDOMNamespaces, doNamespaces);
+parser->getDomConfig()->setParameter(XMLUni::fgXercesSchema, doSchema);
</source>
</s3>
Modified: xerces/c/trunk/doc/program.xml
URL:
http://svn.apache.org/viewcvs/xerces/c/trunk/doc/program.xml?rev=390437&r1=390436&r2=390437&view=diff
==============================================================================
--- xerces/c/trunk/doc/program.xml (original)
+++ xerces/c/trunk/doc/program.xml Fri Mar 31 06:55:07 2006
@@ -78,18 +78,18 @@
<li><jump href="program-dom.html#XercesDOMFeatures">Supported
Features</jump></li>
<li><jump href="program-dom.html#XercesDOMProperties">Supported
Properties</jump></li>
</ul>
- <li><jump href="program-dom.html#DOMBuilder">DOMBuilder</jump></li>
+ <li><jump href="program-dom.html#DOMLSParser">DOMLSParser</jump></li>
<ul>
- <li><jump href="program-dom.html#ConstructDOMBuilder">Constructing a
DOMBuilder</jump></li>
- <li><jump href="program-dom.html#InputSourceWrapper">How to
interchange DOMInputSource and SAX InputSource?</jump></li>
- <li><jump href="program-dom.html#DOMBuilderFeatures">Supported
Features</jump></li>
- <li><jump href="program-dom.html#DOMBuilderProperties">Supported
Properties</jump></li>
+ <li><jump href="program-dom.html#ConstructDOMLSParser">Constructing
a DOMLSParser</jump></li>
+ <li><jump href="program-dom.html#InputSourceWrapper">How to
interchange DOMLSInput and SAX InputSource?</jump></li>
+ <li><jump href="program-dom.html#DOMLSParserFeatures">Supported
Features</jump></li>
+ <li><jump href="program-dom.html#DOMLSParserProperties">Supported
Properties</jump></li>
</ul>
- <li><jump href="program-dom.html#DOMWriter">DOMWriter</jump></li>
+ <li><jump
href="program-dom.html#DOMLSSerializer">DOMLSSerializer</jump></li>
<ul>
- <li><jump href="program-dom.html#ConstructDOMWriter">Constructing a
DOMWriter</jump></li>
- <li><jump href="program-dom.html#DOMWriterEntityRef">How does
DOMWriter handle built-in entity Reference in node value?</jump></li>
- <li><jump href="program-dom.html#DOMWriterFeatures">Supported
Features</jump></li>
+ <li><jump
href="program-dom.html#ConstructDOMLSSerializer">Constructing a
DOMLSSerializer</jump></li>
+ <li><jump href="program-dom.html#DOMLSSerializerEntityRef">How does
DOMLSSerializer handle built-in entity Reference in node value?</jump></li>
+ <li><jump href="program-dom.html#DOMLSSerializerFeatures">Supported
Features</jump></li>
</ul>
<li><jump href="program-dom.html#Deprecated">Deprecated - Java-like
DOM</jump></li>
</ul>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
