You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by kn...@apache.org on 2002/05/22 22:53:41 UTC
cvs commit: xml-xerces/c/src/xercesc/parsers AbstractDOMParser.cpp AbstractDOMParser.hpp Makefile.in SAX2XMLReaderImpl.cpp SAXParser.cpp XercesDOMParser.cpp XercesDOMParser.hpp
knoaman 02/05/22 13:53:41
Modified: c/src/xercesc/parsers Makefile.in SAX2XMLReaderImpl.cpp
SAXParser.cpp XercesDOMParser.cpp
XercesDOMParser.hpp
Added: c/src/xercesc/parsers AbstractDOMParser.cpp
AbstractDOMParser.hpp
Log:
Prepare for DOM L3 :
- Make use of the XMLEntityHandler/XMLErrorReporter interfaces, instead of using
EntityHandler/ErrorHandler directly.
- Add 'AbstractDOMParser' class to provide common functionality for XercesDOMParser
and DOMBuilder.
Revision Changes Path
1.3 +3 -1 xml-xerces/c/src/xercesc/parsers/Makefile.in
Index: Makefile.in
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/parsers/Makefile.in,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Makefile.in 21 May 2002 19:26:50 -0000 1.2
+++ Makefile.in 22 May 2002 20:53:41 -0000 1.3
@@ -54,7 +54,7 @@
# <http://www.apache.org/>.
#
#
-# $Id: Makefile.in,v 1.2 2002/05/21 19:26:50 tng Exp $
+# $Id: Makefile.in,v 1.3 2002/05/22 20:53:41 knoaman Exp $
#
PLATFORM = @platform@
@@ -77,6 +77,7 @@
MODULE = parsers
PARSERS_CPP_PUBHEADERS = \
+ AbstractDOMParser.hpp \
XercesDOMParser.hpp \
SAXParser.hpp \
SAX2XMLReaderImpl.hpp
@@ -86,6 +87,7 @@
PARSERS_C_FILES =
PARSERS_CPP_OBJECTS = \
+ AbstractDOMParser.$(TO) \
XercesDOMParser.$(TO) \
SAXParser.$(TO) \
SAX2XMLReaderImpl.$(TO)
1.3 +3 -2 xml-xerces/c/src/xercesc/parsers/SAX2XMLReaderImpl.cpp
Index: SAX2XMLReaderImpl.cpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/parsers/SAX2XMLReaderImpl.cpp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- SAX2XMLReaderImpl.cpp 13 Feb 2002 16:09:24 -0000 1.2
+++ SAX2XMLReaderImpl.cpp 22 May 2002 20:53:41 -0000 1.3
@@ -56,6 +56,13 @@
/*
* $Log: SAX2XMLReaderImpl.cpp,v $
+ * Revision 1.3 2002/05/22 20:53:41 knoaman
+ * Prepare for DOM L3 :
+ * - Make use of the XMLEntityHandler/XMLErrorReporter interfaces, instead of using
+ * EntityHandler/ErrorHandler directly.
+ * - Add 'AbstractDOMParser' class to provide common functionality for XercesDOMParser
+ * and DOMBuilder.
+ *
* Revision 1.2 2002/02/13 16:09:24 knoaman
* Move SAX2 features/properties names constants to XMLUni.
*
@@ -444,11 +451,9 @@
fEntityResolver = resolver;
if (fEntityResolver) {
fScanner->setEntityHandler(this);
- fScanner->setEntityResolver(fEntityResolver);
}
else {
fScanner->setEntityHandler(0);
- fScanner->setEntityResolver(0);
}
}
1.2 +3 -2 xml-xerces/c/src/xercesc/parsers/SAXParser.cpp
Index: SAXParser.cpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/parsers/SAXParser.cpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- SAXParser.cpp 1 Feb 2002 22:22:07 -0000 1.1
+++ SAXParser.cpp 22 May 2002 20:53:41 -0000 1.2
@@ -56,8 +56,15 @@
/*
* $Log: SAXParser.cpp,v $
- * Revision 1.1 2002/02/01 22:22:07 peiyongz
- * Initial revision
+ * Revision 1.2 2002/05/22 20:53:41 knoaman
+ * Prepare for DOM L3 :
+ * - Make use of the XMLEntityHandler/XMLErrorReporter interfaces, instead of using
+ * EntityHandler/ErrorHandler directly.
+ * - Add 'AbstractDOMParser' class to provide common functionality for XercesDOMParser
+ * and DOMBuilder.
+ *
+ * Revision 1.1.1.1 2002/02/01 22:22:07 peiyongz
+ * sane_include
*
* Revision 1.23 2001/11/20 18:51:44 tng
* Schema: schemaLocation and noNamespaceSchemaLocation to be specified outside the instance document. New methods setExternalSchemaLocation and setExternalNoNamespaceSchemaLocation are added (for SAX2, two new properties are added).
@@ -532,11 +539,9 @@
fEntityResolver = resolver;
if (fEntityResolver) {
fScanner->setEntityHandler(this);
- fScanner->setEntityResolver(fEntityResolver);
}
else {
fScanner->setEntityHandler(0);
- fScanner->setEntityResolver(0);
}
}
1.3 +18 -1088 xml-xerces/c/src/xercesc/parsers/XercesDOMParser.cpp
Index: XercesDOMParser.cpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/parsers/XercesDOMParser.cpp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- XercesDOMParser.cpp 21 May 2002 19:28:29 -0000 1.2
+++ XercesDOMParser.cpp 22 May 2002 20:53:41 -0000 1.3
@@ -59,7 +59,7 @@
* handler with the scanner. In these handler methods, appropriate DOM nodes
* are created and added to the DOM tree.
*
-* $Id: XercesDOMParser.cpp,v 1.2 2002/05/21 19:28:29 tng Exp $
+* $Id: XercesDOMParser.cpp,v 1.3 2002/05/22 20:53:41 knoaman Exp $
*
*/
@@ -69,181 +69,43 @@
// Includes
// ---------------------------------------------------------------------------
#include <xercesc/sax/EntityResolver.hpp>
-#include <xercesc/util/XMLUniDefs.hpp>
#include <xercesc/sax/ErrorHandler.hpp>
#include <xercesc/sax/SAXParseException.hpp>
-#include <xercesc/framework/XMLNotationDecl.hpp>
-#include <xercesc/util/IOException.hpp>
#include <xercesc/internal/XMLScanner.hpp>
-#include <xercesc/validators/DTD/DTDValidator.hpp>
#include <xercesc/parsers/XercesDOMParser.hpp>
-#include <xercesc/dom/DOMImplementation.hpp>
-#include <xercesc/dom/DOMElement.hpp>
-#include <xercesc/dom/impl/DOMAttrImpl.hpp>
-#include <xercesc/dom/DOMCDATASection.hpp>
-#include <xercesc/dom/DOMComment.hpp>
-#include <xercesc/dom/impl/DOMTextImpl.hpp>
-#include <xercesc/dom/impl/DOMDocumentImpl.hpp>
-#include <xercesc/dom/impl/DOMDocumentTypeImpl.hpp>
-#include <xercesc/dom/DOMDocumentType.hpp>
-#include <xercesc/dom/impl/DOMElementImpl.hpp>
-#include <xercesc/dom/impl/DOMEntityImpl.hpp>
-#include <xercesc/dom/impl/DOMEntityReferenceImpl.hpp>
-#include <xercesc/dom/impl/DOMNotationImpl.hpp>
-#include <xercesc/dom/DOMNamedNodeMap.hpp>
-#include <xercesc/dom/DOMProcessingInstruction.hpp>
-#include <xercesc/dom/impl/DOMNodeIDMap.hpp>
-#include <xercesc/validators/common/ContentSpecNode.hpp>
-#include <xercesc/validators/DTD/DTDAttDefList.hpp>
-
// ---------------------------------------------------------------------------
// XercesDOMParser: Constructors and Destructor
// ---------------------------------------------------------------------------
XercesDOMParser::XercesDOMParser(XMLValidator* const valToAdopt) :
-fErrorHandler(0)
+AbstractDOMParser(valToAdopt)
+, fErrorHandler(0)
, fEntityResolver(0)
-, fCreateEntityReferenceNodes(true)
-, fIncludeIgnorableWhitespace(true)
-, fNodeStack(0)
-, fScanner(0)
-, fDocument(0)
-, fDocumentVector(0)
{
- //
- // Create a scanner and tell it what validator to use. Then set us
- // as the document event handler so we can fill the DOM document.
- //
- fScanner = new XMLScanner(valToAdopt);
- fScanner->setDocHandler(this);
- fScanner->setDocTypeHandler(this);
-
- fNodeStack = new ValueStackOf<DOMNode*>(64);
- this->reset();
-
-
}
XercesDOMParser::~XercesDOMParser()
{
- if (fDocumentVector)
- delete fDocumentVector;
-
- delete fDocument;
- delete fNodeStack;
- delete fScanner;
}
-void XercesDOMParser::reset()
-{
- // if fDocument exists already, store the old pointer in the vector for deletion later
- if (fDocument) {
- if (!fDocumentVector) {
- // allocate the vector if not exists yet
- fDocumentVector = new RefVectorOf<DOMDocumentImpl>(10, true) ;
- }
- fDocumentVector->addElement(fDocument);
- }
-
- fDocument = 0;
- resetDocType();
-
- fCurrentParent = 0;
- fCurrentNode = 0;
- fParseInProgress = false;
- fWithinElement = false;
- fNodeStack->removeAllElements();
-};
-
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Getter methods
-// ---------------------------------------------------------------------------
-DOMDocument* XercesDOMParser::getDocument()
-{
- return fDocument;
-}
-
-const XMLValidator& XercesDOMParser::getValidator() const
-{
- return *fScanner->getValidator();
-}
-
-bool XercesDOMParser::getDoNamespaces() const
-{
- return fScanner->getDoNamespaces();
-}
-
-bool XercesDOMParser::getExitOnFirstFatalError() const
-{
- return fScanner->getExitOnFirstFatal();
-}
-
-bool XercesDOMParser::getValidationConstraintFatal() const
-{
- return fScanner->getValidationConstraintFatal();
-}
-
-XercesDOMParser::ValSchemes XercesDOMParser::getValidationScheme() const
-{
- const XMLScanner::ValSchemes scheme = fScanner->getValidationScheme();
-
- if (scheme == XMLScanner::Val_Always)
- return Val_Always;
- else if (scheme == XMLScanner::Val_Never)
- return Val_Never;
-
- return Val_Auto;
-}
-
-bool XercesDOMParser::getDoSchema() const
-{
- return fScanner->getDoSchema();
-}
-
-bool XercesDOMParser::getValidationSchemaFullChecking() const
-{
- return fScanner->getValidationSchemaFullChecking();
-}
-
-int XercesDOMParser::getErrorCount() const
-{
- return fScanner->getErrorCount();
-}
-
-XMLCh* XercesDOMParser::getExternalSchemaLocation() const
-{
- return fScanner->getExternalSchemaLocation();
-}
-
-XMLCh* XercesDOMParser::getExternalNoNamespaceSchemaLocation() const
-{
- return fScanner->getExternalNoNamespaceSchemaLocation();
-}
-
// ---------------------------------------------------------------------------
// XercesDOMParser: Setter methods
// ---------------------------------------------------------------------------
-void XercesDOMParser::setDoNamespaces(const bool newState)
-{
- fScanner->setDoNamespaces(newState);
-}
-
void XercesDOMParser::setErrorHandler(ErrorHandler* const handler)
{
fErrorHandler = handler;
+ XMLScanner* scanner = getScanner();
if (fErrorHandler) {
- fScanner->setErrorReporter(this);
- fScanner->setErrorHandler(fErrorHandler);
+ scanner->setErrorReporter(this);
+ scanner->setErrorHandler(fErrorHandler);
}
else {
- fScanner->setErrorReporter(0);
- fScanner->setErrorHandler(0);
+ scanner->setErrorReporter(0);
+ scanner->setErrorHandler(0);
}
}
@@ -251,214 +113,25 @@
{
fEntityResolver = handler;
if (fEntityResolver) {
- fScanner->setEntityHandler(this);
- fScanner->setEntityResolver(fEntityResolver);
+ getScanner()->setEntityHandler(this);
}
else {
- fScanner->setEntityHandler(0);
- fScanner->setEntityResolver(0);
- }
-}
-
-void XercesDOMParser::setExitOnFirstFatalError(const bool newState)
-{
- fScanner->setExitOnFirstFatal(newState);
-}
-
-void XercesDOMParser::setValidationConstraintFatal(const bool newState)
-{
- fScanner->setValidationConstraintFatal(newState);
-}
-
-void XercesDOMParser::setValidationScheme(const ValSchemes newScheme)
-{
- if (newScheme == Val_Never)
- fScanner->setValidationScheme(XMLScanner::Val_Never);
- else if (newScheme == Val_Always)
- fScanner->setValidationScheme(XMLScanner::Val_Always);
- else
- fScanner->setValidationScheme(XMLScanner::Val_Auto);
-}
-
-void XercesDOMParser::setDoSchema(const bool newState)
-{
- fScanner->setDoSchema(newState);
-}
-
-void XercesDOMParser::setValidationSchemaFullChecking(const bool schemaFullChecking)
-{
- fScanner->setValidationSchemaFullChecking(schemaFullChecking);
-}
-
-void XercesDOMParser::setExternalSchemaLocation(const XMLCh* const schemaLocation)
-{
- fScanner->setExternalSchemaLocation(schemaLocation);
-}
-void XercesDOMParser::setExternalNoNamespaceSchemaLocation(const XMLCh* const noNamespaceSchemaLocation)
-{
- fScanner->setExternalNoNamespaceSchemaLocation(noNamespaceSchemaLocation);
-}
-
-void XercesDOMParser::setExternalSchemaLocation(const char* const schemaLocation)
-{
- fScanner->setExternalSchemaLocation(schemaLocation);
-}
-void XercesDOMParser::setExternalNoNamespaceSchemaLocation(const char* const noNamespaceSchemaLocation)
-{
- fScanner->setExternalNoNamespaceSchemaLocation(noNamespaceSchemaLocation);
-}
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Parsing methods
-// ---------------------------------------------------------------------------
-void XercesDOMParser::parse(const InputSource& source, const bool reuseGrammar)
-{
- // Avoid multiple entrance
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- try
- {
- fParseInProgress = true;
- fScanner->scanDocument(source, reuseGrammar);
- fParseInProgress = false;
- }
-
- catch(...)
- {
- fParseInProgress = false;
- throw;
- }
-}
-
-void XercesDOMParser::parse(const XMLCh* const systemId, const bool reuseGrammar)
-{
- // Avoid multiple entrance
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- try
- {
- fParseInProgress = true;
- fScanner->scanDocument(systemId, reuseGrammar);
- fParseInProgress = false;
- }
-
- catch(...)
- {
- fParseInProgress = false;
- throw;
+ getScanner()->setEntityHandler(0);
}
}
-void XercesDOMParser::parse(const char* const systemId, const bool reuseGrammar)
-{
- // Avoid multiple entrance
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- try
- {
- fParseInProgress = true;
- fScanner->scanDocument(systemId, reuseGrammar);
- fParseInProgress = false;
- }
-
- catch(...)
- {
- fParseInProgress = false;
- throw;
- }
-}
-
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Progressive parse methods
-// ---------------------------------------------------------------------------
-bool XercesDOMParser::parseFirst( const XMLCh* const systemId
- , XMLPScanToken& toFill
- , const bool reuseGrammar)
-{
- //
- // Avoid multiple entrance. We cannot enter here while a regular parse
- // is in progress.
- //
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- return fScanner->scanFirst(systemId, toFill, reuseGrammar);
-}
-
-bool XercesDOMParser::parseFirst( const char* const systemId
- , XMLPScanToken& toFill
- , const bool reuseGrammar)
-{
- //
- // Avoid multiple entrance. We cannot enter here while a regular parse
- // is in progress.
- //
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- return fScanner->scanFirst(systemId, toFill, reuseGrammar);
-}
-
-bool XercesDOMParser::parseFirst( const InputSource& source
- , XMLPScanToken& toFill
- , const bool reuseGrammar)
-{
- //
- // Avoid multiple entrance. We cannot enter here while a regular parse
- // is in progress.
- //
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- return fScanner->scanFirst(source, toFill, reuseGrammar);
-}
-
-bool XercesDOMParser::parseNext(XMLPScanToken& token)
-{
- return fScanner->scanNext(token);
-}
-
-void XercesDOMParser::parseReset(XMLPScanToken& token)
-{
- // Reset the scanner, and then reset the parser
- fScanner->scanReset(token);
- reset();
-}
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Utilities
-// ---------------------------------------------------------------------------
-void XercesDOMParser::resetDocumentPool()
-{
- // We cannot enter here while a regular parse is in progress.
- if (fParseInProgress)
- ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
-
- if (fDocumentVector)
- fDocumentVector->removeAllElements();
-
- delete fDocument;
- fDocument = 0;
-}
-
// ---------------------------------------------------------------------------
// XercesDOMParser: Implementation of the XMLErrorReporter interface
// ---------------------------------------------------------------------------
-void XercesDOMParser::error( const unsigned int code
- , const XMLCh* const msgDomain
- , const XMLErrorReporter::ErrTypes errType
- , const XMLCh* const errorText
- , const XMLCh* const systemId
- , const XMLCh* const publicId
- , const unsigned int lineNum
- , const unsigned int colNum)
+void XercesDOMParser::error( const unsigned int code
+ , const XMLCh* const msgDomain
+ , const XMLErrorReporter::ErrTypes errType
+ , const XMLCh* const errorText
+ , const XMLCh* const systemId
+ , const XMLCh* const publicId
+ , const unsigned int lineNum
+ , const unsigned int colNum)
{
SAXParseException toThrow = SAXParseException
(
@@ -508,746 +181,3 @@
return 0;
}
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Implementation of XMLDocumentHandler interface
-// ---------------------------------------------------------------------------
-void XercesDOMParser::docCharacters( const XMLCh* const chars
- , const unsigned int length
- , const bool cdataSection)
-{
- // Ignore chars outside of content
- if (!fWithinElement)
- return;
-
- // revisit. Is it really safe to null-terminate here?
- // Does the scanner do it already?
- // If scanner goes up to the very end of an unterminated
- // buffer, we may be stepping on something bad here.
- // Probably best to modify the scanner to null terminate.
- XMLCh savedChar = chars[length];
- XMLCh *ncChars = (XMLCh *)chars; // cast off const
- ncChars[length] = 0;
- if (cdataSection == true)
- {
- DOMCDATASection *node = fDocument->createCDATASection(chars);
- fCurrentParent->appendChild(node);
- fCurrentNode = node;
- }
- else
- {
- if (fCurrentNode->getNodeType() == DOMNode::TEXT_NODE)
- {
- DOMText *node = (DOMText *)fCurrentNode;
- node->appendData(chars);
- }
- else
- {
- DOMText *node = fDocument->createTextNode(chars);
- fCurrentParent->appendChild(node);
- fCurrentNode = node;
- }
- }
- ncChars[length] = savedChar;
- return;
-}
-
-
-void XercesDOMParser::docComment(const XMLCh* const comment)
-{
- DOMComment *dcom = fDocument->createComment(comment);
- fCurrentParent->appendChild(dcom);
- fCurrentNode = dcom;
-}
-
-
-void XercesDOMParser::docPI( const XMLCh* const target
- , const XMLCh* const data)
-{
- DOMProcessingInstruction *pi = fDocument->createProcessingInstruction
- (
- target
- , data
- );
- fCurrentParent->appendChild(pi);
- fCurrentNode = pi;
-}
-
-
-void XercesDOMParser::endEntityReference(const XMLEntityDecl& entDecl)
-{
- if (fCreateEntityReferenceNodes == true)
- {
- if (fCurrentParent->getNodeType() == DOMNode::ENTITY_REFERENCE_NODE) {
- DOMEntityReferenceImpl *erImpl = (DOMEntityReferenceImpl *) fCurrentParent;
- erImpl->setReadOnly(true, true);
- }
- fCurrentParent = fNodeStack->pop();
- fCurrentNode = fCurrentParent;
- }
-}
-
-
-void XercesDOMParser::endElement( const XMLElementDecl& elemDecl
- , const unsigned int urlId
- , const bool isRoot)
-{
- fCurrentNode = fCurrentParent;
- fCurrentParent = fNodeStack->pop();
-
- // If we've hit the end of content, clear the flag
- if (fNodeStack->empty())
- fWithinElement = false;
-}
-
-
-void XercesDOMParser::ignorableWhitespace(const XMLCh* const chars
- , const unsigned int length
- , const bool cdataSection)
-{
- // Ignore chars before the root element
- if (!fWithinElement || !fIncludeIgnorableWhitespace)
- return;
-
- // revisit. Not safe to slam in a null like this.
- XMLCh savedChar = chars[length];
- XMLCh *ncChars = (XMLCh *)chars; // cast off const
- ncChars[length] = chNull;
-
- if (fCurrentNode->getNodeType() == DOMNode::TEXT_NODE)
- {
- DOMText *node = (DOMText *)fCurrentNode;
- node->appendData(chars);
- }
- else
- {
- DOMTextImpl *node = (DOMTextImpl *)fDocument->createTextNode(chars);
- node->setIgnorableWhitespace(true);
- fCurrentParent->appendChild(node);
-
- fCurrentNode = node;
- }
- ncChars[length] = savedChar;
-}
-
-
-void XercesDOMParser::resetDocument()
-{
- //
- // The reset methods are called before a new parse event occurs.
- // Reset this parsers state to clear out anything that may be left
- // from a previous use, in particular the DOM document itself.
- //
- this->reset();
- fDocument = (DOMDocumentImpl *)DOMImplementation::getImplementation()->createDocument();
-}
-
-
-void XercesDOMParser::startDocument()
-{
- // Just set the document as the current parent and current node
- fCurrentParent = fDocument;
- fCurrentNode = fDocument;
- // set DOM error checking off
- fDocument->setErrorChecking(false);
-}
-
-
-void XercesDOMParser::endDocument()
-{
- // set DOM error checking back on
- fDocument->setErrorChecking(true);
-}
-
-
-void XercesDOMParser::startElement(const XMLElementDecl& elemDecl
- , const unsigned int urlId
- , const XMLCh* const elemPrefix
- , const RefVectorOf<XMLAttr>& attrList
- , const unsigned int attrCount
- , const bool isEmpty
- , const bool isRoot)
-{
- DOMElement *elem;
-
- if (fScanner -> getDoNamespaces()) { //DOM Level 2, doNamespaces on
- XMLBuffer buf;
- XMLCh* namespaceURI = 0;
- if (urlId != fScanner->getEmptyNamespaceId()) { //TagName has a prefix
- fScanner->getURIText(urlId, buf); //get namespaceURI
- namespaceURI = buf.getRawBuffer();
- }
- elem = createElementNSNode(namespaceURI, elemDecl.getFullName());
- DOMElementImpl *elemImpl = (DOMElementImpl *) elem;
- for (unsigned int index = 0; index < attrCount; ++index) {
- static const XMLCh XMLNS[] = {
- chLatin_x, chLatin_m, chLatin_l, chLatin_n, chLatin_s, chNull
- };
- const XMLAttr* oneAttrib = attrList.elementAt(index);
- unsigned int attrURIId = oneAttrib -> getURIId();
- namespaceURI = 0;
- if (!XMLString::compareString(oneAttrib -> getName(), XMLNS)) //for xmlns=...
- attrURIId = fScanner->getXMLNSNamespaceId();
- if (attrURIId != fScanner->getEmptyNamespaceId()) { //TagName has a prefix
- fScanner->getURIText(attrURIId, buf); //get namespaceURI
- namespaceURI = buf.getRawBuffer();
- }
- // revisit. Optimize to init the named node map to the
- // right size up front.
- DOMAttrImpl *attr = (DOMAttrImpl *)
- fDocument->createAttributeNS(namespaceURI, oneAttrib->getQName());
- attr->setValue(oneAttrib -> getValue());
- elemImpl->setAttributeNode(attr);
-
- //DOMAttrImpl *attr = elemImpl->setAttributeNS(namespaceURI, oneAttrib -> getQName(),
- // oneAttrib -> getValue());
-
- // Attributes of type ID. If this is one, add it to the hashtable of IDs
- // that is constructed for use by GetElementByID().
- //
- if (oneAttrib->getType()==XMLAttDef::ID)
- {
- if (fDocument->fNodeIDMap == 0)
- fDocument->fNodeIDMap = new (fDocument) DOMNodeIDMap(500, fDocument);
- fDocument->fNodeIDMap->add(attr);
- attr->fNode.isIdAttr(true);
- }
-
- attr->setSpecified(oneAttrib->getSpecified());
- }
- }
- else { //DOM Level 1
- elem = fDocument->createElement(elemDecl.getFullName());
- DOMElementImpl *elemImpl = (DOMElementImpl *) elem;
- for (unsigned int index = 0; index < attrCount; ++index) {
- const XMLAttr* oneAttrib = attrList.elementAt(index);
- //AttrImpl *attr = elemImpl->setAttribute(oneAttrib->getName(), oneAttrib->getValue());
- DOMAttrImpl *attr = (DOMAttrImpl *)
- fDocument->createAttribute(oneAttrib->getName());
- attr->setValue(oneAttrib -> getValue());
- elemImpl->setAttributeNode(attr);
- attr->setSpecified(oneAttrib->getSpecified());
-
- // Attributes of type ID. If this is one, add it to the hashtable of IDs
- // that is constructed for use by GetElementByID().
- //
- if (oneAttrib->getType()==XMLAttDef::ID)
- {
- if (fDocument->fNodeIDMap == 0)
- fDocument->fNodeIDMap = new (fDocument) DOMNodeIDMap(500, fDocument);
- fDocument->fNodeIDMap->add(attr);
- attr->fNode.isIdAttr(true);
- }
- }
- }
-
- fCurrentParent->appendChild(elem);
-
- fNodeStack->push(fCurrentParent);
- fCurrentParent = elem;
- fCurrentNode = elem;
- fWithinElement = true;
-
- // If an empty element, do end right now (no endElement() will be called)
- if (isEmpty)
- endElement(elemDecl, urlId, isRoot);
-}
-
-
-void XercesDOMParser::startEntityReference(const XMLEntityDecl& entDecl)
-{
- if (fCreateEntityReferenceNodes == true)
- {
- const XMLCh * entName = entDecl.getName();
- DOMEntityReference *er = fDocument->createEntityReference(entName);
-
- //set the readOnly flag to false before appending node, will be reset in endEntityReference
- DOMEntityReferenceImpl *erImpl = (DOMEntityReferenceImpl *) er;
- erImpl->setReadOnly(false, true);
-
- fCurrentParent->appendChild(er);
- fNodeStack->push(fCurrentParent);
- fCurrentParent = er;
- fCurrentNode = er;
-
- // this entityRef needs to be stored in Entity map too.
- // We'd decide later whether the entity nodes should be created by a
- // separated method in parser or not. For now just stick it in if
- // the ref nodes are created
- DOMNamedNodeMap *entities = fDocumentType->getEntities();
- DOMEntityImpl* entity = (DOMEntityImpl*)entities->getNamedItem(entName);
- entity->setEntityRef(er);
-
- }
-}
-
-
-void XercesDOMParser::XMLDecl(const XMLCh* const version
- , const XMLCh* const encoding
- , const XMLCh* const standalone
- , const XMLCh* const actualEncStr)
-{
- // placehold for DOM Level 3
-}
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Helper methods
-// ---------------------------------------------------------------------------
-DOMElement* XercesDOMParser::createElementNSNode(const XMLCh *namespaceURI,
- const XMLCh *qualifiedName)
-{
- return fDocument->createElementNS(namespaceURI, qualifiedName);
-}
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Deprecated methods
-// ---------------------------------------------------------------------------
-bool XercesDOMParser::getDoValidation() const
-{
- //
- // We don't want to tie the public parser classes to the enum used
- // by the scanner, so we use a separate one and map.
- //
- // DON'T mix the new and old methods!!
- //
- const XMLScanner::ValSchemes scheme = fScanner->getValidationScheme();
- if (scheme == XMLScanner::Val_Always)
- return true;
- return false;
-}
-
-void XercesDOMParser::setDoValidation(const bool newState)
-{
- fScanner->setDoValidation
- (
- newState ? XMLScanner::Val_Always : XMLScanner::Val_Never
- );
-}
-
-//doctypehandler interfaces
-void XercesDOMParser::attDef
-(
- const DTDElementDecl& elemDecl
- , const DTDAttDef& attDef
- , const bool ignoring
- )
-{
- if (fDocumentType->isIntSubsetReading())
- {
- XMLBuffer attString;
- if (elemDecl.hasAttDefs())
- {
- attString.append(chOpenAngle);
- attString.append(chBang);
- attString.append(XMLUni::fgAttListString);
- attString.append(chSpace);
- attString.append(elemDecl.getFullName());
-
- attString.append(chSpace);
- attString.append(attDef.getFullName());
-
- // Get the type and display it
- const XMLAttDef::AttTypes type = attDef.getType();
- switch(type)
- {
- case XMLAttDef::CData :
- attString.append(chSpace);
- attString.append(XMLUni::fgCDATAString);
- break;
- case XMLAttDef::ID :
- attString.append(chSpace);
- attString.append(XMLUni::fgIDString);
- break;
- case XMLAttDef::IDRef :
- attString.append(chSpace);
- attString.append(XMLUni::fgIDRefString);
- break;
- case XMLAttDef::IDRefs :
- attString.append(chSpace);
- attString.append(XMLUni::fgIDRefsString);
- break;
- case XMLAttDef::Entity :
- attString.append(chSpace);
- attString.append(XMLUni::fgEntityString);
- break;
- case XMLAttDef::Entities :
- attString.append(chSpace);
- attString.append(XMLUni::fgEntitiesString);
- break;
- case XMLAttDef::NmToken :
- attString.append(chSpace);
- attString.append(XMLUni::fgNmTokenString);
- break;
- case XMLAttDef::NmTokens :
- attString.append(chSpace);
- attString.append(XMLUni::fgNmTokensString);
- break;
-
- case XMLAttDef::Notation :
- attString.append(chSpace);
- attString.append(XMLUni::fgNotationString);
- break;
-
- case XMLAttDef::Enumeration :
- attString.append(chSpace);
- const XMLCh* enumString = attDef.getEnumeration();
- int length = XMLString::stringLen(enumString);
- if (length > 0) {
-
- XMLBuffer anotherEnumString;
-
- anotherEnumString.append(chOpenParen );
- for(int i=0; i<length; i++) {
- if (enumString[i] == chSpace)
- anotherEnumString.append(chPipe);
- else
- anotherEnumString.append(enumString[i]);
- }
- anotherEnumString.append(chCloseParen);
- attString.append(anotherEnumString.getRawBuffer());
- }
- break;
- }
- //get te default types of the attlist
- const XMLAttDef::DefAttTypes def = attDef.getDefaultType();
- switch(def)
- {
- case XMLAttDef::Required :
- attString.append(chSpace);
- attString.append(XMLUni::fgRequiredString);
- break;
- case XMLAttDef::Implied :
- attString.append(chSpace);
- attString.append(XMLUni::fgImpliedString);
- break;
- case XMLAttDef::Fixed :
- attString.append(chSpace);
- attString.append(XMLUni::fgFixedString);
- break;
- }
-
- const XMLCh* defaultValue = attDef.getValue();
- if (defaultValue != 0) {
- attString.append(chSpace);
- attString.append(chDoubleQuote);
- attString.append(defaultValue);
- attString.append(chDoubleQuote);
- }
-
- attString.append(chCloseAngle);
- fDocumentType->setInternalSubset(attString.getRawBuffer());
- }
- }
-}
-
-void XercesDOMParser::doctypeComment
-(
- const XMLCh* const comment
-)
-{
- if (fDocumentType->isIntSubsetReading())
- {
- if (comment != 0)
- {
- XMLBuffer comString;
- comString.append(XMLUni::fgCommentString);
- comString.append(chSpace);
- comString.append(comment);
- comString.append(chSpace);
- comString.append(chDash);
- comString.append(chDash);
- comString.append(chCloseAngle);
- fDocumentType->setInternalSubset(comString.getRawBuffer());
- }
- }
-}
-
-void XercesDOMParser::doctypeDecl
-(
- const DTDElementDecl& elemDecl
- , const XMLCh* const publicId
- , const XMLCh* const systemId
- , const bool hasIntSubset
-)
-{
- fDocumentType = (DOMDocumentTypeImpl *) fDocument->createDocumentType(elemDecl.getFullName(), publicId, systemId);
- fDocument->setDocumentType(fDocumentType);
-
-}
-
-void XercesDOMParser::doctypePI
-(
- const XMLCh* const target
- , const XMLCh* const data
-)
-{
- if (fDocumentType->isIntSubsetReading())
- {
- //add these chars to internalSubset variable
- XMLBuffer pi;
- pi.append(chOpenAngle);
- pi.append(chQuestion);
- pi.append(target);
- pi.append(chSpace);
- pi.append(data);
- pi.append(chQuestion);
- pi.append(chCloseAngle);
-
- fDocumentType->setInternalSubset(pi.getRawBuffer());
- }
-
-}
-
-
-void XercesDOMParser::doctypeWhitespace
-(
- const XMLCh* const chars
- , const unsigned int length
-)
-{
- if (fDocumentType->isIntSubsetReading())
- fDocumentType->setInternalSubset(chars);
-}
-
-void XercesDOMParser::elementDecl
-(
- const DTDElementDecl& decl
- , const bool isIgnored
-)
-{
- if (fDocumentType->isIntSubsetReading())
- {
- XMLBuffer elemDecl;
-
- elemDecl.append(chOpenAngle);
- elemDecl.append(chBang);
- elemDecl.append(XMLUni::fgElemString);
- elemDecl.append(chSpace);
- elemDecl.append(decl.getFullName());
-
- //get the ContentSpec information
- const XMLCh* contentModel = decl.getFormattedContentModel();
- if (contentModel != 0) {
- elemDecl.append(chSpace);
- elemDecl.append(contentModel);
- }
-
- elemDecl.append(chCloseAngle);
- fDocumentType->setInternalSubset(elemDecl.getRawBuffer());
- }
-}
-
-void XercesDOMParser::endAttList
-(
- const DTDElementDecl& elemDecl
-)
-{
- // this section sets up default attributes.
- // default attribute nodes are stored in a NamedNodeMap DocumentTypeImpl::elements
- // default attribute data attached to the document is used to conform to the
- // DOM spec regarding creating element nodes & removing attributes with default values
- // see DocumentTypeImpl
- if (elemDecl.hasAttDefs())
- {
- XMLAttDefList* defAttrs = &elemDecl.getAttDefList();
- XMLAttDef* attr = 0;
-
- DOMAttrImpl * insertAttr = 0;
- DOMElement *elem = fDocument->createElement(elemDecl.getFullName());
- DOMElementImpl *elemImpl = (DOMElementImpl *) elem;
-
- while (defAttrs->hasMoreElements())
- {
- attr = &defAttrs->nextElement();
- if (attr->getValue() != 0)
- {
- if (fScanner->getDoNamespaces())
- {
- // DOM Level 2 wants all namespace declaration attributes
- // to be bound to "http://www.w3.org/2000/xmlns/"
- // So as long as the XML parser doesn't do it, it needs to
- // done here.
- const XMLCh* qualifiedName = attr->getFullName();
- int index = DOMDocumentImpl::indexofQualifiedName(qualifiedName);
-
- XMLBuffer buf;
- static const XMLCh XMLNS[] = {
- chLatin_x, chLatin_m, chLatin_l, chLatin_n, chLatin_s, chNull};
-
- if (index > 0) {
- // there is prefix
- // map to XML URI for all cases except when prefix == "xmlns"
- XMLCh* prefix;
- XMLCh temp[1000];
-
- if (index > 999)
- prefix = new XMLCh[index+1];
- else
- prefix = temp;
-
- XMLString::subString(prefix ,qualifiedName, 0, index);
-
- if (!XMLString::compareString(prefix,XMLNS))
- buf.append(XMLUni::fgXMLNSURIName);
- else
- buf.append(XMLUni::fgXMLURIName);
-
- if (index > 999)
- delete prefix;
- }
- else {
- // No prefix
- if (!XMLString::compareString(qualifiedName,XMLNS))
- buf.append(XMLUni::fgXMLNSURIName);
- }
-
- insertAttr = (DOMAttrImpl *) fDocument->createAttributeNS(
- buf.getRawBuffer(), // NameSpaceURI
- qualifiedName); // qualified name
-
- }
- else
- {
- // Namespaces is turned off...
- insertAttr = (DOMAttrImpl *) fDocument->createAttribute(attr->getFullName());
- }
- insertAttr->setValue(attr->getValue());
- elemImpl->setAttributeNode(insertAttr);
- insertAttr->setSpecified(false);
- }
- }
- fDocumentType->getElements()->setNamedItem(elemImpl);
- }
-}
-
-void XercesDOMParser::endIntSubset()
-{
- fDocumentType->intSubsetReading = false;
-}
-
-void XercesDOMParser::endExtSubset()
-{
-}
-
-void XercesDOMParser::entityDecl
-(
- const DTDEntityDecl& entityDecl
- , const bool isPEDecl
- , const bool isIgnored
-)
-{
- DOMEntityImpl* entity = (DOMEntityImpl *) fDocument->createEntity(entityDecl.getName());
-
- entity->setPublicId(entityDecl.getPublicId());
- entity->setSystemId(entityDecl.getSystemId());
- entity->setNotationName(entityDecl.getNotationName());
-
- DOMEntityImpl *previousDef = (DOMEntityImpl *)
- fDocumentType->getEntities()->setNamedItem( entity );
-
- #ifdef _revisit
- //
- // If this new entity node is replacing an entity node that was already
- // in the entities named node map (happens if documents redefine the
- // predefined entited such as lt), we need to delete the original
- // entitiy node, assuming no-one else was referencing it.
- //
- if (previousDef != 0 && previousDef->nodeRefCount == 0)
- NodeImpl::deleteIf(previousDef);
- #endif
-
- if (fDocumentType->isIntSubsetReading())
- {
- //add thes chars to internalSubset variable
- XMLBuffer entityName;
- entityName.append(chOpenAngle);
- entityName.append(chBang);
- entityName.append(XMLUni::fgEntityString);
- entityName.append(chSpace);
-
- entityName.append(entityDecl.getName());
-
- const XMLCh* id = entity->getPublicId();
- if (id != 0) {
- entityName.append(chSpace);
- entityName.append(XMLUni::fgPubIDString);
- entityName.append(chSpace);
- entityName.append(chDoubleQuote);
- entityName.append(id);
- entityName.append(chDoubleQuote);
- }
- id = entity->getSystemId();
- if (id != 0) {
- entityName.append(chSpace);
- entityName.append(XMLUni::fgSysIDString);
- entityName.append(chSpace);
- entityName.append(chDoubleQuote);
- entityName.append(id);
- entityName.append(chDoubleQuote);
-
- }
- id = entity->getNotationName();
- if (id != 0) {
- entityName.append(chSpace);
- entityName.append(XMLUni::fgNDATAString);
- entityName.append(chSpace);
- entityName.append(chDoubleQuote);
- entityName.append(id);
- entityName.append(chDoubleQuote);
- }
- id = entityDecl.getValue();
- if (id !=0) {
- entityName.append(chSpace);
- entityName.append(chDoubleQuote);
- entityName.append(id);
- entityName.append(chDoubleQuote);
- }
-
- entityName.append(chCloseAngle);
- fDocumentType->setInternalSubset(entityName.getRawBuffer());
- }
-
-}
-
-void XercesDOMParser::resetDocType()
-{
- fDocumentType = 0;
-}
-
-void XercesDOMParser::notationDecl
-(
- const XMLNotationDecl& notDecl
- , const bool isIgnored
-)
-{
- DOMNotationImpl* notation = (DOMNotationImpl *)fDocument->createNotation(notDecl.getName());
- notation->setPublicId(notDecl.getPublicId());
- notation->setSystemId(notDecl.getSystemId());
-
- fDocumentType->getNotations()->setNamedItem( notation );
-
-}
-
-void XercesDOMParser::startAttList
-(
- const DTDElementDecl& elemDecl
-)
-{
-}
-
-void XercesDOMParser::startIntSubset()
-{
- fDocumentType->intSubsetReading = true;
-}
-
-void XercesDOMParser::startExtSubset()
-{
-}
-
-void XercesDOMParser::TextDecl
-(
- const XMLCh* const versionStr
- , const XMLCh* const encodingStr
-)
-{
-}
1.3 +6 -1205 xml-xerces/c/src/xercesc/parsers/XercesDOMParser.hpp
Index: XercesDOMParser.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/parsers/XercesDOMParser.hpp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- XercesDOMParser.hpp 21 May 2002 19:28:29 -0000 1.2
+++ XercesDOMParser.hpp 22 May 2002 20:53:41 -0000 1.3
@@ -1,7 +1,7 @@
/*
* The Apache Software License, Version 1.1
*
- * Copyright (c) 2001 The Apache Software Foundation. All rights
+ * Copyright (c) 2001-2002 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
@@ -55,7 +55,7 @@
*/
/*
- * $Id: XercesDOMParser.hpp,v 1.2 2002/05/21 19:28:29 tng Exp $
+ * $Id: XercesDOMParser.hpp,v 1.3 2002/05/22 20:53:41 knoaman Exp $
*
*/
@@ -63,27 +63,13 @@
#define XercesDOMParser_HPP
-#include <xercesc/dom/DOMDocument.hpp>
-#include <xercesc/framework/XMLDocumentHandler.hpp>
-#include <xercesc/framework/XMLErrorReporter.hpp>
-#include <xercesc/framework/XMLEntityHandler.hpp>
-#include <xercesc/util/ValueStackOf.hpp>
-
-#include <xercesc/validators/DTD/DocTypeHandler.hpp>
-#include <xercesc/dom/DOMDocumentType.hpp>
-#include <xercesc/validators/DTD/DTDElementDecl.hpp>
+#include <xercesc/parsers/AbstractDOMParser.hpp>
class EntityResolver;
class ErrorHandler;
-class XMLPScanToken;
-class XMLScanner;
-class XMLValidator;
-class DOMDocumentImpl;
-class DOMDocumentTypeImpl;
-class DOMElement;
-/**
+ /**
* This class implements the Document Object Model (DOM) interface.
* It should be used by applications which choose to parse and
* process the XML document using the DOM api's. This implementation
@@ -93,26 +79,10 @@
* <p>It can be used to instantiate a validating or non-validating
* parser, by setting a member flag.</p>
*/
-class PARSERS_EXPORT XercesDOMParser :
-
- public XMLDocumentHandler
- , public XMLErrorReporter
- , public XMLEntityHandler
- , public DocTypeHandler
+class PARSERS_EXPORT XercesDOMParser : public AbstractDOMParser
{
public :
// -----------------------------------------------------------------------
- // Class types
- // -----------------------------------------------------------------------
- enum ValSchemes
- {
- Val_Never
- , Val_Always
- , Val_Auto
- };
-
-
- // -----------------------------------------------------------------------
// Constructors and Detructor
// -----------------------------------------------------------------------
@@ -136,38 +106,6 @@
//@}
- /** Reset the parser
- *
- * This method resets the state of the DOM driver and makes
- * it ready for a fresh parse run.
- */
- void reset();
-
- /** Reset the documents vector pool and release all the associated memory
- * back to the system.
- *
- * When parsing a document using an XercesDOMParser, all memory allocated
- * for a DOM tree is associated to the DOM document.
- *
- * If you do multiple parse using the same XercesDOMParser instance, then
- * multiple DOM documents will be generated and saved in a vector pool.
- * All these documents (and thus all the allocated memory)
- * won't be deleted until the parser instance is destroyed.
- *
- * If you don't need these DOM documents anymore and don't want to
- * destroy the XercesDOMParser instance at this moment, then you can call this method
- * to reset the document vector pool and release all the allocated memory
- * back to the system.
- *
- * It is an error to call this method if you are in the middle of a
- * parse (e.g. in the mid of a progressive parse).
- *
- * @exception IOException An exception from the parser if this function
- * is called when a parse is in progress.
- *
- */
- void resetDocumentPool();
-
// -----------------------------------------------------------------------
// Getter methods
@@ -176,17 +114,6 @@
/** @name Getter methods */
//@{
- /** Get the DOM document
- *
- * This method returns the DOMDocument object representing the
- * root of the document tree. This object provides the primary
- * access to the document's data.
- *
- * @return The DOMDocument object which represents the entire
- * XML document.
- */
- DOMDocument* getDocument();
-
/** Get a pointer to the error handler
*
* This method returns the installed error handler. If no handler
@@ -223,179 +150,6 @@
*/
const EntityResolver* getEntityResolver() const;
- /** Get a const reference to the validator
- *
- * This method returns a reference to the parser's installed
- * validator.
- *
- * @return A const reference to the installed validator object.
- */
- const XMLValidator& getValidator() const;
-
- /**
- * This method returns an enumerated value that indicates the current
- * validation scheme set on this parser.
- *
- * @return The ValSchemes value current set on this parser.
- * @see #setValidationScheme
- */
- ValSchemes getValidationScheme() const;
-
- /** Get the 'do schema' flag
- *
- * This method returns the state of the parser's schema processing
- * flag.
- *
- * @return true, if the parser is currently configured to
- * understand schema, false otherwise.
- *
- * @see #setDoSchema
- */
- bool getDoSchema() const;
-
- /** Get the 'full schema constraint checking' flag
- *
- * This method returns the state of the parser's full schema constraint
- * checking flag.
- *
- * @return true, if the parser is currently configured to
- * have full schema constraint checking, false otherwise.
- *
- * @see #setValidationSchemaFullChecking
- */
- bool getValidationSchemaFullChecking() const;
-
- /** Get error count from the last parse operation.
- *
- * This method returns the error count from the last parse
- * operation. Note that this count is actually stored in the
- * scanner, so this method simply returns what the
- * scanner reports.
- *
- * @return number of errors encountered during the latest
- * parse operation.
- *
- */
- int getErrorCount() const;
-
- /** Get the 'do namespaces' flag
- *
- * This method returns the state of the parser's namespace processing
- * flag.
- *
- * @return true, if the parser is currently configured to
- * understand namespaces, false otherwise.
- *
- * @see #setDoNamespaces
- */
- bool getDoNamespaces() const;
-
- /** Get the 'exit on first error' flag
- *
- * This method returns the state of the parser's
- * exit-on-First-Fatal-Error flag. If this flag is true, then the
- * parse will exit the first time it sees any non-wellformed XML or
- * any validity error. The default state is true.
- *
- * @return true, if the parser is currently configured to
- * exit on the first fatal error, false otherwise.
- *
- * @see #setExitOnFirstFatalError
- */
- bool getExitOnFirstFatalError() const;
-
- /**
- * This method returns the state of the parser's
- * validation-constraint-fatal flag.
- *
- * @return true, if the parser is currently configured to
- * set validation constraint errors as fatal, false
- * otherwise.
- *
- * @see #setValidationContraintFatal
- */
- bool getValidationConstraintFatal() const;
-
- /** Get the 'expand entity references' flag.
- * DEPRECATED Use getCreateEntityReferenceNodes() instead.
- *
- * This method returns the state of the parser's expand entity
- * references flag.
- *
- * @return 'true' if the expand entity reference flag is set on
- * the parser, 'false' otherwise.
- *
- * @see #setExpandEntityReferences
- * @see #setCreateEntityReferenceNodes
- * @see #getCreateEntityReferenceNodes
- */
- bool getExpandEntityReferences() const;
-
- /** Get the 'include entity references' flag
- *
- * This method returns the flag that specifies whether the parser is
- * creating entity reference nodes in the DOM tree being produced.
- *
- * @return The state of the create entity reference node
- * flag.
- * @see #setCreateEntityReferenceNodes
- */
- bool getCreateEntityReferenceNodes()const;
-
- /** Get the 'include ignorable whitespace' flag.
- *
- * This method returns the state of the parser's include ignorable
- * whitespace flag.
- *
- * @return 'true' if the include ignorable whitespace flag is set on
- * the parser, 'false' otherwise.
- *
- * @see #setIncludeIgnorableWhitespace
- */
- bool getIncludeIgnorableWhitespace() const;
-
- /** Get the set of Namespace/SchemaLocation that is specified externaly.
- *
- * This method returns the list of Namespace/SchemaLocation that was
- * specified using setExternalSchemaLocation.
- *
- * The parser owns the returned string, and the memory allocated for
- * the returned string will be destroyed when the parser is deleted.
- *
- * To ensure assessiblity of the returned information after the parser
- * is deleted, callers need to copy and store the returned information
- * somewhere else.
- *
- * @return a pointer to the list of Namespace/SchemaLocation that was
- * specified externally. The pointer spans the same life-time as
- * the parser. A null pointer is returned if nothing
- * was specified externally.
- *
- * @see #setExternalSchemaLocation(const XMLCh* const)
- */
- XMLCh* getExternalSchemaLocation() const;
-
- /** Get the noNamespace SchemaLocation that is specified externaly.
- *
- * This method returns the no target namespace XML Schema Location
- * that was specified using setExternalNoNamespaceSchemaLocation.
- *
- * The parser owns the returned string, and the memory allocated for
- * the returned string will be destroyed when the parser is deleted.
- *
- * To ensure assessiblity of the returned information after the parser
- * is deleted, callers need to copy and store the returned information
- * somewhere else.
- *
- * @return a pointer to the no target namespace Schema Location that was
- * specified externally. The pointer spans the same life-time as
- * the parser. A null pointer is returned if nothing
- * was specified externally.
- *
- * @see #setExternalNoNamespaceSchemaLocation(const XMLCh* const)
- */
- XMLCh* getExternalNoNamespaceSchemaLocation() const;
-
//@}
@@ -438,469 +192,8 @@
*/
void setEntityResolver(EntityResolver* const handler);
- /** Set the 'do namespaces' flag
- *
- * This method allows users to enable or disable the parser's
- * namespace processing. When set to true, parser starts enforcing
- * all the constraints and rules specified by the NameSpace
- * specification.
- *
- * The parser's default state is: false.
- *
- * This flag is ignored by the underlying scanner if the installed
- * validator indicates that namespace constraints should be
- * enforced.
- *
- * @param newState The value specifying whether NameSpace rules should
- * be enforced or not.
- *
- * @see #getDoNamespaces
- */
- void setDoNamespaces(const bool newState);
-
- /** Set the 'exit on first error' flag
- *
- * This method allows users to set the parser's behaviour when it
- * encounters the first fatal error. If set to true, the parser
- * will exit at the first fatal error. If false, then it will
- * report the error and continue processing.
- *
- * The default value is 'true' and the parser exits on the
- * first fatal error.
- *
- * @param newState The value specifying whether the parser should
- * continue or exit when it encounters the first
- * fatal error.
- *
- * @see #getExitOnFirstFatalError
- */
- void setExitOnFirstFatalError(const bool newState);
-
- /**
- * This method allows users to set the parser's behaviour when it
- * encounters a validtion constraint error. If set to true, and the
- * the parser is set to exit when it encounter the first fatal error,
- * the parser will exit at the first encounter. If false, then it will
- * report the error and continue processing.
- *
- * <p>The default value is 'false'.</p>
- *
- * @param newState The value specifying whether the parser should
- * continue or exit when it encounters a validation
- * constraint error.
- *
- * @see #getValidationConstraintFatal
- */
- void setValidationConstraintFatal(const bool newState);
-
- /** Set the 'expand entity references' flag
- *
- * DEPRECATED. USE setCreateEntityReferenceNodes instead.
- * This method allows the user to specify whether the parser should
- * expand all entity reference nodes. When the 'do expansion' flag is
- * true, the DOM tree does not have any entity reference nodes. It is
- * replaced by the sub-tree representing the replacement text of the
- * entity. When the 'do expansion' flag is false, the DOM tree
- * contains an extra entity reference node, whose children is the
- * sub tree of the replacement text.
- * <p>The default value is 'false'.
- *
- * @param expand The new state of the expand entity reference
- * flag.
- * @see #setCreateEntityReferenceNodes
- */
- void setExpandEntityReferences(const bool expand);
-
- /** Set the 'include entity references' flag
- *
- * This method allows the user to specify whether the parser should
- * create entity reference nodes in the DOM tree being produced.
- * When the 'create' flag is
- * true, the parser will create EntityReference nodes in the DOM tree.
- * The EntityReference nodes and their child nodes will be read-only.
- * When the 'create' flag is false, no EntityReference nodes will be created.
- * <p>The replacement text
- * of the entity is included in either case, either as a
- * child of the Entity Reference node or in place at the location
- * of the reference.
- * <p>The default value is 'true'.
- *
- * @param create The new state of the create entity reference nodes
- * flag.
- * @see #getCreateEntityReferenceNodes
- */
- void setCreateEntityReferenceNodes(const bool create);
-
- /** Set the 'include ignorable whitespace' flag
- *
- * This method allows the user to specify whether a validating parser
- * should include ignorable whitespaces as text nodes. It has no effect
- * on non-validating parsers which always include non-markup text.
- * <p>When set to true (also the default), ignorable whitespaces will be
- * added to the DOM tree as text nodes. The method
- * DOMText::isIgnorableWhitespace() will return true for those text
- * nodes only.
- * <p>When set to false, all ignorable whitespace will be discarded and
- * no text node is added to the DOM tree. Note: applications intended
- * to process the "xml:space" attribute should not set this flag to false.
- * And this flag also overrides any schema datateye whitespace facets,
- * that is, all ignorable whitespace will be discarded even though
- * 'preserve' is set in schema datatype whitespace facets.
- *
- * @param include The new state of the include ignorable whitespace
- * flag.
- *
- * @see #getIncludeIgnorableWhitespace
- */
- void setIncludeIgnorableWhitespace(const bool include);
-
- /**
- * This method allows users to set the validation scheme to be used
- * by this parser. The value is one of the ValSchemes enumerated values
- * defined by this class:
- *
- * <br> Val_Never - turn off validation
- * <br> Val_Always - turn on validation
- * <br> Val_Auto - turn on validation if any internal/external
- * DTD subset have been seen
- *
- * <p>The parser's default state is: Val_Auto.</p>
- *
- * @param newScheme The new validation scheme to use.
- *
- * @see #getValidationScheme
- */
- void setValidationScheme(const ValSchemes newScheme);
-
- /** Set the 'do schema' flag
- *
- * This method allows users to enable or disable the parser's
- * schema processing. When set to false, parser will not process
- * any schema found.
- *
- * The parser's default state is: false.
- *
- * @param newState The value specifying whether schema support should
- * be enforced or not.
- *
- * @see #getDoSchema
- */
- void setDoSchema(const bool newState);
-
- /**
- * This method allows the user to turn full Schema constraint checking on/off.
- * Only takes effect if Schema validation is enabled.
- * If turned off, partial constraint checking is done.
- *
- * Full schema constraint checking includes those checking that may
- * be time-consuming or memory intensive. Currently, particle unique
- * attribution constraint checking and particle derivation resriction checking
- * are controlled by this option.
- *
- * The parser's default state is: false.
- *
- * @param schemaFullChecking True to turn on full schema constraint checking.
- *
- * @see #getValidationSchemaFullChecking
- */
- void setValidationSchemaFullChecking(const bool schemaFullChecking);
-
- /**
- * This method allows the user to specify a list of schemas to use.
- * If the targetNamespace of a schema specified using this method matches
- * the targetNamespace of a schema occuring in the instance document in
- * the schemaLocation attribute, or if the targetNamespace matches the
- * namespace attribute of the "import" element, the schema specified by the
- * user using this method will be used (i.e., the schemaLocation attribute
- * in the instance document or on the "import" element will be effectively ignored).
- *
- * If this method is called more than once, only the last one takes effect.
- *
- * The syntax is the same as for schemaLocation attributes in instance
- * documents: e.g, "http://www.example.com file_name.xsd". The user can
- * specify more than one XML Schema in the list.
- *
- * @param schemaLocation the list of schemas to use
- *
- * @see #getExternalSchemaLocation
- */
-
- void setExternalSchemaLocation(const XMLCh* const schemaLocation);
-
- /**
- * This method is same as setExternalSchemaLocation(const XMLCh* const).
- * It takes native char string as parameter
- *
- * @param schemaLocation the list of schemas to use
- *
- * @see #setExternalSchemaLocation(const XMLCh* const)
- */
- void setExternalSchemaLocation(const char* const schemaLocation);
-
- /**
- * This method allows the user to specify the no target namespace XML
- * Schema Location externally. If specified, the instance document's
- * noNamespaceSchemaLocation attribute will be effectively ignored.
- *
- * If this method is called more than once, only the last one takes effect.
- *
- * The syntax is the same as for the noNamespaceSchemaLocation attribute
- * that may occur in an instance document: e.g."file_name.xsd".
- *
- * @param noNamespaceSchemaLocation the XML Schema Location with no target namespace
- *
- * @see #getExternalNoNamespaceSchemaLocation
- */
- void setExternalNoNamespaceSchemaLocation(const XMLCh* const noNamespaceSchemaLocation);
-
- /**
- * This method is same as setExternalNoNamespaceSchemaLocation(const XMLCh* const).
- * It takes native char string as parameter
- *
- * @param noNamespaceSchemaLocation the XML Schema Location with no target namespace
- *
- * @see #setExternalNoNamespaceSchemaLocation(const XMLCh* const)
- */
- void setExternalNoNamespaceSchemaLocation(const char* const noNamespaceSchemaLocation);
-
- //@}
-
-
- // -----------------------------------------------------------------------
- // Parsing methods
- // -----------------------------------------------------------------------
-
- /** @name Parsing methods */
- //@{
-
- /** Parse via an input source object
- *
- * This method invokes the parsing process on the XML file specified
- * by the InputSource parameter. This API is borrowed from the
- * SAX Parser interface.
- *
- * @param source A const reference to the InputSource object which
- * points to the XML file to be parsed.
- * @param reuseGrammar The flag indicating whether the existing Grammar
- * should be reused or not for this parsing run.
- * If true, there cannot be any internal subset.
- * @exception SAXException Any SAX exception, possibly
- * wrapping another exception.
- * @exception XMLException An exception from the parser or client
- * handler code.
- * @exception DOMException A DOM exception as per DOM spec.
- * @see InputSource#InputSource
- * @see #setEntityResolver
- * @see #setErrorHandler
- */
- void parse(const InputSource& source, const bool reuseGrammar = false);
-
- /** Parse via a file path or URL
- *
- * This method invokes the parsing process on the XML file specified by
- * the Unicode string parameter 'systemId'. This method is borrowed
- * from the SAX Parser interface.
- *
- * @param systemId A const XMLCh pointer to the Unicode string which
- * contains the path to the XML file to be parsed.
- * @param reuseGrammar The flag indicating whether the existing Grammar
- * should be reused or not for this parsing run.
- * If true, there cannot be any internal subset.
- *
- * @exception SAXException Any SAX exception, possibly
- * wrapping another exception.
- * @exception XMLException An exception from the parser or client
- * handler code.
- * @exception DOMException A DOM exception as per DOM spec.
- * @see #parse(InputSource,...)
- */
- void parse(const XMLCh* const systemId, const bool reuseGrammar = false);
-
- /** Parse via a file path or URL (in the local code page)
- *
- * This method invokes the parsing process on the XML file specified by
- * the native char* string parameter 'systemId'.
- *
- * @param systemId A const char pointer to a native string which
- * contains the path to the XML file to be parsed.
- * @param reuseGrammar The flag indicating whether the existing Grammar
- * should be reused or not for this parsing run.
- * If true, there cannot be any internal subset.
- *
- * @exception SAXException Any SAX exception, possibly
- * wrapping another exception.
- * @exception XMLException An exception from the parser or client
- * handler code.
- * @exception DOMException A DOM exception as per DOM spec.
- * @see #parse(InputSource,...)
- */
- void parse(const char* const systemId, const bool reuseGrammar = false);
-
- /** Begin a progressive parse operation
- *
- * This method is used to start a progressive parse on a XML file.
- * To continue parsing, subsequent calls must be to the parseNext
- * method.
- *
- * It scans through the prolog and returns a token to be used on
- * subsequent scanNext() calls. If the return value is true, then the
- * token is legal and ready for further use. If it returns false, then
- * the scan of the prolog failed and the token is not going to work on
- * subsequent scanNext() calls.
- *
- * @param systemId A pointer to a Unicode string represting the path
- * to the XML file to be parsed.
- * @param toFill A token maintaing state information to maintain
- * internal consistency between invocation of 'parseNext'
- * calls.
- * @param reuseGrammar The flag indicating whether the existing Grammar
- * should be reused or not for this parsing process.
- * If true, there cannot be any internal subset.
- * @return 'true', if successful in parsing the prolog. It indicates the
- * user can go ahead with parsing the rest of the file. It
- * returns 'false' to indicate that the parser could not parse
- * the prolog.
- *
- * @see #parseNext
- * @see #parseFirst(char*,...)
- * @see #parseFirst(InputSource&,...)
- */
- bool parseFirst
- (
- const XMLCh* const systemId
- , XMLPScanToken& toFill
- , const bool reuseGrammar = false
- );
-
- /** Begin a progressive parse operation
- *
- * This method is used to start a progressive parse on a XML file.
- * To continue parsing, subsequent calls must be to the parseNext
- * method.
- *
- * It scans through the prolog and returns a token to be used on
- * subsequent scanNext() calls. If the return value is true, then the
- * token is legal and ready for further use. If it returns false, then
- * the scan of the prolog failed and the token is not going to work on
- * subsequent scanNext() calls.
- *
- * @param systemId A pointer to a regular native string represting
- * the path to the XML file to be parsed.
- * @param toFill A token maintaing state information to maintain
- * internal consistency between invocation of 'parseNext'
- * calls.
- * @param reuseGrammar The flag indicating whether the existing Grammar
- * should be reused or not for this parsing run.
- * If true, there cannot be any internal subset.
- *
- * @return 'true', if successful in parsing the prolog. It indicates the
- * user can go ahead with parsing the rest of the file. It
- * returns 'false' to indicate that the parser could not parse
- * the prolog.
- *
- * @see #parseNext
- * @see #parseFirst(XMLCh*,...)
- * @see #parseFirst(InputSource&,...)
- */
- bool parseFirst
- (
- const char* const systemId
- , XMLPScanToken& toFill
- , const bool reuseGrammar = false
- );
-
- /** Begin a progressive parse operation
- *
- * This method is used to start a progressive parse on a XML file.
- * To continue parsing, subsequent calls must be to the parseNext
- * method.
- *
- * It scans through the prolog and returns a token to be used on
- * subsequent scanNext() calls. If the return value is true, then the
- * token is legal and ready for further use. If it returns false, then
- * the scan of the prolog failed and the token is not going to work on
- * subsequent scanNext() calls.
- *
- * @param source A const reference to the InputSource object which
- * points to the XML file to be parsed.
- * @param toFill A token maintaing state information to maintain
- * internal consistency between invocation of 'parseNext'
- * calls.
- * @param reuseGrammar The flag indicating whether the existing Grammar
- * should be reused or not for this parsing process.
- * If true, there cannot be any internal subset.
- *
- * @return 'true', if successful in parsing the prolog. It indicates the
- * user can go ahead with parsing the rest of the file. It
- * returns 'false' to indicate that the parser could not parse
- * the prolog.
- *
- * @see #parseNext
- * @see #parseFirst(XMLCh*,...)
- * @see #parseFirst(char*,...)
- */
- bool parseFirst
- (
- const InputSource& source
- , XMLPScanToken& toFill
- , const bool reuseGrammar = false
- );
-
- /** Continue a progressive parse operation
- *
- * This method is used to continue with progressive parsing of
- * XML files started by a call to 'parseFirst' method.
- *
- * It parses the XML file and stops as soon as it comes across
- * a XML token (as defined in the XML specification).
- *
- * @param token A token maintaing state information to maintain
- * internal consistency between invocation of 'parseNext'
- * calls.
- *
- * @return 'true', if successful in parsing the next XML token.
- * It indicates the user can go ahead with parsing the rest
- * of the file. It returns 'false' to indicate that the parser
- * could not find next token as per the XML specification
- * production rule.
- *
- * @see #parseFirst(XMLCh*,...)
- * @see #parseFirst(char*,...)
- * @see #parseFirst(InputSource&,...)
- */
- bool parseNext(XMLPScanToken& token);
-
- /** Reset the parser after a progressive parse
- *
- * If a progressive parse loop exits before the end of the document
- * is reached, the parser has no way of knowing this. So it will leave
- * open any files or sockets or memory buffers that were in use at
- * the time that the parse loop exited.
- *
- * The next parse operation will cause these open files and such to
- * be closed, but the next parse operation might occur at some unknown
- * future point. To avoid this problem, you should reset the parser if
- * you exit the loop early.
- *
- * If you exited because of an error, then this cleanup will be done
- * for you. Its only when you exit the file prematurely of your own
- * accord, because you've found what you wanted in the file most
- * likely.
- *
- * @param token A token maintaing state information to maintain
- * internal consistency between invocation of 'parseNext'
- * calls.
- *
- * @see #parseFirst(XMLCh*,...)
- * @see #parseFirst(char*,...)
- * @see #parseFirst(InputSource&,...)
- */
- void parseReset(XMLPScanToken& token);
-
//@}
-
-
// -----------------------------------------------------------------------
// Implementation of the XMLErrorReporter interface.
// -----------------------------------------------------------------------
@@ -1046,455 +339,18 @@
//@}
-
- // -----------------------------------------------------------------------
- // Implementation of the XMLDocumentHandler interface.
- // -----------------------------------------------------------------------
-
- /** @name Implementation of the XMLDocumentHandler interface. */
- //@{
-
- /** Handle document character events
- *
- * This method is used to report all the characters scanned by the
- * parser. This DOM implementation stores this data in the appropriate
- * DOM node, creating one if necessary.
- *
- * @param chars A const pointer to a Unicode string representing the
- * character data.
- * @param length The length of the Unicode string returned in 'chars'.
- * @param cdataSection A flag indicating if the characters represent
- * content from the CDATA section.
- */
- virtual void docCharacters
- (
- const XMLCh* const chars
- , const unsigned int length
- , const bool cdataSection
- );
-
- /** Handle a document comment event
- *
- * This method is used to report any comments scanned by the parser.
- * A new comment node is created which stores this data.
- *
- * @param comment A const pointer to a null terminated Unicode
- * string representing the comment text.
- */
- virtual void docComment
- (
- const XMLCh* const comment
- );
-
- /** Handle a document PI event
- *
- * This method is used to report any PI scanned by the parser. A new
- * PI node is created and appended as a child of the current node in
- * the tree.
- *
- * @param target A const pointer to a Unicode string representing the
- * target of the PI declaration.
- * @param data A const pointer to a Unicode string representing the
- * data of the PI declaration. See the PI production rule
- * in the XML specification for details.
- */
- virtual void docPI
- (
- const XMLCh* const target
- , const XMLCh* const data
- );
-
- /** Handle the end of document event
- *
- * This method is used to indicate the end of the current document.
- */
- virtual void endDocument();
-
- /** Handle and end of element event
- *
- * This method is used to indicate the end tag of an element. The
- * DOMParse pops the current element off the top of the element
- * stack, and make it the new current element.
- *
- * @param elemDecl A const reference to the object containing element
- * declaration information.
- * @param urlId An id referring to the namespace prefix, if
- * namespaces setting is switched on.
- * @param isRoot A flag indicating whether this element was the
- * root element.
- */
- virtual void endElement
- (
- const XMLElementDecl& elemDecl
- , const unsigned int urlId
- , const bool isRoot
- );
-
- /** Handle and end of entity reference event
- *
- * This method is used to indicate that an end of an entity reference
- * was just scanned.
- *
- * @param entDecl A const reference to the object containing the
- * entity declaration information.
- */
- virtual void endEntityReference
- (
- const XMLEntityDecl& entDecl
- );
-
- /** Handle an ignorable whitespace vent
- *
- * This method is used to report all the whitespace characters, which
- * are determined to be 'ignorable'. This distinction between characters
- * is only made, if validation is enabled.
- *
- * Any whitespace before content is ignored. If the current node is
- * already of type DOMNode::TEXT_NODE, then these whitespaces are
- * appended, otherwise a new Text node is created which stores this
- * data. Essentially all contiguous ignorable characters are collected
- * in one node.
- *
- * @param chars A const pointer to a Unicode string representing the
- * ignorable whitespace character data.
- * @param length The length of the Unicode string 'chars'.
- * @param cdataSection A flag indicating if the characters represent
- * content from the CDATA section.
- */
- virtual void ignorableWhitespace
- (
- const XMLCh* const chars
- , const unsigned int length
- , const bool cdataSection
- );
-
- /** Handle a document reset event
- *
- * This method allows the user installed Document Handler to 'reset'
- * itself, freeing all the memory resources. The scanner calls this
- * method before starting a new parse event.
- */
- virtual void resetDocument();
-
- /** Handle a start document event
- *
- * This method is used to report the start of the parsing process.
- */
- virtual void startDocument();
-
- /** Handle a start element event
- *
- * This method is used to report the start of an element. It is
- * called at the end of the element, by which time all attributes
- * specified are also parsed. A new DOM Element node is created
- * along with as many attribute nodes as required. This new element
- * is added appended as a child of the current node in the tree, and
- * then replaces it as the current node (if the isEmpty flag is false.)
- *
- * @param elemDecl A const reference to the object containing element
- * declaration information.
- * @param urlId An id referring to the namespace prefix, if
- * namespaces setting is switched on.
- * @param elemPrefix A const pointer to a Unicode string containing
- * the namespace prefix for this element. Applicable
- * only when namespace processing is enabled.
- * @param attrList A const reference to the object containing the
- * list of attributes just scanned for this element.
- * @param attrCount A count of number of attributes in the list
- * specified by the parameter 'attrList'.
- * @param isEmpty A flag indicating whether this is an empty element
- * or not. If empty, then no endElement() call will
- * be made.
- * @param isRoot A flag indicating whether this element was the
- * root element.
- * @see DocumentHandler#startElement
- */
- virtual void startElement
- (
- const XMLElementDecl& elemDecl
- , const unsigned int urlId
- , const XMLCh* const elemPrefix
- , const RefVectorOf<XMLAttr>& attrList
- , const unsigned int attrCount
- , const bool isEmpty
- , const bool isRoot
- );
-
- /** Handle a start entity reference event
- *
- * This method is used to indicate the start of an entity reference.
- * If the expand entity reference flag is true, then a new
- * DOM Entity reference node is created.
- *
- * @param entDecl A const reference to the object containing the
- * entity declaration information.
- */
- virtual void startEntityReference
- (
- const XMLEntityDecl& entDecl
- );
-
- /** Handle an XMLDecl event
- *
- * This method is used to report the XML decl scanned by the parser.
- * Refer to the XML specification to see the meaning of parameters.
- *
- * <b><font color="#FF0000">This method is a no-op for this DOM
- * implementation.</font></b>
- *
- * @param versionStr A const pointer to a Unicode string representing
- * version string value.
- * @param encodingStr A const pointer to a Unicode string representing
- * the encoding string value.
- * @param standaloneStr A const pointer to a Unicode string
- * representing the standalone string value.
- * @param actualEncStr A const pointer to a Unicode string
- * representing the actual encoding string
- * value.
- */
- virtual void XMLDecl
- (
- const XMLCh* const versionStr
- , const XMLCh* const encodingStr
- , const XMLCh* const standaloneStr
- , const XMLCh* const actualEncStr
- );
- //@}
-
-
- /** @name Deprecated Methods */
- //@{
- /**
- * This method returns the state of the parser's validation
- * handling flag which controls whether validation checks
- * are enforced or not.
- *
- * @return true, if the parser is currently configured to
- * do validation, false otherwise.
- *
- * @see #setDoValidation
- */
- bool getDoValidation() const;
-
- /**
- * This method allows users to enable or disable the parser's validation
- * checks.
- *
- * <p>By default, the parser does not to any validation. The default
- * value is false.</p>
- *
- * @param newState The value specifying whether the parser should
- * do validity checks or not against the DTD in the
- * input XML document.
- *
- * @see #getDoValidation
- */
- void setDoValidation(const bool newState);
-
- /**
- * Deprecated doctypehandler interfaces
- */
- virtual void attDef
- (
- const DTDElementDecl& elemDecl
- , const DTDAttDef& attDef
- , const bool ignoring
- );
-
- virtual void doctypeComment
- (
- const XMLCh* const comment
- );
-
- virtual void doctypeDecl
- (
- const DTDElementDecl& elemDecl
- , const XMLCh* const publicId
- , const XMLCh* const systemId
- , const bool hasIntSubset
- );
-
- virtual void doctypePI
- (
- const XMLCh* const target
- , const XMLCh* const data
- );
-
- virtual void doctypeWhitespace
- (
- const XMLCh* const chars
- , const unsigned int length
- );
-
- virtual void elementDecl
- (
- const DTDElementDecl& decl
- , const bool isIgnored
- );
-
- virtual void endAttList
- (
- const DTDElementDecl& elemDecl
- );
-
- virtual void endIntSubset();
-
- virtual void endExtSubset();
-
- virtual void entityDecl
- (
- const DTDEntityDecl& entityDecl
- , const bool isPEDecl
- , const bool isIgnored
- );
-
- virtual void resetDocType();
-
- virtual void notationDecl
- (
- const XMLNotationDecl& notDecl
- , const bool isIgnored
- );
-
- virtual void startAttList
- (
- const DTDElementDecl& elemDecl
- );
-
- virtual void startIntSubset();
-
- virtual void startExtSubset();
-
- virtual void TextDecl
- (
- const XMLCh* const versionStr
- , const XMLCh* const encodingStr
- );
-
-
- //@}
-
-
-protected :
- // -----------------------------------------------------------------------
- // Protected getter methods
- // -----------------------------------------------------------------------
-
- /** @name Protected getter methods */
- //@{
- /** Get the current DOM node
- *
- * This provides derived classes with access to the current node, i.e.
- * the node to which new nodes are being added.
- */
- DOMNode* getCurrentNode();
-
- //@}
-
-
- // -----------------------------------------------------------------------
- // Protected setter methods
- // -----------------------------------------------------------------------
-
- /** @name Protected setter methods */
- //@{
-
- /** Set the current DOM node
- *
- * This method sets the current node maintained inside the parser to
- * the one specified.
- *
- * @param toSet The DOM node which will be the current node.
- */
- void setCurrentNode(DOMNode* toSet);
-
- /** Set the document node
- *
- * This method sets the DOM Document node to the one specified.
- *
- * @param toSet The new DOM Document node for this XML document.
- */
- void setDocument(DOMDocument* toSet);
- //@}
-
- // -----------------------------------------------------------------------
- // Protected Helper methods
- // -----------------------------------------------------------------------
- virtual DOMElement* createElementNSNode(const XMLCh *fNamespaceURI,
- const XMLCh *qualifiedName);
-
-
- // -----------------------------------------------------------------------
- // Protected data members
- //
- // fScanner
- // The scanner used for this parser. This is created during the
- // constructor.
- // -----------------------------------------------------------------------
- XMLScanner* fScanner;
-
-
private :
// -----------------------------------------------------------------------
// Private data members
//
- // fCurrentNode
- // fCurrentParent
- // Used to track the current node during nested element events. Since
- // the tree must be built from a set of disjoint callbacks, we need
- // these to keep up with where we currently are.
- //
- // fDocument
- // The root document object, filled with the document contents.
- //
// fEntityResolver
// The installed SAX entity resolver, if any. Null if none.
//
// fErrorHandler
// The installed SAX error handler, if any. Null if none.
- //
- // fCreateEntityReferenceNode
- // Indicates whether entity reference nodes should be created.
- //
- // fIncludeIgnorableWhitespace
- // Indicates whether ignorable whiltespace should be added to
- // the DOM tree for validating parsers.
- //
- // fNodeStack
- // Used to track previous parent nodes during nested element events.
- //
- // fParseInProgress
- // Used to prevent multiple entrance to the parser while its doing
- // a parse.
- //
- // fScanner
- // The scanner used for this parser. This is created during the
- // constructor.
- //
- // fWithinElement
- // A flag to indicate that the parser is within at least one level
- // of element processing.
- //
- // fDocumentType
- // Used to store and update the documentType variable information
- // in fDocument
- //
- // fDocumentVector
- // Store all the previous fDocument(s) (thus not the current fDocument)
- // created in this parser. It is destroyed when the parser is destructed.
- // -----------------------------------------------------------------------
- DOMNode* fCurrentParent;
- DOMNode* fCurrentNode;
- DOMDocumentImpl* fDocument;
+ //-----------------------------------------------------------------------
EntityResolver* fEntityResolver;
ErrorHandler* fErrorHandler;
- bool fCreateEntityReferenceNodes;
- bool fIncludeIgnorableWhitespace;
- ValueStackOf<DOMNode*>* fNodeStack;
- bool fParseInProgress;
- bool fWithinElement;
- DOMDocumentTypeImpl* fDocumentType;
- RefVectorOf<DOMDocumentImpl>* fDocumentVector;
};
@@ -1547,60 +403,5 @@
return fEntityResolver;
}
-inline bool XercesDOMParser::getExpandEntityReferences() const
-{
- return !fCreateEntityReferenceNodes;
-}
-inline bool XercesDOMParser::getCreateEntityReferenceNodes() const
-{
- return fCreateEntityReferenceNodes;
-}
-
-inline bool XercesDOMParser::getIncludeIgnorableWhitespace() const
-{
- return fIncludeIgnorableWhitespace;
-}
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Setter methods
-// ---------------------------------------------------------------------------
-inline void XercesDOMParser::setExpandEntityReferences(const bool expand)
-{
- fCreateEntityReferenceNodes = !expand;
-}
-
-inline void XercesDOMParser::setCreateEntityReferenceNodes(const bool create)
-{
- fCreateEntityReferenceNodes = create;
-}
-
-inline void XercesDOMParser::setIncludeIgnorableWhitespace(const bool include)
-{
- fIncludeIgnorableWhitespace = include;
-}
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Protected getter methods
-// ---------------------------------------------------------------------------
-inline DOMNode* XercesDOMParser::getCurrentNode()
-{
- return fCurrentNode;
-}
-
-
-// ---------------------------------------------------------------------------
-// XercesDOMParser: Protected setter methods
-// ---------------------------------------------------------------------------
-inline void XercesDOMParser::setCurrentNode(DOMNode* toSet)
-{
- fCurrentNode = toSet;
-}
-
-inline void XercesDOMParser::setDocument(DOMDocument* toSet)
-{
- fDocument = (DOMDocumentImpl*)toSet;
-}
#endif
1.1 xml-xerces/c/src/xercesc/parsers/AbstractDOMParser.cpp
Index: AbstractDOMParser.cpp
===================================================================
/*
* The Apache Software License, Version 1.1
*
* Copyright (c) 2002 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
* software without prior written permission. For written
* permission, please contact apache\@apache.org.
*
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 2001, International
* Business Machines, Inc., http://www.ibm.com . For more information
* on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
/**
* This file contains code to build the DOM tree. It registers a document
* handler with the scanner. In these handler methods, appropriate DOM nodes
* are created and added to the DOM tree.
*
* $Id: AbstractDOMParser.cpp,v 1.1 2002/05/22 20:53:41 knoaman Exp $
*
*/
// ---------------------------------------------------------------------------
// Includes
// ---------------------------------------------------------------------------
#include <xercesc/sax/EntityResolver.hpp>
#include <xercesc/util/XMLUniDefs.hpp>
#include <xercesc/framework/XMLNotationDecl.hpp>
#include <xercesc/util/IOException.hpp>
#include <xercesc/internal/XMLScanner.hpp>
#include <xercesc/validators/DTD/DTDValidator.hpp>
#include <xercesc/parsers/AbstractDOMParser.hpp>
#include <xercesc/dom/DOMImplementation.hpp>
#include <xercesc/dom/DOMElement.hpp>
#include <xercesc/dom/impl/DOMAttrImpl.hpp>
#include <xercesc/dom/DOMCDATASection.hpp>
#include <xercesc/dom/DOMComment.hpp>
#include <xercesc/dom/impl/DOMTextImpl.hpp>
#include <xercesc/dom/impl/DOMDocumentImpl.hpp>
#include <xercesc/dom/impl/DOMDocumentTypeImpl.hpp>
#include <xercesc/dom/DOMDocumentType.hpp>
#include <xercesc/dom/impl/DOMElementImpl.hpp>
#include <xercesc/dom/impl/DOMEntityImpl.hpp>
#include <xercesc/dom/impl/DOMEntityReferenceImpl.hpp>
#include <xercesc/dom/impl/DOMNotationImpl.hpp>
#include <xercesc/dom/DOMNamedNodeMap.hpp>
#include <xercesc/dom/DOMProcessingInstruction.hpp>
#include <xercesc/dom/impl/DOMNodeIDMap.hpp>
#include <xercesc/validators/common/ContentSpecNode.hpp>
#include <xercesc/validators/DTD/DTDAttDefList.hpp>
// ---------------------------------------------------------------------------
// AbstractDOMParser: Constructors and Destructor
// ---------------------------------------------------------------------------
AbstractDOMParser::AbstractDOMParser(XMLValidator* const valToAdopt) :
fCreateEntityReferenceNodes(true)
, fIncludeIgnorableWhitespace(true)
, fWithinElement(false)
, fParseInProgress(false)
, fScanner(0)
, fCurrentParent(0)
, fCurrentNode(0)
, fDocument(0)
, fNodeStack(0)
, fDocumentType(0)
, fDocumentVector(0)
{
//
// Create a scanner and tell it what validator to use. Then set us
// as the document event handler so we can fill the DOM document.
//
fScanner = new XMLScanner(valToAdopt);
fScanner->setDocHandler(this);
fScanner->setDocTypeHandler(this);
fNodeStack = new ValueStackOf<DOMNode*>(64);
this->reset();
}
AbstractDOMParser::~AbstractDOMParser()
{
if (fDocumentVector)
delete fDocumentVector;
delete fDocument;
delete fNodeStack;
delete fScanner;
}
void AbstractDOMParser::reset()
{
// if fDocument exists already, store the old pointer in the vector for deletion later
if (fDocument) {
if (!fDocumentVector) {
// allocate the vector if not exists yet
fDocumentVector = new RefVectorOf<DOMDocumentImpl>(10, true) ;
}
fDocumentVector->addElement(fDocument);
}
fDocument = 0;
resetDocType();
fCurrentParent = 0;
fCurrentNode = 0;
fParseInProgress = false;
fWithinElement = false;
fNodeStack->removeAllElements();
};
// ---------------------------------------------------------------------------
// AbstractDOMParser: Getter methods
// ---------------------------------------------------------------------------
DOMDocument* AbstractDOMParser::getDocument()
{
return fDocument;
}
const XMLValidator& AbstractDOMParser::getValidator() const
{
return *fScanner->getValidator();
}
bool AbstractDOMParser::getDoNamespaces() const
{
return fScanner->getDoNamespaces();
}
bool AbstractDOMParser::getExitOnFirstFatalError() const
{
return fScanner->getExitOnFirstFatal();
}
bool AbstractDOMParser::getValidationConstraintFatal() const
{
return fScanner->getValidationConstraintFatal();
}
AbstractDOMParser::ValSchemes AbstractDOMParser::getValidationScheme() const
{
const XMLScanner::ValSchemes scheme = fScanner->getValidationScheme();
if (scheme == XMLScanner::Val_Always)
return Val_Always;
else if (scheme == XMLScanner::Val_Never)
return Val_Never;
return Val_Auto;
}
bool AbstractDOMParser::getDoSchema() const
{
return fScanner->getDoSchema();
}
bool AbstractDOMParser::getValidationSchemaFullChecking() const
{
return fScanner->getValidationSchemaFullChecking();
}
int AbstractDOMParser::getErrorCount() const
{
return fScanner->getErrorCount();
}
XMLCh* AbstractDOMParser::getExternalSchemaLocation() const
{
return fScanner->getExternalSchemaLocation();
}
XMLCh* AbstractDOMParser::getExternalNoNamespaceSchemaLocation() const
{
return fScanner->getExternalNoNamespaceSchemaLocation();
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Setter methods
// ---------------------------------------------------------------------------
void AbstractDOMParser::setDoNamespaces(const bool newState)
{
fScanner->setDoNamespaces(newState);
}
void AbstractDOMParser::setExitOnFirstFatalError(const bool newState)
{
fScanner->setExitOnFirstFatal(newState);
}
void AbstractDOMParser::setValidationConstraintFatal(const bool newState)
{
fScanner->setValidationConstraintFatal(newState);
}
void AbstractDOMParser::setValidationScheme(const ValSchemes newScheme)
{
if (newScheme == Val_Never)
fScanner->setValidationScheme(XMLScanner::Val_Never);
else if (newScheme == Val_Always)
fScanner->setValidationScheme(XMLScanner::Val_Always);
else
fScanner->setValidationScheme(XMLScanner::Val_Auto);
}
void AbstractDOMParser::setDoSchema(const bool newState)
{
fScanner->setDoSchema(newState);
}
void AbstractDOMParser::setValidationSchemaFullChecking(const bool schemaFullChecking)
{
fScanner->setValidationSchemaFullChecking(schemaFullChecking);
}
void AbstractDOMParser::setExternalSchemaLocation(const XMLCh* const schemaLocation)
{
fScanner->setExternalSchemaLocation(schemaLocation);
}
void AbstractDOMParser::setExternalNoNamespaceSchemaLocation(const XMLCh* const noNamespaceSchemaLocation)
{
fScanner->setExternalNoNamespaceSchemaLocation(noNamespaceSchemaLocation);
}
void AbstractDOMParser::setExternalSchemaLocation(const char* const schemaLocation)
{
fScanner->setExternalSchemaLocation(schemaLocation);
}
void AbstractDOMParser::setExternalNoNamespaceSchemaLocation(const char* const noNamespaceSchemaLocation)
{
fScanner->setExternalNoNamespaceSchemaLocation(noNamespaceSchemaLocation);
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Parsing methods
// ---------------------------------------------------------------------------
void AbstractDOMParser::parse(const InputSource& source, const bool reuseGrammar)
{
// Avoid multiple entrance
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
try
{
fParseInProgress = true;
fScanner->scanDocument(source, reuseGrammar);
fParseInProgress = false;
}
catch(...)
{
fParseInProgress = false;
throw;
}
}
void AbstractDOMParser::parse(const XMLCh* const systemId, const bool reuseGrammar)
{
// Avoid multiple entrance
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
try
{
fParseInProgress = true;
fScanner->scanDocument(systemId, reuseGrammar);
fParseInProgress = false;
}
catch(...)
{
fParseInProgress = false;
throw;
}
}
void AbstractDOMParser::parse(const char* const systemId, const bool reuseGrammar)
{
// Avoid multiple entrance
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
try
{
fParseInProgress = true;
fScanner->scanDocument(systemId, reuseGrammar);
fParseInProgress = false;
}
catch(...)
{
fParseInProgress = false;
throw;
}
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Progressive parse methods
// ---------------------------------------------------------------------------
bool AbstractDOMParser::parseFirst( const XMLCh* const systemId
, XMLPScanToken& toFill
, const bool reuseGrammar)
{
//
// Avoid multiple entrance. We cannot enter here while a regular parse
// is in progress.
//
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
return fScanner->scanFirst(systemId, toFill, reuseGrammar);
}
bool AbstractDOMParser::parseFirst( const char* const systemId
, XMLPScanToken& toFill
, const bool reuseGrammar)
{
//
// Avoid multiple entrance. We cannot enter here while a regular parse
// is in progress.
//
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
return fScanner->scanFirst(systemId, toFill, reuseGrammar);
}
bool AbstractDOMParser::parseFirst( const InputSource& source
, XMLPScanToken& toFill
, const bool reuseGrammar)
{
//
// Avoid multiple entrance. We cannot enter here while a regular parse
// is in progress.
//
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
return fScanner->scanFirst(source, toFill, reuseGrammar);
}
bool AbstractDOMParser::parseNext(XMLPScanToken& token)
{
return fScanner->scanNext(token);
}
void AbstractDOMParser::parseReset(XMLPScanToken& token)
{
// Reset the scanner, and then reset the parser
fScanner->scanReset(token);
reset();
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Utilities
// ---------------------------------------------------------------------------
void AbstractDOMParser::resetDocumentPool()
{
// We cannot enter here while a regular parse is in progress.
if (fParseInProgress)
ThrowXML(IOException, XMLExcepts::Gen_ParseInProgress);
if (fDocumentVector)
fDocumentVector->removeAllElements();
delete fDocument;
fDocument = 0;
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Implementation of XMLDocumentHandler interface
// ---------------------------------------------------------------------------
void AbstractDOMParser::docCharacters( const XMLCh* const chars
, const unsigned int length
, const bool cdataSection)
{
// Ignore chars outside of content
if (!fWithinElement)
return;
// revisit. Is it really safe to null-terminate here?
// Does the scanner do it already?
// If scanner goes up to the very end of an unterminated
// buffer, we may be stepping on something bad here.
// Probably best to modify the scanner to null terminate.
XMLCh savedChar = chars[length];
XMLCh *ncChars = (XMLCh *)chars; // cast off const
ncChars[length] = 0;
if (cdataSection == true)
{
DOMCDATASection *node = fDocument->createCDATASection(chars);
fCurrentParent->appendChild(node);
fCurrentNode = node;
}
else
{
if (fCurrentNode->getNodeType() == DOMNode::TEXT_NODE)
{
DOMText *node = (DOMText *)fCurrentNode;
node->appendData(chars);
}
else
{
DOMText *node = fDocument->createTextNode(chars);
fCurrentParent->appendChild(node);
fCurrentNode = node;
}
}
ncChars[length] = savedChar;
return;
}
void AbstractDOMParser::docComment(const XMLCh* const comment)
{
DOMComment *dcom = fDocument->createComment(comment);
fCurrentParent->appendChild(dcom);
fCurrentNode = dcom;
}
void AbstractDOMParser::docPI( const XMLCh* const target
, const XMLCh* const data)
{
DOMProcessingInstruction *pi = fDocument->createProcessingInstruction
(
target
, data
);
fCurrentParent->appendChild(pi);
fCurrentNode = pi;
}
void AbstractDOMParser::endEntityReference(const XMLEntityDecl& entDecl)
{
if (fCreateEntityReferenceNodes == true)
{
if (fCurrentParent->getNodeType() == DOMNode::ENTITY_REFERENCE_NODE) {
DOMEntityReferenceImpl *erImpl = (DOMEntityReferenceImpl *) fCurrentParent;
erImpl->setReadOnly(true, true);
}
fCurrentParent = fNodeStack->pop();
fCurrentNode = fCurrentParent;
}
}
void AbstractDOMParser::endElement( const XMLElementDecl& elemDecl
, const unsigned int urlId
, const bool isRoot)
{
fCurrentNode = fCurrentParent;
fCurrentParent = fNodeStack->pop();
// If we've hit the end of content, clear the flag
if (fNodeStack->empty())
fWithinElement = false;
}
void AbstractDOMParser::ignorableWhitespace(const XMLCh* const chars
, const unsigned int length
, const bool cdataSection)
{
// Ignore chars before the root element
if (!fWithinElement || !fIncludeIgnorableWhitespace)
return;
// revisit. Not safe to slam in a null like this.
XMLCh savedChar = chars[length];
XMLCh *ncChars = (XMLCh *)chars; // cast off const
ncChars[length] = chNull;
if (fCurrentNode->getNodeType() == DOMNode::TEXT_NODE)
{
DOMText *node = (DOMText *)fCurrentNode;
node->appendData(chars);
}
else
{
DOMTextImpl *node = (DOMTextImpl *)fDocument->createTextNode(chars);
node->setIgnorableWhitespace(true);
fCurrentParent->appendChild(node);
fCurrentNode = node;
}
ncChars[length] = savedChar;
}
void AbstractDOMParser::resetDocument()
{
//
// The reset methods are called before a new parse event occurs.
// Reset this parsers state to clear out anything that may be left
// from a previous use, in particular the DOM document itself.
//
this->reset();
fDocument = (DOMDocumentImpl *)DOMImplementation::getImplementation()->createDocument();
}
void AbstractDOMParser::startDocument()
{
// Just set the document as the current parent and current node
fCurrentParent = fDocument;
fCurrentNode = fDocument;
// set DOM error checking off
fDocument->setErrorChecking(false);
}
void AbstractDOMParser::endDocument()
{
// set DOM error checking back on
fDocument->setErrorChecking(true);
}
void AbstractDOMParser::startElement(const XMLElementDecl& elemDecl
, const unsigned int urlId
, const XMLCh* const elemPrefix
, const RefVectorOf<XMLAttr>& attrList
, const unsigned int attrCount
, const bool isEmpty
, const bool isRoot)
{
DOMElement *elem;
if (fScanner -> getDoNamespaces()) { //DOM Level 2, doNamespaces on
XMLBuffer buf;
XMLCh* namespaceURI = 0;
if (urlId != fScanner->getEmptyNamespaceId()) { //TagName has a prefix
fScanner->getURIText(urlId, buf); //get namespaceURI
namespaceURI = buf.getRawBuffer();
}
elem = createElementNSNode(namespaceURI, elemDecl.getFullName());
DOMElementImpl *elemImpl = (DOMElementImpl *) elem;
for (unsigned int index = 0; index < attrCount; ++index) {
static const XMLCh XMLNS[] = {
chLatin_x, chLatin_m, chLatin_l, chLatin_n, chLatin_s, chNull
};
const XMLAttr* oneAttrib = attrList.elementAt(index);
unsigned int attrURIId = oneAttrib -> getURIId();
namespaceURI = 0;
if (!XMLString::compareString(oneAttrib -> getName(), XMLNS)) //for xmlns=...
attrURIId = fScanner->getXMLNSNamespaceId();
if (attrURIId != fScanner->getEmptyNamespaceId()) { //TagName has a prefix
fScanner->getURIText(attrURIId, buf); //get namespaceURI
namespaceURI = buf.getRawBuffer();
}
// revisit. Optimize to init the named node map to the
// right size up front.
DOMAttrImpl *attr = (DOMAttrImpl *)
fDocument->createAttributeNS(namespaceURI, oneAttrib->getQName());
attr->setValue(oneAttrib -> getValue());
elemImpl->setAttributeNode(attr);
//DOMAttrImpl *attr = elemImpl->setAttributeNS(namespaceURI, oneAttrib -> getQName(),
// oneAttrib -> getValue());
// Attributes of type ID. If this is one, add it to the hashtable of IDs
// that is constructed for use by GetElementByID().
//
if (oneAttrib->getType()==XMLAttDef::ID)
{
if (fDocument->fNodeIDMap == 0)
fDocument->fNodeIDMap = new (fDocument) DOMNodeIDMap(500, fDocument);
fDocument->fNodeIDMap->add(attr);
attr->fNode.isIdAttr(true);
}
attr->setSpecified(oneAttrib->getSpecified());
}
}
else { //DOM Level 1
elem = fDocument->createElement(elemDecl.getFullName());
DOMElementImpl *elemImpl = (DOMElementImpl *) elem;
for (unsigned int index = 0; index < attrCount; ++index) {
const XMLAttr* oneAttrib = attrList.elementAt(index);
//AttrImpl *attr = elemImpl->setAttribute(oneAttrib->getName(), oneAttrib->getValue());
DOMAttrImpl *attr = (DOMAttrImpl *)
fDocument->createAttribute(oneAttrib->getName());
attr->setValue(oneAttrib -> getValue());
elemImpl->setAttributeNode(attr);
attr->setSpecified(oneAttrib->getSpecified());
// Attributes of type ID. If this is one, add it to the hashtable of IDs
// that is constructed for use by GetElementByID().
//
if (oneAttrib->getType()==XMLAttDef::ID)
{
if (fDocument->fNodeIDMap == 0)
fDocument->fNodeIDMap = new (fDocument) DOMNodeIDMap(500, fDocument);
fDocument->fNodeIDMap->add(attr);
attr->fNode.isIdAttr(true);
}
}
}
fCurrentParent->appendChild(elem);
fNodeStack->push(fCurrentParent);
fCurrentParent = elem;
fCurrentNode = elem;
fWithinElement = true;
// If an empty element, do end right now (no endElement() will be called)
if (isEmpty)
endElement(elemDecl, urlId, isRoot);
}
void AbstractDOMParser::startEntityReference(const XMLEntityDecl& entDecl)
{
if (fCreateEntityReferenceNodes == true)
{
const XMLCh * entName = entDecl.getName();
DOMEntityReference *er = fDocument->createEntityReference(entName);
//set the readOnly flag to false before appending node, will be reset in endEntityReference
DOMEntityReferenceImpl *erImpl = (DOMEntityReferenceImpl *) er;
erImpl->setReadOnly(false, true);
fCurrentParent->appendChild(er);
fNodeStack->push(fCurrentParent);
fCurrentParent = er;
fCurrentNode = er;
// this entityRef needs to be stored in Entity map too.
// We'd decide later whether the entity nodes should be created by a
// separated method in parser or not. For now just stick it in if
// the ref nodes are created
DOMNamedNodeMap *entities = fDocumentType->getEntities();
DOMEntityImpl* entity = (DOMEntityImpl*)entities->getNamedItem(entName);
entity->setEntityRef(er);
}
}
void AbstractDOMParser::XMLDecl(const XMLCh* const version
, const XMLCh* const encoding
, const XMLCh* const standalone
, const XMLCh* const actualEncStr)
{
// placehold for DOM Level 3
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Helper methods
// ---------------------------------------------------------------------------
DOMElement* AbstractDOMParser::createElementNSNode(const XMLCh *namespaceURI,
const XMLCh *qualifiedName)
{
return fDocument->createElementNS(namespaceURI, qualifiedName);
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Deprecated methods
// ---------------------------------------------------------------------------
bool AbstractDOMParser::getDoValidation() const
{
//
// We don't want to tie the public parser classes to the enum used
// by the scanner, so we use a separate one and map.
//
// DON'T mix the new and old methods!!
//
const XMLScanner::ValSchemes scheme = fScanner->getValidationScheme();
if (scheme == XMLScanner::Val_Always)
return true;
return false;
}
void AbstractDOMParser::setDoValidation(const bool newState)
{
fScanner->setDoValidation
(
newState ? XMLScanner::Val_Always : XMLScanner::Val_Never
);
}
//doctypehandler interfaces
void AbstractDOMParser::attDef
(
const DTDElementDecl& elemDecl
, const DTDAttDef& attDef
, const bool ignoring
)
{
if (fDocumentType->isIntSubsetReading())
{
XMLBuffer attString;
if (elemDecl.hasAttDefs())
{
attString.append(chOpenAngle);
attString.append(chBang);
attString.append(XMLUni::fgAttListString);
attString.append(chSpace);
attString.append(elemDecl.getFullName());
attString.append(chSpace);
attString.append(attDef.getFullName());
// Get the type and display it
const XMLAttDef::AttTypes type = attDef.getType();
switch(type)
{
case XMLAttDef::CData :
attString.append(chSpace);
attString.append(XMLUni::fgCDATAString);
break;
case XMLAttDef::ID :
attString.append(chSpace);
attString.append(XMLUni::fgIDString);
break;
case XMLAttDef::IDRef :
attString.append(chSpace);
attString.append(XMLUni::fgIDRefString);
break;
case XMLAttDef::IDRefs :
attString.append(chSpace);
attString.append(XMLUni::fgIDRefsString);
break;
case XMLAttDef::Entity :
attString.append(chSpace);
attString.append(XMLUni::fgEntityString);
break;
case XMLAttDef::Entities :
attString.append(chSpace);
attString.append(XMLUni::fgEntitiesString);
break;
case XMLAttDef::NmToken :
attString.append(chSpace);
attString.append(XMLUni::fgNmTokenString);
break;
case XMLAttDef::NmTokens :
attString.append(chSpace);
attString.append(XMLUni::fgNmTokensString);
break;
case XMLAttDef::Notation :
attString.append(chSpace);
attString.append(XMLUni::fgNotationString);
break;
case XMLAttDef::Enumeration :
attString.append(chSpace);
const XMLCh* enumString = attDef.getEnumeration();
int length = XMLString::stringLen(enumString);
if (length > 0) {
XMLBuffer anotherEnumString;
anotherEnumString.append(chOpenParen );
for(int i=0; i<length; i++) {
if (enumString[i] == chSpace)
anotherEnumString.append(chPipe);
else
anotherEnumString.append(enumString[i]);
}
anotherEnumString.append(chCloseParen);
attString.append(anotherEnumString.getRawBuffer());
}
break;
}
//get te default types of the attlist
const XMLAttDef::DefAttTypes def = attDef.getDefaultType();
switch(def)
{
case XMLAttDef::Required :
attString.append(chSpace);
attString.append(XMLUni::fgRequiredString);
break;
case XMLAttDef::Implied :
attString.append(chSpace);
attString.append(XMLUni::fgImpliedString);
break;
case XMLAttDef::Fixed :
attString.append(chSpace);
attString.append(XMLUni::fgFixedString);
break;
}
const XMLCh* defaultValue = attDef.getValue();
if (defaultValue != 0) {
attString.append(chSpace);
attString.append(chDoubleQuote);
attString.append(defaultValue);
attString.append(chDoubleQuote);
}
attString.append(chCloseAngle);
fDocumentType->setInternalSubset(attString.getRawBuffer());
}
}
}
void AbstractDOMParser::doctypeComment
(
const XMLCh* const comment
)
{
if (fDocumentType->isIntSubsetReading())
{
if (comment != 0)
{
XMLBuffer comString;
comString.append(XMLUni::fgCommentString);
comString.append(chSpace);
comString.append(comment);
comString.append(chSpace);
comString.append(chDash);
comString.append(chDash);
comString.append(chCloseAngle);
fDocumentType->setInternalSubset(comString.getRawBuffer());
}
}
}
void AbstractDOMParser::doctypeDecl
(
const DTDElementDecl& elemDecl
, const XMLCh* const publicId
, const XMLCh* const systemId
, const bool hasIntSubset
)
{
fDocumentType = (DOMDocumentTypeImpl *) fDocument->createDocumentType(elemDecl.getFullName(), publicId, systemId);
fDocument->setDocumentType(fDocumentType);
}
void AbstractDOMParser::doctypePI
(
const XMLCh* const target
, const XMLCh* const data
)
{
if (fDocumentType->isIntSubsetReading())
{
//add these chars to internalSubset variable
XMLBuffer pi;
pi.append(chOpenAngle);
pi.append(chQuestion);
pi.append(target);
pi.append(chSpace);
pi.append(data);
pi.append(chQuestion);
pi.append(chCloseAngle);
fDocumentType->setInternalSubset(pi.getRawBuffer());
}
}
void AbstractDOMParser::doctypeWhitespace
(
const XMLCh* const chars
, const unsigned int length
)
{
if (fDocumentType->isIntSubsetReading())
fDocumentType->setInternalSubset(chars);
}
void AbstractDOMParser::elementDecl
(
const DTDElementDecl& decl
, const bool isIgnored
)
{
if (fDocumentType->isIntSubsetReading())
{
XMLBuffer elemDecl;
elemDecl.append(chOpenAngle);
elemDecl.append(chBang);
elemDecl.append(XMLUni::fgElemString);
elemDecl.append(chSpace);
elemDecl.append(decl.getFullName());
//get the ContentSpec information
const XMLCh* contentModel = decl.getFormattedContentModel();
if (contentModel != 0) {
elemDecl.append(chSpace);
elemDecl.append(contentModel);
}
elemDecl.append(chCloseAngle);
fDocumentType->setInternalSubset(elemDecl.getRawBuffer());
}
}
void AbstractDOMParser::endAttList
(
const DTDElementDecl& elemDecl
)
{
// this section sets up default attributes.
// default attribute nodes are stored in a NamedNodeMap DocumentTypeImpl::elements
// default attribute data attached to the document is used to conform to the
// DOM spec regarding creating element nodes & removing attributes with default values
// see DocumentTypeImpl
if (elemDecl.hasAttDefs())
{
XMLAttDefList* defAttrs = &elemDecl.getAttDefList();
XMLAttDef* attr = 0;
DOMAttrImpl * insertAttr = 0;
DOMElement *elem = fDocument->createElement(elemDecl.getFullName());
DOMElementImpl *elemImpl = (DOMElementImpl *) elem;
while (defAttrs->hasMoreElements())
{
attr = &defAttrs->nextElement();
if (attr->getValue() != 0)
{
if (fScanner->getDoNamespaces())
{
// DOM Level 2 wants all namespace declaration attributes
// to be bound to "http://www.w3.org/2000/xmlns/"
// So as long as the XML parser doesn't do it, it needs to
// done here.
const XMLCh* qualifiedName = attr->getFullName();
int index = DOMDocumentImpl::indexofQualifiedName(qualifiedName);
XMLBuffer buf;
static const XMLCh XMLNS[] = {
chLatin_x, chLatin_m, chLatin_l, chLatin_n, chLatin_s, chNull};
if (index > 0) {
// there is prefix
// map to XML URI for all cases except when prefix == "xmlns"
XMLCh* prefix;
XMLCh temp[1000];
if (index > 999)
prefix = new XMLCh[index+1];
else
prefix = temp;
XMLString::subString(prefix ,qualifiedName, 0, index);
if (!XMLString::compareString(prefix,XMLNS))
buf.append(XMLUni::fgXMLNSURIName);
else
buf.append(XMLUni::fgXMLURIName);
if (index > 999)
delete prefix;
}
else {
// No prefix
if (!XMLString::compareString(qualifiedName,XMLNS))
buf.append(XMLUni::fgXMLNSURIName);
}
insertAttr = (DOMAttrImpl *) fDocument->createAttributeNS(
buf.getRawBuffer(), // NameSpaceURI
qualifiedName); // qualified name
}
else
{
// Namespaces is turned off...
insertAttr = (DOMAttrImpl *) fDocument->createAttribute(attr->getFullName());
}
insertAttr->setValue(attr->getValue());
elemImpl->setAttributeNode(insertAttr);
insertAttr->setSpecified(false);
}
}
fDocumentType->getElements()->setNamedItem(elemImpl);
}
}
void AbstractDOMParser::endIntSubset()
{
fDocumentType->intSubsetReading = false;
}
void AbstractDOMParser::endExtSubset()
{
}
void AbstractDOMParser::entityDecl
(
const DTDEntityDecl& entityDecl
, const bool isPEDecl
, const bool isIgnored
)
{
DOMEntityImpl* entity = (DOMEntityImpl *) fDocument->createEntity(entityDecl.getName());
entity->setPublicId(entityDecl.getPublicId());
entity->setSystemId(entityDecl.getSystemId());
entity->setNotationName(entityDecl.getNotationName());
DOMEntityImpl *previousDef = (DOMEntityImpl *)
fDocumentType->getEntities()->setNamedItem( entity );
#ifdef _revisit
//
// If this new entity node is replacing an entity node that was already
// in the entities named node map (happens if documents redefine the
// predefined entited such as lt), we need to delete the original
// entitiy node, assuming no-one else was referencing it.
//
if (previousDef != 0 && previousDef->nodeRefCount == 0)
NodeImpl::deleteIf(previousDef);
#endif
if (fDocumentType->isIntSubsetReading())
{
//add thes chars to internalSubset variable
XMLBuffer entityName;
entityName.append(chOpenAngle);
entityName.append(chBang);
entityName.append(XMLUni::fgEntityString);
entityName.append(chSpace);
entityName.append(entityDecl.getName());
const XMLCh* id = entity->getPublicId();
if (id != 0) {
entityName.append(chSpace);
entityName.append(XMLUni::fgPubIDString);
entityName.append(chSpace);
entityName.append(chDoubleQuote);
entityName.append(id);
entityName.append(chDoubleQuote);
}
id = entity->getSystemId();
if (id != 0) {
entityName.append(chSpace);
entityName.append(XMLUni::fgSysIDString);
entityName.append(chSpace);
entityName.append(chDoubleQuote);
entityName.append(id);
entityName.append(chDoubleQuote);
}
id = entity->getNotationName();
if (id != 0) {
entityName.append(chSpace);
entityName.append(XMLUni::fgNDATAString);
entityName.append(chSpace);
entityName.append(chDoubleQuote);
entityName.append(id);
entityName.append(chDoubleQuote);
}
id = entityDecl.getValue();
if (id !=0) {
entityName.append(chSpace);
entityName.append(chDoubleQuote);
entityName.append(id);
entityName.append(chDoubleQuote);
}
entityName.append(chCloseAngle);
fDocumentType->setInternalSubset(entityName.getRawBuffer());
}
}
void AbstractDOMParser::resetDocType()
{
fDocumentType = 0;
}
void AbstractDOMParser::notationDecl
(
const XMLNotationDecl& notDecl
, const bool isIgnored
)
{
DOMNotationImpl* notation = (DOMNotationImpl *)fDocument->createNotation(notDecl.getName());
notation->setPublicId(notDecl.getPublicId());
notation->setSystemId(notDecl.getSystemId());
fDocumentType->getNotations()->setNamedItem( notation );
}
void AbstractDOMParser::startAttList
(
const DTDElementDecl& elemDecl
)
{
}
void AbstractDOMParser::startIntSubset()
{
fDocumentType->intSubsetReading = true;
}
void AbstractDOMParser::startExtSubset()
{
}
void AbstractDOMParser::TextDecl
(
const XMLCh* const versionStr
, const XMLCh* const encodingStr
)
{
}
1.1 xml-xerces/c/src/xercesc/parsers/AbstractDOMParser.hpp
Index: AbstractDOMParser.hpp
===================================================================
/*
* The Apache Software License, Version 1.1
*
* Copyright (c) 2002 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
* software without prior written permission. For written
* permission, please contact apache\@apache.org.
*
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 2001, International
* Business Machines, Inc., http://www.ibm.com . For more information
* on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
/*
* $Id: AbstractDOMParser.hpp,v 1.1 2002/05/22 20:53:41 knoaman Exp $
*
*/
#if !defined(ABSTRACTDOMPARSER_HPP)
#define ABSTRACTDOMPARSER_HPP
#include <xercesc/dom/DOMDocument.hpp>
#include <xercesc/framework/XMLDocumentHandler.hpp>
#include <xercesc/framework/XMLErrorReporter.hpp>
#include <xercesc/framework/XMLEntityHandler.hpp>
#include <xercesc/util/ValueStackOf.hpp>
#include <xercesc/validators/DTD/DocTypeHandler.hpp>
#include <xercesc/dom/DOMDocumentType.hpp>
#include <xercesc/validators/DTD/DTDElementDecl.hpp>
class XMLPScanToken;
class XMLScanner;
class XMLValidator;
class DOMDocumentImpl;
class DOMDocumentTypeImpl;
class DOMElement;
/**
* This class implements the Document Object Model (DOM) interface.
* It is used as a base for DOM parsers (i.e. XercesDOMParser, DOMBuilder).
*/
class PARSERS_EXPORT AbstractDOMParser :
public XMLDocumentHandler
, public XMLErrorReporter
, public XMLEntityHandler
, public DocTypeHandler
{
public :
// -----------------------------------------------------------------------
// Class types
// -----------------------------------------------------------------------
enum ValSchemes
{
Val_Never
, Val_Always
, Val_Auto
};
// -----------------------------------------------------------------------
// Constructors and Detructor
// -----------------------------------------------------------------------
/** @name Destructor */
//@{
/**
* Destructor
*/
virtual ~AbstractDOMParser();
//@}
/** Reset the parser
*
* This method resets the state of the DOM driver and makes
* it ready for a fresh parse run.
*/
void reset();
/** Reset the documents vector pool and release all the associated memory
* back to the system.
*
* When parsing a document using a DOM parser, all memory allocated
* for a DOM tree is associated to the DOM document.
*
* If you do multiple parse using the same DOM parser instance, then
* multiple DOM documents will be generated and saved in a vector pool.
* All these documents (and thus all the allocated memory)
* won't be deleted until the parser instance is destroyed.
*
* If you don't need these DOM documents anymore and don't want to
* destroy the DOM parser instance at this moment, then you can call this method
* to reset the document vector pool and release all the allocated memory
* back to the system.
*
* It is an error to call this method if you are in the middle of a
* parse (e.g. in the mid of a progressive parse).
*
* @exception IOException An exception from the parser if this function
* is called when a parse is in progress.
*
*/
void resetDocumentPool();
// -----------------------------------------------------------------------
// Getter methods
// -----------------------------------------------------------------------
/** @name Getter methods */
//@{
/** Get the DOM document
*
* This method returns the DOMDocument object representing the
* root of the document tree. This object provides the primary
* access to the document's data.
*
* @return The DOMDocument object which represents the entire
* XML document.
*/
DOMDocument* getDocument();
/** Get a const reference to the validator
*
* This method returns a reference to the parser's installed
* validator.
*
* @return A const reference to the installed validator object.
*/
const XMLValidator& getValidator() const;
/**
* This method returns an enumerated value that indicates the current
* validation scheme set on this parser.
*
* @return The ValSchemes value current set on this parser.
* @see #setValidationScheme
*/
ValSchemes getValidationScheme() const;
/** Get the 'do schema' flag
*
* This method returns the state of the parser's schema processing
* flag.
*
* @return true, if the parser is currently configured to
* understand schema, false otherwise.
*
* @see #setDoSchema
*/
bool getDoSchema() const;
/** Get the 'full schema constraint checking' flag
*
* This method returns the state of the parser's full schema constraint
* checking flag.
*
* @return true, if the parser is currently configured to
* have full schema constraint checking, false otherwise.
*
* @see #setValidationSchemaFullChecking
*/
bool getValidationSchemaFullChecking() const;
/** Get error count from the last parse operation.
*
* This method returns the error count from the last parse
* operation. Note that this count is actually stored in the
* scanner, so this method simply returns what the
* scanner reports.
*
* @return number of errors encountered during the latest
* parse operation.
*
*/
int getErrorCount() const;
/** Get the 'do namespaces' flag
*
* This method returns the state of the parser's namespace processing
* flag.
*
* @return true, if the parser is currently configured to
* understand namespaces, false otherwise.
*
* @see #setDoNamespaces
*/
bool getDoNamespaces() const;
/** Get the 'exit on first error' flag
*
* This method returns the state of the parser's
* exit-on-First-Fatal-Error flag. If this flag is true, then the
* parse will exit the first time it sees any non-wellformed XML or
* any validity error. The default state is true.
*
* @return true, if the parser is currently configured to
* exit on the first fatal error, false otherwise.
*
* @see #setExitOnFirstFatalError
*/
bool getExitOnFirstFatalError() const;
/**
* This method returns the state of the parser's
* validation-constraint-fatal flag.
*
* @return true, if the parser is currently configured to
* set validation constraint errors as fatal, false
* otherwise.
*
* @see #setValidationContraintFatal
*/
bool getValidationConstraintFatal() const;
/** Get the 'expand entity references' flag.
* DEPRECATED Use getCreateEntityReferenceNodes() instead.
*
* This method returns the state of the parser's expand entity
* references flag.
*
* @return 'true' if the expand entity reference flag is set on
* the parser, 'false' otherwise.
*
* @see #setExpandEntityReferences
* @see #setCreateEntityReferenceNodes
* @see #getCreateEntityReferenceNodes
*/
bool getExpandEntityReferences() const;
/** Get the 'include entity references' flag
*
* This method returns the flag that specifies whether the parser is
* creating entity reference nodes in the DOM tree being produced.
*
* @return The state of the create entity reference node
* flag.
* @see #setCreateEntityReferenceNodes
*/
bool getCreateEntityReferenceNodes()const;
/** Get the 'include ignorable whitespace' flag.
*
* This method returns the state of the parser's include ignorable
* whitespace flag.
*
* @return 'true' if the include ignorable whitespace flag is set on
* the parser, 'false' otherwise.
*
* @see #setIncludeIgnorableWhitespace
*/
bool getIncludeIgnorableWhitespace() const;
/** Get the set of Namespace/SchemaLocation that is specified externaly.
*
* This method returns the list of Namespace/SchemaLocation that was
* specified using setExternalSchemaLocation.
*
* The parser owns the returned string, and the memory allocated for
* the returned string will be destroyed when the parser is deleted.
*
* To ensure assessiblity of the returned information after the parser
* is deleted, callers need to copy and store the returned information
* somewhere else.
*
* @return a pointer to the list of Namespace/SchemaLocation that was
* specified externally. The pointer spans the same life-time as
* the parser. A null pointer is returned if nothing
* was specified externally.
*
* @see #setExternalSchemaLocation(const XMLCh* const)
*/
XMLCh* getExternalSchemaLocation() const;
/** Get the noNamespace SchemaLocation that is specified externaly.
*
* This method returns the no target namespace XML Schema Location
* that was specified using setExternalNoNamespaceSchemaLocation.
*
* The parser owns the returned string, and the memory allocated for
* the returned string will be destroyed when the parser is deleted.
*
* To ensure assessiblity of the returned information after the parser
* is deleted, callers need to copy and store the returned information
* somewhere else.
*
* @return a pointer to the no target namespace Schema Location that was
* specified externally. The pointer spans the same life-time as
* the parser. A null pointer is returned if nothing
* was specified externally.
*
* @see #setExternalNoNamespaceSchemaLocation(const XMLCh* const)
*/
XMLCh* getExternalNoNamespaceSchemaLocation() const;
//@}
// -----------------------------------------------------------------------
// Setter methods
// -----------------------------------------------------------------------
/** @name Setter methods */
//@{
/** Set the 'do namespaces' flag
*
* This method allows users to enable or disable the parser's
* namespace processing. When set to true, parser starts enforcing
* all the constraints and rules specified by the NameSpace
* specification.
*
* The parser's default state is: false.
*
* This flag is ignored by the underlying scanner if the installed
* validator indicates that namespace constraints should be
* enforced.
*
* @param newState The value specifying whether NameSpace rules should
* be enforced or not.
*
* @see #getDoNamespaces
*/
void setDoNamespaces(const bool newState);
/** Set the 'exit on first error' flag
*
* This method allows users to set the parser's behaviour when it
* encounters the first fatal error. If set to true, the parser
* will exit at the first fatal error. If false, then it will
* report the error and continue processing.
*
* The default value is 'true' and the parser exits on the
* first fatal error.
*
* @param newState The value specifying whether the parser should
* continue or exit when it encounters the first
* fatal error.
*
* @see #getExitOnFirstFatalError
*/
void setExitOnFirstFatalError(const bool newState);
/**
* This method allows users to set the parser's behaviour when it
* encounters a validtion constraint error. If set to true, and the
* the parser is set to exit when it encounter the first fatal error,
* the parser will exit at the first encounter. If false, then it will
* report the error and continue processing.
*
* <p>The default value is 'false'.</p>
*
* @param newState The value specifying whether the parser should
* continue or exit when it encounters a validation
* constraint error.
*
* @see #getValidationConstraintFatal
*/
void setValidationConstraintFatal(const bool newState);
/** Set the 'expand entity references' flag
*
* DEPRECATED. USE setCreateEntityReferenceNodes instead.
* This method allows the user to specify whether the parser should
* expand all entity reference nodes. When the 'do expansion' flag is
* true, the DOM tree does not have any entity reference nodes. It is
* replaced by the sub-tree representing the replacement text of the
* entity. When the 'do expansion' flag is false, the DOM tree
* contains an extra entity reference node, whose children is the
* sub tree of the replacement text.
* <p>The default value is 'false'.
*
* @param expand The new state of the expand entity reference
* flag.
* @see #setCreateEntityReferenceNodes
*/
void setExpandEntityReferences(const bool expand);
/** Set the 'include entity references' flag
*
* This method allows the user to specify whether the parser should
* create entity reference nodes in the DOM tree being produced.
* When the 'create' flag is
* true, the parser will create EntityReference nodes in the DOM tree.
* The EntityReference nodes and their child nodes will be read-only.
* When the 'create' flag is false, no EntityReference nodes will be created.
* <p>The replacement text
* of the entity is included in either case, either as a
* child of the Entity Reference node or in place at the location
* of the reference.
* <p>The default value is 'true'.
*
* @param create The new state of the create entity reference nodes
* flag.
* @see #getCreateEntityReferenceNodes
*/
void setCreateEntityReferenceNodes(const bool create);
/** Set the 'include ignorable whitespace' flag
*
* This method allows the user to specify whether a validating parser
* should include ignorable whitespaces as text nodes. It has no effect
* on non-validating parsers which always include non-markup text.
* <p>When set to true (also the default), ignorable whitespaces will be
* added to the DOM tree as text nodes. The method
* DOMText::isIgnorableWhitespace() will return true for those text
* nodes only.
* <p>When set to false, all ignorable whitespace will be discarded and
* no text node is added to the DOM tree. Note: applications intended
* to process the "xml:space" attribute should not set this flag to false.
* And this flag also overrides any schema datateye whitespace facets,
* that is, all ignorable whitespace will be discarded even though
* 'preserve' is set in schema datatype whitespace facets.
*
* @param include The new state of the include ignorable whitespace
* flag.
*
* @see #getIncludeIgnorableWhitespace
*/
void setIncludeIgnorableWhitespace(const bool include);
/**
* This method allows users to set the validation scheme to be used
* by this parser. The value is one of the ValSchemes enumerated values
* defined by this class:
*
* <br> Val_Never - turn off validation
* <br> Val_Always - turn on validation
* <br> Val_Auto - turn on validation if any internal/external
* DTD subset have been seen
*
* <p>The parser's default state is: Val_Auto.</p>
*
* @param newScheme The new validation scheme to use.
*
* @see #getValidationScheme
*/
void setValidationScheme(const ValSchemes newScheme);
/** Set the 'do schema' flag
*
* This method allows users to enable or disable the parser's
* schema processing. When set to false, parser will not process
* any schema found.
*
* The parser's default state is: false.
*
* @param newState The value specifying whether schema support should
* be enforced or not.
*
* @see #getDoSchema
*/
void setDoSchema(const bool newState);
/**
* This method allows the user to turn full Schema constraint checking on/off.
* Only takes effect if Schema validation is enabled.
* If turned off, partial constraint checking is done.
*
* Full schema constraint checking includes those checking that may
* be time-consuming or memory intensive. Currently, particle unique
* attribution constraint checking and particle derivation resriction checking
* are controlled by this option.
*
* The parser's default state is: false.
*
* @param schemaFullChecking True to turn on full schema constraint checking.
*
* @see #getValidationSchemaFullChecking
*/
void setValidationSchemaFullChecking(const bool schemaFullChecking);
/**
* This method allows the user to specify a list of schemas to use.
* If the targetNamespace of a schema specified using this method matches
* the targetNamespace of a schema occuring in the instance document in
* the schemaLocation attribute, or if the targetNamespace matches the
* namespace attribute of the "import" element, the schema specified by the
* user using this method will be used (i.e., the schemaLocation attribute
* in the instance document or on the "import" element will be effectively ignored).
*
* If this method is called more than once, only the last one takes effect.
*
* The syntax is the same as for schemaLocation attributes in instance
* documents: e.g, "http://www.example.com file_name.xsd". The user can
* specify more than one XML Schema in the list.
*
* @param schemaLocation the list of schemas to use
*
* @see #getExternalSchemaLocation
*/
void setExternalSchemaLocation(const XMLCh* const schemaLocation);
/**
* This method is same as setExternalSchemaLocation(const XMLCh* const).
* It takes native char string as parameter
*
* @param schemaLocation the list of schemas to use
*
* @see #setExternalSchemaLocation(const XMLCh* const)
*/
void setExternalSchemaLocation(const char* const schemaLocation);
/**
* This method allows the user to specify the no target namespace XML
* Schema Location externally. If specified, the instance document's
* noNamespaceSchemaLocation attribute will be effectively ignored.
*
* If this method is called more than once, only the last one takes effect.
*
* The syntax is the same as for the noNamespaceSchemaLocation attribute
* that may occur in an instance document: e.g."file_name.xsd".
*
* @param noNamespaceSchemaLocation the XML Schema Location with no target namespace
*
* @see #getExternalNoNamespaceSchemaLocation
*/
void setExternalNoNamespaceSchemaLocation(const XMLCh* const noNamespaceSchemaLocation);
/**
* This method is same as setExternalNoNamespaceSchemaLocation(const XMLCh* const).
* It takes native char string as parameter
*
* @param noNamespaceSchemaLocation the XML Schema Location with no target namespace
*
* @see #setExternalNoNamespaceSchemaLocation(const XMLCh* const)
*/
void setExternalNoNamespaceSchemaLocation(const char* const noNamespaceSchemaLocation);
//@}
// -----------------------------------------------------------------------
// Parsing methods
// -----------------------------------------------------------------------
/** @name Parsing methods */
//@{
/** Parse via an input source object
*
* This method invokes the parsing process on the XML file specified
* by the InputSource parameter. This API is borrowed from the
* SAX Parser interface.
*
* @param source A const reference to the InputSource object which
* points to the XML file to be parsed.
* @param reuseGrammar The flag indicating whether the existing Grammar
* should be reused or not for this parsing run.
* If true, there cannot be any internal subset.
* @exception SAXException Any SAX exception, possibly
* wrapping another exception.
* @exception XMLException An exception from the parser or client
* handler code.
* @exception DOMException A DOM exception as per DOM spec.
* @see InputSource#InputSource
*/
virtual void parse(const InputSource& source, const bool reuseGrammar = false);
/** Parse via a file path or URL
*
* This method invokes the parsing process on the XML file specified by
* the Unicode string parameter 'systemId'. This method is borrowed
* from the SAX Parser interface.
*
* @param systemId A const XMLCh pointer to the Unicode string which
* contains the path to the XML file to be parsed.
* @param reuseGrammar The flag indicating whether the existing Grammar
* should be reused or not for this parsing run.
* If true, there cannot be any internal subset.
*
* @exception SAXException Any SAX exception, possibly
* wrapping another exception.
* @exception XMLException An exception from the parser or client
* handler code.
* @exception DOMException A DOM exception as per DOM spec.
* @see #parse(InputSource,...)
*/
virtual void parse(const XMLCh* const systemId, const bool reuseGrammar = false);
/** Parse via a file path or URL (in the local code page)
*
* This method invokes the parsing process on the XML file specified by
* the native char* string parameter 'systemId'.
*
* @param systemId A const char pointer to a native string which
* contains the path to the XML file to be parsed.
* @param reuseGrammar The flag indicating whether the existing Grammar
* should be reused or not for this parsing run.
* If true, there cannot be any internal subset.
*
* @exception SAXException Any SAX exception, possibly
* wrapping another exception.
* @exception XMLException An exception from the parser or client
* handler code.
* @exception DOMException A DOM exception as per DOM spec.
* @see #parse(InputSource,...)
*/
virtual void parse(const char* const systemId, const bool reuseGrammar = false);
/** Begin a progressive parse operation
*
* This method is used to start a progressive parse on a XML file.
* To continue parsing, subsequent calls must be to the parseNext
* method.
*
* It scans through the prolog and returns a token to be used on
* subsequent scanNext() calls. If the return value is true, then the
* token is legal and ready for further use. If it returns false, then
* the scan of the prolog failed and the token is not going to work on
* subsequent scanNext() calls.
*
* @param systemId A pointer to a Unicode string represting the path
* to the XML file to be parsed.
* @param toFill A token maintaing state information to maintain
* internal consistency between invocation of 'parseNext'
* calls.
* @param reuseGrammar The flag indicating whether the existing Grammar
* should be reused or not for this parsing process.
* If true, there cannot be any internal subset.
* @return 'true', if successful in parsing the prolog. It indicates the
* user can go ahead with parsing the rest of the file. It
* returns 'false' to indicate that the parser could not parse
* the prolog.
*
* @see #parseNext
* @see #parseFirst(char*,...)
* @see #parseFirst(InputSource&,...)
*/
bool parseFirst
(
const XMLCh* const systemId
, XMLPScanToken& toFill
, const bool reuseGrammar = false
);
/** Begin a progressive parse operation
*
* This method is used to start a progressive parse on a XML file.
* To continue parsing, subsequent calls must be to the parseNext
* method.
*
* It scans through the prolog and returns a token to be used on
* subsequent scanNext() calls. If the return value is true, then the
* token is legal and ready for further use. If it returns false, then
* the scan of the prolog failed and the token is not going to work on
* subsequent scanNext() calls.
*
* @param systemId A pointer to a regular native string represting
* the path to the XML file to be parsed.
* @param toFill A token maintaing state information to maintain
* internal consistency between invocation of 'parseNext'
* calls.
* @param reuseGrammar The flag indicating whether the existing Grammar
* should be reused or not for this parsing run.
* If true, there cannot be any internal subset.
*
* @return 'true', if successful in parsing the prolog. It indicates the
* user can go ahead with parsing the rest of the file. It
* returns 'false' to indicate that the parser could not parse
* the prolog.
*
* @see #parseNext
* @see #parseFirst(XMLCh*,...)
* @see #parseFirst(InputSource&,...)
*/
bool parseFirst
(
const char* const systemId
, XMLPScanToken& toFill
, const bool reuseGrammar = false
);
/** Begin a progressive parse operation
*
* This method is used to start a progressive parse on a XML file.
* To continue parsing, subsequent calls must be to the parseNext
* method.
*
* It scans through the prolog and returns a token to be used on
* subsequent scanNext() calls. If the return value is true, then the
* token is legal and ready for further use. If it returns false, then
* the scan of the prolog failed and the token is not going to work on
* subsequent scanNext() calls.
*
* @param source A const reference to the InputSource object which
* points to the XML file to be parsed.
* @param toFill A token maintaing state information to maintain
* internal consistency between invocation of 'parseNext'
* calls.
* @param reuseGrammar The flag indicating whether the existing Grammar
* should be reused or not for this parsing process.
* If true, there cannot be any internal subset.
*
* @return 'true', if successful in parsing the prolog. It indicates the
* user can go ahead with parsing the rest of the file. It
* returns 'false' to indicate that the parser could not parse
* the prolog.
*
* @see #parseNext
* @see #parseFirst(XMLCh*,...)
* @see #parseFirst(char*,...)
*/
bool parseFirst
(
const InputSource& source
, XMLPScanToken& toFill
, const bool reuseGrammar = false
);
/** Continue a progressive parse operation
*
* This method is used to continue with progressive parsing of
* XML files started by a call to 'parseFirst' method.
*
* It parses the XML file and stops as soon as it comes across
* a XML token (as defined in the XML specification).
*
* @param token A token maintaing state information to maintain
* internal consistency between invocation of 'parseNext'
* calls.
*
* @return 'true', if successful in parsing the next XML token.
* It indicates the user can go ahead with parsing the rest
* of the file. It returns 'false' to indicate that the parser
* could not find next token as per the XML specification
* production rule.
*
* @see #parseFirst(XMLCh*,...)
* @see #parseFirst(char*,...)
* @see #parseFirst(InputSource&,...)
*/
bool parseNext(XMLPScanToken& token);
/** Reset the parser after a progressive parse
*
* If a progressive parse loop exits before the end of the document
* is reached, the parser has no way of knowing this. So it will leave
* open any files or sockets or memory buffers that were in use at
* the time that the parse loop exited.
*
* The next parse operation will cause these open files and such to
* be closed, but the next parse operation might occur at some unknown
* future point. To avoid this problem, you should reset the parser if
* you exit the loop early.
*
* If you exited because of an error, then this cleanup will be done
* for you. Its only when you exit the file prematurely of your own
* accord, because you've found what you wanted in the file most
* likely.
*
* @param token A token maintaing state information to maintain
* internal consistency between invocation of 'parseNext'
* calls.
*
* @see #parseFirst(XMLCh*,...)
* @see #parseFirst(char*,...)
* @see #parseFirst(InputSource&,...)
*/
void parseReset(XMLPScanToken& token);
//@}
// -----------------------------------------------------------------------
// Implementation of the XMLDocumentHandler interface.
// -----------------------------------------------------------------------
/** @name Implementation of the XMLDocumentHandler interface. */
//@{
/** Handle document character events
*
* This method is used to report all the characters scanned by the
* parser. This DOM implementation stores this data in the appropriate
* DOM node, creating one if necessary.
*
* @param chars A const pointer to a Unicode string representing the
* character data.
* @param length The length of the Unicode string returned in 'chars'.
* @param cdataSection A flag indicating if the characters represent
* content from the CDATA section.
*/
virtual void docCharacters
(
const XMLCh* const chars
, const unsigned int length
, const bool cdataSection
);
/** Handle a document comment event
*
* This method is used to report any comments scanned by the parser.
* A new comment node is created which stores this data.
*
* @param comment A const pointer to a null terminated Unicode
* string representing the comment text.
*/
virtual void docComment
(
const XMLCh* const comment
);
/** Handle a document PI event
*
* This method is used to report any PI scanned by the parser. A new
* PI node is created and appended as a child of the current node in
* the tree.
*
* @param target A const pointer to a Unicode string representing the
* target of the PI declaration.
* @param data A const pointer to a Unicode string representing the
* data of the PI declaration. See the PI production rule
* in the XML specification for details.
*/
virtual void docPI
(
const XMLCh* const target
, const XMLCh* const data
);
/** Handle the end of document event
*
* This method is used to indicate the end of the current document.
*/
virtual void endDocument();
/** Handle and end of element event
*
* This method is used to indicate the end tag of an element. The
* DOM parser pops the current element off the top of the element
* stack, and make it the new current element.
*
* @param elemDecl A const reference to the object containing element
* declaration information.
* @param urlId An id referring to the namespace prefix, if
* namespaces setting is switched on.
* @param isRoot A flag indicating whether this element was the
* root element.
*/
virtual void endElement
(
const XMLElementDecl& elemDecl
, const unsigned int urlId
, const bool isRoot
);
/** Handle and end of entity reference event
*
* This method is used to indicate that an end of an entity reference
* was just scanned.
*
* @param entDecl A const reference to the object containing the
* entity declaration information.
*/
virtual void endEntityReference
(
const XMLEntityDecl& entDecl
);
/** Handle an ignorable whitespace vent
*
* This method is used to report all the whitespace characters, which
* are determined to be 'ignorable'. This distinction between characters
* is only made, if validation is enabled.
*
* Any whitespace before content is ignored. If the current node is
* already of type DOMNode::TEXT_NODE, then these whitespaces are
* appended, otherwise a new Text node is created which stores this
* data. Essentially all contiguous ignorable characters are collected
* in one node.
*
* @param chars A const pointer to a Unicode string representing the
* ignorable whitespace character data.
* @param length The length of the Unicode string 'chars'.
* @param cdataSection A flag indicating if the characters represent
* content from the CDATA section.
*/
virtual void ignorableWhitespace
(
const XMLCh* const chars
, const unsigned int length
, const bool cdataSection
);
/** Handle a document reset event
*
* This method allows the user installed Document Handler to 'reset'
* itself, freeing all the memory resources. The scanner calls this
* method before starting a new parse event.
*/
virtual void resetDocument();
/** Handle a start document event
*
* This method is used to report the start of the parsing process.
*/
virtual void startDocument();
/** Handle a start element event
*
* This method is used to report the start of an element. It is
* called at the end of the element, by which time all attributes
* specified are also parsed. A new DOM Element node is created
* along with as many attribute nodes as required. This new element
* is added appended as a child of the current node in the tree, and
* then replaces it as the current node (if the isEmpty flag is false.)
*
* @param elemDecl A const reference to the object containing element
* declaration information.
* @param urlId An id referring to the namespace prefix, if
* namespaces setting is switched on.
* @param elemPrefix A const pointer to a Unicode string containing
* the namespace prefix for this element. Applicable
* only when namespace processing is enabled.
* @param attrList A const reference to the object containing the
* list of attributes just scanned for this element.
* @param attrCount A count of number of attributes in the list
* specified by the parameter 'attrList'.
* @param isEmpty A flag indicating whether this is an empty element
* or not. If empty, then no endElement() call will
* be made.
* @param isRoot A flag indicating whether this element was the
* root element.
* @see DocumentHandler#startElement
*/
virtual void startElement
(
const XMLElementDecl& elemDecl
, const unsigned int urlId
, const XMLCh* const elemPrefix
, const RefVectorOf<XMLAttr>& attrList
, const unsigned int attrCount
, const bool isEmpty
, const bool isRoot
);
/** Handle a start entity reference event
*
* This method is used to indicate the start of an entity reference.
* If the expand entity reference flag is true, then a new
* DOM Entity reference node is created.
*
* @param entDecl A const reference to the object containing the
* entity declaration information.
*/
virtual void startEntityReference
(
const XMLEntityDecl& entDecl
);
/** Handle an XMLDecl event
*
* This method is used to report the XML decl scanned by the parser.
* Refer to the XML specification to see the meaning of parameters.
*
* <b><font color="#FF0000">This method is a no-op for this DOM
* implementation.</font></b>
*
* @param versionStr A const pointer to a Unicode string representing
* version string value.
* @param encodingStr A const pointer to a Unicode string representing
* the encoding string value.
* @param standaloneStr A const pointer to a Unicode string
* representing the standalone string value.
* @param actualEncStr A const pointer to a Unicode string
* representing the actual encoding string
* value.
*/
virtual void XMLDecl
(
const XMLCh* const versionStr
, const XMLCh* const encodingStr
, const XMLCh* const standaloneStr
, const XMLCh* const actualEncStr
);
//@}
/** @name Deprecated Methods */
//@{
/**
* This method returns the state of the parser's validation
* handling flag which controls whether validation checks
* are enforced or not.
*
* @return true, if the parser is currently configured to
* do validation, false otherwise.
*
* @see #setDoValidation
*/
bool getDoValidation() const;
/**
* This method allows users to enable or disable the parser's validation
* checks.
*
* <p>By default, the parser does not to any validation. The default
* value is false.</p>
*
* @param newState The value specifying whether the parser should
* do validity checks or not against the DTD in the
* input XML document.
*
* @see #getDoValidation
*/
void setDoValidation(const bool newState);
/**
* Deprecated doctypehandler interfaces
*/
virtual void attDef
(
const DTDElementDecl& elemDecl
, const DTDAttDef& attDef
, const bool ignoring
);
virtual void doctypeComment
(
const XMLCh* const comment
);
virtual void doctypeDecl
(
const DTDElementDecl& elemDecl
, const XMLCh* const publicId
, const XMLCh* const systemId
, const bool hasIntSubset
);
virtual void doctypePI
(
const XMLCh* const target
, const XMLCh* const data
);
virtual void doctypeWhitespace
(
const XMLCh* const chars
, const unsigned int length
);
virtual void elementDecl
(
const DTDElementDecl& decl
, const bool isIgnored
);
virtual void endAttList
(
const DTDElementDecl& elemDecl
);
virtual void endIntSubset();
virtual void endExtSubset();
virtual void entityDecl
(
const DTDEntityDecl& entityDecl
, const bool isPEDecl
, const bool isIgnored
);
virtual void resetDocType();
virtual void notationDecl
(
const XMLNotationDecl& notDecl
, const bool isIgnored
);
virtual void startAttList
(
const DTDElementDecl& elemDecl
);
virtual void startIntSubset();
virtual void startExtSubset();
virtual void TextDecl
(
const XMLCh* const versionStr
, const XMLCh* const encodingStr
);
//@}
protected :
// -----------------------------------------------------------------------
// Protected getter methods
// -----------------------------------------------------------------------
/** @name Constructors */
//@{
/** Construct a AbstractDOMParser, with an optional validator
*
* Constructor with an instance of validator class to use for
* validation. If you don't provide a validator, a default one will
* be created for you in the scanner.
*
* @param valToAdopt Pointer to the validator instance to use. The
* parser is responsible for freeing the memory.
*/
AbstractDOMParser(XMLValidator* const valToAdopt = 0);
//@}
/** @name Protected getter methods */
//@{
/** Get the current DOM node
*
* This provides derived classes with access to the current node, i.e.
* the node to which new nodes are being added.
*/
DOMNode* getCurrentNode();
/** Get the XML scanner
*
* This provides derived classes with access to the XML scanner.
*/
XMLScanner* getScanner() const;
/** Get the parse in progress flag
*
* This provides derived classes with access to the parse in progress
* flag.
*/
bool getParseInProgress() const;
//@}
// -----------------------------------------------------------------------
// Protected setter methods
// -----------------------------------------------------------------------
/** @name Protected setter methods */
//@{
/** Set the current DOM node
*
* This method sets the current node maintained inside the parser to
* the one specified.
*
* @param toSet The DOM node which will be the current node.
*/
void setCurrentNode(DOMNode* toSet);
/** Set the document node
*
* This method sets the DOM Document node to the one specified.
*
* @param toSet The new DOM Document node for this XML document.
*/
void setDocument(DOMDocument* toSet);
//@}
// -----------------------------------------------------------------------
// Protected Helper methods
// -----------------------------------------------------------------------
virtual DOMElement* createElementNSNode(const XMLCh *fNamespaceURI,
const XMLCh *qualifiedName);
private :
// -----------------------------------------------------------------------
// Private data members
//
// fCurrentNode
// fCurrentParent
// Used to track the current node during nested element events. Since
// the tree must be built from a set of disjoint callbacks, we need
// these to keep up with where we currently are.
//
// fDocument
// The root document object, filled with the document contents.
//
// fCreateEntityReferenceNode
// Indicates whether entity reference nodes should be created.
//
// fIncludeIgnorableWhitespace
// Indicates whether ignorable whiltespace should be added to
// the DOM tree for validating parsers.
//
// fScanner
// The scanner used for this parser. This is created during the
// constructor.
//
// fNodeStack
// Used to track previous parent nodes during nested element events.
//
// fParseInProgress
// Used to prevent multiple entrance to the parser while its doing
// a parse.
//
// fWithinElement
// A flag to indicate that the parser is within at least one level
// of element processing.
//
// fDocumentType
// Used to store and update the documentType variable information
// in fDocument
//
// fDocumentVector
// Store all the previous fDocument(s) (thus not the current fDocument)
// created in this parser. It is destroyed when the parser is destructed.
// -----------------------------------------------------------------------
bool fCreateEntityReferenceNodes;
bool fIncludeIgnorableWhitespace;
bool fWithinElement;
bool fParseInProgress;
XMLScanner* fScanner;
DOMNode* fCurrentParent;
DOMNode* fCurrentNode;
DOMDocumentImpl* fDocument;
ValueStackOf<DOMNode*>* fNodeStack;
DOMDocumentTypeImpl* fDocumentType;
RefVectorOf<DOMDocumentImpl>* fDocumentVector;
};
// ---------------------------------------------------------------------------
// AbstractDOMParser: Getter methods
// ---------------------------------------------------------------------------
inline bool AbstractDOMParser::getExpandEntityReferences() const
{
return !fCreateEntityReferenceNodes;
}
inline bool AbstractDOMParser::getCreateEntityReferenceNodes() const
{
return fCreateEntityReferenceNodes;
}
inline bool AbstractDOMParser::getIncludeIgnorableWhitespace() const
{
return fIncludeIgnorableWhitespace;
}
inline bool AbstractDOMParser::getParseInProgress() const
{
return fParseInProgress;
}
inline XMLScanner* AbstractDOMParser::getScanner() const
{
return fScanner;
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Setter methods
// ---------------------------------------------------------------------------
inline void AbstractDOMParser::setExpandEntityReferences(const bool expand)
{
fCreateEntityReferenceNodes = !expand;
}
inline void AbstractDOMParser::setCreateEntityReferenceNodes(const bool create)
{
fCreateEntityReferenceNodes = create;
}
inline void AbstractDOMParser::setIncludeIgnorableWhitespace(const bool include)
{
fIncludeIgnorableWhitespace = include;
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Protected getter methods
// ---------------------------------------------------------------------------
inline DOMNode* AbstractDOMParser::getCurrentNode()
{
return fCurrentNode;
}
// ---------------------------------------------------------------------------
// AbstractDOMParser: Protected setter methods
// ---------------------------------------------------------------------------
inline void AbstractDOMParser::setCurrentNode(DOMNode* toSet)
{
fCurrentNode = toSet;
}
inline void AbstractDOMParser::setDocument(DOMDocument* toSet)
{
fDocument = (DOMDocumentImpl *)toSet;
}
#endif
---------------------------------------------------------------------
To unsubscribe, e-mail: xerces-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-cvs-help@xml.apache.org