DTDEventListener
, java.util.EventListener
TDTDReader
public class DTDHandlerBase extends java.lang.Object implements DTDEventListener
CHOICE, CONTENT_MODEL_ANY, CONTENT_MODEL_CHILDREN, CONTENT_MODEL_EMPTY, CONTENT_MODEL_MIXED, OCCURENCE_ONCE, OCCURENCE_ONE_OR_MORE, OCCURENCE_ZERO_OR_MORE, OCCURENCE_ZERO_OR_ONE, SEQUENCE, USE_FIXED, USE_IMPLIED, USE_NORMAL, USE_REQUIRED
Constructor | Description |
---|---|
DTDHandlerBase() |
Modifier and Type | Method | Description |
---|---|---|
void |
attributeDecl(java.lang.String elementName,
java.lang.String attributeName,
java.lang.String attributeType,
java.lang.String[] enumeration,
short attributeUse,
java.lang.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(java.lang.String elementName,
short occurence) |
|
void |
comment(java.lang.String n) |
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(java.lang.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 |
error(org.xml.sax.SAXParseException e) |
|
void |
externalGeneralEntityDecl(java.lang.String n,
java.lang.String p,
java.lang.String s) |
Receive notification of an external parsed general entity
declaration event.
|
void |
externalParameterEntityDecl(java.lang.String n,
java.lang.String p,
java.lang.String s) |
Receive notification of an external parameter entity declaration
event.
|
void |
fatalError(org.xml.sax.SAXParseException e) |
|
void |
ignorableWhitespace(char[] ch,
int start,
int length) |
Receive notification of ignorable whitespace in element content.
|
void |
internalGeneralEntityDecl(java.lang.String n,
java.lang.String v) |
Receive notification of a internal general entity declaration event.
|
void |
internalParameterEntityDecl(java.lang.String n,
java.lang.String v) |
Receive notification of a internal parameter entity declaration
event.
|
void |
mixedElement(java.lang.String elementName) |
receives notification of child element of mixed content model.
|
void |
notationDecl(java.lang.String name,
java.lang.String publicId,
java.lang.String systemId) |
Receive notification of a Notation Declaration.
|
void |
processingInstruction(java.lang.String target,
java.lang.String data) |
Receive notification of a Processing Instruction.
|
void |
setDocumentLocator(org.xml.sax.Locator loc) |
|
void |
startCDATA() |
Receive notification that a CDATA section is beginning.
|
void |
startContentModel(java.lang.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 |
startModelGroup() |
|
void |
unparsedEntityDecl(java.lang.String name,
java.lang.String publicId,
java.lang.String systemId,
java.lang.String notationName) |
Receive notification of an unparsed entity declaration.
|
void |
warning(org.xml.sax.SAXParseException err) |
public void processingInstruction(java.lang.String target, java.lang.String data) throws org.xml.sax.SAXException
DTDEventListener
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.org.xml.sax.SAXException
public void setDocumentLocator(org.xml.sax.Locator loc)
setDocumentLocator
in interface DTDEventListener
public void fatalError(org.xml.sax.SAXParseException e) throws org.xml.sax.SAXException
fatalError
in interface DTDEventListener
org.xml.sax.SAXException
public void error(org.xml.sax.SAXParseException e) throws org.xml.sax.SAXException
error
in interface DTDEventListener
org.xml.sax.SAXException
public void warning(org.xml.sax.SAXParseException err) throws org.xml.sax.SAXException
warning
in interface DTDEventListener
org.xml.sax.SAXException
public void notationDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId) throws org.xml.sax.SAXException
DTDEventListener
notationDecl
in interface DTDEventListener
name
- The notation name, referred to by entities and
elements.publicId
- The public identifiersystemId
- The system identifierorg.xml.sax.SAXException
public void unparsedEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId, java.lang.String notationName) throws org.xml.sax.SAXException
DTDEventListener
unparsedEntityDecl
in interface DTDEventListener
name
- The name of the unparsed entity.publicId
- The public identifiersystemId
- The system identifiernotationName
- The associated notationorg.xml.sax.SAXException
public void endDTD() throws org.xml.sax.SAXException
DTDEventListener
endDTD
in interface DTDEventListener
org.xml.sax.SAXException
DTDEventListener.startDTD(InputEntity)
public void externalGeneralEntityDecl(java.lang.String n, java.lang.String p, java.lang.String s) throws org.xml.sax.SAXException
DTDEventListener
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
n
- The entity name.p
- The entity's public identifier, or null if
none was given.s
- The entity's system identifier.org.xml.sax.SAXException
DTDEventListener.unparsedEntityDecl(String, String, String, String)
public void internalGeneralEntityDecl(java.lang.String n, java.lang.String v) throws org.xml.sax.SAXException
DTDEventListener
internalGeneralEntityDecl
in interface DTDEventListener
n
- The internal general entity name.v
- The value of the entity, which may include unexpanded
entity references. Character references will have been
expanded.org.xml.sax.SAXException
DTDEventListener.externalGeneralEntityDecl(String, String, String)
public void externalParameterEntityDecl(java.lang.String n, java.lang.String p, java.lang.String s) throws org.xml.sax.SAXException
DTDEventListener
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
n
- The parameter entity name.p
- The entity's public identifier, or null if
none was given.s
- The entity's system identifier.org.xml.sax.SAXException
DTDEventListener.unparsedEntityDecl(String, String, String, String)
public void internalParameterEntityDecl(java.lang.String n, java.lang.String v) throws org.xml.sax.SAXException
DTDEventListener
internalParameterEntityDecl
in interface DTDEventListener
n
- The internal parameter entity name.v
- The value of the entity, which may include unexpanded
entity references. Character references will have been
expanded.org.xml.sax.SAXException
DTDEventListener.externalParameterEntityDecl(String, String, String)
public void startDTD(InputEntity in) throws org.xml.sax.SAXException
DTDEventListener
startDTD
in interface DTDEventListener
in
- Current input entity.org.xml.sax.SAXException
DTDEventListener.endDTD()
public void comment(java.lang.String n) throws org.xml.sax.SAXException
DTDEventListener
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
n
- the text within the comment delimiters.org.xml.sax.SAXException
public void characters(char[] ch, int start, int length) throws org.xml.sax.SAXException
DTDEventListener
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
ch
- The characters from the DTD.start
- The start position in the array.length
- The number of characters to read from the array.org.xml.sax.SAXException
DTDEventListener.ignorableWhitespace(char[], int, int)
public void ignorableWhitespace(char[] ch, int start, int length) throws org.xml.sax.SAXException
DTDEventListener
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
ch
- The characters from the DTD.start
- The start position in the array.length
- The number of characters to read from the array.org.xml.sax.SAXException
DTDEventListener.characters(char[], int, int)
public void startCDATA() throws org.xml.sax.SAXException
DTDEventListener
startCDATA
in interface DTDEventListener
org.xml.sax.SAXException
DTDEventListener.endCDATA()
public void endCDATA() throws org.xml.sax.SAXException
DTDEventListener
endCDATA
in interface DTDEventListener
org.xml.sax.SAXException
DTDEventListener.startCDATA()
public void startContentModel(java.lang.String elementName, short contentModelType) throws org.xml.sax.SAXException
DTDEventListener
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
org.xml.sax.SAXException
public void endContentModel(java.lang.String elementName, short contentModelType) throws org.xml.sax.SAXException
DTDEventListener
endContentModel
in interface DTDEventListener
org.xml.sax.SAXException
public void attributeDecl(java.lang.String elementName, java.lang.String attributeName, java.lang.String attributeType, java.lang.String[] enumeration, short attributeUse, java.lang.String defaultValue) throws org.xml.sax.SAXException
DTDEventListener
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
org.xml.sax.SAXException
public void childElement(java.lang.String elementName, short occurence) throws org.xml.sax.SAXException
childElement
in interface DTDEventListener
org.xml.sax.SAXException
public void mixedElement(java.lang.String elementName) throws org.xml.sax.SAXException
DTDEventListener
mixedElement
in interface DTDEventListener
org.xml.sax.SAXException
DTDEventListener.startContentModel(String, short)
public void startModelGroup() throws org.xml.sax.SAXException
startModelGroup
in interface DTDEventListener
org.xml.sax.SAXException
public void endModelGroup(short occurence) throws org.xml.sax.SAXException
endModelGroup
in interface DTDEventListener
org.xml.sax.SAXException
public void connector(short connectorType) throws org.xml.sax.SAXException
DTDEventListener
IOW, you'll never see an event sequence like (a|b,c)
connector
in interface DTDEventListener
org.xml.sax.SAXException
Copyright © 2018 Oracle Corporation. All rights reserved.