Xerces-C++  3.1.3
Protected Member Functions | Protected Attributes | List of all members
AbstractDOMParser Class Reference

This class implements the Document Object Model (DOM) interface. More...

Inheritance diagram for AbstractDOMParser:
XMemory XMLDocumentHandler XMLErrorReporter XMLEntityHandler PSVIHandler XercesDOMParser

Public Types

Public constants
enum  ValSchemes { Val_Never, Val_Always, Val_Auto }
 ValScheme enum used in setValidationScheme Val_Never: Do not report validation errors. More...
 
- Public Types inherited from XMLErrorReporter
enum  ErrTypes { ErrType_Warning, ErrType_Error, ErrType_Fatal, ErrTypes_Unknown }
 

Public Member Functions

Destructor
virtual ~AbstractDOMParser ()
 Destructor. More...
 
Utility methods
void reset ()
 Reset the parser. More...
 
DOMDocumentadoptDocument ()
 Adopt the DOM document. More...
 
Getter methods
DOMDocumentgetDocument ()
 Get the DOM document. More...
 
const XMLValidatorgetValidator () const
 Get a const reference to the validator. More...
 
ValSchemes getValidationScheme () const
 This method returns an enumerated value that indicates the current validation scheme set on this parser. More...
 
bool getDoSchema () const
 Get the 'do schema' flag. More...
 
bool getValidationSchemaFullChecking () const
 Get the 'full schema constraint checking' flag. More...
 
bool getIdentityConstraintChecking () const
 Get the identity constraint checking' flag. More...
 
XMLSize_t getErrorCount () const
 Get error count from the last parse operation. More...
 
bool getDoNamespaces () const
 Get the 'do namespaces' flag. More...
 
bool getExitOnFirstFatalError () const
 Get the 'exit on first error' flag. More...
 
bool getValidationConstraintFatal () const
 This method returns the state of the parser's validation-constraint-fatal flag. More...
 
bool getCreateEntityReferenceNodes () const
 Get the 'include entity references' flag. More...
 
bool getIncludeIgnorableWhitespace () const
 Get the 'include ignorable whitespace' flag. More...
 
XMLChgetExternalSchemaLocation () const
 Get the set of Namespace/SchemaLocation that is specified externally. More...
 
XMLChgetExternalNoNamespaceSchemaLocation () const
 Get the noNamespace SchemaLocation that is specified externally. More...
 
SecurityManagergetSecurityManager () const
 Get the SecurityManager instance attached to this parser. More...
 
const XMLSize_tgetLowWaterMark () const
 Get the raw buffer low water mark for this parser. More...
 
bool getLoadExternalDTD () const
 Get the 'Loading External DTD' flag. More...
 
bool getLoadSchema () const
 Get the 'Loading Schema' flag. More...
 
bool getCreateCommentNodes () const
 Get the 'create comment node' flag. More...
 
bool getCalculateSrcOfs () const
 Get the 'calculate src offset flag'. More...
 
bool getStandardUriConformant () const
 Get the 'force standard uri flag'. More...
 
PSVIHandlergetPSVIHandler ()
 This method returns the installed PSVI handler. More...
 
const PSVIHandlergetPSVIHandler () const
 This method returns the installed PSVI handler. More...
 
bool getCreateSchemaInfo () const
 Get the 'associate schema info' flag. More...
 
bool getDoXInclude () const
 Get the 'do XInclude' flag. More...
 
bool getGenerateSyntheticAnnotations () const
 Get the 'generate synthetic annotations' flag. More...
 
bool getValidateAnnotations () const
 Get the 'validate annotations' flag. More...
 
bool getIgnoreAnnotations () const
 Get the 'ignore annotations' flag. More...
 
bool getDisableDefaultEntityResolution () const
 Get the 'disable default entity resolution' flag. More...
 
bool getSkipDTDValidation () const
 Get the 'skip DTD validation' flag. More...
 
bool getHandleMultipleImports () const
 Get the 'handle multiple schema imports' flag. More...
 
Setter methods
void setGenerateSyntheticAnnotations (const bool newValue)
 set the 'generate synthetic annotations' flag More...
 
void setValidateAnnotations (const bool newValue)
 set the 'validlate annotations' flag More...
 
void setDoNamespaces (const bool newState)
 Set the 'do namespaces' flag. More...
 
void setExitOnFirstFatalError (const bool newState)
 Set the 'exit on first error' flag. More...
 
void setValidationConstraintFatal (const bool newState)
 This method allows users to set the parser's behaviour when it encounters a validation constraint error. More...
 
void setCreateEntityReferenceNodes (const bool create)
 Set the 'include entity references' flag. More...
 
void setIncludeIgnorableWhitespace (const bool include)
 Set the 'include ignorable whitespace' flag. More...
 
void setValidationScheme (const ValSchemes newScheme)
 This method allows users to set the validation scheme to be used by this parser. More...
 
void setDoSchema (const bool newState)
 Set the 'do schema' flag. More...
 
void setValidationSchemaFullChecking (const bool schemaFullChecking)
 This method allows the user to turn full Schema constraint checking on/off. More...
 
void setIdentityConstraintChecking (const bool newState)
 This method allows users to enable or disable the parser's identity constraint checks. More...
 
void setExternalSchemaLocation (const XMLCh *const schemaLocation)
 This method allows the user to specify a list of schemas to use. More...
 
void setExternalSchemaLocation (const char *const schemaLocation)
 This method is same as setExternalSchemaLocation(const XMLCh* const). More...
 
void setExternalNoNamespaceSchemaLocation (const XMLCh *const noNamespaceSchemaLocation)
 This method allows the user to specify the no target namespace XML Schema Location externally. More...
 
void setExternalNoNamespaceSchemaLocation (const char *const noNamespaceSchemaLocation)
 This method is same as setExternalNoNamespaceSchemaLocation(const XMLCh* const). More...
 
void setSecurityManager (SecurityManager *const securityManager)
 This allows an application to set a SecurityManager on the parser; this object stores information that various components use to limit their consumption of system resources while processing documents. More...
 
void setLowWaterMark (XMLSize_t lwm)
 Set the raw buffer low water mark for this parser. More...
 
void setLoadExternalDTD (const bool newState)
 Set the 'Loading External DTD' flag. More...
 
void setLoadSchema (const bool newState)
 Set the 'Loading Schema' flag. More...
 
void setCreateCommentNodes (const bool create)
 Set the 'create comment nodes' flag. More...
 
void setCalculateSrcOfs (const bool newState)
 Enable/disable src offset calculation. More...
 
void setStandardUriConformant (const bool newState)
 Force standard uri. More...
 
void useScanner (const XMLCh *const scannerName)
 Set the scanner to use when scanning the XML document. More...
 
void useImplementation (const XMLCh *const implementationFeatures)
 Set the implementation to use when creating the document. More...
 
virtual void setPSVIHandler (PSVIHandler *const handler)
 This method installs the user specified PSVI handler on the parser. More...
 
void setCreateSchemaInfo (const bool newState)
 Set the 'associate schema info' flag. More...
 
void setDoXInclude (const bool newState)
 Set the 'do XInclude' flag. More...
 
void setIgnoreAnnotations (const bool newValue)
 Set the 'ignore annotation' flag. More...
 
void setDisableDefaultEntityResolution (const bool newValue)
 Set the 'disable default entity resolution' flag. More...
 
void setSkipDTDValidation (const bool newValue)
 Set the 'skip DTD validation' flag. More...
 
void setHandleMultipleImports (const bool newValue)
 Set the 'handle multiple schema imports' flag. More...
 
Parsing methods
void parse (const InputSource &source)
 Parse via an input source object. More...
 
void parse (const XMLCh *const systemId)
 Parse via a file path or URL. More...
 
void parse (const char *const systemId)
 Parse via a file path or URL (in the local code page) More...
 
bool parseFirst (const XMLCh *const systemId, XMLPScanToken &toFill)
 Begin a progressive parse operation. More...
 
bool parseFirst (const char *const systemId, XMLPScanToken &toFill)
 Begin a progressive parse operation. More...
 
bool parseFirst (const InputSource &source, XMLPScanToken &toFill)
 Begin a progressive parse operation. More...
 
bool parseNext (XMLPScanToken &token)
 Continue a progressive parse operation. More...
 
void parseReset (XMLPScanToken &token)
 Reset the parser after a progressive parse. More...
 
Implementation of the PSVIHandler interface.
virtual void handleElementPSVI (const XMLCh *const localName, const XMLCh *const uri, PSVIElement *elementInfo)
 Receive notification of the PSVI properties of an element. More...
 
virtual void handlePartialElementPSVI (const XMLCh *const localName, const XMLCh *const uri, PSVIElement *elementInfo)
 Receive notification of partial PSVI properties of an element. More...
 
virtual void handleAttributesPSVI (const XMLCh *const localName, const XMLCh *const uri, PSVIAttributeList *psviAttributes)
 Enables PSVI information about attributes to be passed back to the application. More...
 
Implementation of the XMLDocumentHandler interface.
virtual void docCharacters (const XMLCh *const chars, const XMLSize_t length, const bool cdataSection)
 Handle document character events. More...
 
virtual void docComment (const XMLCh *const comment)
 Handle a document comment event. More...
 
virtual void docPI (const XMLCh *const target, const XMLCh *const data)
 Handle a document PI event. More...
 
virtual void endDocument ()
 Handle the end of document event. More...
 
virtual void endElement (const XMLElementDecl &elemDecl, const unsigned int urlId, const bool isRoot, const XMLCh *const elemPrefix)
 Handle and end of element event. More...
 
virtual void endEntityReference (const XMLEntityDecl &entDecl)
 Handle and end of entity reference event. More...
 
virtual void ignorableWhitespace (const XMLCh *const chars, const XMLSize_t length, const bool cdataSection)
 Handle an ignorable whitespace vent. More...
 
virtual void resetDocument ()
 Handle a document reset event. More...
 
virtual void startDocument ()
 Handle a start document event. More...
 
virtual void startElement (const XMLElementDecl &elemDecl, const unsigned int urlId, const XMLCh *const elemPrefix, const RefVectorOf< XMLAttr > &attrList, const XMLSize_t attrCount, const bool isEmpty, const bool isRoot)
 Handle a start element event. More...
 
virtual void startEntityReference (const XMLEntityDecl &entDecl)
 Handle a start entity reference event. More...
 
virtual void XMLDecl (const XMLCh *const versionStr, const XMLCh *const encodingStr, const XMLCh *const standaloneStr, const XMLCh *const actualEncStr)
 Handle an XMLDecl event. More...
 
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, const bool hasExtSubset=false)
 
virtual void doctypePI (const XMLCh *const target, const XMLCh *const data)
 
virtual void doctypeWhitespace (const XMLCh *const chars, const XMLSize_t 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)
 
- Public Member Functions inherited from XMemory
void * operator new (size_t size)
 This method overrides operator new. More...
 
void * operator new (size_t size, MemoryManager *memMgr)
 This method defines a custom operator new, that will use the provided memory manager to perform the allocation. More...
 
void * operator new (size_t size, void *ptr)
 This method overrides placement operator new. More...
 
void operator delete (void *p)
 This method overrides operator delete. More...
 
void operator delete (void *p, MemoryManager *memMgr)
 This method provides a matching delete for the custom operator new. More...
 
void operator delete (void *p, void *ptr)
 This method provides a matching delete for the placement new. More...
 
- Public Member Functions inherited from XMLDocumentHandler
virtual ~XMLDocumentHandler ()
 
- Public Member Functions inherited from XMLErrorReporter
virtual ~XMLErrorReporter ()
 Default destructor. More...
 
virtual void error (const unsigned int errCode, const XMLCh *const errDomain, const ErrTypes type, const XMLCh *const errorText, const XMLCh *const systemId, const XMLCh *const publicId, const XMLFileLoc lineNum, const XMLFileLoc colNum)=0
 Called to report errors from the scanner or validator. More...
 
virtual void resetErrors ()=0
 Called before a new parse event to allow the handler to reset. More...
 
- Public Member Functions inherited from XMLEntityHandler
virtual ~XMLEntityHandler ()
 Default destructor. More...
 
virtual void endInputSource (const InputSource &inputSource)=0
 This method get called after the scanner has finished reading from the given input source while processing external entity references. More...
 
virtual bool expandSystemId (const XMLCh *const systemId, XMLBuffer &toFill)=0
 This method allows the passes the scanned systemId to the entity handler, thereby giving it a chance to provide any customized handling like resolving relative path names. More...
 
virtual void resetEntities ()=0
 This method allows the entity handler to reset itself, so that it can be used again. More...
 
virtual InputSourceresolveEntity (XMLResourceIdentifier *resourceIdentifier)=0
 This method allows the entity handler to provide customized application specific entity resolution. More...
 
virtual void startInputSource (const InputSource &inputSource)=0
 This method will be called before the scanner starts reading from an input source while processing external entity references. More...
 
- Public Member Functions inherited from PSVIHandler
virtual ~PSVIHandler ()
 

Protected Member Functions

virtual DOMCDATASectioncreateCDATASection (const XMLCh *, XMLSize_t)
 
virtual DOMTextcreateText (const XMLCh *, XMLSize_t)
 
virtual DOMElementcreateElement (const XMLCh *name)
 
virtual DOMElementcreateElementNS (const XMLCh *namespaceURI, const XMLCh *elemPrefix, const XMLCh *localName, const XMLCh *qName)
 
virtual DOMAttrcreateAttr (const XMLCh *name)
 
virtual DOMAttrcreateAttrNS (const XMLCh *namespaceURI, const XMLCh *elemPrefix, const XMLCh *localName, const XMLCh *qName)
 
Constructors
 AbstractDOMParser (XMLValidator *const valToAdopt=0, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager, XMLGrammarPool *const gramPool=0)
 Construct a AbstractDOMParser, with an optional validator. More...
 
Protected getter methods
DOMNodegetCurrentNode ()
 Get the current DOM node. More...
 
XMLScanner * getScanner () const
 Get the XML scanner. More...
 
GrammarResolver * getGrammarResolver () const
 Get the Grammar resolver. More...
 
bool getParseInProgress () const
 Get the parse in progress flag. More...
 
MemoryManagergetMemoryManager () const
 
Protected setter methods
void setCurrentNode (DOMNode *toSet)
 Set the current DOM node. More...
 
void setDocument (DOMDocument *toSet)
 Set the document node. More...
 
void setParseInProgress (const bool toSet)
 Set the parse in progress flag. More...
 
Protected helper methods
void resetPool ()
 
bool isDocumentAdopted () const
 Returns true if the user has adopted the document. More...
 
- Protected Member Functions inherited from XMemory
 XMemory ()
 Protected default constructor. More...
 
- Protected Member Functions inherited from XMLDocumentHandler
 XMLDocumentHandler ()
 
- Protected Member Functions inherited from XMLErrorReporter
 XMLErrorReporter ()
 Default constructor. More...
 
- Protected Member Functions inherited from XMLEntityHandler
 XMLEntityHandler ()
 Protected default constructor. More...
 
- Protected Member Functions inherited from PSVIHandler
 PSVIHandler ()
 

Protected Attributes

bool fCreateEntityReferenceNodes
 
bool fIncludeIgnorableWhitespace
 
bool fWithinElement
 
bool fParseInProgress
 
bool fCreateCommentNodes
 
bool fDocumentAdoptedByUser
 
bool fCreateSchemaInfo
 
bool fDoXInclude
 
XMLScanner * fScanner
 
XMLChfImplementationFeatures
 
DOMNodefCurrentParent
 
DOMNodefCurrentNode
 
DOMEntityImpl * fCurrentEntity
 
DOMDocumentImpl * fDocument
 
DOMDocumentTypeImpl * fDocumentType
 
RefVectorOf< DOMDocumentImpl > * fDocumentVector
 
GrammarResolver * fGrammarResolver
 
XMLStringPool * fURIStringPool
 
XMLValidatorfValidator
 
MemoryManagerfMemoryManager
 
XMLGrammarPoolfGrammarPool
 
XMLBufferMgr fBufMgr
 
XMLBuffer & fInternalSubset
 
PSVIHandlerfPSVIHandler
 

Detailed Description

This class implements the Document Object Model (DOM) interface.

It is used as a base for DOM parsers (i.e. XercesDOMParser, DOMLSParser).

Member Enumeration Documentation

ValScheme enum used in setValidationScheme Val_Never: Do not report validation errors.

Val_Always: The parser will always report validation errors. Val_Auto: The parser will report validation errors only if a grammar is specified.

See also
setValidationScheme
Enumerator
Val_Never 
Val_Always 
Val_Auto 

Constructor & Destructor Documentation

virtual AbstractDOMParser::~AbstractDOMParser ( )
virtual

Destructor.

AbstractDOMParser::AbstractDOMParser ( XMLValidator *const  valToAdopt = 0,
MemoryManager *const  manager = XMLPlatformUtils::fgMemoryManager,
XMLGrammarPool *const  gramPool = 0 
)
protected

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.

Parameters
valToAdoptPointer to the validator instance to use. The parser is responsible for freeing the memory.
gramPoolPointer to the grammar pool instance from external application (through derivatives). The parser does NOT own it.
managerPointer to the memory manager to be used to allocate objects.

Member Function Documentation

DOMDocument* AbstractDOMParser::adoptDocument ( )

Adopt the DOM document.

This method returns the DOMDocument object representing the root of the document tree.

The caller will adopt the DOMDocument and thus is responsible to call DOMDocument::release() to release the associated memory. The parser will not delete it. The ownership is transferred from the parser to the caller.

Returns
The adopted DOMDocument object which represents the entire XML document.
virtual void AbstractDOMParser::attDef ( const DTDElementDecl &  elemDecl,
const DTDAttDef &  attDef,
const bool  ignoring 
)
virtual
virtual DOMAttr* AbstractDOMParser::createAttr ( const XMLCh name)
protectedvirtual
virtual DOMAttr* AbstractDOMParser::createAttrNS ( const XMLCh namespaceURI,
const XMLCh elemPrefix,
const XMLCh localName,
const XMLCh qName 
)
protectedvirtual
virtual DOMCDATASection* AbstractDOMParser::createCDATASection ( const XMLCh ,
XMLSize_t   
)
protectedvirtual
virtual DOMElement* AbstractDOMParser::createElement ( const XMLCh name)
protectedvirtual
virtual DOMElement* AbstractDOMParser::createElementNS ( const XMLCh namespaceURI,
const XMLCh elemPrefix,
const XMLCh localName,
const XMLCh qName 
)
protectedvirtual
virtual DOMText* AbstractDOMParser::createText ( const XMLCh ,
XMLSize_t   
)
protectedvirtual
virtual void AbstractDOMParser::docCharacters ( const XMLCh *const  chars,
const XMLSize_t  length,
const bool  cdataSection 
)
virtual

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.

Parameters
charsA const pointer to a Unicode string representing the character data.
lengthThe length of the Unicode string returned in 'chars'.
cdataSectionA flag indicating if the characters represent content from the CDATA section.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::docComment ( const XMLCh *const  comment)
virtual

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.

Parameters
commentA const pointer to a null terminated Unicode string representing the comment text.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::docPI ( const XMLCh *const  target,
const XMLCh *const  data 
)
virtual

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.

Parameters
targetA const pointer to a Unicode string representing the target of the PI declaration.
dataA const pointer to a Unicode string representing the data of the PI declaration. See the PI production rule in the XML specification for details.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::doctypeComment ( const XMLCh *const  comment)
virtual
virtual void AbstractDOMParser::doctypeDecl ( const DTDElementDecl &  elemDecl,
const XMLCh *const  publicId,
const XMLCh *const  systemId,
const bool  hasIntSubset,
const bool  hasExtSubset = false 
)
virtual
virtual void AbstractDOMParser::doctypePI ( const XMLCh *const  target,
const XMLCh *const  data 
)
virtual
virtual void AbstractDOMParser::doctypeWhitespace ( const XMLCh *const  chars,
const XMLSize_t  length 
)
virtual
virtual void AbstractDOMParser::elementDecl ( const DTDElementDecl &  decl,
const bool  isIgnored 
)
virtual
virtual void AbstractDOMParser::endAttList ( const DTDElementDecl &  elemDecl)
virtual
virtual void AbstractDOMParser::endDocument ( )
virtual

Handle the end of document event.

This method is used to indicate the end of the current document.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::endElement ( const XMLElementDecl elemDecl,
const unsigned int  urlId,
const bool  isRoot,
const XMLCh *const  elemPrefix 
)
virtual

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.

Parameters
elemDeclA const reference to the object containing element declaration information.
urlIdAn id referring to the namespace prefix, if namespaces setting is switched on.
isRootA flag indicating whether this element was the root element.
elemPrefixA const pointer to a Unicode string containing the namespace prefix for this element. Applicable only when namespace processing is enabled.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::endEntityReference ( const XMLEntityDecl entDecl)
virtual

Handle and end of entity reference event.

This method is used to indicate that an end of an entity reference was just scanned.

Parameters
entDeclA const reference to the object containing the entity declaration information.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::endExtSubset ( )
virtual
virtual void AbstractDOMParser::endIntSubset ( )
virtual
virtual void AbstractDOMParser::entityDecl ( const DTDEntityDecl &  entityDecl,
const bool  isPEDecl,
const bool  isIgnored 
)
virtual
bool AbstractDOMParser::getCalculateSrcOfs ( ) const

Get the 'calculate src offset flag'.

This method returns the state of the parser's src offset calculation when parsing an XML document.

Returns
true, if the parser is currently configured to calculate src offsets, false otherwise.
See also
setCalculateSrcOfs
bool AbstractDOMParser::getCreateCommentNodes ( ) const

Get the 'create comment node' flag.

This method returns the flag that specifies whether the parser is creating comment nodes in the DOM tree being produced.

Returns
The state of the create comment node flag.
See also
setCreateCommentNodes

References fCreateCommentNodes.

bool AbstractDOMParser::getCreateEntityReferenceNodes ( ) 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.

Returns
The state of the create entity reference node flag.
See also
setCreateEntityReferenceNodes

References fCreateEntityReferenceNodes.

bool AbstractDOMParser::getCreateSchemaInfo ( ) const

Get the 'associate schema info' flag.

This method returns the flag that specifies whether the parser is storing schema informations in the element and attribute nodes in the DOM tree being produced.

Returns
The state of the associate schema info flag.
See also
setCreateSchemaInfo

References fCreateSchemaInfo.

DOMNode * AbstractDOMParser::getCurrentNode ( )
protected

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.

References fCurrentNode.

bool AbstractDOMParser::getDisableDefaultEntityResolution ( ) const

Get the 'disable default entity resolution' flag.

Returns
true, if the parser is currently configured to not perform default entity resolution, false otherwise.
See also
setDisableDefaultEntityResolution
DOMDocument* AbstractDOMParser::getDocument ( )

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.

The returned DOMDocument object is owned by the parser.

Returns
The DOMDocument object which represents the entire XML document.
bool AbstractDOMParser::getDoNamespaces ( ) const

Get the 'do namespaces' flag.

This method returns the state of the parser's namespace processing flag.

Returns
true, if the parser is currently configured to understand namespaces, false otherwise.
See also
setDoNamespaces
bool AbstractDOMParser::getDoSchema ( ) const

Get the 'do schema' flag.

This method returns the state of the parser's schema processing flag.

Returns
true, if the parser is currently configured to understand schema, false otherwise.
See also
setDoSchema
bool AbstractDOMParser::getDoXInclude ( ) const

Get the 'do XInclude' flag.

This method returns the flag that specifies whether the parser will process XInclude nodes in the DOM tree being produced.

Returns
The state of the 'do XInclude' flag.
See also
setDoXInclude

References fDoXInclude.

XMLSize_t AbstractDOMParser::getErrorCount ( ) 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.

Returns
number of errors encountered during the latest parse operation.
bool AbstractDOMParser::getExitOnFirstFatalError ( ) 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.

Returns
true, if the parser is currently configured to exit on the first fatal error, false otherwise.
See also
setExitOnFirstFatalError
XMLCh* AbstractDOMParser::getExternalNoNamespaceSchemaLocation ( ) const

Get the noNamespace SchemaLocation that is specified externally.

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 accessibility of the returned information after the parser is deleted, callers need to copy and store the returned information somewhere else.

Returns
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 also
setExternalNoNamespaceSchemaLocation(const XMLCh* const)
XMLCh* AbstractDOMParser::getExternalSchemaLocation ( ) const

Get the set of Namespace/SchemaLocation that is specified externally.

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 accessibility of the returned information after the parser is deleted, callers need to copy and store the returned information somewhere else.

Returns
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 also
setExternalSchemaLocation(const XMLCh* const)
bool AbstractDOMParser::getGenerateSyntheticAnnotations ( ) const

Get the 'generate synthetic annotations' flag.

Returns
true, if the parser is currently configured to generate synthetic annotations, false otherwise. A synthetic XSAnnotation is created when a schema component has non-schema attributes but has no child annotations so that the non-schema attributes can be recovered under PSVI.
See also
setGenerateSyntheticAnnotations
GrammarResolver * AbstractDOMParser::getGrammarResolver ( ) const
protected

Get the Grammar resolver.

This provides derived classes with access to the grammar resolver.

References fGrammarResolver.

bool AbstractDOMParser::getHandleMultipleImports ( ) const

