public Interface DTDEventListener

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.

Exceptions

SAXException:

for errors

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

Parameters

ch:char[]

The characters from the DTD.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

Exceptions

SAXException:

for errors

See Also

ignorableWhitespace(char[], int, int)

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.

Parameters

text:String

the text within the comment delimiters.

Exceptions

SAXException:

for errors

Connectors in one model group is guaranteed to be the same.

IOW, you'll never see an event sequence like (a|b,c)

Exceptions

SAXException:

for errors

Receive notification that the CDATA section finished.

Exceptions

SAXException:

for errors

See Also

startCDATA()

receives notification that parsing of content model is finished.

Exceptions

SAXException:

for errors

Receive notification of the end of a DTD. The parser will invoke this method only once.

Exceptions

SAXException:

for errors

See Also

startDTD(InputEntity)

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.

Parameters

name:String

The entity name.

publicId:String

The entity's public identifier, or null if none was given.

systemId:String

The entity's system identifier.

Exceptions

SAXException:

for errors

See Also

unparsedEntityDecl(String, String, String, String)

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.

Parameters

name:String

The parameter entity name.

publicId:String

The entity's public identifier, or null if none was given.

systemId:String

The entity's system identifier.

Exceptions

SAXException:

for errors

See Also

unparsedEntityDecl(String, String, String, String)

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.

Parameters

ch:char[]

The characters from the DTD.

start:int

The start position in the array.

length:int

The number of characters to read from the array.

Exceptions

SAXException:

for errors

See Also

characters(char[], int, int)

Receive notification of a internal general entity declaration event.

Parameters

name:String

The internal general entity name.

value:String

The value of the entity, which may include unexpanded entity references. Character references will have been expanded.

Exceptions

SAXException:

for errors

See Also

externalGeneralEntityDecl(String, String, String)

Receive notification of a internal parameter entity declaration event.

Parameters

name:String

The internal parameter entity name.

value:String

The value of the entity, which may include unexpanded entity references. Character references will have been expanded.

Exceptions

SAXException:

for errors

See Also

externalParameterEntityDecl(String, String, String)

Receives notification of child element of mixed content model. This method is called for each child element.

Exceptions

SAXException:

for errors

See Also

startContentModel(String, short)

Receive notification of a Notation Declaration. Notation declarations are used by elements and entities for identifying embedded non-XML data.

Parameters

name:String

The notation name, referred to by entities and elements.

publicId:String

The public identifier

systemId:String

The system identifier

Exceptions

SAXException:

for errors

Receive notification of a Processing Instruction. Processing instructions contain information meaningful to the application.

Parameters

target:String

The target of the processing instruction which should have meaning to the application.

data:String

The instruction itself which should contain valid XML characters.

Exceptions

SAXException:

for errors

Receive notification that a CDATA section is beginning. Data in a CDATA section is reported through the appropriate event, either characters() or ignorableWhitespace.

Exceptions

SAXException:

for errors

See Also

endCDATA()

receives notification that parsing of content model is beginning.

Parameters

elementName:String

name of the element whose content model is going to be defined.

contentModelType:short

CONTENT_MODEL_EMPTY this element has EMPTY content model. This notification will be immediately followed by the corresponding endContentModel. CONTENT_MODEL_ANY this element has ANY content model. This notification will be immediately followed by the corresponding endContentModel. CONTENT_MODEL_MIXED this element has mixed content model. #PCDATA will not be reported. each child element will be reported by mixedElement method. CONTENT_MODEL_CHILDREN this element 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

Exceptions

SAXException:

for errors

Receive notification of the beginning of the DTD.

Parameters

in:InputEntity

Current input entity.

Exceptions

SAXException:

for errors

See Also

endDTD()

Receive notification of an unparsed entity declaration. Unparsed entities are non-XML data.

Parameters

name:String

The name of the unparsed entity.

publicId:String

The public identifier

systemId:String

The system identifier

notationName:String

The associated notation

Exceptions

SAXException:

for errors