Interface DTDEventListener
- All Superinterfaces:
EventListener
- All Known Implementing Classes:
DTDHandlerBase
,TDTDReader
-
Field Summary
Modifier and TypeFieldDescriptionstatic final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
static final short
-
Method Summary
Modifier and TypeMethodDescriptionvoid
attributeDecl
(String elementName, String attributeName, String attributeType, String[] enumeration, short attributeUse, String defaultValue) For each entry in an ATTLIST declaration, this event will be fired.void
characters
(char[] ch, int start, int length) Receive notification of character data.void
childElement
(String elementName, short occurence) void
Receive notification that a comment has been read.void
connector
(short connectorType) Connectors in one model group is guaranteed to be the same.void
endCDATA()
Receive notification that the CDATA section finished.void
endContentModel
(String elementName, short contentModelType) receives notification that parsing of content model is finished.void
endDTD()
Receive notification of the end of a DTD.void
endModelGroup
(short occurence) void
void
externalGeneralEntityDecl
(String name, String publicId, String systemId) Receive notification of an external parsed general entity declaration event.void
externalParameterEntityDecl
(String name, String publicId, String systemId) Receive notification of an external parameter entity declaration event.void
void
ignorableWhitespace
(char[] ch, int start, int length) Receive notification of ignorable whitespace in element content.void
internalGeneralEntityDecl
(String name, String value) Receive notification of a internal general entity declaration event.void
internalParameterEntityDecl
(String name, String value) Receive notification of a internal parameter entity declaration event.void
mixedElement
(String elementName) receives notification of child element of mixed content model.this method is called for each child element.void
notationDecl
(String name, String publicId, String systemId) Receive notification of a Notation Declaration.void
processingInstruction
(String target, String data) Receive notification of a Processing Instruction.void
void
Receive notification that a CDATA section is beginning.void
startContentModel
(String elementName, short contentModelType) receives notification that parsing of content model is beginning.void
startDTD
(InputEntity in) Receive notification of the beginning of the DTD.void
void
unparsedEntityDecl
(String name, String publicId, String systemId, String notationName) Receive notification of an unparsed entity declaration.void
warning
(SAXParseException err)
-
Field Details
-
CONTENT_MODEL_EMPTY
static final short CONTENT_MODEL_EMPTY- See Also:
-
CONTENT_MODEL_ANY
static final short CONTENT_MODEL_ANY- See Also:
-
CONTENT_MODEL_MIXED
static final short CONTENT_MODEL_MIXED- See Also:
-
CONTENT_MODEL_CHILDREN
static final short CONTENT_MODEL_CHILDREN- See Also:
-
USE_NORMAL
static final short USE_NORMAL- See Also:
-
USE_IMPLIED
static final short USE_IMPLIED- See Also:
-
USE_FIXED
static final short USE_FIXED- See Also:
-
USE_REQUIRED
static final short USE_REQUIRED- See Also:
-
CHOICE
static final short CHOICE- See Also:
-
SEQUENCE
static final short SEQUENCE- See Also:
-
OCCURENCE_ZERO_OR_MORE
static final short OCCURENCE_ZERO_OR_MORE- See Also:
-
OCCURENCE_ONE_OR_MORE
static final short OCCURENCE_ONE_OR_MORE- See Also:
-
OCCURENCE_ZERO_OR_ONE
static final short OCCURENCE_ZERO_OR_ONE- See Also:
-
OCCURENCE_ONCE
static final short OCCURENCE_ONCE- See Also:
-
-
Method Details
-
setDocumentLocator
-
processingInstruction
Receive notification of a Processing Instruction. Processing instructions contain information meaningful to the application.- Parameters:
target
- The target of the proceessing instruction which should have meaning to the application.data
- The instruction itself which should contain valid XML characters.- Throws:
SAXException
- for errors
-
notationDecl
Receive notification of a Notation Declaration. Notation declarations are used by elements and entities for identifying embedded non-XML data.- Parameters:
name
- The notation name, referred to by entities and elements.publicId
- The public identifiersystemId
- The system identifier- Throws:
SAXException
- for errors
-
unparsedEntityDecl
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.- Parameters:
name
- The name of the unparsed entity.publicId
- The public identifiersystemId
- The system identifiernotationName
- The associated notation- Throws:
SAXException
- for errors
-
internalGeneralEntityDecl
Receive notification of a internal general entity declaration event.- Parameters:
name
- The internal general entity name.value
- The value of the entity, which may include unexpanded entity references. Character references will have been expanded.- Throws:
SAXException
- for errors- See Also:
-
externalGeneralEntityDecl
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
- The entity name.publicId
- The entity's public identifier, or null if none was given.systemId
- The entity's system identifier.- Throws:
SAXException
- for errors- See Also:
-
internalParameterEntityDecl
Receive notification of a internal parameter entity declaration event.- Parameters:
name
- The internal parameter entity name.value
- The value of the entity, which may include unexpanded entity references. Character references will have been expanded.- Throws:
SAXException
- for errors- See Also:
-
externalParameterEntityDecl
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
- The parameter entity name.publicId
- The entity's public identifier, or null if none was given.systemId
- The entity's system identifier.- Throws:
SAXException
- for errors- See Also:
-
startDTD
Receive notification of the beginning of the DTD.- Parameters:
in
- Current input entity.- Throws:
SAXException
- for errors- See Also:
-
endDTD
Receive notification of the end of a DTD. The parser will invoke this method only once.- Throws:
SAXException
- for errors- See Also:
-
comment
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
- the text within the comment delimiters.- Throws:
SAXException
- for errors
-
characters
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
- The characters from the DTD.start
- The start position in the array.length
- The number of characters to read from the array.- Throws:
SAXException
- for errors- See Also:
-
ignorableWhitespace
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
- The characters from the DTD.start
- The start position in the array.length
- The number of characters to read from the array.- Throws:
SAXException
- for errors- See Also:
-
startCDATA
Receive notification that a CDATA section is beginning. Data in a CDATA section is is reported through the appropriate event, either characters() or ignorableWhitespace.- Throws:
SAXException
- for errors- See Also:
-
endCDATA
Receive notification that the CDATA section finished.- Throws:
SAXException
- for errors- See Also:
-
fatalError
- Throws:
SAXException
-
error
- Throws:
SAXException
-
warning
- Throws:
SAXException
-
startContentModel
receives notification that parsing of content model is beginning.- Parameters:
elementName
- name of the element whose content model is going to be defined.contentModelType
-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 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
- Throws:
SAXException
- for errors
-
endContentModel
receives notification that parsing of content model is finished.- Throws:
SAXException
- for errors
-
attributeDecl
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.
- Throws:
SAXException
- for errors
-
childElement
- Throws:
SAXException
-
mixedElement
receives notification of child element of mixed content model.this method is called for each child element.- Throws:
SAXException
- for errors- See Also:
-
startModelGroup
- Throws:
SAXException
-
endModelGroup
- Throws:
SAXException
-
connector
Connectors in one model group is guaranteed to be the same.IOW, you'll never see an event sequence like (a|b,c)
- Throws:
SAXException
- for errors
-