Get the 'handle multiple schema imports' flag.

Returns
true, if the parser is currently configured to import multiple schemas with the same namespace, false otherwise.
See also
setHandleMultipleImports
bool AbstractDOMParser::getIdentityConstraintChecking ( ) const

Get the identity constraint checking' flag.

This method returns the state of the parser's identity constraint checking flag.

Returns
true, if the parser is currently configured to have identity constraint checking, false otherwise.
See also
setIdentityConstraintChecking
bool AbstractDOMParser::getIgnoreAnnotations ( ) const

Get the 'ignore annotations' flag.

Returns
true, if the parser is currently configured to ignore annotations, false otherwise.
See also
setIgnoreAnnotations
bool AbstractDOMParser::getIncludeIgnorableWhitespace ( ) const

Get the 'include ignorable whitespace' flag.

This method returns the state of the parser's include ignorable whitespace flag.

Returns
'true' if the include ignorable whitespace flag is set on the parser, 'false' otherwise.
See also
setIncludeIgnorableWhitespace

References fIncludeIgnorableWhitespace.

bool AbstractDOMParser::getLoadExternalDTD ( ) const

Get the 'Loading External DTD' flag.

This method returns the state of the parser's loading external DTD flag.

Returns
false, if the parser is currently configured to ignore external DTD completely, true otherwise.
See also
setLoadExternalDTD
getValidationScheme
bool AbstractDOMParser::getLoadSchema ( ) const

Get the 'Loading Schema' flag.

This method returns the state of the parser's loading schema flag.

Returns
true, if the parser is currently configured to automatically load schemas that are not in the grammar pool, false otherwise.
See also
setLoadSchema
const XMLSize_t& AbstractDOMParser::getLowWaterMark ( ) const

Get the raw buffer low water mark for this parser.

If the number of available bytes in the raw buffer is less than the low water mark the parser will attempt to read more data before continuing parsing. By default the value for this parameter is 100 bytes. You may want to set this parameter to 0 if you would like the parser to parse the available data immediately without potentially blocking while waiting for more date.

Returns
current low water mark
See also
setSecurityManager
MemoryManager * AbstractDOMParser::getMemoryManager ( ) const
protected

References fMemoryManager.

bool AbstractDOMParser::getParseInProgress ( ) const
protected

Get the parse in progress flag.

This provides derived classes with access to the parse in progress flag.

References fParseInProgress.

PSVIHandler * AbstractDOMParser::getPSVIHandler ( )

This method returns the installed PSVI handler.

Suitable for 'lvalue' usages.

Returns
The pointer to the installed PSVI handler object.

References fPSVIHandler.

const PSVIHandler * AbstractDOMParser::getPSVIHandler ( ) const

This method returns the installed PSVI handler.

Suitable for 'rvalue' usages.

Returns
A const pointer to the installed PSVI handler object.

References fPSVIHandler.

XMLScanner * AbstractDOMParser::getScanner ( ) const
protected

Get the XML scanner.

This provides derived classes with access to the XML scanner.

References fScanner.

SecurityManager* AbstractDOMParser::getSecurityManager ( ) const

Get the SecurityManager instance attached to this parser.

This method returns the security manager that was specified using setSecurityManager.

The SecurityManager instance must have been specified by the application; this should not be deleted until after the parser has been deleted (or a new SecurityManager instance has been supplied to the parser).

Returns
a pointer to the SecurityManager instance specified externally. A null pointer is returned if nothing was specified externally.
See also
setSecurityManager
bool AbstractDOMParser::getSkipDTDValidation ( ) const

Get the 'skip DTD validation' flag.

Returns
true, if the parser is currently configured to skip DTD validation, false otherwise.
See also
setSkipDTDValidation
bool AbstractDOMParser::getStandardUriConformant ( ) const

Get the 'force standard uri flag'.

This method returns the state if the parser forces standard uri

Returns
true, if the parser is currently configured to force standard uri, i.e. malformed uri will be rejected.
See also
setStandardUriConformant
bool AbstractDOMParser::getValidateAnnotations ( ) const

Get the 'validate annotations' flag.

Returns
true, if the parser is currently configured to validate annotations, false otherwise.
See also
setValidateAnnotations
bool AbstractDOMParser::getValidationConstraintFatal ( ) const

This method returns the state of the parser's validation-constraint-fatal flag.

Returns
true, if the parser is currently configured to set validation constraint errors as fatal, false otherwise.
See also
setValidationConstraintFatal
bool AbstractDOMParser::getValidationSchemaFullChecking ( ) const

Get the 'full schema constraint checking' flag.

This method returns the state of the parser's full schema constraint checking flag.

Returns
true, if the parser is currently configured to have full schema constraint checking, false otherwise.
See also
setValidationSchemaFullChecking
ValSchemes AbstractDOMParser::getValidationScheme ( ) const

This method returns an enumerated value that indicates the current validation scheme set on this parser.

Returns
The ValSchemes value current set on this parser.
See also
setValidationScheme
const XMLValidator& AbstractDOMParser::getValidator ( ) const

Get a const reference to the validator.

This method returns a reference to the parser's installed validator.

Returns
A const reference to the installed validator object.
virtual void AbstractDOMParser::handleAttributesPSVI ( const XMLCh *const  localName,
const XMLCh *const  uri,
PSVIAttributeList psviAttributes 
)
virtual

Enables PSVI information about attributes to be passed back to the application.

This callback will be made on all elements; on elements with no attributes, the final parameter will be null.

Parameters
localNameThe name of the element upon which start tag these attributes were encountered.
uriThe namespace to which the element is bound
psviAttributesObject containing the attributes' PSVI properties with information to identify them.

Implements PSVIHandler.

virtual void AbstractDOMParser::handleElementPSVI ( const XMLCh *const  localName,
const XMLCh *const  uri,
PSVIElement elementInfo 
)
virtual

Receive notification of the PSVI properties of an element.

The scanner will issue this call after the XMLDocumentHandler endElement call. Since the scanner will issue the psviAttributes call immediately after reading the start tag of an element, all element content will be effectively bracketed by these two calls.

Parameters
localNameThe name of the element whose end tag was just parsed.
uriThe namespace to which the element is bound
elementInfoObject containing the element's PSVI properties

Implements PSVIHandler.

virtual void AbstractDOMParser::handlePartialElementPSVI ( const XMLCh *const  localName,
const XMLCh *const  uri,
PSVIElement elementInfo 
)
virtual

Receive notification of partial PSVI properties of an element.

This callback is made right after the psviAttributes call for non-empty element.

The PSVIElement passed in has all fields properly set and it can be safely accessed the same way as the one passed in handleElementPSVI. However, fields listed below always have default values.

getValidity() PSVIItem::VALIDITY_NOTKNOWN getValidationAttemped() PSVIItem::VALIDATION_NONE getMemberTypeDefinition() 0 getSchemaNormalizedValue() 0 getCanonicalRepresentation() 0 getNotationDeclaration() 0

Parameters
localNameThe name of the element upon which start tag these attributes were encountered.
uriThe namespace to which the element is bound
elementInfoObject containing the element's partial PSVI properties

Reimplemented from PSVIHandler.

virtual void AbstractDOMParser::ignorableWhitespace ( const XMLCh *const  chars,
const XMLSize_t  length,
const bool  cdataSection 
)
virtual

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.

Parameters
charsA const pointer to a Unicode string representing the ignorable whitespace character data.
lengthThe length of the Unicode string 'chars'.
cdataSectionA flag indicating if the characters represent content from the CDATA section.

Implements XMLDocumentHandler.

bool AbstractDOMParser::isDocumentAdopted ( ) const
protected

Returns true if the user has adopted the document.

virtual void AbstractDOMParser::notationDecl ( const XMLNotationDecl notDecl,
const bool  isIgnored 
)
virtual
void AbstractDOMParser::parse ( const InputSource source)

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.

Parameters
sourceA const reference to the InputSource object which points to the XML file to be parsed.
Exceptions
SAXExceptionAny SAX exception, possibly wrapping another exception.
XMLExceptionAn exception from the parser or client handler code.
DOMExceptionA DOM exception as per DOM spec.
See also
InputSource::InputSource
void AbstractDOMParser::parse ( const XMLCh *const  systemId)

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.

Parameters
systemIdA const XMLCh pointer to the Unicode string which contains the path to the XML file to be parsed.
Exceptions
SAXExceptionAny SAX exception, possibly wrapping another exception.
XMLExceptionAn exception from the parser or client handler code.
DOMExceptionA DOM exception as per DOM spec.
See also
parse(InputSource,...)
void AbstractDOMParser::parse ( const char *const  systemId)

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'.

Parameters
systemIdA const char pointer to a native string which contains the path to the XML file to be parsed.
Exceptions
SAXExceptionAny SAX exception, possibly wrapping another exception.
XMLExceptionAn exception from the parser or client handler code.
DOMExceptionA DOM exception as per DOM spec.
See also
parse(InputSource,...)
bool AbstractDOMParser::parseFirst ( const XMLCh *const  systemId,
XMLPScanToken &  toFill 
)

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.

Parameters
systemIdA pointer to a Unicode string representing the path to the XML file to be parsed.
toFillA token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.
Returns
'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 also
parseNext
parseFirst(char*,...)
parseFirst(InputSource&,...)
bool AbstractDOMParser::parseFirst ( const char *const  systemId,
XMLPScanToken &  toFill 
)

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.

Parameters
systemIdA pointer to a regular native string representing the path to the XML file to be parsed.
toFillA token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.
Returns
'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 also
parseNext
parseFirst(XMLCh*,...)
parseFirst(InputSource&,...)
bool AbstractDOMParser::parseFirst ( const InputSource source,
XMLPScanToken &  toFill 
)

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.

Parameters
sourceA const reference to the InputSource object which points to the XML file to be parsed.
toFillA token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.
Returns
'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 also
parseNext
parseFirst(XMLCh*,...)
parseFirst(char*,...)
bool AbstractDOMParser::parseNext ( XMLPScanToken &  token)

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).

