|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.xerces.parsers.XMLParser | +--org.apache.xerces.parsers.AbstractXMLDocumentParser | +--org.apache.xerces.parsers.AbstractDOMParser
This is the base class of all DOM parsers. It implements the XNI
callback methods to create the DOM tree. After a successful parse of
an XML document, the DOM Document object can be queried using the
getDocument
method. The actual pipeline is defined in
parser configuration.
Field Summary | |
protected static java.lang.String |
CREATE_ENTITY_REF_NODES
Feature id: create entity ref nodes. |
protected boolean |
fCreateEntityRefNodes
Create entity reference nodes. |
protected org.w3c.dom.Node |
fCurrentNode
Current node. |
protected org.w3c.dom.Document |
fDocument
The document. |
protected DocumentImpl |
fDocumentImpl
The default Xerces document implementation, if used. |
protected boolean |
fInCDATASection
True if inside CDATA section. |
protected boolean |
fIncludeIgnorableWhitespace
Include ignorable whitespace. |
protected boolean |
fInDocument
True if inside document. |
protected static java.lang.String |
INCLUDE_IGNORABLE_WHITESPACE
Feature id: include ignorable whitespace. |
Fields inherited from class org.apache.xerces.parsers.AbstractXMLDocumentParser |
fInDTD |
Fields inherited from class org.apache.xerces.parsers.XMLParser |
ENTITY_RESOLVER,
ERROR_HANDLER,
fConfiguration |
Constructor Summary | |
protected |
AbstractDOMParser(org.apache.xerces.xni.parser.XMLParserConfiguration config)
Default constructor. |
Method Summary | |
protected int |
buildAttrEntityRefs(org.w3c.dom.Text text,
org.apache.xerces.xni.XMLAttributes attributes,
int attrIndex,
int entityCount,
int entityIndex,
int textOffset)
Builds entity references in attribute values. |
void |
characters(org.apache.xerces.xni.XMLString text)
Character content. |
void |
comment(org.apache.xerces.xni.XMLString text)
A comment. |
void |
doctypeDecl(java.lang.String rootElement,
java.lang.String publicId,
java.lang.String systemId)
Notifies of the presence of the DOCTYPE line in the document. |
void |
endCDATA()
The end of a CDATA section. |
void |
endDocument()
The end of the document. |
void |
endElement(org.apache.xerces.xni.QName element)
The end of an element. |
void |
endEntity(java.lang.String name)
This method notifies the end of an entity. |
void |
endPrefixMapping(java.lang.String prefix)
The end of a namespace prefix mapping. |
org.w3c.dom.Document |
getDocument()
Returns the DOM document object. |
void |
ignorableWhitespace(org.apache.xerces.xni.XMLString text)
Ignorable whitespace. |
void |
processingInstruction(java.lang.String target,
org.apache.xerces.xni.XMLString data)
A processing instruction. |
void |
reset()
Resets the parser state. |
void |
startCDATA()
The start of a CDATA section. |
void |
startDocument(org.apache.xerces.xni.XMLLocator locator,
java.lang.String encoding)
The start of the document. |
void |
startElement(org.apache.xerces.xni.QName element,
org.apache.xerces.xni.XMLAttributes attributes)
The start of an element. |
void |
startEntity(java.lang.String name,
java.lang.String publicId,
java.lang.String systemId,
java.lang.String baseSystemId,
java.lang.String encoding)
This method notifies of the start of an entity. |
Methods inherited from class org.apache.xerces.parsers.AbstractXMLDocumentParser |
any,
attributeDecl,
element,
elementDecl,
empty,
emptyElement,
endAttlist,
endConditional,
endContentModel,
endDTD,
endGroup,
externalEntityDecl,
internalEntityDecl,
notationDecl,
occurrence,
pcdata,
separator,
startAttlist,
startConditional,
startContentModel,
startDTD,
startGroup,
startPrefixMapping,
textDecl,
unparsedEntityDecl,
xmlDecl |
Methods inherited from class org.apache.xerces.parsers.XMLParser |
parse |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Field Detail |
protected static final java.lang.String CREATE_ENTITY_REF_NODES
protected static final java.lang.String INCLUDE_IGNORABLE_WHITESPACE
protected boolean fCreateEntityRefNodes
protected boolean fIncludeIgnorableWhitespace
protected org.w3c.dom.Document fDocument
protected DocumentImpl fDocumentImpl
protected org.w3c.dom.Node fCurrentNode
protected boolean fInDocument
protected boolean fInCDATASection
Constructor Detail |
protected AbstractDOMParser(org.apache.xerces.xni.parser.XMLParserConfiguration config)
Method Detail |
public org.w3c.dom.Document getDocument()
public void reset() throws org.apache.xerces.xni.XNIException
public void startEntity(java.lang.String name, java.lang.String publicId, java.lang.String systemId, java.lang.String baseSystemId, java.lang.String encoding) throws org.apache.xerces.xni.XNIException
Note: Since the DTD is an entity, the handler will be notified of the start of the DTD entity by calling the startEntity method with the entity name "[dtd]" before calling the startDTD method.
Note: This method is not called for entity references appearing as part of attribute values.
name
- The name of the entity.publicId
- The public identifier of the entity if the entity
is external, null otherwise.systemId
- The system identifier of the entity if the entity
is external, null otherwise.encoding
- The auto-detected IANA encoding name of the entity
stream. This value will be null in those situations
where the entity encoding is not auto-detected (e.g.
internal parameter entities).public void comment(org.apache.xerces.xni.XMLString text) throws org.apache.xerces.xni.XNIException
text
- The text in the comment.public void processingInstruction(java.lang.String target, org.apache.xerces.xni.XMLString data) throws org.apache.xerces.xni.XNIException
Typically, a processing instruction's data will contain a series of pseudo-attributes. These pseudo-attributes follow the form of element attributes but are not parsed or presented to the application as anything other than text. The application is responsible for parsing the data.
target
- The target.data
- The data or null if none specified.public void startDocument(org.apache.xerces.xni.XMLLocator locator, java.lang.String encoding) throws org.apache.xerces.xni.XNIException
systemId
- The system identifier of the entity if the entity
is external, null otherwise.encoding
- The auto-detected IANA encoding name of the entity
stream. This value will be null in those situations
where the entity encoding is not auto-detected (e.g.
internal entities or a document entity that is
parsed from a java.io.Reader).public void doctypeDecl(java.lang.String rootElement, java.lang.String publicId, java.lang.String systemId) throws org.apache.xerces.xni.XNIException
rootElement
- The name of the root element.publicId
- The public identifier if an external DTD or null
if the external DTD is specified using SYSTEM.systemId
- The system identifier if an external DTD, null
otherwise.public void startElement(org.apache.xerces.xni.QName element, org.apache.xerces.xni.XMLAttributes attributes) throws org.apache.xerces.xni.XNIException
element
- The name of the element.attributes
- The element attributes.public void characters(org.apache.xerces.xni.XMLString text) throws org.apache.xerces.xni.XNIException
text
- The content.public void ignorableWhitespace(org.apache.xerces.xni.XMLString text) throws org.apache.xerces.xni.XNIException
text
- The ignorable whitespace.public void endElement(org.apache.xerces.xni.QName element) throws org.apache.xerces.xni.XNIException
element
- The name of the element.public void endPrefixMapping(java.lang.String prefix) throws org.apache.xerces.xni.XNIException
prefix
- The namespace prefix.public void startCDATA() throws org.apache.xerces.xni.XNIException
public void endCDATA() throws org.apache.xerces.xni.XNIException
public void endDocument() throws org.apache.xerces.xni.XNIException
public void endEntity(java.lang.String name) throws org.apache.xerces.xni.XNIException
Note: Since the DTD is an entity, the handler will be notified of the end of the DTD entity by calling the endEntity method with the entity name "[dtd]" after calling the endDTD method.
Note: This method is not called for entity references appearing as part of attribute values.
name
- The name of the entity.protected int buildAttrEntityRefs(org.w3c.dom.Text text, org.apache.xerces.xni.XMLAttributes attributes, int attrIndex, int entityCount, int entityIndex, int textOffset)
text
- The text node that needs to be split.attributes
- The attribute information.attrIndex
- The attribute index.entityCount
- The number of entities. This is passed as
a convenience so that this method doesn't
have to call XMLAttributes#getEntityCount.
The caller already has the entity count so
it's kind of a waste to make each invocation
of this method query it again.entityIndex
- The entity index that this method invocation
should start building from.textOffset
- The offset at which the start of this text
should be considered. We need this to adjust
the offset since the characters in the current
text string are indexed from zero.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |