do-nothing implementation of DTDEventHandler.
attributeDecl
public void attributeDecl(String elementName,
String attributeName,
String attributeType,
String[] enumeration,
short attributeUse,
String defaultValue)
throws SAXException
For each entry in an ATTLIST declaration,
this event will be fired.
DTD allows the same attributes to be declared more than
once, and in that case the first one wins. I think
this method will be only fired for the first one,
but I need to check.
- attributeDecl in interface DTDEventListener
characters
public void characters(ch[] ,
int start,
int length)
throws SAXException
Receive notification of character data.
The Parser will call this method to report each chunk of
character data. SAX parsers may return all contiguous character
data in a single chunk, or they may split it into several
chunks; however, all of the characters in any single event
must come from the same external entity, so that the Locator
provides useful information.
The application must not attempt to read from the array
outside of the specified range.
Note that some parsers will report whitespace using the
ignorableWhitespace() method rather than this one (validating
parsers must do so).
- characters in interface DTDEventListener
start
- The start position in the array.length
- The number of characters to read from the array.
ignorableWhitespace(char[], int, int)
comment
public void comment(String n)
throws SAXException
Receive notification that a comment has been read.
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.
- comment in interface DTDEventListener
connector
public void connector(short connectorType)
throws SAXException
Connectors in one model group is guaranteed to be the same.
IOW, you'll never see an event sequence like (a|b,c)
- connector in interface DTDEventListener
endCDATA
public void endCDATA()
throws SAXException
Receive notification that the CDATA section finished.
- endCDATA in interface DTDEventListener
endContentModel
public void endContentModel(String elementName,
short contentModelType)
throws SAXException
receives notification that parsing of content model is finished.
- endContentModel in interface DTDEventListener
endDTD
public void endDTD()
throws SAXException
Receive notification of the end of a DTD. The parser will invoke
this method only once.
- endDTD in interface DTDEventListener
externalGeneralEntityDecl
public void externalGeneralEntityDecl(String n,
String p,
String s)
throws SAXException
Receive notification of an external parsed general entity
declaration event.
If a system identifier is present, and it is a relative URL, the
parser will have resolved it fully before passing it through this
method to a listener.
- externalGeneralEntityDecl in interface DTDEventListener
externalParameterEntityDecl
public void externalParameterEntityDecl(String n,
String p,
String s)
throws SAXException
Receive notification of an external parameter entity declaration
event.
If a system identifier is present, and it is a relative URL, the
parser will have resolved it fully before passing it through this
method to a listener.
- externalParameterEntityDecl in interface DTDEventListener
ignorableWhitespace
public void ignorableWhitespace(ch[] ,
int start,
int length)
throws SAXException
Receive notification of ignorable whitespace in element content.
Validating Parsers must use this method to report each chunk
of ignorable whitespace (see the W3C XML 1.0 recommendation,
section 2.10): non-validating parsers may also use this method
if they are capable of parsing and using content models.
SAX parsers may return all contiguous whitespace in a single
chunk, or they may split it into several chunks; however, all of
the characters in any single event must come from the same
external entity, so that the Locator provides useful
information.
The application must not attempt to read from the array
outside of the specified range.
- ignorableWhitespace in interface DTDEventListener
start
- The start position in the array.length
- The number of characters to read from the array.
characters(char[], int, int)
internalGeneralEntityDecl
public void internalGeneralEntityDecl(String n,
String v)
throws SAXException
Receive notification of a internal general entity declaration event.
- internalGeneralEntityDecl in interface DTDEventListener
internalParameterEntityDecl
public void internalParameterEntityDecl(String n,
String v)
throws SAXException
Receive notification of a internal parameter entity declaration
event.
- internalParameterEntityDecl in interface DTDEventListener
mixedElement
public void mixedElement(String elementName)
throws SAXException
receives notification of child element of mixed content model.
this method is called for each child element.
- mixedElement in interface DTDEventListener
notationDecl
public void notationDecl(String name,
String publicId,
String systemId)
throws SAXException
Receive notification of a Notation Declaration.
Notation declarations are used by elements and entities
for identifying embedded non-XML data.
- notationDecl in interface DTDEventListener
name
- The notation name, referred to by entities and
elements.publicId
- The public identifiersystemId
- The system identifier
processingInstruction
public void processingInstruction(String target,
String data)
throws SAXException
Receive notification of a Processing Instruction.
Processing instructions contain information meaningful
to the application.
- processingInstruction in interface DTDEventListener
target
- The target of the proceessing instruction
which should have meaning to the application.data
- The instruction itself which should contain
valid XML characters.
startCDATA
public void startCDATA()
throws SAXException
Receive notification that a CDATA section is beginning. Data in a
CDATA section is is reported through the appropriate event, either
characters() or ignorableWhitespace.
- startCDATA in interface DTDEventListener
startContentModel
public void startContentModel(String elementName,
short contentModelType)
throws SAXException
receives notification that parsing of content model is beginning.
- startContentModel in interface DTDEventListener
elementName
- name of the element whose content model is going to be defined.contentModelType
- DTDEventListener.CONTENT_MODEL_EMPTY
this element has EMPTY content model. This notification
will be immediately followed by the corresponding endContentModel.
DTDEventListener.CONTENT_MODEL_ANY
this element has ANY content model. This notification
will be immediately followed by the corresponding endContentModel.
DTDEventListener.CONTENT_MODEL_MIXED
this element has mixed content model. #PCDATA will not be reported.
each child element will be reported by mixedElement method.
DTDEventListener.CONTENT_MODEL_CHILDREN
this elemen has child content model. The actual content model will
be reported by childElement, startModelGroup, endModelGroup, and
connector methods. Possible call sequences are:
START := MODEL_GROUP
MODEL_GROUP := startModelGroup TOKEN (connector TOKEN)* endModelGroup
TOKEN := childElement
| MODEL_GROUP
startDTD
public void startDTD(InputEntity in)
throws SAXException
Receive notification of the beginning of the DTD.
- startDTD in interface DTDEventListener
in
- Current input entity.
unparsedEntityDecl
public void unparsedEntityDecl(String name,
String publicId,
String systemId,
String notationName)
throws SAXException
Receive notification of an unparsed entity declaration.
Unparsed entities are non-XML data.
- unparsedEntityDecl in interface DTDEventListener
name
- The name of the unparsed entity.publicId
- The public identifiersystemId
- The system identifiernotationName
- The associated notation