Table 18-2 summarizes the methods of available through the DOMParser
interface.
Table 18-2 Summary of DOMParser Methods; Parser Package
Function | Summary |
---|---|
getContext
|
Returns parser's XML context (allocation and encodings). |
getParserId
|
Get parser id. |
parse
|
Parse the document. |
parseDTD
|
Parse DTD document. |
parseSchVal
|
Parse and validate the document. |
setValidator
|
Set the validator for this parser. |
Each parser object is allocated and executed in a particular Oracle XML context. This member function returns a pointer to this context.
virtual Context* getContext() const = 0;
(Context*)
pointer to parser's context
virtual DOMParserIdType getParserId() const = 0;
(DOMParserIdType)
Parser Id
Parses the document and returns the tree root node
virtual DocumentRef< Node>* parse( InputSource* isrc_ptr, boolean DTDvalidate = FALSE, DocumentTypeRef< Node>* dtd_ptr = NULL, boolean no_mod = FALSE, DOMImplementation< Node>* impl_ptr = NULL) throw (ParserException) = 0;
Parameter | Description |
---|---|
isrc_ptr |
input source |
DTDvalidate |
TRUE if validated by DTD
|
dtd_ptr |
DTD reference |
no_mod |
TRUE if no modifications allowed
|
impl_ptr |
optional DomImplementation pointer
|
(DocumentRef)
document tree
Parse DTD document.
virtual DocumentRef< Node>* parseDTD( InputSource* isrc_ptr, boolean no_mod = FALSE, DOMImplementation< Node>* impl_ptr = NULL) throw (ParserException) = 0;
Parameter | Description |
---|---|
isrc_ptr |
input source |
no_mod |
TRUE if no modifications allowed
|
impl_ptr |
optional DomImplementation pointer |
(DocumentRef)
DTD document tree
Parses and validates the document. Sets the validator if the corresponding parameter is not NULL
.
virtual DocumentRef< Node>* parseSchVal( InputSource* src_par, boolean no_mod = FALSE, DOMImplementation< Node>* impl_ptr = NULL, SchemaValidator< Node>* tor_ptr = NULL) throw (ParserException) = 0;
Parameter | Description |
---|---|
isrc_ptr |
input source |
no_mod |
TRUE if no modifications allowed
|
impl_ptr |
optional DomImplementation pointer |
tor_ptr |
schema validator |
(DocumentRef)
document tree
Sets the validator for all validations except when another one is given in parseSchVal
virtual void setValidator( SchemaValidator< Node>* tor_ptr) = 0;
Parameter | Description |
---|---|
tor_ptr |
schema validator |