Parameters
tokenA token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.
Returns
'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 also
parseFirst(XMLCh*,...)
parseFirst(char*,...)
parseFirst(InputSource&,...)
void AbstractDOMParser::parseReset ( 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.

Parameters
tokenA token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.
See also
parseFirst(XMLCh*,...)
parseFirst(char*,...)
parseFirst(InputSource&,...)
void AbstractDOMParser::reset ( )

Reset the parser.

This method resets the state of the DOM driver and makes it ready for a fresh parse run.

virtual void AbstractDOMParser::resetDocType ( )
virtual
virtual void AbstractDOMParser::resetDocument ( )
virtual

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.

Implements XMLDocumentHandler.

void AbstractDOMParser::resetPool ( )
protected
void AbstractDOMParser::setCalculateSrcOfs ( const bool  newState)

Enable/disable src offset calculation.

This method allows users to enable/disable src offset calculation. Disabling the calculation will improve performance.

The parser's default state is: false.

Parameters
newStateThe value specifying whether we should enable or disable src offset calculation
See also
getCalculateSrcOfs
void AbstractDOMParser::setCreateCommentNodes ( const bool  create)

Set the 'create comment nodes' flag.

This method allows the user to specify whether the parser should create comment nodes in the DOM tree being produced.

The default value is 'true'.

Parameters
createThe new state of the create comment nodes flag.
See also
getCreateCommentNodes

References fCreateCommentNodes.

void AbstractDOMParser::setCreateEntityReferenceNodes ( const bool  create)

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.

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.

The default value is 'true'.

Parameters
createThe new state of the create entity reference nodes flag.
See also
getCreateEntityReferenceNodes

References fCreateEntityReferenceNodes.

void AbstractDOMParser::setCreateSchemaInfo ( const bool  newState)

Set the 'associate schema info' flag.

This method allows users to specify whether the parser should store schema informations in the element and attribute nodes in the DOM tree being produced.

Parameters
newStateThe state to set
See also
getCreateSchemaInfo
void AbstractDOMParser::setCurrentNode ( DOMNode toSet)
protected

Set the current DOM node.

This method sets the current node maintained inside the parser to the one specified.

Parameters
toSetThe DOM node which will be the current node.

References fCurrentNode.

void AbstractDOMParser::setDisableDefaultEntityResolution ( const bool  newValue)

Set the 'disable default entity resolution' flag.

This method gives users the option to not perform default entity resolution. If the user's resolveEntity method returns NULL the parser will try to resolve the entity on its own. When this option is set to true, the parser will not attempt to resolve the entity when the resolveEntity method returns NULL.

The parser's default state is false

Parameters
newValueThe state to set
See also
EntityResolver
void AbstractDOMParser::setDocument ( DOMDocument toSet)
protected

Set the document node.

This method sets the DOM Document node to the one specified.

Parameters
toSetThe new DOM Document node for this XML document.
void AbstractDOMParser::setDoNamespaces ( const bool  newState)

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.

Parameters
newStateThe value specifying whether NameSpace rules should be enforced or not.
See also
getDoNamespaces
void AbstractDOMParser::setDoSchema ( const bool  newState)

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.

Note: If set to true, namespace processing must also be turned on.

Parameters
newStateThe value specifying whether schema support should be enforced or not.
See also
getDoSchema
void AbstractDOMParser::setDoXInclude ( const bool  newState)

Set the 'do XInclude' flag.

This method allows users to specify whether the parser should process XInclude nodes in the DOM tree being produced.

Parameters
newStateThe state to set
See also
getDoXInclude

References fDoXInclude.

void AbstractDOMParser::setExitOnFirstFatalError ( 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.

Parameters
newStateThe value specifying whether the parser should continue or exit when it encounters the first fatal error.
See also
getExitOnFirstFatalError
void AbstractDOMParser::setExternalNoNamespaceSchemaLocation ( const XMLCh *const  noNamespaceSchemaLocation)

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".

Parameters
noNamespaceSchemaLocationthe XML Schema Location with no target namespace
See also
getExternalNoNamespaceSchemaLocation
void AbstractDOMParser::setExternalNoNamespaceSchemaLocation ( const char *const  noNamespaceSchemaLocation)

This method is same as setExternalNoNamespaceSchemaLocation(const XMLCh* const).

It takes native char string as parameter

Parameters
noNamespaceSchemaLocationthe XML Schema Location with no target namespace
See also
setExternalNoNamespaceSchemaLocation(const XMLCh* const)
void AbstractDOMParser::setExternalSchemaLocation ( const XMLCh *const  schemaLocation)

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 occurring 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.

Parameters
schemaLocationthe list of schemas to use
See also
getExternalSchemaLocation
void AbstractDOMParser::setExternalSchemaLocation ( const char *const  schemaLocation)

This method is same as setExternalSchemaLocation(const XMLCh* const).

It takes native char string as parameter

Parameters
schemaLocationthe list of schemas to use
See also
setExternalSchemaLocation(const XMLCh* const)
void AbstractDOMParser::setGenerateSyntheticAnnotations ( const bool  newValue)

set the 'generate synthetic annotations' flag

Parameters
newValueThe value for specifying whether Synthetic Annotations should be generated or not. A synthetic XSAnnotation is created when a schema component has non-schema attributes but has no child annotations so that the non-schema attributes can be recovered under PSVI.
See also
getGenerateSyntheticAnnotations
void AbstractDOMParser::setHandleMultipleImports ( const bool  newValue)

Set the 'handle multiple schema imports' flag.

This method gives users the ability to import multiple schemas that have the same namespace.

NOTE: This option is ignored if schema validation is disabled.

The parser's default state is false

Parameters
newValueThe state to set
void AbstractDOMParser::setIdentityConstraintChecking ( const bool  newState)

This method allows users to enable or disable the parser's identity constraint checks.

By default, the parser does identity constraint checks. The default value is true.

Parameters
newStateThe value specifying whether the parser should do identity constraint checks or not in the input XML document.
See also
getIdentityConstraintChecking
void AbstractDOMParser::setIgnoreAnnotations ( const bool  newValue)

Set the 'ignore annotation' flag.

This method gives users the option to not generate XSAnnotations when "traversing" a schema.

The parser's default state is false

Parameters
newValueThe state to set
void AbstractDOMParser::setIncludeIgnorableWhitespace ( const bool  include)

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.

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.

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.

Parameters
includeThe new state of the include ignorable whitespace flag.
See also
getIncludeIgnorableWhitespace

References fIncludeIgnorableWhitespace.

void AbstractDOMParser::setLoadExternalDTD ( const bool  newState)

Set the 'Loading External DTD' flag.

This method allows users to enable or disable the loading of external DTD. When set to false, the parser will ignore any external DTD completely if the validationScheme is set to Val_Never.

The parser's default state is: true.

This flag is ignored if the validationScheme is set to Val_Always or Val_Auto.

Parameters
newStateThe value specifying whether external DTD should be loaded or not.
See also
getLoadExternalDTD
setValidationScheme
void AbstractDOMParser::setLoadSchema ( const bool  newState)

Set the 'Loading Schema' flag.

This method allows users to enable or disable the loading of schemas. When set to false, the parser not attempt to load schemas beyond querying the grammar pool for them.

The parser's default state is: true.

Parameters
newStateThe value specifying whether schemas should be loaded if they're not found in the grammar pool.
See also
getLoadSchema
setDoSchema
void AbstractDOMParser::setLowWaterMark ( XMLSize_t  lwm)

Set the raw buffer low water mark for this parser.

If the number of available bytes in the raw buffer is less than the low water mark the parser will attempt to read more data before continuing parsing. By default the value for this parameter is 100 bytes. You may want to set this parameter to 0 if you would like the parser to parse the available data immediately without potentially blocking while waiting for more date.

Parameters
lwmnew low water mark
See also
getSecurityManager
void AbstractDOMParser::setParseInProgress ( const bool  toSet)
protected

Set the parse in progress flag.

This method sets the parse in progress flag to true or false.

Parameters
toSetThe value of the flag to be set.

References fParseInProgress.

virtual void AbstractDOMParser::setPSVIHandler ( PSVIHandler *const  handler)
virtual

This method installs the user specified PSVI handler on the parser.

Parameters
handlerA pointer to the PSVI handler to be called when the parser comes across 'PSVI' events as per the schema specification.
void AbstractDOMParser::setSecurityManager ( SecurityManager *const  securityManager)

This allows an application to set a SecurityManager on the parser; this object stores information that various components use to limit their consumption of system resources while processing documents.

If this method is called more than once, only the last one takes effect. It may not be reset during a parse.

Parameters
securityManagerthe SecurityManager instance to be used by this parser
See also
getSecurityManager
void AbstractDOMParser::setSkipDTDValidation ( const bool  newValue)

Set the 'skip DTD validation' flag.

This method gives users the option to skip DTD validation only when schema validation is on (i.e. when performing validation, we will ignore the DTD, except for entities, when schema validation is enabled).

NOTE: This option is ignored if schema validation is disabled.

The parser's default state is false

Parameters
newValueThe state to set
void AbstractDOMParser::setStandardUriConformant ( const bool  newState)

Force standard uri.

This method allows users to tell the parser to force standard uri conformance.

The parser's default state is: false.

Parameters
newStateThe value specifying whether the parser should reject malformed URI.
See also
getStandardUriConformant
void AbstractDOMParser::setValidateAnnotations ( const bool  newValue)

set the 'validlate annotations' flag

Parameters
newValueThe value for specifying whether Annotations should be validated or not.
See also
getValidateAnnotations
void AbstractDOMParser::setValidationConstraintFatal ( const bool  newState)

This method allows users to set the parser's behaviour when it encounters a validation constraint error.

If set to true, and the the parser will treat validation error as fatal and will exit depends on the state of "getExitOnFirstFatalError". If false, then it will report the error and continue processing.

Note: setting this true does not mean the validation error will be printed with the word "Fatal Error". It is still printed as "Error", but the parser will exit if "setExitOnFirstFatalError" is set to true.

The default value is 'false'.

Parameters
newStateIf true, the parser will exit if "setExitOnFirstFatalError" is set to true.
See also
getValidationConstraintFatal
setExitOnFirstFatalError
void AbstractDOMParser::setValidationSchemaFullChecking ( const bool  schemaFullChecking)

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 restriction checking are controlled by this option.

The parser's default state is: false.

Parameters
schemaFullCheckingTrue to turn on full schema constraint checking.
See also
getValidationSchemaFullChecking
void AbstractDOMParser::setValidationScheme ( const ValSchemes  newScheme)

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:


Val_Never - turn off validation
Val_Always - turn on validation
Val_Auto - turn on validation if any internal/external DTD subset have been seen

The parser's default state is: Val_Never.

Parameters
newSchemeThe new validation scheme to use.
See also
getValidationScheme
virtual void AbstractDOMParser::startAttList ( const DTDElementDecl &  elemDecl)
virtual
virtual void AbstractDOMParser::startDocument ( )
virtual

Handle a start document event.

This method is used to report the start of the parsing process.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::startElement ( const XMLElementDecl elemDecl,
const unsigned int  urlId,
const XMLCh *const  elemPrefix,
const RefVectorOf< XMLAttr > &  attrList,
const XMLSize_t  attrCount,
const bool  isEmpty,
const bool  isRoot 
)
virtual

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.)

Parameters
elemDeclA const reference to the object containing element declaration information.
urlIdAn id referring to the namespace prefix, if namespaces setting is switched on.
elemPrefixA const pointer to a Unicode string containing the namespace prefix for this element. Applicable only when namespace processing is enabled.
attrListA const reference to the object containing the list of attributes just scanned for this element.
attrCountA count of number of attributes in the list specified by the parameter 'attrList'.
isEmptyA flag indicating whether this is an empty element or not. If empty, then no endElement() call will be made.
isRootA flag indicating whether this element was the root element.
See also
DocumentHandler::startElement

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::startEntityReference ( const XMLEntityDecl entDecl)
virtual

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.

Parameters
entDeclA const reference to the object containing the entity declaration information.

Implements XMLDocumentHandler.

virtual void AbstractDOMParser::startExtSubset ( )
virtual
virtual void AbstractDOMParser::startIntSubset ( )
virtual
virtual void AbstractDOMParser::TextDecl ( const XMLCh *const  versionStr,
const XMLCh *const  encodingStr 
)
virtual
void AbstractDOMParser::useImplementation ( const XMLCh *const  implementationFeatures)

Set the implementation to use when creating the document.

This method allows users to set the implementation to use to create the document when parseing.

Parameters
implementationFeaturesThe names of the desired features the implementation should have.

References MemoryManager::deallocate(), fImplementationFeatures, fMemoryManager, and XMLString::replicate().

void AbstractDOMParser::useScanner ( const XMLCh *const  scannerName)

Set the scanner to use when scanning the XML document.

This method allows users to set the scanner to use when scanning a given XML document.

Parameters
scannerNameThe name of the desired scanner
virtual void AbstractDOMParser::XMLDecl ( const XMLCh *const  versionStr,
const XMLCh *const  encodingStr,
const XMLCh *const  standaloneStr,
const XMLCh *const  actualEncStr 
)
virtual

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.

This method is a no-op for this DOM implementation.

Parameters
versionStrA const pointer to a Unicode string representing version string value.
encodingStrA const pointer to a Unicode string representing the encoding string value.
standaloneStrA const pointer to a Unicode string representing the standalone string value.
actualEncStrA const pointer to a Unicode string representing the actual encoding string value.

Implements XMLDocumentHandler.

Member Data Documentation

XMLBufferMgr AbstractDOMParser::fBufMgr
protected
bool AbstractDOMParser::fCreateCommentNodes
protected
bool AbstractDOMParser::fCreateEntityReferenceNodes
protected
bool AbstractDOMParser::fCreateSchemaInfo
protected

Referenced by getCreateSchemaInfo().

DOMEntityImpl* AbstractDOMParser::fCurrentEntity
protected
DOMNode* AbstractDOMParser::fCurrentNode
protected

Referenced by getCurrentNode(), and setCurrentNode().

DOMNode* AbstractDOMParser::fCurrentParent
protected
DOMDocumentImpl* AbstractDOMParser::fDocument
protected
bool AbstractDOMParser::fDocumentAdoptedByUser
protected
DOMDocumentTypeImpl* AbstractDOMParser::fDocumentType
protected
RefVectorOf<DOMDocumentImpl>* AbstractDOMParser::fDocumentVector
protected
bool AbstractDOMParser::fDoXInclude
protected

Referenced by getDoXInclude(), and setDoXInclude().

XMLGrammarPool* AbstractDOMParser::fGrammarPool
protected
GrammarResolver* AbstractDOMParser::fGrammarResolver
protected

Referenced by getGrammarResolver().

XMLCh* AbstractDOMParser::fImplementationFeatures
protected

Referenced by useImplementation().

bool AbstractDOMParser::fIncludeIgnorableWhitespace
protected
XMLBuffer& AbstractDOMParser::fInternalSubset
protected
MemoryManager* AbstractDOMParser::fMemoryManager
protected
bool AbstractDOMParser::fParseInProgress
protected
PSVIHandler* AbstractDOMParser::fPSVIHandler
protected

Referenced by getPSVIHandler().

XMLScanner* AbstractDOMParser::fScanner
protected

Referenced by getScanner().

XMLStringPool* AbstractDOMParser::fURIStringPool
protected
XMLValidator* AbstractDOMParser::fValidator
protected
bool AbstractDOMParser::fWithinElement
protected

The documentation for this class was generated from the following file: