|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Provides notification of information which DOM permits to be exposed. This consists of lexical information (comments; and alternative representations and modularizations of content) which is generally intended to be relevant only to document authors.
Even when combined with other information provided by SAX parsers, this information is not sufficient to physically recreate the source document. Certain classes of white space are not presented (e.g. whitespace separating attributes in start tags, and outside of the document element), and line ending characters are normalized (per the XML specification) to a single newline.
DtdEventListener
Method Summary | |
void |
comment(java.lang.String text)
Receive notification that a comment has been read. |
void |
endCDATA()
Receive notification that the CDATA section finished. |
void |
endParsedEntity(java.lang.String name,
boolean included)
Receive notification that the named entity inclusion into document content is completed. |
void |
startCDATA()
Receive notification that a CDATA section is beginning. |
void |
startParsedEntity(java.lang.String name)
Receive notification that the named entity is being included in document content (not element attributes). |
Methods inherited from interface org.xml.sax.DocumentHandler |
characters,
endDocument,
endElement,
ignorableWhitespace,
processingInstruction,
setDocumentLocator,
startDocument,
startElement |
Method Detail |
public void startParsedEntity(java.lang.String name) throws SAXException
name
- the name of the entity now being includedDtdEventListener
,
endParsedEntity(java.lang.String, boolean)
public void endParsedEntity(java.lang.String name, boolean included) throws SAXException
The XML specification requires nonvalidating XML processors to tell applications when they recognize, but do not include, external parsed entities. (Section 4.4.3 defines entity inclusion in this manner.) That notification is provided through this method. Applications might request, through EntityResolver, that an entity not be included ... such a mechanism remains TBS.
name
- the name of the entity whose inclusion is completed.included
- true iff the entity was included; always true
for validating parsers.startParsedEntity(java.lang.String)
public void startCDATA() throws SAXException
endCDATA()
,
DocumentHandler.characters(char[], int, int)
,
DocumentHandler.ignorableWhitespace(char[], int, int)
public void endCDATA() throws SAXException
startCDATA()
public void comment(java.lang.String text) throws SAXException
Note that processing instructions are the mechanism designed to hold information for consumption by applications, not comments. XML systems may rely on applications being able to access information found in processing instructions; this is not true of comments, which are typically discarded.
text
- the text within the comment delimiters.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |